{ "openapi": "3.0.1", "x-stoplight": { "id": "c6mm7uj7zp3wj" }, "info": { "title": "Ecommerce", "version": "v1" }, "paths": { "/ecommerce/v1/payment-buttons": { "get": { "tags": [ "Button" ], "summary": "List of Payment Buttons", "parameters": [ { "name": "page", "in": "query", "required": true, "schema": { "maximum": 2147483647, "minimum": 1, "type": "integer", "format": "int32", "example": 1 }, "example": 1 }, { "name": "size", "in": "query", "required": true, "schema": { "maximum": 2147483647, "minimum": 1, "type": "integer", "format": "int32", "example": 20 }, "example": 20 }, { "name": "status", "in": "query", "schema": { "type": "string", "enum": [ "None", "Active", "Disabled", "Expired", "Forbidden" ] } }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Models.PaginatedList`1[Application.Common.Models.Button.Response.ButtonLinksResponseModel]" }, "examples": { "Example 1": { "value": { "items": [ { "code": "B6T9KPKY3BQ98", "url": "https://demo.mypos.eu/vmp/btn/B6T9KPKY3BQ9", "custom_name": "Test Button", "amount": 0.2, "currency": "EUR", "status": "Active" } ], "page": 0, "page_size": 0, "total_pages": 0, "total_count": 0, "has_previous_page": true, "has_next_page": true } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } } }, "x-stoplight": { "id": "olx12pr2ph125" }, "operationId": "list-of-payment-buttons" }, "post": { "tags": [ "Button" ], "summary": "Create Payment Button", "parameters": [ { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "name": "X-Application-Id", "required": true } ], "requestBody": { "content": { "application/json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Button.Request.CreateButtonRequestModel" }, "examples": { "Example 1": { "value": { "button_size": "Small", "cancel_url": "string", "return_url": "string", "item_name": "Creating a button", "item_price": 0.1, "pref_language": "en", "currency": "EUR", "account_number": "50480563548", "custom_name": "Test Button", "quantity": 1, "website": "https://mywebsite.com/", "ask_for_customer_name": false, "ask_for_shipping_address": false, "ask_for_customer_email": false, "ask_for_customer_phone_number": false, "ask_for_customer_id": false, "send_sms": false, "send_email": false } } } }, "text/json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Button.Request.CreateButtonRequestModel" } }, "application/*+json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Button.Request.CreateButtonRequestModel" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Button.Response.CreateButtonResponseModel" }, "examples": { "Example 1": { "value": { "url": "https://demo.mypos.eu/vmp/btn/B8MQEGCFBG638" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "property1": [ "string" ], "property2": [ "string" ] }, "property1": null, "property2": null } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "mitqhkd3d7cfj" }, "operationId": "create-payment-button" } }, "/ecommerce/v1/payment-buttons/{code}": { "get": { "tags": [ "Button" ], "summary": "Payment Button Details", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Button.Response.ButtonLinkDetailsResponseModel" }, "examples": { "Example 1": { "value": { "created_on": "2025-10-30T14:19:13", "code": "B6T9KPKY3BQ98", "url": "https://demo.mypos.eu/vmp/btn/BE2J9AR8AMB52", "custom_name": "Test Button", "item_name": "Creating a button", "enable": true, "item_price": 0.1, "total_amount": 0.2, "quantity": 2, "button_size": 0, "button_type": 1, "send_sms": false, "send_email": false, "hide_quantity": false, "ask_for_customer_name": false, "ask_for_shipping_address": false, "ask_for_customer_email": false, "ask_for_customer_phone_number": false, "ask_for_customer_id": false, "currency": "EUR", "pref_language": "en", "website": "https://mywebsite.com/", "cancel_url": "string", "return_url": "string", "expire_date": "2025-11-30T14:19:13", "account_number": "50480563548" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } } }, "x-stoplight": { "id": "b251zmer7to16" }, "operationId": "payment-button-details" }, "delete": { "tags": [ "Button" ], "summary": "Delete Payment Button", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "wz6il23r9pst5" }, "operationId": "delete-payment-button" }, "patch": { "tags": [ "Button" ], "summary": "Update Details of Payment Button", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "requestBody": { "content": { "application/json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Button.Request.UpdateButtonDetailsRequestModel" }, "examples": { "Example 1": { "value": { "website": "https://mywebsite.com/", "cancel_url": "string", "return_url": "string", "button_size": "Small", "pref_lang": "en", "custom_name": "string", "send_sms": false, "send_email": false, "ask_for_customer_name": false, "ask_for_shipping_address": false, "ask_for_customer_email": false, "ask_for_customer_phone_number": false, "ask_for_customer_id": false, "enable": false } } } }, "text/json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Button.Request.UpdateButtonDetailsRequestModel" } }, "application/*+json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Button.Request.UpdateButtonDetailsRequestModel" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Button.Response.ButtonLinkDetailsResponseModel" }, "examples": { "Example 1": { "value": { "created_on": "2025-10-30T14:19:13", "code": "B6T9KPKY3BQ98", "url": "https://demo.mypos.eu/vmp/btn/B6T9KPKY3BQ98", "custom_name": "Test Button", "item_name": "Creating a button", "enable": true, "item_price": 0.1, "total_amount": 0.2, "quantity": 2, "button_size": 0, "button_type": 1, "send_sms": false, "send_email": false, "hide_quantity": false, "ask_for_customer_name": false, "ask_for_shipping_address": false, "ask_for_customer_email": false, "ask_for_customer_phone_number": false, "ask_for_customer_id": false, "currency": "EUR", "pref_language": "en", "website": "https://mywebsite.com/", "cancel_url": "string", "return_url": "string", "expire_date": "2025-11-30T14:19:13", "account_number": "50480563548" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } } }, "x-stoplight": { "id": "ryhskmr6lnkfv" }, "operationId": "update-details-of-payment-button" }, "parameters": [ { "schema": { "type": "string" }, "name": "code", "in": "path", "required": true } ] }, "/ecommerce/v1/payment-buttons/transactions": { "get": { "tags": [ "Button" ], "summary": "Get Payment Button Transactions List", "parameters": [ { "name": "page", "in": "query", "required": true, "schema": { "maximum": 2147483647, "minimum": 1, "type": "integer", "format": "int32", "example": 1 }, "example": 1 }, { "name": "size", "in": "query", "required": true, "schema": { "maximum": 2147483647, "minimum": 1, "type": "integer", "format": "int32", "example": 20 }, "example": 20 }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "name": "X-Partner-Id", "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" }, { "schema": { "type": "string" }, "in": "query", "name": "code" }, { "schema": { "type": "string" }, "in": "query", "name": "date_from" }, { "schema": { "type": "string" }, "in": "query", "name": "date_to" } ], "requestBody": { "content": { "application/json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Button.Request.ButtonTransactionsRequestModel" }, "examples": { "Example 1": { "value": { "code": "string", "date_from": "2019-08-24T14:15:22Z", "date_to": "2019-08-24T14:15:22Z" } } } }, "text/json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Button.Request.ButtonTransactionsRequestModel" } }, "application/*+json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Button.Request.ButtonTransactionsRequestModel" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Models.PaginatedList`1[Application.Common.Models.Button.Response.ButtonTransactionsResponseModel]" }, "examples": { "Example 1": { "value": { "items": [ { "date": "2025-05-16T17:37:17", "code": "BDYZC4KBNFG98", "custom_name": "test", "amount": 1, "currency": "EUR", "settlement_date": "2025-05-16T17:37:17", "settlement_amount": "1", "settlement_currency": "EUR", "fee": 0.14, "customer_name": "TEST", "customer_address": "test address", "customer_email": "test@mypos.com", "customer_phone": "359888888888", "payment_reference": "MTCOR15253S5OFPX" } ], "page": 0, "page_size": 0, "total_pages": 0, "total_count": 0, "has_previous_page": true, "has_next_page": true } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } } }, "x-stoplight": { "id": "0il4k7bqcfdjw" }, "operationId": "get-payment-button-transactions-list" }, "parameters": [] }, "/ecommerce/v1/common/languages": { "get": { "tags": [ "Common" ], "parameters": [ { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" }, { "schema": { "type": "string" }, "in": "query", "name": "page ", "required": true }, { "schema": { "type": "string" }, "in": "query", "name": "size ", "required": true } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Common.Response.LanguagesResponseModel" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "0ee0jesufdf5w" }, "summary": "List of Languages", "operationId": "list-of-languages" } }, "/ecommerce/v1/common/settlement-data": { "get": { "tags": [ "Common" ], "parameters": [ { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" }, { "schema": { "type": "string" }, "in": "query", "name": "page " }, { "schema": { "type": "string" }, "in": "query", "name": "size " } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Common.Response.SettlementDataResponseModel" }, "examples": { "Example 1": { "value": { "items": [ { "settlement_currency": "EUR", "account": { "account_number": "50480563548", "iban": "IE61MPOS99039050480563", "currency": "EUR", "name": "EUR Account", "is_reserve": true, "is_suspense_account": true } } ], "page": 0, "page_size": 0, "total_pages": 0, "total_count": 0, "has_previous_page": true, "has_next_page": true } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "xglxt7mwer0ue" }, "summary": "Settlement Data", "operationId": "settlement-data" } }, "/ecommerce/v1/payment-links": { "get": { "tags": [ "Link" ], "summary": "List of Payment Links", "parameters": [ { "name": "status", "in": "query", "schema": { "$ref": "#/components/schemas/Application.Common.Enums.PaymentLinkStatus" } }, { "name": "page", "in": "query", "required": true, "schema": { "maximum": 2147483647, "minimum": 1, "type": "integer", "format": "int32", "example": 1 }, "example": 1 }, { "name": "size", "in": "query", "required": true, "schema": { "maximum": 2147483647, "minimum": 1, "type": "integer", "format": "int32", "example": 20 }, "example": 20 }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Models.PaginatedList`1[Application.Common.Models.Link.Response.PaymentLinkListResponseModel]" }, "examples": { "Example 1": { "value": { "items": [ { "code": "BGOBAFZ65QS08", "url": "https://demo.mypos.eu/vmp/btn/BGOBAFZ65QS08", "custom_name": "Create a Payment Link", "amount": 0.2, "currency": "EUR", "status": "Active" } ], "page": 0, "page_size": 0, "total_pages": 0, "total_count": 0, "has_previous_page": true, "has_next_page": true } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "9teaa7aqh01kz" }, "operationId": "list-of-payment-links" }, "post": { "tags": [ "Link" ], "summary": "Create Payment Link", "parameters": [ { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "requestBody": { "content": { "application/json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Link.Request.CreateLinkRequestModel" }, "examples": { "Example 1": { "value": { "hide_quantity": false, "expired_date": "2025-05-16T17:37:17", "item_name": "Test Payment Link", "item_price": 1, "pref_language": "en", "currency": "EUR", "account_number": "50480563548", "custom_name": "Testin1g", "quantity": 1, "website": "http://www.mywesbite.com/", "ask_for_customer_name": false, "ask_for_shipping_address": false, "ask_for_customer_email": false, "ask_for_customer_phone_number": false, "ask_for_customer_id": false, "send_sms": false, "send_email": false } } } }, "text/json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Link.Request.CreateLinkRequestModel" } }, "application/*+json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Link.Request.CreateLinkRequestModel" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Link.Response.CreateLinkResponseModel" }, "examples": { "Example 1": { "value": { "url": "https://demo.mypos.eu/vmp/btn/BGOBAFZ65QS08" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "7ubfdeyclywua" }, "operationId": "create-payment-link" } }, "/ecommerce/v1/payment-links/{code}": { "get": { "tags": [ "Link" ], "summary": "Receive Payment Link Details by Code", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Link.Response.PaymentLinkResponseModel" }, "examples": { "Example 1": { "value": { "created_on": "2025-10-20T14:31:50", "code": "BLQ2IYI5LQV79", "url": "https://demo.mypos.eu/vmp/btn/BLQ2IYI5LQV79", "custom_name": "Create a Payment Link", "item_name": "Test Payment Link", "enable": true, "item_price": 0.2, "total_amount": 0.4, "quantity": 2, "button_size": 0, "button_type": 2, "send_sms": true, "send_email": true, "hide_quantity": true, "ask_for_customer_name": true, "ask_for_shipping_address": true, "ask_for_customer_email": true, "ask_for_customer_phone_number": true, "ask_for_customer_id": true, "currency": "EUR", "pref_language": "en", "website": "https://mywebsite.com/", "cancel_url": "string", "return_url": "string", "expire_date": "2025-11-19T12:00:00", "account_number": "50480563548" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "t9c6jwkbpi660" }, "operationId": "receive-payment-link-details-by-code" }, "patch": { "tags": [ "Link" ], "summary": "Edit Payment Link Details", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "requestBody": { "content": { "application/json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Link.Request.EditPaymentLinkRequestModel" }, "examples": { "Example 1": { "value": { "pref_lang": "string", "custom_name": "string", "send_sms": true, "sens_email": true, "ask_for_customer_name": true, "ask_for_shipping_address": true, "ask_for_customer_email": true, "ask_for_customer_phone_number": true, "ask_for_customer_id": true, "enable": true, "hide_quantity": true, "website": "string", "expired_date": "string" } }, "Example 2": { "value": { "pref_lang": "en", "custom_name": "Set Custom Name", "send_sms": true, "sens_email": true, "ask_for_customer_name": true, "ask_for_shipping_address": true, "ask_for_customer_email": true, "ask_for_customer_phone_number": true, "ask_for_customer_id": true, "enable": true, "hide_quantity": true, "website": "https://mywebsite.com/", "expired_date": "2025-11-19T12:00:00" } } } }, "text/json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Link.Request.EditPaymentLinkRequestModel" } }, "application/*+json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Link.Request.EditPaymentLinkRequestModel" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.Link.Response.PaymentLinkResponseModel" }, "examples": { "Example 1": { "value": { "created_on": "2025-10-20T14:31:50", "code": "BLQ2IYI5LQV79", "url": "https://demo.mypos.eu/vmp/btn/BLQ2IYI5LQV79", "custom_name": "Create a Payment Link", "item_name": "Test Payment Link", "enable": true, "item_price": 0.2, "total_amount": 0.4, "quantity": 2, "button_size": 0, "button_type": 2, "send_sms": true, "send_email": true, "hide_quantity": true, "ask_for_customer_name": true, "ask_for_shipping_address": true, "ask_for_customer_email": true, "ask_for_customer_phone_number": true, "ask_for_customer_id": true, "currency": "EUR", "pref_language": "en", "website": "https://mywebsite.com/", "cancel_url": "string", "return_url": "string", "expire_date": "2025-11-19T12:00:00", "account_number": "50480563548" } }, "Example 2": { "value": { "created_on": "2025-10-20T14:31:50", "code": "BLQ2IYI5LQV79", "url": "https://demo.mypos.eu/vmp/btn/BLQ2IYI5LQV79", "custom_name": "Set Custom Name", "item_name": "string", "enable": true, "item_price": 0.2, "total_amount": 0.4, "quantity": 2, "button_size": 0, "button_type": 2, "send_sms": true, "send_email": true, "hide_quantity": true, "ask_for_customer_name": true, "ask_for_shipping_address": true, "ask_for_customer_email": true, "ask_for_customer_phone_number": true, "ask_for_customer_id": true, "currency": "EUR", "pref_language": "en", "website": "https://mywebsite.com/", "cancel_url": "string", "return_url": "string", "expire_date": "2025-11-19T12:00:00", "account_number": "50480563548" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "u8elg45gy8prj" }, "operationId": "edit-payment-link-details" }, "delete": { "tags": [ "Link" ], "summary": "Delete payment link by code", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "1rfcusgi0zhxb" }, "operationId": "delete-payment-link-by-code" }, "parameters": [ { "schema": { "type": "string" }, "name": "code", "in": "path", "required": true } ] }, "/ecommerce/v1/payment-links/transactions": { "get": { "tags": [ "Link" ], "summary": "Receive a list with transactions for the payment links", "parameters": [ { "name": "status", "in": "query", "schema": { "$ref": "#/components/schemas/Application.Common.Enums.PaymentLinkStatus" } }, { "name": "code", "in": "query", "schema": { "type": "string" } }, { "name": "date_from", "in": "query", "schema": { "type": "string", "format": "date-time" } }, { "name": "date_to", "in": "query", "schema": { "type": "string", "format": "date-time" } }, { "name": "page", "in": "query", "required": true, "schema": { "maximum": 2147483647, "minimum": 1, "type": "integer", "format": "int32", "example": 1 }, "example": 1 }, { "name": "size", "in": "query", "required": true, "schema": { "maximum": 2147483647, "minimum": 1, "type": "integer", "format": "int32", "example": 20 }, "example": 20 }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Models.PaginatedList`1[Application.Common.Models.Link.Response.PaymentLinkTransactionDetailsReponseModel]" }, "examples": { "Example 1": { "value": { "items": [ { "date": "string", "code": "string", "custom_name": "string", "amount": 0, "currency": "string", "settlement_date": "string", "settlement_amount": "string", "settlement_currency": "string", "fee": 0, "customer_name": "string", "customer_address": "string", "customer_email": "string", "customer_phone": "string", "payment_reference": "string" } ], "page": 0, "page_size": 0, "total_pages": 0, "total_count": 0, "has_previous_page": true, "has_next_page": true } }, "Example 2": { "value": { "items": [ { "date": "2025-05-29T14:21:10", "code": "BIE589ACVLD43", "custom_name": "DEMO", "amount": 1, "currency": "EUR", "settlement_date": "2025-05-29T14:21:11", "settlement_amount": "1", "settlement_currency": "EUR", "fee": 0.29, "customer_name": "DEMO", "customer_address": "string", "customer_email": "string", "customer_phone": "string", "payment_reference": "MTCOS0224461F39K" } ], "page": 0, "page_size": 0, "total_pages": 0, "total_count": 0, "has_previous_page": true, "has_next_page": true } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "k6mvh6pnnrjo4" }, "operationId": "receive-payment-link-transactions-list" }, "parameters": [] }, "/ecommerce/v1/payment-requests": { "post": { "summary": "Create Payment Request", "parameters": [ { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" }, { "schema": { "type": "string" }, "in": "query", "name": "status" }, { "schema": { "type": "string" }, "in": "query", "name": "code" }, { "schema": { "type": "string" }, "in": "query", "name": "from_amount" }, { "schema": { "type": "string" }, "in": "query", "name": "to_amount" }, { "schema": { "type": "string" }, "in": "query", "name": "currency" }, { "schema": { "type": "string" }, "in": "query", "name": "from_date" }, { "schema": { "type": "string" }, "in": "query", "name": "to_date" }, { "schema": { "type": "string" }, "in": "query", "name": "client_name" }, { "schema": { "type": "string" }, "in": "query", "name": "reason" }, { "schema": { "type": "string" }, "in": "query", "name": "booking_text" } ], "requestBody": { "content": { "application/json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.PaymentRequest.Request.CreatePrRequestModel" }, "examples": { "Example 1": { "value": { "amount": 28.78, "currency": "EUR", "client_name": "EUR", "reason": "Test Reason", "booking_text": "Random Text", "dba": "company", "expiry_date": "2025-08-18", "payment_request_lang": "en", "notify_gsm": "+359885885885", "qr_generated": true } } } }, "text/json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.PaymentRequest.Request.CreatePrRequestModel" } }, "application/*+json; x-api-version=1": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.PaymentRequest.Request.CreatePrRequestModel" } } } }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.PaymentRequest.Response.CreatePrResponseModel" }, "examples": { "Example 1": { "value": { "code": "B9UU2SESPY5Y42", "payment_request_url": "https://demo.mypos.eu/bg/qr-pr/B9UU2SESPY5Y42" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "itvqzaz9ctyo4" }, "operationId": "create-payment-request", "tags": [ "Payment-request" ] }, "parameters": [], "get": { "summary": "Receive List of Payment Requests", "parameters": [ { "name": "status", "in": "query", "schema": { "$ref": "#/components/schemas/Application.Common.Enums.PaymentRequestStatus" } }, { "name": "code", "in": "query", "schema": { "type": "string" } }, { "name": "from_amount", "in": "query", "schema": { "type": "number", "format": "double" } }, { "name": "to_amount", "in": "query", "schema": { "type": "number", "format": "double" } }, { "name": "currency", "in": "query", "schema": { "type": "string" } }, { "name": "from_date", "in": "query", "schema": { "type": "string", "format": "date-time" } }, { "name": "to_date", "in": "query", "schema": { "type": "string", "format": "date-time" } }, { "name": "client_name", "in": "query", "schema": { "type": "string" } }, { "name": "reason", "in": "query", "schema": { "type": "string" } }, { "name": "booking_text", "in": "query", "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": true, "schema": { "maximum": 2147483647, "minimum": 1, "type": "integer", "format": "int32", "example": 1 }, "example": 1 }, { "name": "size", "in": "query", "required": true, "schema": { "maximum": 2147483647, "minimum": 1, "type": "integer", "format": "int32", "example": 20 }, "example": 20 }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Models.PaginatedList`1[Application.Common.Models.PaymentRequest.Response.PrListDetailsResponseModel]" }, "examples": { "Example 1": { "value": { "items": [ { "code": "BF4FWKWIQXPV30", "url": "https://demo.mypos.eu/bg/qr-pr/BF4FWKWIQXPV30", "added_on": "2025-10-31T09:03:03", "client_name": "Test Client Name", "amount": 28.78, "currency": "EUR", "reason": "Test Reason", "booking_text": "Test booking ", "status": "Pending" } ], "page": 1, "page_size": 20, "total_pages": 1, "total_count": 2, "has_previous_page": false, "has_next_page": false } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "gguhwlokykocr" }, "operationId": "receive-list-of-payment-requests", "tags": [ "Payment-request" ] } }, "/ecommerce/v1/payment-requests/{code}": { "get": { "summary": "Payment Request Details", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.PaymentRequest.Response.PrDetailsResponseModel" }, "examples": { "Example 1": { "value": { "code": "B9UU2SESPY5Y42", "url": "https://demo.mypos.eu/bg/qr-pr/B9UU2SESPY5Y42", "added_on": "2025-10-31T09:00:00", "client_name": "Test Client", "amount": 28.78, "currency": "EUR", "reason": "Test Reason", "booking_text": "Test booking text", "attempts": 0, "expiry_on": "2025-11-30T23:59:59", "qr_generated": true, "email": "test@mypos.com", "gsm": "+359888888888", "status": "Pending" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" }, "examples": { "Example 1": { "value": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } } } } }, "x-stoplight": { "id": "or7wodtr8lauy" }, "operationId": "payment-requests-details", "tags": [ "Payment-request" ] }, "parameters": [ { "schema": { "type": "string" }, "name": "code", "in": "path", "required": true } ] }, "/ecommerce/v1/payment-requests/{code}/reminder": { "patch": { "summary": "Send Payment Request Reminder", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "X-Session", "in": "header", "schema": { "type": "string" }, "required": true }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Partner-Id" }, { "schema": { "type": "string" }, "in": "header", "required": true, "name": "X-Application-Id" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Application.Common.Models.PaymentRequest.Response.PrDetailsResponseModel" }, "examples": { "Example 1": { "value": { "code": "B9UU2SESPY5Y42", "url": "https://demo.mypos.eu/bg/qr-pr/B9UU2SESPY5Y42", "added_on": "2025-10-31T09:00:00", "client_name": "Test Client", "amount": 28.78, "currency": "EUR", "reason": "Test Reason", "booking_text": "Test booking text", "attempts": 0, "expiry_on": "2025-11-30T23:59:59", "qr_generated": true, "email": "test@mypos.com", "gsm": "+359888888888", "status": "Pending" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ValidationProblemDetails" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails" } } } } }, "x-stoplight": { "id": "uiqtmyq3iw6m0" }, "description": "Reminder is available only for Payhment Requests which are not having 'QR' (qr_generated = **true**).", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "gsm": { "type": "string", "x-stoplight": { "id": "dxsqssn0yjr3p" }, "example": "+359885885885" }, "email": { "type": "string", "x-stoplight": { "id": "wrbx59b3ytuo5" }, "example": "test@mypos.com" } } }, "examples": { "Example 1": { "value": { "gsm": "+359885885885", "email": "test@mypos.com" } } } } } }, "operationId": "send-payment-request-reminder", "tags": [ "Payment-request" ] }, "parameters": [ { "schema": { "type": "string" }, "name": "code", "in": "path", "required": true } ] } }, "components": { "schemas": { "Application.Common.Enums.PaymentButtonSizeEnum": { "enum": [ "Small", "Big" ], "type": "string", "x-stoplight": { "id": "a8tft8yzeirzw" } }, "Application.Common.Enums.PaymentButtonStatus": { "enum": [ "None", "Active", "Disabled", "Expired", "Forbidden" ], "type": "string", "x-stoplight": { "id": "8pclh2mujh864" }, "example": "Active", "x-examples": { "Example 1": "None" } }, "Application.Common.Enums.PaymentLinkStatus": { "enum": [ "None", "Active", "Disabled", "Expired", "Forbidden" ], "type": "string", "x-stoplight": { "id": "0hp1spxrah908" }, "x-examples": { "Example 1": "None" }, "example": "Active", "x-extension-1": null }, "Application.Common.Enums.PaymentRequestStatus": { "enum": [ "None", "Pending", "Seen", "Failed", "Paid", "Expired", "Cancelled" ], "type": "string", "x-stoplight": { "id": "f6xeco2bfeoup" }, "example": "Pending" }, "Application.Common.Models.Button.Request.ButtonTransactionsRequestModel": { "type": "object", "properties": { "code": { "type": "string", "nullable": true }, "date_from": { "type": "string", "format": "date-time", "nullable": true }, "date_to": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": false, "x-stoplight": { "id": "ovvwacz488pnh" } }, "Application.Common.Models.Button.Request.CreateButtonRequestModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "9qoxm63xq258l" }, "x-internal": false, "x-examples": { "Example 1": { "button_size": "Small", "cancel_url": "string", "return_url": "string", "item_name": "Creating a button", "item_price": 0.1, "pref_language": "en", "currency": "EUR", "account_number": "50480563548", "custom_name": "Test Button", "quantity": 1, "website": "https://mywebsite.com/", "ask_for_customer_name": false, "ask_for_shipping_address": false, "ask_for_customer_email": false, "ask_for_customer_phone_number": false, "ask_for_customer_id": false, "send_sms": false, "send_email": false } }, "properties": { "button_size": { "$ref": "#/components/schemas/Application.Common.Enums.PaymentButtonSizeEnum" }, "cancel_url": { "type": "string", "nullable": true }, "return_url": { "type": "string", "nullable": true }, "item_name": { "type": "string", "example": "Creating a button", "nullable": true }, "item_price": { "type": "number", "format": "double", "example": 0.1 }, "pref_language": { "type": "string", "example": "en", "nullable": true }, "currency": { "type": "string", "example": "EUR", "nullable": true }, "account_number": { "type": "string", "example": "50480563548", "nullable": true }, "custom_name": { "type": "string", "example": "Test Button", "nullable": true }, "quantity": { "type": "integer", "format": "int32", "example": 1 }, "website": { "type": "string", "example": "https://mywebsite.com/", "nullable": true }, "ask_for_customer_name": { "type": "boolean", "default": false }, "ask_for_shipping_address": { "type": "boolean", "default": false }, "ask_for_customer_email": { "type": "boolean", "default": false }, "ask_for_customer_phone_number": { "type": "boolean", "default": false }, "ask_for_customer_id": { "type": "boolean", "default": false }, "send_sms": { "type": "boolean", "default": false }, "send_email": { "type": "boolean", "default": false } } }, "Application.Common.Models.Button.Request.UpdateButtonDetailsRequestModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "7bp1qyptj1ske" }, "x-examples": { "Example 1": { "website": "https://mywebsite.com/", "cancel_url": "string", "return_url": "string", "button_size": "Small", "pref_lang": "en", "custom_name": "string", "send_sms": false, "send_email": false, "ask_for_customer_name": false, "ask_for_shipping_address": false, "ask_for_customer_email": false, "ask_for_customer_phone_number": false, "ask_for_customer_id": false, "enable": false } }, "properties": { "website": { "type": "string", "example": "https://mywebsite.com/", "nullable": true }, "cancel_url": { "type": "string", "example": "string", "nullable": true }, "return_url": { "type": "string", "example": "string", "nullable": true }, "button_size": { "$ref": "#/components/schemas/Application.Common.Enums.PaymentButtonSizeEnum" }, "pref_lang": { "type": "string", "example": "en", "nullable": true }, "custom_name": { "type": "string", "nullable": true }, "send_sms": { "type": "boolean", "default": false, "nullable": true }, "send_email": { "type": "boolean", "default": false, "nullable": true }, "ask_for_customer_name": { "type": "boolean", "default": false, "nullable": true }, "ask_for_shipping_address": { "type": "boolean", "default": false, "nullable": true }, "ask_for_customer_email": { "type": "boolean", "default": false, "nullable": true }, "ask_for_customer_phone_number": { "type": "boolean", "default": false, "nullable": true }, "ask_for_customer_id": { "type": "boolean", "default": false, "nullable": true }, "enable": { "type": "boolean", "default": false, "nullable": true } }, "description": "" }, "Application.Common.Models.Button.Response.ButtonLinkDetailsResponseModel": { "type": "object", "x-examples": { "Example 1": { "created_on": "2025-10-30T12:35:45.656Z", "code": "string", "url": "string", "custom_name": "string", "item_name": "string", "enable": true, "item_price": 0, "total_amount": 0, "quantity": 0, "button_size": 0, "button_type": 0, "send_sms": true, "send_email": true, "hide_quantity": true, "ask_for_customer_name": true, "ask_for_shipping_address": true, "ask_for_customer_email": true, "ask_for_customer_phone_number": true, "ask_for_customer_id": true, "currency": "string", "pref_language": "string", "website": "string", "cancel_url": "string", "return_url": "string", "expire_date": "2025-10-30T12:35:45.656Z", "account_number": "string" } }, "properties": { "created_on": { "type": "string", "example": "2025-10-30T14:19:13" }, "code": { "type": "string", "example": "B6T9KPKY3BQ98" }, "url": { "type": "string", "example": "https://demo.mypos.eu/vmp/btn/BE2J9AR8AMB52" }, "custom_name": { "type": "string", "example": "Test Button" }, "item_name": { "type": "string", "example": "Creating a button" }, "enable": { "type": "boolean", "default": true }, "item_price": { "type": "integer", "example": 0.1 }, "total_amount": { "type": "integer", "example": 0.2 }, "quantity": { "type": "integer", "example": 2 }, "button_size": { "type": "integer", "example": 0 }, "button_type": { "type": "integer", "example": 1 }, "send_sms": { "type": "boolean", "default": false }, "send_email": { "type": "boolean", "default": false }, "hide_quantity": { "type": "boolean", "default": false }, "ask_for_customer_name": { "type": "boolean", "default": false }, "ask_for_shipping_address": { "type": "boolean", "default": false }, "ask_for_customer_email": { "type": "boolean", "default": false }, "ask_for_customer_phone_number": { "type": "boolean", "default": false }, "ask_for_customer_id": { "type": "boolean", "default": false }, "currency": { "type": "string", "example": "EUR" }, "pref_language": { "type": "string", "example": "en" }, "website": { "type": "string", "example": "https://mywebsite.com/" }, "cancel_url": { "type": "string", "example": "string" }, "return_url": { "type": "string", "example": "string" }, "expire_date": { "type": "string", "example": "2025-11-30T14:19:13" }, "account_number": { "type": "string", "example": "50480563548" } } }, "Application.Common.Models.Button.Response.ButtonLinksResponseModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "nfxget106p4fd" }, "properties": { "code": { "type": "string", "example": "B6T9KPKY3BQ98", "nullable": true }, "url": { "type": "string", "example": "https://demo.mypos.eu/vmp/btn/B6T9KPKY3BQ9", "nullable": true }, "custom_name": { "type": "string", "example": "Test Button", "nullable": true }, "amount": { "type": "number", "format": "double", "example": 0.2 }, "currency": { "type": "string", "example": "EUR", "nullable": true }, "status": { "$ref": "#/components/schemas/Application.Common.Enums.PaymentButtonStatus" } }, "x-examples": { "Example 2": { "code": "B6T9KPKY3BQ98", "url": "https://demo.mypos.eu/vmp/btn/B6T9KPKY3BQ9", "custom_name": "Test Button", "amount": 0.2, "currency": "EUR", "status": "Active" } } }, "Application.Common.Models.Button.Response.ButtonTransactionsResponseModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "dt2gbexm21cjn" }, "properties": { "date": { "type": "string", "example": "2025-05-16T17:37:17", "nullable": true }, "code": { "type": "string", "example": "BDYZC4KBNFG98", "nullable": true }, "custom_name": { "type": "string", "example": "test", "nullable": true }, "amount": { "type": "number", "format": "double", "example": 1 }, "currency": { "type": "string", "example": "EUR", "nullable": true }, "settlement_date": { "type": "string", "example": "2025-05-16T17:37:17", "nullable": true }, "settlement_amount": { "type": "string", "example": "1", "nullable": true }, "settlement_currency": { "type": "string", "example": "EUR", "nullable": true }, "fee": { "type": "number", "format": "double", "example": 0.14 }, "customer_name": { "type": "string", "example": "TEST", "nullable": true }, "customer_address": { "type": "string", "example": "test address", "nullable": true }, "customer_email": { "type": "string", "example": "test@mypos.com", "nullable": true }, "customer_phone": { "type": "string", "example": "359888888888", "nullable": true }, "payment_reference": { "type": "string", "example": "MTCOR15253S5OFPX", "nullable": true } }, "x-examples": { "Example 1": { "date": "2025-05-16T17:37:17", "code": "BDYZC4KBNFG98", "custom_name": "test", "amount": 1, "currency": "EUR", "settlement_date": "2025-05-16T17:37:17", "settlement_amount": "1", "settlement_currency": "EUR", "fee": 0.14, "customer_name": "TEST", "customer_address": "test address", "customer_email": "test@mypos.com", "customer_phone": "359888888888", "payment_reference": "MTCOR15253S5OFPX" } } }, "Application.Common.Models.Button.Response.CreateButtonResponseModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "s0hf81dk290k6" }, "properties": { "url": { "type": "string", "example": "https://demo.mypos.eu/vmp/btn/B8MQEGCFBG638", "nullable": true } }, "x-examples": { "Example 1": { "url": "https://demo.mypos.eu/vmp/btn/B8MQEGCFBG638" } } }, "Application.Common.Models.Common.Response.LanguagesResponseModel": { "type": "object", "x-examples": { "Example ": { "items": [ { "code": "EN", "description": "English" } ], "page": 0, "page_size": 0, "total_pages": 0, "total_count": 0, "has_previous_page": true, "has_next_page": true }, "Example 1": { "items": [ { "code": "EN", "description": "English" } ], "page": 0, "page_size": 0, "total_pages": 0, "total_count": 0, "has_previous_page": true, "has_next_page": true } }, "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "example": "EN" }, "description": { "type": "string", "example": "English" } } } }, "page": { "type": "integer", "example": 0 }, "page_size": { "type": "integer", "example": 0 }, "total_pages": { "type": "integer", "example": 0 }, "total_count": { "type": "integer", "example": 0 }, "has_previous_page": { "type": "boolean", "default": true }, "has_next_page": { "type": "boolean", "default": true } } }, "Application.Common.Models.Common.Response.SettlementDataResponseModel": { "type": "object", "x-examples": { "Example 1": { "items": [ { "settlement_currency": "EUR", "account": { "account_number": "50480563548", "iban": "IE61MPOS99039050480563", "currency": "EUR", "name": "EUR Account", "is_reserve": true, "is_suspense_account": true } } ], "page": 0, "page_size": 0, "total_pages": 0, "total_count": 0, "has_previous_page": true, "has_next_page": true } }, "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "settlement_currency": { "type": "string", "example": "EUR" }, "account": { "type": "object", "properties": { "account_number": { "type": "string", "example": "50480563548" }, "iban": { "type": "string", "example": "IE61MPOS99039050480563" }, "currency": { "type": "string", "example": "EUR" }, "name": { "type": "string", "example": "EUR Account" }, "is_reserve": { "type": "boolean", "default": true }, "is_suspense_account": { "type": "boolean", "default": true } } } } } }, "page": { "type": "integer", "example": 0 }, "page_size": { "type": "integer", "example": 0 }, "total_pages": { "type": "integer", "example": 0 }, "total_count": { "type": "integer", "example": 0 }, "has_previous_page": { "type": "boolean", "default": true }, "has_next_page": { "type": "boolean", "default": true } } }, "Application.Common.Models.Link.Request.CreateLinkRequestModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "kczpv0c6o8yl9" }, "properties": { "hide_quantity": { "type": "boolean", "default": false }, "expired_date": { "type": "string", "example": "2025-05-16T17:37:17", "nullable": true }, "item_name": { "type": "string", "example": "Test Payment Link", "nullable": true }, "item_price": { "type": "number", "format": "double", "example": 1 }, "pref_language": { "type": "string", "example": "en", "nullable": true }, "currency": { "type": "string", "example": "EUR", "nullable": true }, "account_number": { "type": "string", "example": "50480563548", "nullable": true }, "custom_name": { "type": "string", "example": "Testin1g", "nullable": true }, "quantity": { "type": "integer", "format": "int32", "example": 1 }, "website": { "type": "string", "example": "http://www.mywesbite.com/", "nullable": true }, "ask_for_customer_name": { "type": "boolean", "default": false }, "ask_for_shipping_address": { "type": "boolean", "default": false }, "ask_for_customer_email": { "type": "boolean", "default": false }, "ask_for_customer_phone_number": { "type": "boolean", "default": false }, "ask_for_customer_id": { "type": "boolean", "default": false }, "send_sms": { "type": "boolean", "default": false }, "send_email": { "type": "boolean", "default": false } }, "x-examples": { "Example 1": { "hide_quantity": false, "expired_date": "2025-05-16T17:37:17", "item_name": "Test Payment Link", "item_price": 1, "pref_language": "en", "currency": "EUR", "account_number": "50480563548", "custom_name": "Testin1g", "quantity": 1, "website": "http://www.mywesbite.com/", "ask_for_customer_name": false, "ask_for_shipping_address": false, "ask_for_customer_email": false, "ask_for_customer_phone_number": false, "ask_for_customer_id": false, "send_sms": false, "send_email": false } } }, "Application.Common.Models.Link.Request.EditPaymentLinkRequestModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "xparb3qpqzy7n" }, "properties": { "pref_lang": { "type": "string", "example": "en", "nullable": true }, "custom_name": { "type": "string", "example": "Set Custom Name", "nullable": true }, "send_sms": { "type": "boolean", "default": true, "nullable": true }, "sens_email": { "type": "boolean", "default": true, "nullable": true }, "ask_for_customer_name": { "type": "boolean", "default": true, "nullable": true }, "ask_for_shipping_address": { "type": "boolean", "default": true, "nullable": true }, "ask_for_customer_email": { "type": "boolean", "default": true, "nullable": true }, "ask_for_customer_phone_number": { "type": "boolean", "default": true, "nullable": true }, "ask_for_customer_id": { "type": "boolean", "default": true, "nullable": true }, "enable": { "type": "boolean", "default": true, "nullable": true }, "hide_quantity": { "type": "boolean", "default": true, "nullable": true }, "website": { "type": "string", "example": "https://mywebsite.com/", "nullable": true }, "expired_date": { "type": "string", "example": "2025-11-19T12:00:00", "nullable": true } }, "x-examples": { "Example 1": { "pref_lang": "en", "custom_name": "Set Custom Name", "send_sms": true, "sens_email": true, "ask_for_customer_name": true, "ask_for_shipping_address": true, "ask_for_customer_email": true, "ask_for_customer_phone_number": true, "ask_for_customer_id": true, "enable": true, "hide_quantity": true, "website": "https://mywebsite.com/", "expired_date": "2025-11-19T12:00:00" } } }, "Application.Common.Models.Link.Response.CreateLinkResponseModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "lb17sqau4asw1" }, "x-examples": { "Example 1": { "url": "https://demo.mypos.eu/vmp/btn/BGOBAFZ65QS08\"" } }, "properties": { "url": { "type": "string", "example": "https://demo.mypos.eu/vmp/btn/BGOBAFZ65QS08", "nullable": true } } }, "Application.Common.Models.Link.Response.PaymentLinkListResponseModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "dc12x8zp66qyp" }, "properties": { "code": { "type": "string", "example": "BGOBAFZ65QS08", "nullable": true }, "url": { "type": "string", "example": "https://demo.mypos.eu/vmp/btn/BGOBAFZ65QS08", "nullable": true }, "custom_name": { "type": "string", "example": "Create a Payment Link", "nullable": true }, "amount": { "type": "number", "format": "double", "example": 0.2 }, "currency": { "type": "string", "example": "EUR", "nullable": true }, "status": { "$ref": "#/components/schemas/Application.Common.Enums.PaymentLinkStatus" } }, "x-examples": { "Example 1": { "code": "BGOBAFZ65QS08", "url": "https://demo.mypos.eu/vmp/btn/BGOBAFZ65QS08", "custom_name": "Create a Payment Link", "amount": 0.2, "currency": "EUR", "status": "Active" } } }, "Application.Common.Models.Link.Response.PaymentLinkResponseModel": { "type": "object", "x-examples": { "Example 1": { "created_on": "2025-10-20T14:31:50", "code": "BLQ2IYI5LQV79", "url": "https://demo.mypos.eu/vmp/btn/BLQ2IYI5LQV79", "custom_name": "Set Custom Name", "item_name": "string", "enable": true, "item_price": 0.2, "total_amount": 0.4, "quantity": 2, "button_size": 0, "button_type": 2, "send_sms": true, "send_email": true, "hide_quantity": true, "ask_for_customer_name": true, "ask_for_shipping_address": true, "ask_for_customer_email": true, "ask_for_customer_phone_number": true, "ask_for_customer_id": true, "currency": "EUR", "pref_language": "en", "website": "https://mywebsite.com/", "cancel_url": "string", "return_url": "string", "expire_date": "2025-11-19T12:00:00", "account_number": "50480563548" } }, "properties": { "created_on": { "type": "string", "example": "2025-10-20T14:31:50" }, "code": { "type": "string", "example": "BLQ2IYI5LQV79" }, "url": { "type": "string", "example": "https://demo.mypos.eu/vmp/btn/BLQ2IYI5LQV79" }, "custom_name": { "type": "string", "example": "Set Custom Name" }, "item_name": { "type": "string", "example": "string" }, "enable": { "type": "boolean", "default": true }, "item_price": { "type": "integer", "example": 0.2 }, "total_amount": { "type": "integer", "example": 0.4 }, "quantity": { "type": "integer", "example": 2 }, "button_size": { "type": "integer", "example": 0 }, "button_type": { "type": "integer", "example": 2 }, "send_sms": { "type": "boolean", "default": true }, "send_email": { "type": "boolean", "default": true }, "hide_quantity": { "type": "boolean", "default": true }, "ask_for_customer_name": { "type": "boolean", "default": true }, "ask_for_shipping_address": { "type": "boolean", "default": true }, "ask_for_customer_email": { "type": "boolean", "default": true }, "ask_for_customer_phone_number": { "type": "boolean", "default": true }, "ask_for_customer_id": { "type": "boolean", "default": true }, "currency": { "type": "string", "example": "EUR" }, "pref_language": { "type": "string", "example": "en" }, "website": { "type": "string", "example": "https://mywebsite.com/" }, "cancel_url": { "type": "string", "example": "string" }, "return_url": { "type": "string", "example": "string" }, "expire_date": { "type": "string", "example": "2025-11-19T12:00:00" }, "account_number": { "type": "string", "example": "50480563548" } } }, "Application.Common.Models.Link.Response.PaymentLinkTransactionDetailsReponseModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "30q9iv31flkow" }, "properties": { "date": { "type": "string", "example": "2025-05-29T14:21:10", "nullable": true }, "code": { "type": "string", "example": "BIE589ACVLD43", "nullable": true }, "custom_name": { "type": "string", "example": "DEMO", "nullable": true }, "amount": { "type": "number", "format": "double", "example": 1 }, "currency": { "type": "string", "example": "EUR", "nullable": true }, "settlement_date": { "type": "string", "example": "2025-05-29T14:21:11", "nullable": true }, "settlement_amount": { "type": "string", "example": "1", "nullable": true }, "settlement_currency": { "type": "string", "example": "EUR", "nullable": true }, "fee": { "type": "number", "format": "double", "example": 0.29 }, "customer_name": { "type": "string", "example": "DEMO", "nullable": true }, "customer_address": { "type": "string", "example": "string", "nullable": true }, "customer_email": { "type": "string", "example": "string", "nullable": true }, "customer_phone": { "type": "string", "example": "string", "nullable": true }, "payment_reference": { "type": "string", "example": "MTCOS0224461F39K", "nullable": true } }, "x-examples": { "Example 1": { "date": "2025-05-29T14:21:10", "code": "BIE589ACVLD43", "custom_name": "DEMO", "amount": 1, "currency": "EUR", "settlement_date": "2025-05-29T14:21:11", "settlement_amount": "1", "settlement_currency": "EUR", "fee": 0.29, "customer_name": "DEMO", "customer_address": "string", "customer_email": "string", "customer_phone": "string", "payment_reference": "MTCOS0224461F39K" } } }, "Application.Common.Models.PaymentRequest.Request.CreatePrRequestModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "vt4d1hcznollk" }, "x-examples": { "Example 1": { "amount": 28.78, "currency": "EUR", "client_name": "EUR", "reason": "Test Reason", "booking_text": "Random Text", "dba": "company", "expiry_date": "2025-08-18", "payment_request_lang": "en", "notify_gsm": "+359885885885", "qr_generated": true } }, "properties": { "amount": { "type": "number", "format": "double", "example": 28.78 }, "currency": { "type": "string", "example": "EUR", "nullable": true }, "client_name": { "type": "string", "example": "EUR", "nullable": true }, "reason": { "type": "string", "example": "Test Reason", "nullable": true }, "booking_text": { "type": "string", "example": "Random Text", "nullable": true }, "dba": { "type": "string", "example": "company", "nullable": true }, "expiry_date": { "type": "string", "example": "2025-08-18", "nullable": true }, "payment_request_lang": { "type": "string", "example": "en", "nullable": true }, "notify_gsm": { "type": "string", "example": "+359885885885", "nullable": true }, "qr_generated": { "type": "boolean", "default": true } }, "description": "" }, "Application.Common.Models.PaymentRequest.Response.CreatePrResponseModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "hzautjhf4ovl7" }, "properties": { "code": { "type": "string", "example": "B9UU2SESPY5Y42", "nullable": true }, "payment_request_url": { "type": "string", "example": "https://demo.mypos.eu/bg/qr-pr/B9UU2SESPY5Y42", "nullable": true } }, "x-examples": { "Example 1": { "code": "B9UU2SESPY5Y42", "payment_request_url": "https://demo.mypos.eu/bg/qr-pr/B9UU2SESPY5Y42" } } }, "Application.Common.Models.PaymentRequest.Response.PrDetailsResponseModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "kd4u42lgnzqh2" }, "x-examples": { "Example 1": { "code": "B9UU2SESPY5Y42", "url": "https://demo.mypos.eu/bg/qr-pr/B9UU2SESPY5Y42", "added_on": "2025-10-31T09:00:00", "client_name": "Test Client", "amount": 28.78, "currency": "EUR", "reason": "Test Reason", "booking_text": "Test booking text", "attempts": 0, "expiry_on": "2025-11-30T23:59:59", "qr_generated": true, "email": "test@mypos.com", "gsm": "+359888888888", "status": "Pending" } }, "properties": { "code": { "type": "string", "example": "B9UU2SESPY5Y42", "nullable": true }, "url": { "type": "string", "example": "https://demo.mypos.eu/bg/qr-pr/B9UU2SESPY5Y42", "nullable": true }, "added_on": { "type": "string", "example": "2025-10-31T09:00:00", "nullable": true }, "client_name": { "type": "string", "example": "Test Client", "nullable": true }, "amount": { "type": "number", "format": "double", "example": 28.78 }, "currency": { "type": "string", "example": "EUR", "nullable": true }, "reason": { "type": "string", "example": "Test Reason", "nullable": true }, "booking_text": { "type": "string", "example": "Test booking text", "nullable": true }, "attempts": { "type": "integer", "format": "int32", "example": 0 }, "expiry_on": { "type": "string", "example": "2025-11-30T23:59:59", "nullable": true }, "qr_generated": { "type": "boolean", "default": true }, "email": { "type": "string", "example": "test@mypos.com", "nullable": true }, "gsm": { "type": "string", "example": "+359888888888", "nullable": true }, "status": { "$ref": "#/components/schemas/Application.Common.Enums.PaymentRequestStatus" } }, "description": "" }, "Application.Common.Models.PaymentRequest.Response.PrListDetailsResponseModel": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "jjl984pv4b3xk" }, "properties": { "code": { "type": "string", "example": "BF4FWKWIQXPV30", "nullable": true }, "url": { "type": "string", "example": "https://demo.mypos.eu/bg/qr-pr/BF4FWKWIQXPV30", "nullable": true }, "added_on": { "type": "string", "example": "2025-10-31T09:03:03", "nullable": true }, "client_name": { "type": "string", "example": "Test Client Name", "nullable": true }, "amount": { "type": "number", "format": "double", "example": 28.78 }, "currency": { "type": "string", "example": "EUR", "nullable": true }, "reason": { "type": "string", "example": "Test Reason", "nullable": true }, "booking_text": { "type": "string", "example": "Test booking ", "nullable": true }, "status": { "$ref": "#/components/schemas/Application.Common.Enums.PaymentRequestStatus" } }, "x-examples": { "Example 1": { "code": "BF4FWKWIQXPV30", "url": "https://demo.mypos.eu/bg/qr-pr/BF4FWKWIQXPV30", "added_on": "2025-10-31T09:03:03", "client_name": "Test Client Name", "amount": 28.78, "currency": "EUR", "reason": "Test Reason", "booking_text": "Test booking ", "status": "Pending" } } }, "Application.Models.PaginatedList`1[Application.Common.Models.Button.Response.ButtonLinksResponseModel]": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "o3g9yybzdlg1l" }, "x-examples": { "Example 2": { "items": [ { "code": "B6T9KPKY3BQ98", "url": "https://demo.mypos.eu/vmp/btn/B6T9KPKY3BQ9", "custom_name": "Test Button", "amount": 0.2, "currency": "EUR", "status": "Active" } ], "page": 0, "page_size": 0, "total_pages": 0, "total_count": 0, "has_previous_page": true, "has_next_page": true } }, "properties": { "items": { "type": "array", "nullable": true, "items": { "$ref": "#/components/schemas/Application.Common.Models.Button.Response.ButtonLinksResponseModel" } }, "page": { "type": "integer", "format": "int32", "example": 0 }, "page_size": { "type": "integer", "format": "int32", "example": 0 }, "total_pages": { "type": "integer", "format": "int32", "example": 0 }, "total_count": { "type": "integer", "format": "int32", "example": 0 }, "has_previous_page": { "type": "boolean", "default": true, "readOnly": true }, "has_next_page": { "type": "boolean", "default": true, "readOnly": true } } }, "Application.Models.PaginatedList`1[Application.Common.Models.Button.Response.ButtonTransactionsResponseModel]": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "nzm6sxnro48pm" }, "properties": { "items": { "type": "array", "nullable": true, "items": { "$ref": "#/components/schemas/Application.Common.Models.Button.Response.ButtonTransactionsResponseModel" } }, "page": { "type": "integer", "format": "int32", "example": 0 }, "page_size": { "type": "integer", "format": "int32", "example": 0 }, "total_pages": { "type": "integer", "format": "int32", "example": 0 }, "total_count": { "type": "integer", "format": "int32", "example": 0 }, "has_previous_page": { "type": "boolean", "default": true, "readOnly": true }, "has_next_page": { "type": "boolean", "default": true, "readOnly": true } } }, "Application.Models.PaginatedList`1[Application.Common.Models.Link.Response.PaymentLinkListResponseModel]": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Application.Common.Models.Link.Response.PaymentLinkListResponseModel" }, "nullable": true }, "page": { "type": "integer", "format": "int32" }, "page_size": { "type": "integer", "format": "int32" }, "total_pages": { "type": "integer", "format": "int32" }, "total_count": { "type": "integer", "format": "int32" }, "has_previous_page": { "type": "boolean", "readOnly": true }, "has_next_page": { "type": "boolean", "readOnly": true } }, "additionalProperties": false, "x-stoplight": { "id": "oc1ybz59jn8uq" } }, "Application.Models.PaginatedList`1[Application.Common.Models.Link.Response.PaymentLinkTransactionDetailsReponseModel]": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "iuv8a3iy6ew7a" }, "properties": { "items": { "type": "array", "nullable": true, "items": { "$ref": "#/components/schemas/Application.Common.Models.Link.Response.PaymentLinkTransactionDetailsReponseModel" } }, "page": { "type": "integer", "format": "int32", "example": 0 }, "page_size": { "type": "integer", "format": "int32", "example": 0 }, "total_pages": { "type": "integer", "format": "int32", "example": 0 }, "total_count": { "type": "integer", "format": "int32", "example": 0 }, "has_previous_page": { "type": "boolean", "default": true, "readOnly": true }, "has_next_page": { "type": "boolean", "default": true, "readOnly": true } } }, "Application.Models.PaginatedList`1[Application.Common.Models.PaymentRequest.Response.PrListDetailsResponseModel]": { "type": "object", "additionalProperties": false, "x-stoplight": { "id": "kq5pq4e11dxza" }, "x-examples": { "Example 1": { "items": [ { "code": "BF4FWKWIQXPV30", "url": "https://demo.mypos.eu/bg/qr-pr/BF4FWKWIQXPV30", "added_on": "2025-10-31T09:03:03", "client_name": "Test Client Name", "amount": 28.78, "currency": "EUR", "reason": "Test Reason", "booking_text": "Test booking ", "status": "Pending" } ], "page": 1, "page_size": 20, "total_pages": 1, "total_count": 2, "has_previous_page": false, "has_next_page": false } }, "properties": { "items": { "type": "array", "nullable": true, "items": { "$ref": "#/components/schemas/Application.Common.Models.PaymentRequest.Response.PrListDetailsResponseModel" } }, "page": { "type": "integer", "format": "int32", "example": 1 }, "page_size": { "type": "integer", "format": "int32", "example": 20 }, "total_pages": { "type": "integer", "format": "int32", "example": 1 }, "total_count": { "type": "integer", "format": "int32", "example": 2 }, "has_previous_page": { "type": "boolean", "default": false, "readOnly": true }, "has_next_page": { "type": "boolean", "default": false, "readOnly": true } }, "description": "" }, "Microsoft.AspNetCore.Mvc.ProblemDetails": { "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "instance": { "type": "string" }, "additionalProp1": { "type": "string" }, "additionalProp2": { "type": "string" }, "additionalProp3": { "type": "string" } }, "x-examples": { "Example 1": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } }, "Microsoft.AspNetCore.Mvc.ValidationProblemDetails": { "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "instance": { "type": "string" }, "errors": { "type": "object", "properties": { "additionalProp1": { "type": "array", "items": { "type": "string" } }, "additionalProp2": { "type": "array", "items": { "type": "string" } }, "additionalProp3": { "type": "array", "items": { "type": "string" } } } }, "additionalProp1": { "type": "string" }, "additionalProp2": { "type": "string" }, "additionalProp3": { "type": "string" } }, "x-examples": { "Example 1": { "type": "string", "title": "string", "status": 0, "detail": "string", "instance": "string", "errors": { "additionalProp1": [ "string" ], "additionalProp2": [ "string" ], "additionalProp3": [ "string" ] }, "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" } } } }, "securitySchemes": { "Bearer": { "type": "http", "description": "Input your Bearer token to access this API", "scheme": "Bearer", "bearerFormat": "JWT" } } }, "security": [ { "Bearer": [] } ], "servers": [ { "url": "https://demo-api-gateway.mypos.com", "description": "Demo" }, { "url": "https://api-gateway.mypos.com", "description": "Prod" } ] }