{ "openapi": "3.1.2", "info": { "title": "Axepta Online API", "description": "The Axepta Online API allows you to seamlessly process and manage payments, supporting 350+ payment methods worldwide. Built on REST principles, the API is designed to be predictable and developer-friendly, with resource-oriented URLs, JSON-encoded requests and responses, and standard HTTP status codes.\r\n\r\n**Security**\r\n\r\nThe Axepta Online API is designed with maximum security while remaining easy to implement. All communication occurs over HTTPS (TLS 1.2 or higher), ensuring end-to-end encryption at the transport level. This prevents packet sniffing, replay attacks, and other vulnerabilities without requiring additional encryption of the data itself.\r\n\r\n**Test Before You Go Live**\r\n\r\nUse our test environment to test your integration without affecting live data. The root URL determines whether the request is for test or live integration.", "version": "2.5.0" }, "servers": [ { "url": "https://test.paymentpage.axepta.bnpparibas/api/v2", "description": "Test" }, { "url": "https://paymentpage.axepta.bnpparibas/api/v2", "description": "Production" } ], "paths": { "/customers": { "get": { "tags": [ "Customers" ], "summary": "Get list of customers", "description": "Get list of customers", "operationId": "getCustomers", "parameters": [ { "name": "page", "in": "query", "description": "Specifies page number", "required": true, "schema": { "type": "integer", "format": "int32", "example": 2 } }, { "name": "createdFrom", "in": "query", "description": "The createdAt date from witch the customers will be fetched", "schema": { "type": "string", "example": "2025-05-12" } }, { "name": "createdTo", "in": "query", "description": "The createdAt date to witch the customers will be fetched", "schema": { "type": "string", "example": "2025-05-15" } }, { "name": "merchantCustomerId", "in": "query", "description": "The merchant customer id", "schema": { "type": "string", "example": "Test_Merchant" } }, { "name": "email", "in": "query", "description": "The email address", "schema": { "type": "string", "example": "test@gmail.com" } }, { "name": "phoneCountry", "in": "query", "description": "The phone country code", "schema": { "type": "string", "example": 33 } }, { "name": "phoneNumber", "in": "query", "description": "The phone number", "schema": { "type": "string", "example": 98746321 } } ], "responses": { "200": { "description": "Customers successfully retrieved", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/customersDetailsResponse" }, "examples": { "Default": { "description": "", "value": { "totalNumberOfPages": 5, "totalNumberOfItems": 82, "page": 5, "pageSize": 20, "data": [ { "id": "cu_841b9b1a99fc4f0", "merchantCustomerId": "1234567890", "firstName": "Max", "lastName": "Mustermann", "email": "maxmustermann@example.com", "phone": { "countryCode": "33", "number": "234567890" }, "scope": "demo_parent", "createdAt": "2023-12-21T12:10:58.087", "updatedAt": "2024-10-01T12:10:58.087" }, { "id": "cu_841b9b1a99fc4f9", "merchantCustomerId": "1234567891", "firstName": "Jane", "lastName": "Doe", "email": "janedoe@example.com", "phone": { "countryCode": "33", "number": "234567889" }, "scope": "demo_parent", "createdAt": "2024-12-05T12:10:58.087", "updatedAt": "2025-05-08T12:10:58.087" } ] } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/customers/{id}": { "get": { "tags": [ "Customers" ], "summary": "Get customer details", "description": "Get customer details", "operationId": "getCustomer", "parameters": [ { "name": "id", "in": "path", "description": "Customer Id", "required": true, "schema": { "type": "string", "example": "cu_841b9b1a99fc4f0" } } ], "responses": { "200": { "description": "Customer successfully retrieved", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/customerDetailsResponse" }, "examples": { "Default": { "description": "", "value": { "id": "cu_841b9b1a99fc4f0", "merchantCustomerId": "1234567890", "firstName": "Max", "lastName": "Mustermann", "email": "maxmustermann@example.com", "phone": { "countryCode": "33", "number": "234567890" }, "billingAddress": { "streetName": "Marienplatz 11A", "city": "Munich", "postalCode": "883433", "state": "Bavaria", "country": "deu" }, "scope": "demo_parent", "createdAt": "2023-12-21T12:10:58.087", "updatedAt": "2024-10-01T12:10:58.087", "lastUsedAt": "2024-10-15T12:10:58.087" } } } } } }, "400": { "description": "Invalid Customer Id supplied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "404": { "description": "Customer Details not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] }, "patch": { "tags": [ "Customers" ], "summary": "Update customer details", "description": "Updates details about customer", "operationId": "updateCustomer", "parameters": [ { "name": "id", "in": "path", "description": "Customer Id", "required": true, "schema": { "type": "string", "example": "cu_841b9b1a99fc4f0" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updateCustomerRequest" }, "examples": { "Default": { "description": "", "value": { "firstName": "Jane", "lastName": "Doe", "email": "janedoe@example.com", "phone": { "countryCode": "33", "number": "234567889" }, "billingAddress": { "streetName": "Marienplatz 55B", "city": "Munich", "postalCode": "883433", "state": "Bavaria", "country": "deu" } } } } } }, "required": true }, "responses": { "200": { "description": "Customer successfully updated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/customerDetailsResponse" }, "examples": { "Default": { "description": "", "value": { "id": "cu_841b9b1a99fc4f0", "merchantCustomerId": "1234567890", "firstName": "Max", "lastName": "Mustermann", "email": "maxmustermann@example.com", "phone": { "countryCode": "33", "number": "234567890" }, "billingAddress": { "streetName": "Marienplatz 11A", "city": "Munich", "postalCode": "883433", "state": "Bavaria", "country": "deu" }, "scope": "demo_parent", "createdAt": "2023-12-21T12:10:58.087", "updatedAt": "2024-10-01T12:10:58.087", "lastUsedAt": "2024-10-15T12:10:58.087" } } } } } }, "400": { "description": "Invalid Customer Id supplied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "404": { "description": "Customer Details not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] }, "delete": { "tags": [ "Customers" ], "summary": "Delete customer details", "description": "Delete customer details", "operationId": "deleteCustomer", "parameters": [ { "name": "id", "in": "path", "description": "Customer Id", "required": true, "schema": { "type": "string", "example": "cu_841b9b1a99fc4f0" } } ], "responses": { "200": { "description": "Customer successfully deleted", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/deleteCustomerResponse" }, "examples": { "Default": { "description": "", "value": { "id": "cu_841b9b1a99fc4f0", "deleted": true } } } } } }, "400": { "description": "Invalid Customer Id supplied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "404": { "description": "Customer Details not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/customers/{id}/paymentMethods": { "get": { "tags": [ "Customers" ], "summary": "Get list of payment methods for customer", "description": "Get list of payment methods for customer", "operationId": "getPaymentMethods", "parameters": [ { "name": "id", "in": "path", "description": "Customer Id", "required": true, "schema": { "type": "string", "example": "cu_841b9b1a99fc4f0" } } ], "responses": { "200": { "description": "Payment methods successfully retrieved", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/customersPaymentMethodsResponse" }, "examples": { "Default": { "description": "", "value": { "gatewayCustomerId": "cu_841b9b1a99fc4f0", "data": [ { "id": "pm_5555b1a99fe4tg3", "type": "CARD", "last4Digits": "4242", "pseudoCardNumber": "0132332232424242", "cardHolderName": "Max Mustermann", "brand": "visa", "expiryDate": "202506", "createdAt": "2023-12-21T12:10:58.087", "updatedAt": "2024-10-01T12:10:58.087", "lastUsedAt": "2024-10-15T12:10:58.087" }, { "id": "pm_5555b1a99fe4tg4", "type": "CARD", "last4Digits": "1111", "pseudoCardNumber": "0132332235858582", "cardHolderName": "Max Mustermann", "brand": "mastercard", "expiryDate": "203006", "createdAt": "2023-12-22T12:10:58.087", "updatedAt": "2025-03-01T12:10:58.087", "lastUsedAt": "2025-05-15T12:10:58.087" } ] } } } } } }, "400": { "description": "Invalid Customer Id supplied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "404": { "description": "Customer Details not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/customers/{customerId}/paymentMethods/{paymentMethodId}": { "get": { "tags": [ "Customers" ], "summary": "Get payment method details", "description": "Get payment method details", "operationId": "getPaymentMethod", "parameters": [ { "name": "customerId", "in": "path", "description": "Customer Id", "required": true, "schema": { "type": "string", "example": "cu_96586bedjfe4tg3" } }, { "name": "paymentMethodId", "in": "path", "description": "Payment Method Id", "required": true, "schema": { "type": "string", "example": "pm_5555b1a99fe4tg3" } } ], "responses": { "200": { "description": "Payment Method successfully retrieved", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/paymentMethodsResponse" }, "examples": { "Default": { "description": "", "value": { "id": "pm_5555b1a99fe4tg3", "type": "CARD", "last4Digits": "4242", "pseudoCardNumber": "0132332232424242", "cardHolderName": "Max Mustermann", "brand": "visa", "expiryDate": "202506", "createdAt": "2023-12-21T12:10:58.087", "updatedAt": "2024-10-01T12:10:58.087", "lastUsedAt": "2024-10-15T12:10:58.087" } } } } } }, "400": { "description": "Invalid Payment Method Id supplied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "404": { "description": "Payment method details not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] }, "delete": { "tags": [ "Customers" ], "summary": "Delete payment method details", "description": "Delete payment method details", "operationId": "deletePaymentMethod", "parameters": [ { "name": "customerId", "in": "path", "description": "Customer Id", "required": true, "schema": { "type": "string", "example": "cu_96586bedjfe4tg3" } }, { "name": "paymentMethodId", "in": "path", "description": "Payment Method Id", "required": true, "schema": { "type": "string", "example": "pm_5555b1a99fe4tg3" } } ], "responses": { "200": { "description": "Payment Method successfully deleted", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/deletePaymentMethodResponse" }, "examples": { "Default": { "description": "", "value": { "id": "pm_5555b1a99fe4tg3", "deleted": true } } } } } }, "400": { "description": "Invalid Payment Method Id supplied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "404": { "description": "Payment method details not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/customers/{customerId}/payment-plans": { "get": { "tags": [ "Customers" ], "summary": "Get list of payment plans for customer", "description": "Get list of payment plans for customer", "operationId": "getCustomerPaymentPlans", "parameters": [ { "name": "customerId", "in": "path", "description": "Customer Id", "required": true, "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "", "schema": { "type": "integer", "format": "int32", "default": 1, "example": 1 } } ], "responses": { "200": { "description": "Payment plans successfully retrieved", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/getPaymentPlansResponseForCustomer" }, "examples": { "Default": { "description": "", "value": { "totalNumberOfPages": 5, "totalNumberOfItems": 82, "page": 5, "pageSize": 20, "data": [ { "id": "ffa39856fbc54bb2a5f5916c324fa3c1", "paymentPlanType": "RECURRING", "lastBillingDate": "2026-02-26T13:28:29.857+01:00", "amount": { "value": 1000, "currency": "EUR" }, "planStatus": "ACTIVE", "description": "test:payment" }, { "id": "f861b00dd4464356b8b6f6a4977c50ee", "paymentPlanType": "UNSCHEDULED_MIT", "lastBillingDate": "2026-02-25T09:08:16.183+01:00", "amount": { "value": 1000, "currency": "EUR" }, "planStatus": "ACTIVE", "description": "test:payment" } ] } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payments/sessions": { "post": { "tags": [ "Payments" ], "summary": "Create checkout session", "description": "This endpoint generates a URL for a hosted payment page where customers can securely select their preferred payment method and complete their transaction.", "operationId": "createSession", "parameters": [ { "name": "Idempotency-Key", "in": "header", "description": "A unique key provided by you to ensure that a particular operation is not processed multiple times in case of retries.", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sessionRequest" }, "examples": { "Example": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "24235345432", "partialPayment": false, "amount": { "currency": "EUR", "value": 10000 }, "language": "de", "template": { "name": "hpp_template", "customFields": { "customField1": "Field 1 Data", "customField2": "Field 2 Data", "customField3": "Field 3 Data", "customField4": "Field 4 Data", "customField5": "Field 5 Data", "customField6": "Field 6 Data", "customField7": "Field 7 Data", "customField8": "Field 8 Data", "customField9": "Field 9 Data", "customField10": "Field 10 Data", "customField11": "Field 11 Data", "customField12": "Field 12 Data", "customField13": "Field 13 Data", "customField14": "Field 14 Data" } }, "captureMethod": { "type": "AUTOMATIC" }, "order": { "merchantReference": "112-445-34567", "numberOfArticles": 1, "creationDate": "2025-03-31T11:58:37Z", "invoiceId": "555-333-2222", "description": "Order description", "items": [ { "id": "1", "sku": "19-402-DEU", "name": "BatteryPowerPack", "quantity": 1, "quantityUnit": "pcs", "taxRate": 0, "netPrice": 1000, "grossPrice": 1000, "taxAmount": 0, "discountAmount": 0, "description": "BatteryPowerPack", "type": "physical", "productInfo": { "brand": "Intel", "categories": [ "Electronics Store", "Computers", "Desktops" ], "globalTradeItemNumber": "EAN", "manufacturerPartNumber": "BOXNUC5CPYA", "imageUrl": "https://www.exampleobjects.com/logo.png", "productUrl": "https://www.estore.com/products/f2a8d7e34" } } ] }, "urls": { "return": "https://my.callback.url.com/success", "cancel": "https://my.callback.url.com/cancel", "webhook": "https://my.callback.url.com/webhook", "appRedirect": "https://my.callback.url.com/appRedirect" }, "billingAddress": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" }, "shipping": { "address": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" } }, "statementDescriptor": "gadgets shop", "customerInfo": { "merchantCustomerId": "cus_1234567890abcdef", "customerType": "individual", "firstName": "Max", "lastName": "Mustermann", "email": "customer@example.com", "phone": { "countryCode": "+49", "number": "1236547890" }, "salutation": "Ms", "title": "Dr", "gender": "female", "maidenName": "Mustermann", "middleName": "sam", "birthDate": "2001-01-01", "birthPlace": "Bamberg", "socialSecurityNumber": "123443534" }, "allowedPaymentMethods": [ "ALIPAY", "BANCONTACT", "BIZUM", "BLIK", "BOLETO", "CARD", "DIRECTDEBIT", "EASYCOLLECT", "EPS", "FLOAPAY", "INSTANEA", "KLARNA", "LIMONETIK", "MBWAY", "MULTIBANCO", "MYBANK", "PAYPAL", "PRZELEWY24", "UNIONPAY", "TRUSTLY", "TWINT", "VIPPSMOBILEPAY", "WECHAT", "WERO" ], "paymentMethods": { "alipay": { "x-alipay": true, "account": { "accountHolderName": "John Doe" }, "hotelInfo": { "name": "Hotel Paradise", "checkInTime": [ "2025-01-15T14:00:00", "2025-02-15T14:00:00", "2025-03-15T14:00:00" ], "checkOutTime": [ "2025-01-18T11:00:00", "2025-02-18T11:00:00", "2025-03-18T11:00:00" ] }, "sellingPoint": "Online Store", "service": "BatteryPowerPack" }, "bancontact": { "x-bancontactPayMethod": true, "sellingPoint": "Online Store", "service": "BatteryPowerPack", "account": { "accountHolderName": "Max Mustermann" }, "checkoutToken": "UlkWjd0MDNwUWs2r45fwf43" }, "bizum": { "sellingPoint": "Online Store", "service": "BatteryPowerPack", "account": { "accountHolderName": "Max Mustermann" } }, "blik": { "sellingPoint": "Online Store", "service": "BatteryPowerPack", "account": { "accountHolderName": "Jan Kowalski" } }, "boleto": { "x-boleto": true, "service": "BatteryPowerPack" }, "card": { "subType": [ "VISA", "MASTERCARD" ], "dccEnabled": true, "template": { "name": "card_template", "fontSize": 11, "textColor": "#FFFFFF", "customFields": { "customField1": "Field 1 Data", "customField2": "Field 2 Data", "customField3": "Field 3 Data", "customField4": "Field 4 Data", "customField5": "Field 5 Data", "customField6": "Field 6 Data", "customField7": "Field 7 Data", "customField8": "Field 8 Data", "customField9": "Field 9 Data", "customField10": "Field 10 Data", "customField11": "Field 11 Data", "customField12": "Field 12 Data", "customField13": "Field 13 Data", "customField14": "Field 14 Data" } } }, "directDebit": { "x-directdebit": true, "method": "ELV", "debitDelay": 2, "service": "BatteryPowerPack", "sellingPoint": "Online Store", "template": { "name": "direct_debit_template", "backgroundColor": "#0000FF", "backgroundImage": "https://example.com/background.jpg", "textColor": "#FFFFFF", "fontName": "Arial", "fontSize": 14, "tableWidth": 600, "tableHeight": 400, "customFields": { "customField1": "Field 1 Data", "customField2": "Field 2 Data", "customField3": "Field 3 Data", "customField4": "Field 4 Data", "customField5": "Field 5 Data", "customField6": "Field 6 Data", "customField7": "Field 7 Data", "customField8": "Field 8 Data", "customField9": "Field 9 Data", "customField10": "Field 10 Data", "customField11": "Field 11 Data", "customField12": "Field 12 Data", "customField13": "Field 13 Data", "customField14": "Field 14 Data" } } }, "easyCollect": { "x-easycollect": true, "accountId": "test_account_123", "contractId": "CTR-20250609-001", "contractDescription": "Direct debit authorization for monthly service fee", "businessIdentifier": "DE123456789", "signatureAgreementType": "SMS", "documentSignature": true, "googleAnalyticsConsent": true, "signatureBySca": false, "sps": true, "validation": true, "customerType": "KNOWN", "mandateType": "CORE", "eventToken": "PAYMENT_ONLY", "dueDate": "2025-07-15", "mandateId": "MANDATE123456789", "signerPositionOccupied": "Chief Financial Officer", "template": { "name": "standard-template", "customFields": { "customField1": "test1", "customField2": "test2", "customField3": "test3", "customField4": "test4", "customField5": "test5" } }, "account": { "number": "238712" } }, "instanea": { "x-instanea": true, "subType": "SEPA_INSTANT", "returnRefundAccount": true }, "klarna": { "layout": { "showSubTotalDetail": "HIDE", "logoUrl": "https://example.com/logo.svg", "pageTitle": "Secure Payment with Klarna" }, "accountId": "exmple_id", "enhancedData": [ { "productCategory": "Test product category", "productName": "Test product name" } ] }, "limonetik": { "subType": "COFIDIS3XCB", "deliveryDetails": { "description": "standard delivery", "speed": "STANDARD", "expectedDate": "2025-02-08T15:30:00Z", "expectedDelay": 1 }, "customerInformation": { "CFID": "true", "CNEW": "false" } }, "mbWay": { "account": { "accountHolderName": "John Doe" }, "sellingPoint": "Some selling point", "service": "Some service" }, "multibanco": { "service": "products", "sellingPoint": "sp", "account": { "accountHolder": "John Doe" } }, "myBank": { "x-mybank": true, "service": "products", "sellingPoint": "sp", "account": { "accountHolderName": "John Doe" } }, "payPal": { "accountId": "customer@example.com", "hideAddress": false }, "przelewy24": { "x-przelewy24": true, "subType": "BLIK", "authenticationCode": "123456", "termsAndConditions": true, "service": "products", "sellingPoint": "sp", "account": { "accountHolderName": "John Doe" } }, "trustly": { "x-trustly": true, "templateUrl": "https://trustly.com/payment-template/abc123" }, "twint": { "x-twint": true, "sellingPoint": "Post office", "service": "DHL", "account": { "accountHolderName": "John Doe" } }, "unionPay": { "account": { "accountHolderName": "John Doe" }, "sellingPoint": "Some selling point", "service": "Some service" }, "eps": { "account": { "accountHolderName": "John Doe", "number": "DE89370400440532013000", "code": "COBADEFFXXX" }, "optionDate": "2025-10-20", "sellingPoint": "Some selling point", "service": "Some service" }, "floapay": { "x-floapay": true, "merchantShopUrl": "https://merchant.com/shop", "travelDetails": { "travelType": "TWO_WAY", "departureDate": "2023-05-12T11:40", "returnDate": "2023-05-20T19:20" } }, "vippsMobilePay": { "x-vippsmobilepay": true, "minAge": 20, "termUrl": "https://example.com/manage-agreement", "billingAgreementId": "BA123456789", "eventToken": "RECURRING_AGREEMENT", "campaign": { "type": "EVENT_CAMPAIGN", "price": 9999, "end": "2025-12-31", "period": { "unit": "MONTH", "count": 12 }, "eventDate": "2025-12-25", "eventText": "Christmas Discount" } }, "weChat": { "account": { "accountHolderName": "John Doe" }, "sellingPoint": "Some selling point", "service": "Some service" }, "wero": { "walletId": "WALLET_987654321" } } } } } } }, "required": true }, "responses": { "202": { "description": "Accepted", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sessionResponse" }, "examples": { "Live Environment": { "description": "", "value": { "_links": { "redirect": { "href": "https://paymentpage.axepta.bnpparibas?token=ce0aef1079d84c5082b3013ee6f9e1fe", "type": "text/html" } } } }, "Test Environment": { "description": "", "value": { "_links": { "redirect": { "href": "https://test.paymentpage.axepta.bnpparibas?token=ce0aef1079d84c5082b3013ee6f9e1fe", "type": "text/html" } } } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "422": { "description": "Unprocessable Entity, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processingProblemDetails" } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payments": { "post": { "tags": [ "Payments" ], "summary": "Create payment", "description": "This endpoint is used to initiate a payment for a specific payment method. You can choose between two integration types:\r\n HOSTED: Returns a URL for a payment method-specific hosted form, where the customer is redirected to securely complete the payment.\r\n DIRECT: Enables server-to-server communication, where you manage the payment UI and directly interacts with the API to process payments.\r\n\r\nNote that not all payment methods support both HOSTED and DIRECT integration types. Some support only one of these options, while others support both. For detailed information about the supported integration types for each payment method, refer to the payment method-specific documentation in our product guide.", "operationId": "createPayment", "parameters": [ { "name": "Idempotency-Key", "in": "header", "description": "A unique key provided by you to ensure that a particular operation is not processed multiple times in case of retries.", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/paymentRequest" }, "examples": { "Alipay - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "REF20250827-02", "amount": { "value": 500, "currency": "EUR" }, "simulationMode": "Test payment", "order": { "description": "Order description", "items": [ { "name": "Wireless Mouse", "quantity": 2 }, { "name": "Keyboard", "quantity": 1 } ] }, "device": { "deviceId": "device12345" }, "urls": { "return": "https://example.com/return", "webhook": "https://example.com/webhook", "cancel": "https://my.callback.url.com/cancel" }, "language": "en", "metadata": { "userData": "my user data", "k1": "v1", "plain": "some plain text", "k2": "v2" }, "paymentMethods": { "integrationType": "HOSTED", "type": "ALIPAY", "alipay": { "account": { "accountHolderName": "John Doe" }, "hotelInfo": { "name": "Hotel Paradise", "checkInTime": [ "2025-01-15T14:00:00", "2025-02-15T14:00:00", "2025-03-15T14:00:00" ], "checkOutTime": [ "2025-01-18T11:00:00", "2025-02-18T11:00:00", "2025-03-18T11:00:00" ] }, "sellingPoint": "Online Store", "service": "BatteryPowerPack" } } } }, "AmazonPay - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "REF-987654", "partialPayment": false, "amount": { "value": 1000, "currency": "EUR" }, "urls": { "return": "https://www.example-shop.com/return", "webhook": "https://www.example-shop.com/webhook", "cancel": "https://www.example-shop.com/cancel" }, "captureMethod": { "type": "AUTOMATIC" }, "statementDescriptor": "My Shop Statement", "simulationMode": "Test 00-01", "credentialOnfile": { "initialPayment": true, "unscheduled": { "subType": "CIT" } }, "shipping": { "address": { "firstName": "John", "streetName": "Main Street 123", "city": "Berlin", "state": "BE", "postalCode": "10115", "countryCode": "DE", "phone": { "countryCode": "49", "number": "123456789" } } }, "paymentMethods": { "integrationType": "DIRECT", "type": "AMAZONPAY", "amazonPay": { "merchantCountryCode": "EU", "shopUrl": "https://www.my-example-shop.com", "buyerCurrency": "EUR", "buyerDetailsScope": "NAME", "addressRestriction": { "type": "ALLOWED", "restrictions": { "US": { "statesOrRegions": [ "WA" ], "zipCodes": [ "95050", "93405" ] }, "GB": { "zipCodes": [ "72046", "72047" ] }, "IN": { "statesOrRegions": [ "AP" ] }, "JP": {} } } } } } }, "ApplePay - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "24235345432", "partialPayment": false, "amount": { "currency": "EUR", "value": 10000 }, "language": "de", "captureMethod": { "type": "AUTOMATIC" }, "order": { "merchantReference": "112-445-34567", "numberOfArticles": 1, "creationDate": "2025-03-31T11:58:37Z", "description": "Order description", "invoiceId": "555-333-2222", "items": [ { "id": "1", "sku": "19-402-DEU", "name": "BatteryPowerPack", "quantity": 1, "quantityUnit": "pcs", "taxRate": 0, "netPrice": 1000, "grossPrice": 1000, "taxAmount": 0, "discountAmount": 0, "description": "BatteryPowerPack", "type": "physical", "productInfo": { "brand": "Intel", "categories": [ "Electronics Store", "Computers", "Desktops" ], "globalTradeItemNumber": "EAN", "manufacturerPartNumber": "BOXNUC5CPYA", "imageUrl": "https://www.exampleobjects.com/logo.png", "productUrl": "https://www.estore.com/products/f2a8d7e34" } } ] }, "billingAddress": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" }, "shipping": { "address": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" } }, "customerInfo": { "merchantCustomerId": "cus_1234567890abcdef", "customerType": "individual", "firstName": "Max", "lastName": "Mustermann", "email": "customer@example.com", "phone": { "countryCode": "+49", "number": "1236547890" }, "salutation": "Ms", "title": "Dr", "gender": "female", "maidenName": "Mustermann", "middleName": "sam", "birthDate": "2001-01-01", "birthPlace": "Bamberg", "socialSecurityNumber": "123443534" }, "channel": "ECOM", "paymentMethods": { "integrationType": "DIRECT", "type": "APPLEPAY", "applePay": { "merchantIdentifierOfPublicKey": "merchant.com.gadgetshop", "token": "{ \"paymentData\": { \"data\": \"GiZiyzsI6r6lnPYUeceR6itk2PDyBozl2Xy77c5u2X8Ze7l5EasyyH4Q6BoAevrvBfe0FnUNARBEXRySLwqqnpUHO6Du/amZEECRXxlrH91wFqH4oXry2CTDRu7TaIlmnR+s3ien5JI8iWo9hoEW7hyJOE7QGaS6rfR1CtQ4DWJEUq/tFnW98tj3kwKU6iOAAvE467boopMDGBS1fK5HzGXs4hH/6r+LPRfSOKBi1L5VWAexs9Bzw3ByyG69i52doRuFb1xOcMOJbmPg40hap13IjBW6dnj1phbsqP2i/JxvWPV3EcuqpuIoVZr5w53w//pPsl54kmeXNddIjVD5dIhhOKZ8AznD4eL2dbzkp6bic8xScBf3G8hrKXTRTL7V+KT2S+TQliHN0SNXrFu6B6o=\", \"signature\": \"MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCABgkqhkiG9w0BBwEAAKCAMIID4zCCA4igAwIBAgIITDBBSVGdVDYwCgYIKoZIzj0EAwIwejEuMCwGA1UEAwwlQXBwbGUgQXBwbGljYXRpb24gSW50ZWdyYXRpb24gQ0EgLSBHMzEmMCQGA1UECwwdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMB4XDTE5MDUxODAxMzI1N1oXDTI0MDUxNjAxMzI1N1owXzElMCMGA1UEAwwcZWNjLXNtcC1icm9rZXItc2lnbl9VQzQtUFJPRDEUMBIGA1UECwwLaU9TIFN5c3RlbXMxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEwhV37evWx7Ihj2jdcJChIY3HsL1vLCg9hGCV2Ur0pUEbg0IO2BHzQH6DMx8cVMP36zIg1rrV1O/0komJPnwPE6OCAhEwggINMAwGA1UdEwEB/wQCMAAwHwYDVR0jBBgwFoAUI/JJxE+T5O8n5sT2KGw/orv9LkswRQYIKwYBBQUHAQEEOTA3MDUGCCsGAQUFBzABhilodHRwOi8vb2NzcC5hcHBsZS5jb20vb2NzcDA0LWFwcGxlYWljYTMwMjCCAR0GA1UdIASCARQwggEQMIIBDAYJKoZIhvdjZAUBMIH+MIHDBggrBgEFBQcCAjCBtgyBs1JlbGlhbmNlIG9uIHRoaXMgY2VydGlmaWNhdGUgYnkgYW55IHBhcnR5IGFzc3VtZXMgYWNjZXB0YW5jZSBvZiB0aGUgdGhlbiBhcHBsaWNhYmxlIHN0YW5kYXJkIHRlcm1zIGFuZCBjb25kaXRpb25zIG9mIHVzZSwgY2VydGlmaWNhdGUgcG9saWN5IGFuZCBjZXJ0aWZpY2F0aW9uIHByYWN0aWNlIHN0YXRlbWVudHMuMDYGCCsGAQUFBwIBFipodHRwOi8vd3d3LmFwcGxlLmNvbS9jZXJ0aWZpY2F0ZWF1dGhvcml0eS8wNAYDVR0fBC0wKzApoCegJYYjaHR0cDovL2NybC5hcHBsZS5jb20vYXBwbGVhaWNhMy5jcmwwHQYDVR0OBBYEFJRX22/VdIGGiYl2L35XhQfnm1gkMA4GA1UdDwEB/wQEAwIHgDAPBgkqhkiG92NkBh0EAgUAMAoGCCqGSM49BAMCA0kAMEYCIQC+CVcf5x4ec1tV5a+stMcv60RfMBhSIsclEAK2Hr1vVQIhANGLNQpd1t1usXRgNbEess6Hz6Pmr2y9g4CJDcgs3apjMIIC7jCCAnWgAwIBAgIISW0vvzqY2pcwCgYIKoZIzj0EAwIwZzEbMBkGA1UEAwwSQXBwbGUgUm9vdCBDQSAtIEczMSYwJAYDVQQLDB1BcHBsZSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTETMBEGA1UECgwKQXBwbGUgSW5jLjELMAkGA1UEBhMCVVMwHhcNMTQwNTA2MjM0NjMwWhcNMjkwNTA2MjM0NjMwWjB6MS4wLAYDVQQDDCVBcHBsZSBBcHBsaWNhdGlvbiBJbnRlZ3JhdGlvbiBDQSAtIEczMSYwJAYDVQQLDB1BcHBsZSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTETMBEGA1UECgwKQXBwbGUgSW5jLjELMAkGA1UEBhMCVVMwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAATwFxGEGddkhdUaXiWBB3bogKLv3nuuTeCN/EuT4TNW1WZbNa4i0Jd2DSJOe7oI/XYXzojLdrtmcL7I6CmE/1RFo4H3MIH0MEYGCCsGAQUFBwEBBDowODA2BggrBgEFBQcwAYYqaHR0cDovL29jc3AuYXBwbGUuY29tL29jc3AwNC1hcHBsZXJvb3RjYWczMB0GA1UdDgQWBBQj8knET5Pk7yfmxPYobD+iu/0uSzAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFLuw3qFYM4iapIqZ3r6966/ayySrMDcGA1UdHwQwMC4wLKAqoCiGJmh0dHA6Ly9jcmwuYXBwbGUuY29tL2FwcGxlcm9vdGNhZzMuY3JsMA4GA1UdDwEB/wQEAwIBBjAQBgoqhkiG92NkBgIOBAIFADAKBggqhkjOPQQDAgNnADBkAjA6z3KDURaZsYb7NcNWymK/9Bft2Q91TaKOvvGcgV5Ct4n4mPebWZ+Y1UENj53pwv4CMDIt1UQhsKMFd2xd8zg7kGf9F3wsIW2WT8ZyaYISb1T4en0dbmcubCYkhYQaZDwmSHQAAMYIBizCCAYcCAQEwgYYwejEuMCwGA1UEAwwlQXBwbGUgQXBwbGljYXRpb24gSW50ZWdyYXRpb24gQ0EgLSBHMzEmMCQGA1UECwwdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTAghMMEFJUZ1UNjANBglghkgBZQMEAgEFAKCBlTAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0yMjAyMjMxMDMyMzFaMCoGCSqGSIb3DQEJNDEdMBswDQYJYIZIAWUDBAIBBQChCgYIKoZIzj0EAwIwLwYJKoZIhvcNAQkEMSIEIKELTeQBJkyBdJ9Ge0BlmVOTIqU4sV75S/aC6sJMIHxbMAoGCCqGSM49BAMCBEYwRAIgC0iKpRgZQE2vMCSczjMRe+4b0aqiO79D2d0+9CKMmA8CICnC+e7RBgIPVbA32ZsKOV8e3iTdvm1OaH/ABCDEFGHIJKL\",\n \"header\": {\n \"publicKeyHash\": \"OgiD2qBTWYf/a+LDshFeQcPq6tOmePu0epHpP4ZkNicc=\",\n \"ephemeralPublicKey\": \"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEc/HxA3lJZrC+B0ITom0Iji+gFdn7ivGtpI+fl2u8n8XByPgBaVK2b44qUvsGigoNd0OFLNXo0Q07R2B54eIdS3A==\", \"transactionId\": \"156632b2aadf355d4958d9051a42bf62e07aea5716e72083aa64247944f6e3e14d\" }, \"version\": \"EC_v1\" }, \"paymentMethod\": { \"displayName\": \"MasterCard 0063\", \"network\": \"MasterCard\", \"type\": \"debit\" }, \"transactionIdentifier\": \"156632B2AAD12F355D4958D9051A42BF62E07AE5716E720AA6424794F6E3E14567D\"}" } } } }, "Bancontact - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "6B29FC62-1069", "partialPayment": false, "amount": { "currency": "EUR", "value": 100 }, "channel": "ECOM", "language": "de", "paymentMethods": { "integrationType": "DIRECT", "type": "BANCONTACT", "bancontact": { "account": { "accountHolderName": "Jane Doe" }, "sellingPoint": "Post office", "service": "DHL", "checkoutToken": "da81921c-f4f3-4810-ad97-08ddbef28917" } } } }, "Bancontact - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "6B29FC62-1069", "partialPayment": false, "amount": { "currency": "EUR", "value": 100 }, "language": "de", "paymentMethods": { "integrationType": "HOSTED", "type": "BANCONTACT", "bancontact": { "account": { "accountHolderName": "Jane Doe" }, "sellingPoint": "Post office", "service": "DHL" } } } }, "Bizum - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "6B29FC62-1069", "amount": { "currency": "EUR", "value": 100 }, "paymentMethods": { "integrationType": "HOSTED", "type": "BIZUM", "bizum": { "account": { "accountHolderName": "Jane Doe" }, "sellingPoint": "Post office", "service": "DHL" } } } }, "Blik - HOSTED": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "BLIK", "blik": { "paymentPurpose": "Payment for Online Shopping", "paymentGuarantee": "VALIDATED", "providerResponseText": "Transaction Successful", "providerTransactionId": "blik-transaction-id-20251016" } } } }, "Boleto - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "6A22FC30-1067-B31D-00DD010662DA", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000 }, "order": { "items": [ { "id": "1", "sku": "sku1", "name": "item1", "quantity": 2, "netPrice": 5000, "description": "desc1" }, { "id": "2", "sku": "sku2", "name": "item2", "quantity": 3, "netPrice": 20000, "description": "desc2" }, { "id": "3", "sku": "sku3", "name": "item3", "quantity": 4, "netPrice": 25000, "description": "desc3" } ], "numberOfArticles": 3 }, "billingAddress": { "street": "test street", "streetNumber": "10", "postalCode": "80335", "city": "Munchen" }, "customerInfo": { "firstName": "John Doe", "email": "test@gmail.com", "phone": { "countryCode": "49", "number": "123654789" } }, "expirationTime": "2023-06-20T13:50:49.112Z", "paymentMethods": { "integrationType": "DIRECT", "type": "BOLETO" } } }, "Boleto - HOSTED": { "description": "", "value": { "transId": "trans-id-123455", "partialPayment": false, "amount": { "value": 100000, "currency": "USD" }, "simulationMode": "Test Boleto payment", "language": "DE", "urls": { "return": "https://return-url.com", "webhook": "https://webhook-url.com" }, "customerInfo": { "merchantCustomerId": "customerNum1234", "firstName": "Jane Doe", "email": "test@gmail.com" }, "channel": "ONLINE", "paymentMethods": { "integrationType": "HOSTED", "type": "BOLETO", "boleto": { "service": "DHL" } } } }, "Card - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "24235345432", "partialPayment": false, "amount": { "currency": "EUR", "value": 10000 }, "captureMethod": { "type": "AUTOMATIC" }, "browserInfo": { "acceptHeaders": "text", "ipAddress": "93.176.166.240", "javaEnabled": false, "javaScriptEnabled": true, "language": "EN", "userAgent": "Mozilla/5.0" }, "order": { "merchantReference": "112-445-34567", "numberOfArticles": 1, "creationDate": "2025-03-31T11:58:37Z", "invoiceId": "555-333-2222", "description": "Order description", "items": [ { "id": "1", "sku": "19-402-DEU", "name": "BatteryPowerPack", "quantity": 1, "quantityUnit": "pcs", "taxRate": 0, "netPrice": 1000, "grossPrice": 1000, "taxAmount": 0, "discountAmount": 0, "description": "BatteryPowerPack", "type": "physical", "productInfo": { "brand": "Intel", "categories": [ "Electronics Store", "Computers", "Desktops" ], "globalTradeItemNumber": "EAN", "manufacturerPartNumber": "BOXNUC5CPYA", "imageUrl": "https://www.exampleobjects.com/logo.png", "productUrl": "https://www.estore.com/products/f2a8d7e34" } } ] }, "billingAddress": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" }, "shipping": { "address": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" } }, "customerInfo": { "merchantCustomerId": "cus_1234567890abcdef", "customerType": "individual", "firstName": "Max", "lastName": "Mustermann", "email": "customer@example.com", "phone": { "countryCode": "+49", "number": "1236547890" }, "salutation": "Ms", "title": "Dr", "gender": "female", "maidenName": "Mustermann", "middleName": "sam", "birthDate": "2001-01-01", "birthPlace": "Bamberg", "socialSecurityNumber": "123443534" }, "channel": "ECOM", "paymentMethods": { "integrationType": "DIRECT", "type": "CARD", "card": { "number": "4242424242424242", "cardHolderName": "Max Mustermann", "expiryDate": "202801", "brand": "VISA", "securityCode": "123", "brandSelection": "MERCHANT", "dcc": { "selected": true, "dccRequestId": "debf1be9841944dc8f6795d73bd4ffb4" } } } } }, "Card - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "24235345432", "partialPayment": false, "amount": { "currency": "EUR", "value": 10000 }, "language": "de", "captureMethod": { "type": "AUTOMATIC" }, "order": { "merchantReference": "112-445-34567", "numberOfArticles": 1, "creationDate": "2025-03-31T11:58:37Z", "invoiceId": "555-333-2222", "description": "Order description", "items": [ { "id": "1", "sku": "19-402-DEU", "name": "BatteryPowerPack", "quantity": 1, "quantityUnit": "pcs", "taxRate": 0, "netPrice": 1000, "grossPrice": 1000, "taxAmount": 0, "discountAmount": 0, "description": "BatteryPowerPack", "type": "physical", "productInfo": { "brand": "Intel", "categories": [ "Electronics Store", "Computers", "Desktops" ], "globalTradeItemNumber": "EAN", "manufacturerPartNumber": "BOXNUC5CPYA", "imageUrl": "https://www.exampleobjects.com/logo.png", "productUrl": "https://www.estore.com/products/f2a8d7e34" } } ] }, "urls": { "return": "https://my.callback.url.com/success", "cancel": "https://my.callback.url.com/cancel", "webhook": "https://my.callback.url.com/webhook" }, "billingAddress": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" }, "shipping": { "address": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" } }, "customerInfo": { "merchantCustomerId": "cus_1234567890abcdef", "customerType": "individual", "firstName": "Max", "lastName": "Mustermann", "email": "customer@example.com", "phone": { "countryCode": "+49", "number": "1236547890" }, "salutation": "Ms", "title": "Dr", "gender": "female", "maidenName": "Mustermann", "middleName": "sam", "birthDate": "2001-01-01", "birthPlace": "Bamberg", "socialSecurityNumber": "123443534" }, "channel": "ECOM", "paymentMethods": { "integrationType": "HOSTED", "type": "CARD", "card": { "subType": [ "VISA", "MASTERCARD" ], "dccEnabled": true, "template": { "name": "card_template", "fontSize": 11, "textColor": "#FFFFFF", "customFields": { "customField1": "Field 1 Data", "customField2": "Field 2 Data", "customField3": "Field 3 Data", "customField4": "Field 4 Data", "customField5": "Field 5 Data", "customField6": "Field 6 Data", "customField7": "Field 7 Data", "customField8": "Field 8 Data", "customField9": "Field 9 Data", "customField10": "Field 10 Data", "customField11": "Field 11 Data", "customField12": "Field 12 Data", "customField13": "Field 13 Data", "customField14": "Field 14 Data" } } } } } }, "DirectDebit - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "externalIntegrationId": "external-integration-id-5678", "refNr": "unique-reference-number-91011", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000 }, "language": "en", "captureMethod": { "type": "AUTOMATIC" }, "order": { "id": "order-id-123", "numberOfArticles": 2, "creationDate": "2025-02-07T15:30:00Z", "items": [ { "quantity": 1, "price": 300 }, { "quantity": 2, "price": 350 } ] }, "simulationMode": "Test EDD payment", "billingAddress": { "streetName": "123 Main St", "streetNumber": "45", "city": "New York", "postalCode": "10001", "country": "US", "addressLine2": "Apt 12B", "addressLine3": "Building C", "state": "NY" }, "shipping": { "address": { "firstName": "John", "lastName": "Doe", "streetName": "123 Main St", "streetNumber": "45" }, "type": "CLICK_AND_COLLECT" }, "customerInfo": { "merchantCustomerId": "customer-123", "customerType": "individual", "firstName": "John", "lastName": "Doe", "email": "john.doe@example.com", "phone": { "countryCode": "49", "number": "123654789" }, "salutation": "MR", "title": "Dr", "gender": "MALE", "birthDate": "1980-01-01", "birthPlace": "New York", "socialSecurityNumber": "123-45-6789" }, "expirationTime": "2025-02-07T16:00:00Z", "paymentMethods": { "integrationType": "DIRECT", "type": "DIRECTDEBIT", "directDebit": { "method": "ELV", "debitDelay": 5, "service": "Subscription Service", "sellingPoint": "Online Store", "account": { "code": "DEUTATWWXXX", "number": "AT141910000088888880", "bankName": "Deutsche Bank", "accountHolderName": "John Doe", "pseudoBankNumber": "PBAN1234567890" }, "mandate": { "mandateId": "6B29FC40-1067-B31D-00DD010A4455", "dateOfSignature": "2023-05-01" } } } } }, "DirectDebit - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "externalIntegrationId": "external-integration-id-5678", "refNr": "unique-reference-number-91011", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000 }, "language": "en", "simulationMode": "Test DD payment", "urls": { "return": "https://merchant.com/return", "cancel": "https://merchant.com/cancel", "webhook": "https://merchant.com/webhook" }, "billingAddress": { "streetName": "123 Main St", "streetNumber": "45", "city": "New York", "postalCode": "10001", "country": "US", "addressLine2": "Apt 12B", "addressLine3": "Building C", "state": "NY" }, "shipping": { "address": { "firstName": "John", "lastName": "Doe", "streetName": "123 Main St", "streetNumber": "45" }, "type": "CLICK_AND_COLLECT" }, "customerInfo": { "merchantCustomerId": "customer-123", "customerType": "individual", "firstName": "John", "lastName": "Doe", "email": "john.doe@example.com", "phone": { "countryCode": "49", "number": "123654789" } }, "expirationTime": "2025-02-07T16:00:00Z", "paymentMethods": { "integrationType": "HOSTED", "type": "DIRECTDEBIT", "directDebit": { "method": "ELV", "debitDelay": 5, "service": "Subscription Service", "sellingPoint": "Online Store", "prefillInfo": { "account": { "code": "DEUTATWWXXX", "number": "AT141910000088888880", "bankName": "Deutsche Bank", "accountHolderName": "John Doe" } } } } } }, "EasyCollect - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "unique-reference-number-91011", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000 }, "captureMethod": { "type": "AUTOMATIC" }, "paymentMethods": { "integrationType": "DIRECT", "type": "EASYCOLLECT", "easyCollect": { "account": { "bankName": "Sample Bank AG", "accountHolderName": "John Doe", "number": "DE89370400440532013000", "code": "COBADEFFXXX" }, "accountId": "test_account_123", "dueDate": "2025-07-15", "mandateId": "MANDATE123456789" } } } }, "EasyCollect - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000 }, "urls": { "return": "https://merchant.com/return", "cancel": "https://merchant.com/cancel", "webhook": "https://merchant.com/webhook" }, "customerInfo": { "companyName": "Example Company", "email": "jane.doe@example.com", "firstName": "Jane", "lastName": "Doe", "phone": { "countryCode": "+49", "number": "15123456789" }, "gender": "F", "merchantCustomerId": "cust-98765" }, "billingAddress": { "streetName": "Market Street", "streetNumber": "42B", "postalCode": "60313", "city": "Frankfurt", "country": "DEU" }, "metadata": { "userData": "user data", "plain": "plain text" }, "paymentMethods": { "integrationType": "HOSTED", "type": "EASYCOLLECT", "easyCollect": { "accountId": "test_account_123", "contractId": "CTR-20250609-001", "contractDescription": "Direct debit authorization for monthly service fee", "businessIdentifier": "DE123456789", "signatureAgreementType": "SMS", "documentSignature": true, "googleAnalyticsConsent": true, "signatureBySca": false, "sps": true, "validation": true, "customerType": "KNOWN", "mandateType": "CORE_BUSINESS", "dueDate": "2025-07-15", "mandateId": "MANDATE123456789", "signerPositionOccupied": "Chief Financial Officer", "template": { "name": "standard-template", "customFields": { "customField1": "test1", "customField2": "test2", "customField3": "test3", "customField4": "test4", "customField5": "test5" } }, "account": { "number": "238712" } } } } }, "EPS - HOSTED": { "description": "", "value": { "transId": "unique-trans-id-20251016", "refNr": "unique-ref-nr-20251016", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000 }, "urls": { "return": "https://my.callback.url.com/success", "webhook": "https://my.callback.url.com/webhook" }, "language": "DE", "simulationMode": "Test EPS payment", "order": { "items": [ { "name": "item1", "quantity": 1, "netPrice": 25000 }, { "name": "item2", "quantity": 2, "netPrice": 12500 } ] }, "paymentMethods": { "integrationType": "HOSTED", "type": "EPS", "eps": { "account": { "accountHolderName": "John Doe", "number": "DE89370400440532013000", "code": "COBADEFFXXX" }, "optionDate": "2025-10-20", "sellingPoint": "Some selling point", "service": "Some service" } } } }, "Floapay - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "partialPayment": false, "amount": { "currency": "EUR", "value": 10000 }, "paymentMethods": { "integrationType": "DIRECT", "type": "FLOAPAY", "floapay": { "providerMerchantId": "38", "providerMerchantSiteId": "7369" } } } }, "Floapay - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "partialPayment": false, "device": { "deviceType": "TABLET", "deviceOs": "ANDROID" }, "amount": { "currency": "EUR", "value": 10000 }, "urls": { "return": "https://example.com/payment/return", "webhook": "https://example.com/payment/webhook", "cancel": "https://example.com/payment/cancel" }, "customerInfo": { "merchantCustomerId": "123456786543", "lastName": "Doe", "firstName": "John", "email": "john.doe@example.com" }, "billingAddress": { "country": "DEU" }, "order": { "creationDate": "2030-12-12", "numberOfArticles": "12" }, "paymentMethods": { "integrationType": "HOSTED", "type": "FLOAPAY", "floapay": { "merchantShopUrl": "https://merchant.com/shop", "providerMerchantId": "38", "providerMerchantSiteId": "7369", "travelDetails": { "travelType": "TWO_WAY", "departureDate": "2023-05-12T11:40", "returnDate": "2023-05-20T19:20", "destinationCountry": "SP", "ticketCount": 2, "travellerCount": 2, "travelClass": "ECONOMY", "ownTicket": true, "mainDepartureCompany": "ERG", "departureAirport": "FRA", "arrivalAirport": "BAR", "discountCode": "123456", "travellerPassports": [ { "expirationDate": "2029-05-12", "issuanceCountry": "FR" }, { "expirationDate": "2029-08-15", "issuanceCountry": "DE" } ] }, "stayDetails": { "company": "BNB", "destination": "Barcelona", "nightNumber": 10, "roomRange": 1 } } } } }, "GooglePay - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "24235345432", "partialPayment": false, "amount": { "currency": "EUR", "value": 10000 }, "language": "de", "captureMethod": { "type": "AUTOMATIC" }, "order": { "merchantReference": "112-445-34567", "numberOfArticles": 1, "creationDate": "2025-03-31T11:58:37Z", "invoiceId": "555-333-2222", "description": "Order description", "items": [ { "id": "1", "sku": "19-402-DEU", "name": "BatteryPowerPack", "quantity": 1, "quantityUnit": "pcs", "taxRate": 0, "netPrice": 1000, "grossPrice": 1000, "taxAmount": 0, "discountAmount": 0, "description": "BatteryPowerPack", "type": "physical", "productInfo": { "brand": "Intel", "categories": [ "Electronics Store", "Computers", "Desktops" ], "globalTradeItemNumber": "EAN", "manufacturerPartNumber": "BOXNUC5CPYA", "imageUrl": "https://www.exampleobjects.com/logo.png", "productUrl": "https://www.estore.com/products/f2a8d7e34" } } ] }, "billingAddress": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" }, "shipping": { "address": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" } }, "customerInfo": { "merchantCustomerId": "cus_1234567890abcdef", "customerType": "individual", "firstName": "Max", "lastName": "Mustermann", "email": "customer@example.com", "phone": { "countryCode": "+49", "number": "1236547890" }, "salutation": "Ms", "title": "Dr", "gender": "female", "maidenName": "Mustermann", "middleName": "sam", "birthDate": "2001-01-01", "birthPlace": "Bamberg", "socialSecurityNumber": "123443534" }, "channel": "ECOM", "paymentMethods": { "integrationType": "DIRECT", "type": "GOOGLEPAY", "googlePay": { "token": "ewogICJzaWduYXR1cmUiOiAiTUVRQ0lDNHovUUhTcnpla1Jra3VrM3ZHWXhCVEJkTmdFUWw1WEZIeDBXazVmRkxJVUFpQjMrcTIyN2hhdkFKZGFnZkdaYU1YYmVmaGF0ZEpFN0RmMnFySW9LRHYxT2c9PSIsCiAgInByb3RvY29sVmVyc2lvbiI6ICJFQ3YxIiwKICAic2lnbmVkTWVzc2FnZSI6ICJ7XCJlbmNyeXB0ZWRNZXNzYWdlXCI6XCJiT1lSbUV4R2VDc0JyRnFFU3Q3a2Q5TzFGTit2UVpmMktHMFVOWUM4ak5BK1ZWZjluUWVLN2xEdlU4azM3Y0grTE96aUpRa0hOTDJPeERISWs2R29SVjFCclhwcndCbkFKUjBPMlZuQ1VIOGxzcXEwRUx3ZW1lcVczNjRJcjhjVS9oREZ6V05wKzM4SDI1SlZEQU1FeFpCS29kTU1UelVYWGd5TytzNWpPeUFsOGpVaG5BdzNmVFJQa2VmdVlzRThORks1dHZjczRMMjloODdabzdvdDAvOFhyVWhYdDliL0ZsZDFMRXRoa3VQU04rSzFlRUZQN2JzZUI2ampSZEhud1lBZHFpRTNpT21oNzFwY0RtTkl5cmxXUmo3NFVKYXN6ZWVyWlc3RG9aTngxMW9ON2ZvdXEvOGZlMXZrbHNyL2UreS9SU0cyblFNV2c1eVIvZk1UZnFDeWFiVERoSk12TU0xWmhlOTErZFEwL3hpL3pLUmdzSWhpb25nSlVqWXRvU05JalVIbk1MUnVWVEtkalg1MENDSTFRT2lCdHI5aDBiT0xlUGh4dzljTFllVTFLd0NmWUp5dDI4REJLQ3ZhV0ZTYkNsK2R6TmNaOUI4M2t2XCIsXCJlcGhlbWVyYWxQdWJsaWNLZXlcIjpcIkJGVWp1NzMvSVQvS3FuQi9uYzBXM0JhTDNCWEZ5YnJiWWFQaU1DS1hJY2c3OFBic2x3VjdNUlVxM1NwV0VERUpUNnBha0xDdmYzNDQxMkhiREdDcHNhNFxcdTAwM2RcIixcInRhZ1wiOlwieEl1Q1VXQjJVNnlXRWZpZHNKcFFhYStsZVUva3FTNTIySkxPbnJuazQyZ1xcdTAwM2RcIn0iCn0K" } } } }, "Ideal - HOSTED": { "description": "", "value": { "transId": "780863758d4f48d4a4f4712b", "refNr": "24235345432", "partialPayment": false, "amount": { "currency": "EUR", "value": 10000 }, "language": "de", "urls": { "return": "https://my.callback.url.com/return", "webhook": "https://my.callback.url.com/webhook" }, "metadata": { "userData": "my user data", "k1": "v1", "plain": "plain text", "k2": "v2" }, "paymentMethods": { "type": "IDEAL", "integrationType": "HOSTED", "ideal": { "subType": "IDEAL" } } } }, "Instanea - HOSTED": { "description": "", "value": { "transId": "78086375-8d4f-48d4-a4f4-712bcfbeb0eb", "refNr": "24235345432", "partialPayment": false, "amount": { "value": 10000, "currency": "EUR" }, "language": "de", "simulationMode": "Test payment", "urls": { "return": "https://my.callback.url.com/success", "cancel": "https://my.callback.url.com/cancel", "webhook": "https://my.callback.url.com/webhook", "appRedirect": "https://my.callback.url.com/appRedirect" }, "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "integrationType": "HOSTED", "type": "INSTANEA", "instanea": { "subType": "SEPA_INSTANT", "returnRefundAccount": true } } } }, "Klarna - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "unique-reference-number-91011", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000, "taxTotal": 500 }, "language": "en", "order": { "id": "order-id-123", "numberOfArticles": 1, "creationDate": "2025-02-07T15:30:00Z", "items": [ { "id": "12345", "sku": "ABCD1234", "name": "Wireless Headphones", "type": "physical", "quantity": 40, "grossPrice": 500, "quantityUnit": "unit", "description": "Premium noise-canceling wireless headphones with 20 hours of battery life.", "marketplaceSellerId": "seller123", "googleProductCategoryId": 123, "productInfo": { "globalTradeItemNumber": "EAN", "manufacturerPartNumber": "MPN9876543210", "imageUrl": "https://example.com/product-image.jpg", "productUrl": "https://example.com/wireless-headphones" } } ] }, "billingAddress": { "streetName": "123 Main St", "streetNumber": "45", "city": "New York", "postalCode": "10001", "country": "USA", "addressLine2": "Apt 12B", "addressLine3": "Building C", "state": "NY" }, "shipping": { "address": { "firstName": "John", "lastName": "Doe", "streetName": "Main Street", "streetNumber": "123", "city": "New York", "postalCode": "10001", "country": "USA", "addressLine2": "Apt 4B", "addressLine3": "Building 12", "state": "NY" }, "type": "CLICK_AND_COLLECT" }, "browserInfo": { "ipAddress": "192.168.1.1" }, "customerInfo": { "merchantCustomerId": "customer-123" }, "paymentMethods": { "integrationType": "DIRECT", "type": "KLARNA", "klarna": { "layout": { "borderColor": "#FF9900", "borderColorSelected": "#FF9900", "detailsColor": "#FF9900", "borderRadius": "8px" }, "accountId": "test", "enhancedData": [ { "productCategory": "Test product category", "productName": "Test product name" } ], "description": "This is a test payment method for demonstration purposes.", "billingAgreementId": "1234567890asdf" } } } }, "Klarna - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "unique-reference-number-91011", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000, "taxTotal": 500 }, "urls": { "return": "https://my.callback.url.com/success", "webhook": "https://my.callback.url.com/notify", "cancel": "https://my.callback.url.com/cancel" }, "language": "en", "order": { "id": "order-id-123", "numberOfArticles": 1, "creationDate": "2025-02-07T15:30:00Z", "items": [ { "id": "12345", "sku": "ABCD1234", "name": "Wireless Headphones", "type": "physical", "quantity": 2, "quantityUnit": "unit", "taxRate": 15, "netPrice": 5000, "grossPrice": 5750, "discountAmount": 500, "taxAmount": 750, "merchantData": "Special discount for VIP customers", "description": "Premium noise-canceling wireless headphones with 20 hours of battery life.", "marketplaceSellerId": "seller123", "lineNumber": 1, "merchantProductType": "Electronics", "googleProductCategory": "Electronics", "googleProductCategoryId": 123, "groupId": "group456", "taxCategory": "standard", "productInfo": { "brand": "TechAudio", "categories": [ "Headphones", "Electronics", "Audio" ], "globalTradeItemNumber": "EAN", "manufacturerPartNumber": "MPN9876543210", "imageUrl": "https://example.com/product-image.jpg", "productUrl": "https://example.com/wireless-headphones" } } ] }, "billingAddress": { "streetName": "123 Main St", "streetNumber": "45", "city": "New York", "postalCode": "10001", "country": "USA", "addressLine2": "Apt 12B", "addressLine3": "Building C", "state": "NY" }, "shipping": { "address": { "firstName": "John", "lastName": "Doe", "streetName": "Main Street", "streetNumber": "123", "city": "New York", "postalCode": "10001", "country": "USA", "addressLine2": "Apt 4B", "addressLine3": "Building 12", "state": "NY" }, "type": "CLICK_AND_COLLECT" }, "browserInfo": { "ipAddress": "192.168.1.1" }, "customerInfo": { "merchantCustomerId": "customer-123" }, "paymentMethods": { "integrationType": "HOSTED", "type": "KLARNA", "klarna": { "layout": { "showSubTotalDetail": "HIDE", "logoUrl": "https://example.com/klarna", "pageTitle": "Secure Payment with Klarna" }, "accountId": "test", "enhancedData": [ { "productCategory": "Test product category", "productName": "Test product name" } ], "description": "This is a test payment method for demonstration purposes." } } } }, "Limonetik - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "REF20250827-02", "amount": { "value": 500, "taxAmount": 100, "currency": "EUR" }, "statementDescriptor": "gadgets shop", "order": { "id": "order-id-123", "numberOfArticles": 1, "creationDate": "2025-02-07T15:30:00Z", "description": "Order description", "items": [ { "id": "12345", "quantity": 2, "netPrice": 5000, "description": "Premium noise-canceling wireless headphones with 20 hours of battery life.", "productInfo": { "brand": "Intel", "categories": [ "Electronics" ] } } ] }, "urls": { "return": "https://example.com/return", "webhook": "https://example.com/webhook" }, "language": "en", "captureMethod": { "type": "AUTOMATIC" }, "customerInfo": { "companyName": "Example Company", "customerType": "individual", "merchantCustomerId": "12341234", "salutation": "Mrs", "firstName": "Jane", "lastName": "Doe", "phone": { "number": "12345678910" }, "email": "customer@example.com" }, "billingAddress": { "streetName": "123 Main St 45", "city": "New York", "postalCode": "10001", "country": "US", "addressLine2": "Apt 12B" }, "shipping": { "address": { "country": "DEU", "salutation": "Mrs", "firstName": "Jane", "lastName": "Doe", "postalCode": "10115", "city": "Berlin", "streetName": "Schwarzenbergstr 4", "phone": { "number": "12345678910" }, "companyName": "Example Company", "addressLine2": "Feldkirchenstr. 21" }, "type": "CARRIER" }, "paymentMethods": { "integrationType": "HOSTED", "type": "LIMONETIK", "limonetik": { "subType": "COFIDIS3XCB", "deliveryDetails": { "description": "standard delivery", "speed": "STANDARD", "expectedDate": "2025-02-08T15:30:00Z", "expectedDelay": 1 }, "customerInformation": { "CFID": "true", "CNEW": "false" } } } } }, "MbWay - HOSTED": { "description": "", "value": { "transId": "unique-trans-id-20251016", "refNr": "unique-ref-nr-20251016", "amount": { "currency": "EUR", "value": 50000 }, "urls": { "return": "https://my.callback.url.com/success", "webhook": "https://my.callback.url.com/webhook", "cancel": "http://example.com/cancel" }, "language": "DE", "simulationMode": "Test MBWay payment", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2" }, "customerInfo": { "phone": { "countryCode": "+49", "number": "912345678" } }, "paymentMethods": { "integrationType": "HOSTED", "type": "MBWAY", "mbWay": { "account": { "accountHolderName": "John Doe" }, "sellingPoint": "Some selling point", "service": "Some service" } } } }, "MobilePay - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "6B29FC62-1069", "partialPayment": false, "amount": { "value": 10000, "currency": "EUR" }, "simulationMode": "Test MOBILEPAY payment", "language": "DE", "urls": { "return": "https://my.callback.url.com/success", "webhook": "https://my.callback.url.com/notify", "cancel": "https://my.callback.url.com/cancel" }, "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "integrationType": "HOSTED", "type": "MOBILEPAY" } } }, "Multibanco - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refnr": "6B29FC62-1069", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000 }, "urls": { "return": "https://my.callback.url.com/success", "cancel": "https://my.callback.url.com/cancel", "webhook": "https://my.callback.url.com/webhook" }, "language": "DE", "channel": "ECOM", "metadata": { "userData": "my userData", "k1": "v1", "plain": "some plain text", "k2": "v2" }, "paymentMethods": { "integrationType": "HOSTED", "type": "MULTIBANCO", "multibanco": { "service": "products", "sellingPoint": "sp", "account": { "accountHolder": "John Doe" } } } } }, "MyBank - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refnr": "6B29FC62-1069", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000 }, "urls": { "return": "https://my.callback.url.com/success", "cancel": "https://my.callback.url.com/cancel", "webhook": "https://my.callback.url.com/webhook" }, "language": "DE", "channel": "ECOM", "metadata": { "userData": "my userData", "k1": "v1", "plain": "some plain text", "k2": "v2" }, "billingAddress": { "country": "DEU" }, "paymentMethods": { "integrationType": "HOSTED", "type": "MYBANK", "myBank": { "service": "products", "sellingPoint": "sp", "account": { "accountHolderName": "John Doe" } } } } }, "PagBrasilPL - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 123, "currency": "BRL" }, "urls": { "return": "https://my.callback.url.com/success", "cancel": "https://my.callback.url.com/failure", "webhook": "https://my.callback.url.com/notify" }, "customerInfo": { "phone": { "countryCode": "47", "subscriberNumber": "1234567565" }, "firstName": "John", "lastName": "Doe", "email": "random@gmail.com", "taxId": "28476378696" }, "billingAddress": { "streetName": "Hartmanstr 7", "city": "Bamberg", "state": "RO", "postalCode": "54330355" }, "statementDescriptor": "chDescending", "expirationTime": "2026-05-06", "paymentMethods": { "type": "PagBrasilPL", "integrationType": "DIRECT", "pagBrasilPl": { "payType": [ "C", "D" ], "productName": "Test product" } } } }, "PayPal - DIRECT": { "description": "", "value": { "transId": "20230511-081056-103", "refNr": "RefNr20230511003", "partialPayment": false, "amount": { "value": 12345, "currency": "EUR", "taxTotal": 0, "netItemTotal": 0, "netShippingAmount": 0 }, "order": { "id": "order-id-123", "numberOfArticles": 1, "creationDate": "2025-02-07T15:30:00Z", "items": [ { "id": "12345", "sku": "ABCD1234", "name": "Wireless Headphones", "quantity": 2, "taxRate": 15, "netPrice": 5000, "description": "Premium noise-canceling wireless headphones with 20 hours of battery life." } ] }, "language": "en", "captureMethod": { "type": "AUTOMATIC" }, "billingAddress": { "streetName": "123 Main St", "streetNumber": "45", "city": "New York", "postalCode": "10001", "country": "US", "addressLine2": "Apt 12B", "addressLine3": "Building C", "state": "NY" }, "paymentMethods": { "integrationType": "DIRECT", "type": "PAYPAL", "payPal": { "accountId": "Your Paypal account ID", "hideAddress": true, "expressCheckout": false } } } }, "PFConnect - DIRECT": { "description": "", "value": { "transId": "20230511-081056-103", "refNr": "RefNr20230511003", "partialPayment": false, "amount": { "value": 12345, "currency": "EUR" }, "order": { "id": "order-id-123", "numberOfArticles": 1, "creationDate": "2025-02-07T15:30:00Z", "items": [ { "id": "12345", "sku": "ABCD1234", "name": "Wireless Headphones", "quantity": 2, "taxRate": 15, "netPrice": 5000, "description": "Premium noise-canceling wireless headphones with 20 hours of battery life." } ] }, "credentialOnFile": { "type": "UNSCHEDULED", "initialPayment": true, "unscheduled": { "subType": "CIT" }, "installments": { "total": 8, "curIdx": 5, "purchaseAmount": 400, "cumulativeAmount": 250, "frequency": "WEEKLY", "expiryDate": "2025-06-10" } }, "paymentMethods": { "integrationType": "DIRECT", "type": "PFCONNECT", "pfConnect": { "merchantCountryCode": "FR", "productId": 123456, "shoppingBasketAmount": 1000, "downPaymentAmount": 200, "deliveryDate": "2025-05-01", "customerRole": "OWNER" } } } }, "PFConnect - HOSTED": { "description": "", "value": { "transId": "20230511-081056-103", "refNr": "RefNr20230511003", "partialPayment": false, "amount": { "value": 12345, "currency": "EUR" }, "urls": { "return": "http://example.com/return", "webhook": "http://example.com/webhook", "failure": "http://example.com/failure" }, "metadata": { "userData": "user data" }, "shipping": { "address": { "firstName": "Jane", "lastName": "Doe", "postalCode": "10115", "city": "Berlin", "country": "DEU", "streetName": "test street", "streetNumber": "test number" } }, "customerInfo": { "merchantCustomerId": "12341234", "salutation": "Mrs", "firstName": "Jane222", "lastName": "Doe", "phone": { "countryCode": "33", "number": "12345678910" }, "birthDate": "1998-11-29", "email": "customer@example.com" }, "order": { "id": "order-id-123", "numberOfArticles": 1, "creationDate": "2025-02-07T15:30:00Z", "items": [ { "id": "12345", "sku": "ABCD1234", "name": "Wireless Headphones", "quantity": 2, "taxRate": 15, "netPrice": 5000, "description": "Premium noise-canceling wireless headphones with 20 hours of battery life." } ] }, "credentialOnFile": { "type": "UNSCHEDULED", "initialPayment": true, "unscheduled": { "subType": "CIT" }, "installments": { "total": 8, "curIdx": 5, "purchaseAmount": 400, "cumulativeAmount": 250, "frequency": "WEEKLY", "expiryDate": "2025-06-10" } }, "billingAddress": { "streetName": "123 Main St", "streetNumber": "45", "city": "New York", "postalCode": "10001", "country": "US", "addressLine2": "Apt 12B", "addressLine3": "Building C", "state": "NY" }, "paymentMethods": { "integrationType": "HOSTED", "type": "PFCONNECT", "pfConnect": { "partnerStoreId": "FR123456", "aboId": 987654321, "applicationDate": "2025-04-14", "customValue": "custom-info", "shoppingBasketAmount": 1200, "deliveryDate": "2025-05-01", "programId": "PROG001", "planId": "PLAN123", "productId": 456789 } } } }, "Przelewy24 - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refnr": "6B29FC62-1069", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000 }, "urls": { "return": "https://my.callback.url.com/success", "webhook": "https://my.callback.url.com/webhook" }, "simulationMode": "Description of refunded goods, unit prices, merchant’s comment etc.", "language": "DE", "channel": "ECOM", "billingAddress": { "streetName": "Main Street", "postalCode": "10115", "country": "DEU", "city": "Berlin" }, "customerInfo": { "firstName": "John", "lastName": "Doe", "email": "john.doe@example.com", "phone": { "countryCode": "49", "number": "123654789" } }, "shipping": { "address": { "streetName": "123 Main St", "city": "Munchen", "postalCode": "80335", "country": "DEU" } }, "metadata": { "userData": "my userData", "k1": "v1", "plain": "some plain text", "k2": "v2" }, "paymentMethods": { "integrationType": "HOSTED", "type": "PRZELEWY24", "przelewy24": { "subType": "BLIK", "authenticationCode": "123456", "termsAndConditions": true, "service": "products", "sellingPoint": "sp", "account": { "accountHolderName": "John Doe" } } } } }, "Ratepay - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "6B29FC62-1069", "partialPayment": false, "amount": { "currency": "EUR", "value": 10000 }, "language": "de", "simulationMode": "Test Ratepay payment", "order": { "id": "order-id-123", "numberOfArticles": 1, "creationDate": "2025-02-07T15:30:00Z", "items": [ { "id": "12345", "sku": "ABCD1234", "name": "Wireless Headphones", "quantity": 2, "taxRate": 15, "netPrice": 5000, "description": "Premium noise-canceling wireless headphones with 20 hours of battery life." } ] }, "customerInfo": { "merchantCustomerId": "12341234", "salutation": "Mrs", "firstName": "Jane222", "lastName": "Doe", "phone": { "countryCode": "33", "number": "12345678910" }, "birthDate": "1998-11-29", "email": "customer@example.com" }, "billingAddress": { "streetName": "123 Main St", "streetNumber": "45", "city": "New York", "postalCode": "10001", "country": "US", "addressLine2": "Apt 12B", "addressLine3": "Building C", "state": "NY" }, "shipping": { "address": { "firstName": "Jane", "lastName": "Doe", "postalCode": "10115", "city": "Berlin", "country": "DEU", "streetName": "test street", "streetNumber": "test number" } }, "channel": "ECOM", "paymentMethods": { "integrationType": "DIRECT", "type": "RATEPAY", "ratepay": { "accountId": "TQ83329400480582083163", "deviceToken": "abc123deviceTokenXYZ", "account": { "number": "DE89370400440532013000", "code": "COBADEFFXXX", "accountHolderName": "Max Mustermann" }, "subType": "PAY_NOW", "transferType": "SEPA_DIRECT_DEBIT" } } } }, "Riverty - DIRECT": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "unique-reference-number-91011", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000 }, "billingAddress": { "streetName": "123 Main St", "streetNumber": "45", "city": "New York", "postalCode": "10001", "country": "US", "addressLine2": "Apt 12B", "addressLine3": "Building C", "state": "NY" }, "shipping": { "address": { "firstName": "John", "lastName": "Doe", "streetName": "Main Street", "streetNumber": "123", "city": "New York", "postalCode": "10001", "country": "USA", "addressLine2": "Apt 4B", "addressLine3": "Building 12", "state": "NY" }, "type": "CLICK_AND_COLLECT" }, "paymentMethods": { "integrationType": "DIRECT", "type": "RIVERTY", "riverty": { "subType": "INVOICE", "billingCareOf": "Jane c/o John", "shippingCareOf": "John c/o Jane", "account": { "number": "12345", "code": "RABONL2U" }, "profileNumber": "123456789", "orderRisk": { "channelType": "INTERNET", "deliveryType": "NORMAL", "ticketDeliveryMethod": "EMAIL" }, "customerRisk": { "existingCustomer": true, "verifiedCustomerIdentification": true, "marketingOptIn": false, "customerSince": "2015-11-20", "customerClassification": "Classification", "acquisitionChannel": "SearchEngine", "hasCustomerCard": true, "customerCardSince": "2016-01-23", "customerCardClassification": "Gold Member", "profileTrackingId": "TrackingID123456", "numberOfTransactions": 27, "customerIndividualScore": 98, "amountOfTransactions": 1, "otherPaymentMethods": true }, "eventToken": "AUTHORIZATION" } } } }, "Swish - DIRECT": { "description": "", "value": { "transId": "b0bccb47-c94b-483d-8985-a736050611db", "refNr": "c99ec9fe-3d07-44b6-87e9-27611f01c8ca", "partialPayment": false, "amount": { "currency": "SEK", "value": 10000 }, "urls": { "webhook": "https://my.callback.url.com/webhook" }, "order": { "simulationMode": "Test payment" }, "customerInfo": { "phone": { "countryCode": "46", "number": "123456789" } }, "channel": "APP", "metadata": { "userData": "my userData" }, "paymentMethods": { "integrationType": "DIRECT", "type": "SWISH" } } }, "Trustly - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "6B29FC62-1069", "partialPayment": false, "amount": { "currency": "EUR", "value": 50000 }, "language": "en", "urls": { "return": "https://my.callback.url.com/success", "webhook": "https://my.callback.url.com/notify", "cancel": "https://my.callback.url.com/cancel" }, "simulationMode": "Test", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "customerInfo": { "firstName": "Alice", "lastName": "Johnson", "email": "alice.johnson@example.com", "phone": { "countryCode": "+1", "number": "5551234567" }, "socialSecurityNumber": "123-45-6789", "merchantCustomerId": "CUST-000123" }, "browserInfo": { "ipAddress": "192.168.1.10" }, "paymentMethods": { "integrationType": "HOSTED", "type": "TRUSTLY", "trustly": { "templateUrl": "https://trustly.com/payment-template/abc123" } } } }, "Twint- HOSTED": { "description": "", "value": { "transId": "123456789", "refNr": "ABC-REF-001", "partialPayment": false, "amount": { "value": 1000, "currency": "CHF" }, "simulationMode": "Test 00-01", "urls": { "return": "https://example.com/return", "webhook": "https://example.com/webhook" }, "metadata": { "userData": "my userData", "k1": "v1", "plain": "some plain text", "k2": "v2" }, "captureMethod": { "type": "MANUAL" }, "paymentMethods": { "integrationType": "HOSTED", "type": "TWINT", "twint": { "sellingPoint": "Post office", "service": "DHL", "account": { "accountHolderName": "John Doe" } } } } }, "UnionPay - HOSTED": { "description": "", "value": { "transId": "unique-trans-id-20251016", "refNr": "unique-ref-nr-20251016", "amount": { "currency": "EUR", "value": 50000 }, "urls": { "return": "https://my.callback.url.com/success", "webhook": "https://my.callback.url.com/webhook" }, "language": "DE", "simulationMode": "Test UnionPay payment", "paymentMethods": { "integrationType": "HOSTED", "type": "UNIONPAY", "unionPay": { "account": { "accountHolderName": "John Doe" }, "sellingPoint": "Some selling point", "service": "Some service" } } } }, "VIPPSMobilePay - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "24235345432", "partialPayment": false, "amount": { "currency": "EUR", "value": 10000 }, "language": "de", "statementDescriptor": "gadgets shop", "simulationMode": "Test", "urls": { "return": "https://my.callback.url.com/success", "cancel": "https://my.callback.url.com/cancel", "webhook": "https://my.callback.url.com/webhook" }, "customerInfo": { "merchantCustomerId": "cus_1234567890abcdef", "customerType": "individual", "firstName": "Max", "lastName": "Mustermann", "email": "customer@example.com", "phone": { "countryCode": "+49", "number": "1236547890" } }, "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "integrationType": "HOSTED", "type": "VIPPSMOBILEPAY", "vippsMobilePay": { "minAge": 20, "termUrl": "https://example.com/manage-agreement", "billingAgreementId": "BA123456789", "eventToken": "RECURRING_AGREEMENT", "campaign": { "type": "EVENT_CAMPAIGN", "price": 9999, "end": "2025-12-31", "period": { "unit": "MONTH", "count": 12 }, "eventDate": "2025-12-25", "eventText": "Christmas Discount" } } } } }, "WeChat - HOSTED": { "description": "", "value": { "transId": "unique-trans-id-20251016", "refNr": "unique-ref-nr-20251016", "amount": { "currency": "EUR", "value": 50000 }, "urls": { "return": "https://my.callback.url.com/success", "webhook": "https://my.callback.url.com/webhook" }, "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2" }, "billingAddress": { "country": "DEU" }, "language": "DE", "simulationMode": "Test WeChat payment", "paymentMethods": { "integrationType": "HOSTED", "type": "WECHAT", "weChat": { "account": { "accountHolderName": "John Doe" }, "sellingPoint": "Some selling point", "service": "Some service" } } } }, "Wero - HOSTED": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "24235345432", "partialPayment": false, "amount": { "currency": "EUR", "value": 10000 }, "simulationMode": "Test WERO payment", "urls": { "return": "https://my.callback.url.com/success", "cancel": "https://my.callback.url.com/cancel", "webhook": "https://my.callback.url.com/notify" }, "order": { "description": "Order description", "items": [ { "id": "1", "sku": "19-402-DEU", "name": "BatteryPowerPack", "quantity": 1, "quantityUnit": "pcs", "taxRate": 0, "netPrice": 1000, "grossPrice": 1000, "taxAmount": 0, "discountAmount": 0, "description": "BatteryPowerPack", "type": "physical" } ] }, "billingAddress": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "addressLine2": "Siechenstr. 61", "city": "Bamberg", "country": "DEU", "postalCode": "96050", "state": "BY" }, "shipping": { "address": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "addressLine2": "Feldkirchenstr. 21", "city": "Bamberg", "country": "DEU", "postalCode": "96050", "state": "BY" } }, "statementDescriptor": "gadgets shop there was a validation for this kvp parameter that it must be a maximum length of 35 characters", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "customerInfo": { "merchantCustomerId": "cus_1234567890abcdef", "customerType": "individual", "firstName": "Max", "lastName": "Mustermann", "email": "customer@example.com", "phone": { "countryCode": "+49", "number": "1236547890" } }, "paymentMethods": { "integrationType": "HOSTED", "type": "WERO", "wero": { "walletId": "test_wallet_id" } } } } } } }, "required": true }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/paymentDirectResponse" }, "examples": { "AmazonPay": { "description": "", "value": { "merchantId": "test_merchant_id", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "TRANS-987654321", "refNr": "REF-2025-001", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "paymentMethods": { "amazonPay": { "buttonSignature": "EXAMPLE_SIGNATURE", "buttonPayload": "EXAMPLE_PAYLOAD", "buttonPublicKeyId": "PUBLIC_KEY_ID_123" } } } }, "ApplePay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "order": { "invoiceId": "ABC123", "merchantReference": "XYZ123" }, "customerInfo": { "merchantCustomerId": "XXX123" }, "paymentMethods": { "applePay": { "schemeReferenceId": "6C21FC4093DD0105678" } } } }, "Boleto": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "boleto": { "paymentSlipLink": "https://paymentPage.aspx" } } } }, "Card": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "order": { "invoiceId": "ABC123", "merchantReference": "XYZ123" }, "paymentMethods": { "card": { "pseudoCardNumber": "0723219245645111", "expiryDate": "202506", "brand": "VISA", "source": "CREDIT", "issuer": "JPMORGAN CHASE BANK, N.A.", "country": "US", "bin": { "accountBin": "411111" }, "versioningData": { "threeDSServerTransId": "14dd844c-b0fc-4dfe-8635-366fbf43468c", "acsStartProtocolVersion": "2.1.0", "acsEndProtocolVersion": "2.1.0", "dsStartProtocolVersion": "2.1.0", "dsEndProtocolVersion": "2.1.0", "threeDSMethodUrl": "https://www.computop-paygate.com/acs/3ds-method", "threeDSMethodDataForm": "eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly93d3cuY29tcHV0b3AtcGF5Z2F0ZS5jb20vY2JUaHJlZURTLmFzcHg_YWN0aW9uPW10aGROdGZuIiwidGhyZWVEU1NlcnZlclRyYW5zSUQiOiIxNGRkODQ0Yy1iMGZjLTRkZmUtODYzNS0zNjZmYmY0MzQ2OGMifQ==", "threeDSMethodData": { "threeDSMethodNotificationUrl": "https://www.computop-paygate.com/cbThreeDS.aspx?action=mthdNtfn", "threeDSServerTransId": "14dd844c-b0fc-4dfe-8635-366fbf43468c" } }, "providerApprovalCode": "20000000", "providerResponseCode": "201", "providerResponseMessage": "SUCCESS" } } } }, "Default": { "description": "", "value": { "merchantId": "test_merchant_id", "payId": "6c7c66e5352241c19d82c175a01f713a", "xId": "93c4093c6d3644fcb6c60484f7a831fd", "transId": "98582271-63d2-4b90-9422-5fb597a4c41d", "status": "OK", "responseCode": "00000000", "responseDescription": "success" } }, "DirectDebit": { "description": "", "value": { "merchantId": "test_merchant_id", "payId": "6c7c66e5352241c19d82c175a01f713a", "xId": "93c4093c6d3644fcb6c60484f7a831fd", "transId": "98582271-63d2-4b90-9422-5fb597a4c41d", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "paymentMethods": { "directDebit": { "account": { "accountHolderName": "Jane Doe", "number": "AT141910000088888880", "bankName": "Test_Bank" }, "mandateId": "FFFFCD45087F1A", "dateOfSignature": "2025-02-25" } } } }, "EasyCollect": { "description": "", "value": { "merchantId": "test_merchant_id", "payId": "6c7c66e5352241c19d82c175a01f713a", "xId": "93c4093c6d3644fcb6c60484f7a831fd", "transId": "98582271-63d2-4b90-9422-5fb597a4c41d", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "paymentMethods": { "easyCollect": { "account": { "accountHolderName": "Jane Doe", "number": "AT141910000088888880", "bankName": "Test_Bank" }, "mandateId": "FFFFCD45087F1A", "dateOfSignature": "2025-02-25" } } } }, "Floapay": { "description": "", "value": { "payId": "00000000000000000000000000000000", "merchantId": "6B29FC40-1067-B31D-00DD010662DA", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "metadata": {}, "paymentMethods": { "floapay": { "providerResponseCode": "0", "providerResponseText": "Request successfully processed", "paymentDetails": { "totalAmount": 10174, "schedule": [ { "scheduleNumber": 1, "repaymentDate": "2025-09-09T00:00:00", "repaymentAmount": 3392 }, { "scheduleNumber": 2, "repaymentDate": "2025-10-09T00:00:00", "repaymentAmount": 3391 }, { "scheduleNumber": 3, "repaymentDate": "2025-11-08T00:00:00", "repaymentAmount": 3391 } ] } } } } }, "GooglePay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "order": { "invoiceId": "ABC123", "merchantReference": "XYZ123" }, "customerInfo": { "merchantCustomerId": "XXX123" }, "metadata": { "userData": "some user data" }, "paymentMethods": { "googlePay": { "schemeReferenceId": "6C21FC4093DD0105678" } } } }, "Klarna": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "klarna": { "accessToken": "2738598h48t672909th", "providerResponseCode": "201", "provideResponseText": "success", "subType": [ "PAY_NOW", "PAY_LATER" ] } } } }, "PayPal": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "payPal": { "orderId": "pay-pal-order-id-123" } } } }, "PFConnect": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "pfConnect": { "financingScenarioDetail": "5-year loan, 3.5% interest, 20% down payment." } } } }, "Ratepay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "authorizationExpiry": "2025-05-22T14:30:00+02:00", "account": { "bankName": "Sample Bank", "code": "DE1234567890", "number": "DE89370400440532013000", "accountHolderName": "John Doe" }, "paymentReference": "Invoice #12345", "providerTransactionId": "txn-9876543210" } } } }, "Riverty": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "riverty": { "billingAddress": { "countryCode": "DE", "postalCode": "10115", "street": "Street", "streetNumber": "20" }, "shippingAddress": { "countryCode": "DE", "postalCode": "60311", "street": "Street", "streetNumber": "23" }, "allowedPaymentMethods": [ { "type": "INVOICE", "directDebit": { "available": true }, "installment": { "basketAmount": "1000", "numberOfInstallments": "1", "installmentAmount": "1000", "firstInstallmentAmount": "1000", "lastInstallmentAmount": "1000" }, "legalInfo": { "requiresCustomerConsent": true, "termsAndConditionsUrl": "https://terms-and-conditions.com", "privacyStatementUrl": "https://privacy-statement.com", "text": "additional legal text" } } ] } } } }, "Swish": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "1f90fa7812244773b2aa3fcbd8decc14", "xId": "e1207dd1-a1fd-426b-841a-d83b21137933", "transId": "ff3526bf-7102-4f20-ab03-344fef82babd", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "3e99131a-0a5f-47d2-87af-9d2f51b29e6b", "paymentMethods": { "swish": { "providerTransactionId": "d943cc8b-2f35-47ea-af1a-a822de126095", "providerToken": "f34DS34lfd0d03fdDselkfd3ffk21" } } } } } } } }, "202": { "description": "Accepted", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/paymentHostedResponse" }, "examples": { "Live Environment": { "description": "", "value": { "_links": { "redirect": { "href": "https://paymentpage.axepta.bnpparibas?token=ce0aef1079d84c5082b3013ee6f9e1fe", "type": "text/html" } } } }, "Test Environment": { "description": "", "value": { "_links": { "redirect": { "href": "https://test.paymentpage.axepta.bnpparibas?token=ce0aef1079d84c5082b3013ee6f9e1fe", "type": "text/html" } } } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "422": { "description": "Unprocessable Entity, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processingProblemDetails" }, "examples": { "Card": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "card": { "providerResponseCode": "05", "providerResponseMessage": "Do not honor", "issuerResponseCode": "2001", "issuerResponseMessage": "Insufficient funds" } } } }, "DirectDebit": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "directDebit": { "providerResponseCode": "12", "providerResponseText": "Insufficient funds" } } } }, "EasyCollect": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "easyCollect": { "providerResponseCode": "12", "providerResponseText": "Insufficient funds" } } } }, "Floapay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Action failed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "floapay": { "providerResponseText": "The action failed.", "providerResponseCode": "101" } } } }, "Klarna": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "providerResponseCode": "101", "providerResponseText": "The transaction was declined due to insufficient funds in the account." } } } }, "Ratepay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "providerDeclineCategory": "insufficient_funds", "providerResponseText": "The transaction was declined due to insufficient funds in the account.", "providerResponseCode": "101" } } } }, "Swish": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "e6862871-9b88-48de-82a8-206d22eaa36c", "xId": "753b009f-44cf-499a-aa84-be21b48d9d36", "transId": "a165b698-a627-4824-8573-770ff08446b0", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "a2217876-e595-4d7e-881f-396246795c46", "paymentMethods": { "swish": { "providerResponseText": "The transaction was declined due to insufficient funds in the account.", "providerResponseCode": "101" } } } } } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payments/{id}/confirms": { "post": { "tags": [ "Payments" ], "summary": "Confirm payment", "description": "This endpoint is used for payment methods that require a multi-step payment flow. It allows you to confirm a previously created payment instance (initiated via the Create Payment endpoint) to complete the transaction. This step is essential for certain payment methods to finalize the payment process.", "operationId": "confirmPayment", "parameters": [ { "name": "id", "in": "path", "description": "PayId assigned by Axepta Online in the initial request", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "description": "A unique key provided by you to ensure that a particular operation is not processed multiple times in case of retries.", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/confirmRequest" }, "examples": { "Card": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 10000, "currency": "EUR" }, "refNr": "24235345432", "captureMethod": { "type": "AUTOMATIC" }, "order": { "merchantReference": "112-445-34567", "numberOfArticles": 1, "creationDate": "2025-03-31T11:58:37Z", "invoiceId": "555-333-2222", "items": [ { "id": "1", "sku": "19-402-DEU", "name": "BatteryPowerPack", "quantity": 1, "quantityUnit": "pcs", "taxRate": 0, "netPrice": 1000, "grossPrice": 1000, "taxAmount": 0, "discountAmount": 0, "description": "BatteryPowerPack", "type": "physical", "productInfo": { "brand": "Intel", "categories": [ "Electronics Store", "Computers", "Desktops" ], "globalTradeItemNumber": "EAN", "manufacturerPartNumber": "BOXNUC5CPYA", "imageUrl": "https://www.exampleobjects.com/logo.png", "productUrl": "https://www.estore.com/products/f2a8d7e34" } } ] }, "paymentMethods": { "card": { "eventToken": "ORDER" } } } }, "Klarna": { "description": "", "value": { "transId": "some-trans-id", "amount": { "value": 10000, "currency": "EUR" }, "refNr": "some-ref-nr", "order": { "id": "order-1-id", "items": [ { "name": "item-1", "quantity": 1, "netPrice": 5000, "taxRate": 0 }, { "name": "item-2", "quantity": 1, "netPrice": 5000, "taxRate": 0 } ] }, "billingAddress": { "streetName": "test", "streetNumber": "22", "postalCode": "10115", "country": "DE" }, "shipping": { "address": { "country": "NL" } }, "paymentMethods": { "klarna": { "accessToken": "some-access-token" } } } } } } }, "required": true }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/confirmResponse" }, "examples": { "ApplePay": { "description": "", "value": { "merchantId": "merchant-test", "payId": "6c7c66e5352241c19d82c175a01f713a", "xId": "93c4093c6d3644fcb6c60484f7a831fd", "transId": "98582271-63d2-4b90-9422-5fb597a4c41d", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "order": { "invoiceId": "ABC123", "merchantReference": "XYZ123" }, "customerInfo": { "merchantCustomerId": "XXX123" } } }, "Card": { "description": "", "value": { "merchantId": "merchant-test", "payId": "6c7c66e5352241c19d82c175a01f713a", "xId": "93c4093c6d3644fcb6c60484f7a831fd", "transId": "98582271-63d2-4b90-9422-5fb597a4c41d", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "order": { "invoiceId": "ABC123", "merchantReference": "XYZ123" } } }, "Default": { "description": "", "value": { "merchantId": "merchant-test", "payId": "6c7c66e5352241c19d82c175a01f713a", "xId": "93c4093c6d3644fcb6c60484f7a831fd", "transId": "98582271-63d2-4b90-9422-5fb597a4c41d", "status": "OK", "responseCode": "00000000", "responseDescription": "success" } }, "GooglePay": { "description": "", "value": { "merchantId": "merchant-test", "payId": "6c7c66e5352241c19d82c175a01f713a", "xId": "93c4093c6d3644fcb6c60484f7a831fd", "transId": "98582271-63d2-4b90-9422-5fb597a4c41d", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "order": { "invoiceId": "ABC123", "merchantReference": "XYZ123" }, "customerInfo": { "merchantCustomerId": "XXX123" } } }, "Klarna": { "description": "", "value": { "merchantId": "merchant-test", "payId": "some-pay-id", "xId": "some-x-id", "transId": "some-trans-id", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "some-ref-br", "paymentMethods": { "klarna": { "providerTransactionId": "klarna-transaction-id", "billingAgreementId": "klarna-billing-id", "redirectUrl": "https://redirect-url.com", "providerResponseCode": "200", "providerResponseText": "Operation successful" } } } }, "PayPal": { "description": "", "value": { "merchantId": "merchant-test", "payId": "some-pay-id", "xId": "some-x-id", "transId": "some-trans-id", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "some-ref-br", "paymentMethods": { "payPal": { "providerResponseCode": "200" } } } }, "Riverty": { "description": "", "value": { "merchantId": "merchant-test", "payId": "some-pay-id", "xId": "some-x-id", "transId": "some-trans-id", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "some-ref-br", "paymentMethods": { "riverty": { "providerResponseCode": "200", "providerResponseText": "Operation successful", "billingAddress": { "streetName": "test-street", "streetNumber": "22", "postalCode": "10115" } } } } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "422": { "description": "Unprocessable Entity, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processingProblemDetails" }, "examples": { "Klarna": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "klarna": { "providerResponseCode": "101", "providerResponseText": "The transaction was declined due to insufficient funds in the account." } } } } } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payments/{id}/incrementals": { "post": { "tags": [ "Payments" ], "summary": "Incremental authorization", "description": "This endpoint allows you to increase the authorized amount for an existing card transaction when the initial authorization is insufficient. The additional amount is appended to the original authorization, and the total authorized amount reflects both.", "operationId": "incrementAuthorization", "parameters": [ { "name": "id", "in": "path", "description": "payId assigned by Axepta Online in the initial request.", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "description": "A unique key provided by you to ensure that a particular operation is not processed multiple times in case of retries.", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/incrementalRequest" }, "examples": { "Default": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 10000, "currency": "EUR" }, "duration": 10 } } } } }, "required": true }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/incrementalResponse" }, "examples": { "Default": { "description": "", "value": { "merchantId": "test-merchant", "payId": "some-pay-id", "xId": "some-x-id", "transId": "some-trans-id", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "some-ref-nr" } }, "Ratepay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "authorizationExpiry": "2025-05-22T14:30:00+02:00", "account": { "bankName": "Sample Bank", "code": "DE1234567890", "number": "DE89370400440532013000", "accountHolderName": "John Doe" }, "paymentReference": "Invoice #12345", "providerTransactionId": "txn-9876543210" } } } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "422": { "description": "Unprocessable Entity, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processingProblemDetails" }, "examples": { "Ratepay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "providerDeclineCategory": "insufficient_funds", "providerResponseText": "The transaction was declined due to insufficient funds in the account.", "providerResponseCode": "101" } } } } } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payments/{id}/reversals": { "post": { "tags": [ "Payments" ], "summary": "Reverse payment", "description": "This endpoint is used to reverse a payment that has not yet been captured, effectively canceling the authorization.", "operationId": "reversePayment", "parameters": [ { "name": "id", "in": "path", "description": "payId assigned by Axepta Online in the initial request", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "description": "A unique key provided by you to ensure that a particular operation is not processed multiple times in case of retries.", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/reversalRequest" }, "examples": { "AmazonPay": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 10000, "currency": "EUR" }, "refNr": "24235345432", "paymentMethods": { "amazonPay": { "reversalReason": "Customer Cancellation" } } } }, "Default": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 10000, "currency": "EUR" }, "refNr": "24235345432" } } } } }, "required": true }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/reversalResponse" }, "examples": { "AmazonPay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "refNr": "6729FC4093DA010662DA", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "paymentMethods": { "amazonPay": { "providerStatus": "Success", "chargeId": "D4010662DB229FC4092", "chargePermissionId": "D4010662DB229FC4191", "providerResponseCode": "200" } } } }, "Card": { "description": "", "value": { "merchantId": "test-merchant", "payId": "some-pay-id", "xId": "some-x-id", "transId": "some-trans-id", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "some-ref-nr", "paymentMethods": { "card": { "providerResponseCode": "200", "providerTransactionId": "some-clearhaus-transaction-id", "providerApprovalCode": "some-approval-code" } } } }, "Default": { "description": "", "value": { "merchantId": "test_merchant_id", "payId": "6c7c66e5352241c19d82c175a01f713a", "xId": "93c4093c6d3644fcb6c60484f7a831fd", "transId": "98582271-63d2-4b90-9422-5fb597a4c41d", "status": "OK", "responseCode": "00000000", "responseDescription": "success" } }, "Floapay": { "description": "", "value": { "merchantId": "test-merchant", "payId": "some-pay-id", "xId": "some-x-id", "transId": "some-trans-id", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "some-ref-nr", "paymentMethods": { "floapay": { "providerResponseCode": "200", "providerResponseText": "Operation successful" } } } }, "Klarna": { "description": "", "value": { "merchantId": "test-merchant", "payId": "some-pay-id", "xId": "some-x-id", "transId": "some-trans-id", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "some-ref-nr", "paymentMethods": { "klarna": { "providerResponseCode": "200", "providerResponseText": "Operation successful" } } } }, "PayPal": { "description": "", "value": { "merchantId": "test-merchant", "payId": "some-pay-id", "xId": "some-x-id", "transId": "some-trans-id", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "some-ref-nr", "paymentMethods": { "payPal": { "providerResponseCode": "200" } } } }, "Ratepay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "authorizationExpiry": "2025-05-22T14:30:00+02:00", "account": { "bankName": "Sample Bank", "code": "DE1234567890", "number": "DE89370400440532013000", "accountHolderName": "John Doe" }, "paymentReference": "Invoice #12345", "providerTransactionId": "txn-9876543210" } } } }, "Riverty": { "description": "", "value": { "merchantId": "test-merchant", "payId": "some-pay-id", "xId": "some-x-id", "transId": "some-trans-id", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "some-ref-nr", "paymentMethods": { "riverty": { "providerResponseCode": "200", "providerResponseText": "Operation successful" } } } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "422": { "description": "Unprocessable Entity, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processingProblemDetails" }, "examples": { "Card": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "card": { "providerResponseCode": "51", "providerResponseText": "Invalid card number" } } } }, "Floapay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Action failed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "floapay": { "providerResponseText": "The action failed.", "providerResponseCode": "101" } } } }, "Klarna": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "providerResponseCode": "101", "providerResponseText": "The transaction was declined due to insufficient funds in the account." } } } }, "Ratepay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "providerDeclineCategory": "insufficient_funds", "providerResponseText": "The transaction was declined due to insufficient funds in the account.", "providerResponseCode": "101" } } } } } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payments/{id}/captures": { "post": { "tags": [ "Payments" ], "summary": "Capture payment", "description": "This endpoint is used to capture an existing authorized payment.", "operationId": "capturePayment", "parameters": [ { "name": "id", "in": "path", "description": "PayId assigned by Axepta Online in the initial request.", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "description": "A unique key provided by you to ensure that a particular operation is not processed multiple times in case of retries.", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/captureRequest" }, "examples": { "AmazonPay": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 10000, "currency": "EUR" }, "refNr": "24235345432", "statementDescriptor": "gadgets shop", "paymentMethods": { "amazonPay": { "amazonPaySimulationCode": "CAPTURE_INITIATED" } } } }, "Card": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 10000, "currency": "EUR" }, "refNr": "24235345432", "statementDescriptor": "gadgets shop", "captureMethod": { "manual": { "currentSequence": 1, "final": false, "total": 3 } }, "paymentMethods": { "card": { "finishAuth": true } } } }, "Default": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 10000, "currency": "EUR" }, "refNr": "24235345432", "statementDescriptor": "gadgets shop", "captureMethod": { "manual": { "currentSequence": 1, "final": false, "total": 3 } } } }, "DirectDebit": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1200, "currency": "EUR" }, "refNr": "6B29FC40-1067-B31D", "statementDescriptor": "Purchase at ABC Store", "captureMethod": { "manual": { "currentSequence": 1, "final": false, "total": 3 } }, "paymentMethods": { "directDebit": { "mandateId": "6B29FC4012CD010A5B61", "dateOfSignature": "2023-05-22" } } } }, "Klarna": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1200, "currency": "EUR" }, "refNr": "6B29FC40-1067-B31D", "statementDescriptor": "Purchase at ABC Store", "captureMethod": { "manual": { "currentSequence": 1, "final": false, "total": 3 } }, "paymentMethods": { "klarna": { "completeType": "yes", "shippingInfo": { "shippingCompany": "17postservice", "shippingMethod": "Home", "trackingId": "63456415674545679074", "trackingUrl": "https://shipping.example/findmypackage?63456415674545679074", "returnShippingCompany": "aaa-cooper", "returnTrackingId": "93456415674545679000", "returnTrackingUrl": "https://shipping.example/findmypackage?93456415674545679000" } } } } }, "MobilePay": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1200, "currency": "EUR" }, "refNr": "6B29FC40-1067-B31D", "paymentMethods": { "mobilePay": { "finishAuth": true, "textfield1": "John Doe", "textfield2": "New York" } } } }, "PayPal": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1200, "currency": "EUR" }, "refNr": "6B29FC40-1067-B31D", "statementDescriptor": "Purchase at ABC Store", "captureMethod": { "manual": { "currentSequence": 1, "final": false, "total": 3 } }, "paymentMethods": { "payPal": { "completeType": true } } } }, "Riverty": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1200, "currency": "EUR" }, "refNr": "6B29FC40-1067-B31D", "statementDescriptor": "Purchase at ABC Store", "captureMethod": { "manual": { "currentSequence": 1, "final": false, "total": 3 } }, "paymentMethods": { "riverty": { "shippingInfo": { "type": "SHIPMENT", "shippingCompany": "companyName", "trackingId": "6C29FC401067B3A8" } } } } }, "Twint": { "description": "", "value": { "transactionId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1000, "currency": "CHF" }, "paymentMethods": { "twint": { "completeType": true } } } } } } }, "required": true }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/captureResponse" }, "examples": { "AmazonPay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "paymentMethods": { "amazonPay": { "providerStatus": "Success", "chargeId": "D4010662DB229FC4092", "chargePermissionId": "D4010662DB229FC4191", "providerResponseCode": "200" } } } }, "Card": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "card": { "providerResponseCode": "SC123", "providerResponseText": "Payment successfully processed.", "providerTransactionId": "CLEAR12345", "providerApprovalCode": 987654321 } } } }, "Default": { "description": "", "value": { "merchantId": "test_merchant_id", "payId": "6c7c66e5352241c19d82c175a01f713a", "xId": "93c4093c6d3644fcb6c60484f7a831fd", "transId": "98582271-63d2-4b90-9422-5fb597a4c41d", "status": "OK", "responseCode": "00000000", "responseDescription": "success" } }, "Floapay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "paymentMethods": { "floapay": { "providerResponseCode": "200", "providerResponseText": "Payment successfully processed." } } } }, "Klarna": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "klarna": { "providerResponseCode": "200", "providerResponseText": "Payment successfully processed.", "invoiceNumber": "KL-INV-987654321" } } } }, "PayPal": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "payPal": { "providerResponseCode": 200, "providerTransactionId": "PAYPALCAPTURE123456789" } } } }, "Ratepay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "authorizationExpiry": "2025-05-22T14:30:00+02:00", "account": { "bankName": "Sample Bank", "code": "DE1234567890", "number": "DE89370400440532013000", "accountHolderName": "John Doe" }, "paymentReference": "Invoice #12345", "providerTransactionId": "txn-9876543210" } } } }, "Riverty": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "riverty": { "providerResponseCode": 200, "providerResponseText": "Payment successfully processed.", "invoiceNumber": "RIV-INV-1122334455" } } } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "422": { "description": "Unprocessable Entity, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processingProblemDetails" }, "examples": { "AmazonPay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6729FC4093DA010662DA", "paymentMethods": { "amazonPay": { "providerStatus": "Failed", "chargeId": "D4010662DB229FC4092", "chargePermissionId": "D4010662DB229FC4191", "providerResponseCode": "101" } } } }, "Card": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "card": { "providerResponseCode": "51", "providerResponseText": "Invalid card number" } } } }, "Floapay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Action failed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "floapay": { "providerResponseText": "The action failed.", "providerResponseCode": "101" } } } }, "Klarna": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "providerResponseCode": "101", "providerResponseText": "The transaction was declined due to insufficient funds in the account." } } } }, "PayPal": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "payPal": { "providerResponseCode": "05" } } } }, "Ratepay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "providerDeclineCategory": "insufficient_funds", "providerResponseText": "The transaction was declined due to insufficient funds in the account.", "providerResponseCode": "101" } } } } } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payments/{id}/refunds": { "post": { "tags": [ "Payments" ], "summary": "Refund payment with reference", "description": "This endpoint is used to refund a captured payment.", "operationId": "refundPayment", "parameters": [ { "name": "id", "in": "path", "description": "PayId assigned by Axepta Online in the initial request.", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "description": "A unique key provided by you to ensure that a particular operation is not processed multiple times in case of retries.", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/refundRequest" }, "examples": { "AmazonPay": { "description": "", "value": { "tranId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1200, "currency": "EUR" }, "statementDescriptor": "Example Store Purchase", "refNr": "6B29FC40-1067-B31D", "paymentMethods": { "amazonPay": { "amazonPaySimulationCode": "CAPTURE_INITIATED" } } } }, "Boleto": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1200, "currency": "EUR" }, "refNr": "6B29FC40-1067-B31D", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "statementDescriptor": "Example Store Purchase", "paymentMethods": { "boleto": { "bankName": "Deutsche Bank AG Filiale Wien", "accountNumber": "12345-6", "bankSortCode": "DEUTATWWXXX" } } } }, "Card": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 10000, "currency": "EUR" }, "refNr": "24235345432", "statementDescriptor": "gadget shop", "paymentMethods": { "card": { "providerTransactionId": "745638292011384" } } } }, "Default": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 10000, "currency": "EUR" }, "refNr": "24235345432", "statementDescriptor": "gadget shop" } }, "MobilePay": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1200, "currency": "EUR" }, "refNr": "6B29FC40-1067-B31D", "paymentMethods": { "mobilePay": { "textfield1": "John Doe", "textfield2": "New York" } } } }, "PayPal": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1200, "currency": "EUR" }, "refNr": "6B29FC40-1067-B31D", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "statementDescriptor": "Example Store Purchase", "paymentMethods": { "payPal": { "providerTransactionId": "PAYPAL1234567890" } } } }, "Riverty": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1200, "currency": "EUR" }, "refNr": "6B29FC40-1067-B31D", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "statementDescriptor": "Example Store Purchase", "paymentMethods": { "riverty": { "refundType": "REFUND", "invoiceNumber": "INV987654321" } } } } } } }, "required": true }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/refundResponse" }, "examples": { "AmazonPay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "refNr": "6729FC4093DA010662DA", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "paymentMethods": { "amazonPay": { "providerStatus": "Success", "chargeId": "D4010662DB229FC4092", "refundId": "D4010662DB229FC4191", "providerResponseCode": "200" } } } }, "Bancontact": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "bancontact": { "providerResponseText": 1 } } } }, "Boleto": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "boleto": { "providerResponseText": 1 } } } }, "Card": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "card": { "providerResponseCode": "200", "providerResponseText": "Transaction successfully synchronized.", "providerTransactionId": "CLEARHAUS987654321" } } } }, "Default": { "description": "", "value": { "merchantId": "test_merchant_id", "payId": "6c7c66e5352241c19d82c175a01f713a", "xId": "93c4093c6d3644fcb6c60484f7a831fd", "transId": "98582271-63d2-4b90-9422-5fb597a4c41d", "status": "OK", "responseCode": "00000000", "responseDescription": "success" } }, "Floapay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "paymentMethods": { "floapay": { "providerResponseCode": "200", "providerResponseText": "Payment successfully authorized." } } } }, "Klarna": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "klarna": { "providerResponseCode": "200", "providerResponseText": "Payment successfully authorized.", "invoiceNumber": "INV123456789" } } } }, "MyBank": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "myBank": { "providerResponseText": "error text" } } } }, "PayPal": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "payPal": { "providerResponseCode": "200", "feeRefundAmount": "5,23", "grossRefundAmount": "50,11", "netRefundAmount": "45,4" } } } }, "Przelewy24": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" } } }, "Ratepay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "authorizationExpiry": "2025-05-22T14:30:00+02:00", "account": { "bankName": "Sample Bank", "code": "DE1234567890", "number": "DE89370400440532013000", "accountHolderName": "John Doe" }, "paymentReference": "Invoice #12345", "providerTransactionId": "txn-9876543210" } } } }, "Riverty": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "riverty": { "providerResponseCode": 200, "providerResponseText": "Transaction successfully synchronized." } } } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "422": { "description": "Unprocessable Entity, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processingProblemDetails" }, "examples": { "Alipay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Action could not be processed.", "refNr": "6C21FC4093DD0108765", "metadata": { "userData": "my user data" }, "paymentMethods": { "alipay": { "providerResponseText": "Invalid account number" } } } }, "Bizum": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Action could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "bizum": { "providerResponseText": "Invalid account number" } } } }, "Card": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "card": { "providerResponseCode": "51", "providerResponseText": "Invalid card number" } } } }, "EPS": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Action could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "eps": { "providerResponseText": "Invalid account number" } } } }, "Floapay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Action failed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "floapay": { "providerResponseText": "The action failed.", "providerResponseCode": "101" } } } }, "Klarna": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "providerResponseCode": "101", "providerResponseText": "The transaction was declined due to insufficient funds in the account." } } } }, "PayPal": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "payPal": { "providerResponseCode": "05" } } } }, "Ratepay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "ratepay": { "providerDeclineCategory": "insufficient_funds", "providerResponseText": "The transaction was declined due to insufficient funds in the account.", "providerResponseCode": "101" } } } }, "Twint": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans001", "status": "FAILED", "responseDescription": "Payment could not be processed.", "responseCode": "422", "refNr": "REF20250910", "paymentMethods": { "twint": { "providerResponseText": "The transaction was declined due to insufficient funds in the account." } } } }, "UnionPay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Action could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "unionPay": { "providerResponseText": "Invalid account number" } } } }, "WeChat": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Action could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "weChat": { "providerResponseText": "Invalid account number" } } } } } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payments/refunds": { "post": { "tags": [ "Payments" ], "summary": "Refund payment without reference", "description": "This endpoint is used to refund a payment without reference.", "operationId": "refundExternalPayment", "parameters": [ { "name": "Idempotency-Key", "in": "header", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/refundExRequest" }, "examples": { "Card": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "24235345432", "amount": { "value": 10000, "currency": "EUR" }, "billingAddress": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" }, "shipping": { "address": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" } }, "statementDescriptor": "gadgets shop", "customerInfo": { "merchantCustomerId": "cus_1234567890abcdef", "customerType": "individual", "firstName": "Max", "lastName": "Mustermann", "email": "customer@example.com", "phone": { "countryCode": "+49", "number": "123654789" }, "birthDate": "2001-01-01" }, "browserInfo": { "acceptHeaders": "application/json, text/javascript, */*; q=0.01", "ipAddress": "192.168.1.1", "sessionId": "session1234567890" }, "paymentMethods": { "card": { "number": "4242424242424242", "cardholderName": "Max Mustermann", "expiryDate": "202701", "brand": "VISA", "securityCode": "123" } } } }, "DirectDebit": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "refNr": "6B29FC40-1067-B31D", "amount": { "value": 50000, "currency": "EUR", "taxTotal": 1500 }, "language": "DE", "billingAddress": { "firstName": "John", "lastName": "Doe", "streetName": "Main Street", "streetNumber": "123", "city": "Springfield", "postalCode": "12345", "country": "US", "addressLine2": "Apt 101", "addressLine3": "Building 1", "state": "IL" }, "shipping": { "address": { "addressLine2": "Apt 202", "addressLine3": "Building 2", "city": "Springfield", "postalCode": "12346", "state": "IL", "country": "US" }, "type": "CLICK_AND_COLLECT" }, "statementDescriptor": "Online Purchase", "customerInfo": { "merchantCustomerId": "6B29FC40-1067-B31D", "customerType": "individual", "firstName": "John", "lastName": "Doe", "email": "test@gmail.com", "phone": { "countryCode": "138", "number": "5551234567" }, "birthDate": "1985-06-15" }, "browserInfo": { "acceptHeaders": "application/json, text/javascript, */*; q=0.01", "ipAddress": "192.168.1.1", "sessionId": "session1234567890" }, "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "directDebit": { "account": { "number": "DE89370400440532013000", "code": "PBNKDEFFXXX", "bankName": "Bank of Example", "accountHolderName": "John Doe" } } } } } } } }, "required": true }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/refundExResponse" }, "examples": { "Card": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "trans-id-123", "status": "OK", "responseCode": 200, "responseDescription": "success", "refNr": "6729FC4093DA010662DA", "metadata": { "k1": "v1", "userData": "my user data", "k2": "v2", "plain": "some plain text", "k3": "v3" }, "paymentMethods": { "card": { "providerResponseCode": "APPROVED", "providerResponseText": "Transaction successfully synchronized.", "providerTransactionId": "CH1234567890XYZ", "providerApprovalCode": 200 } } } }, "Default": { "description": "", "value": { "merchantId": "test_merchant_id", "payId": "6c7c66e5352241c19d82c175a01f713a", "xId": "93c4093c6d3644fcb6c60484f7a831fd", "transId": "98582271-63d2-4b90-9422-5fb597a4c41d", "status": "OK", "responseCode": "00000000", "responseDescription": "success" } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "422": { "description": "Unprocessable Entity, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processingProblemDetails" }, "examples": { "Card": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "FAILED", "responseCode": "422", "responseDescription": "Payment could not be processed.", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "card": { "providerResponseCode": "51", "providerResponseText": "Invalid card number" } } } } } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payments/getByTransId/{id}": { "get": { "tags": [ "Payments" ], "summary": "Retrieve payment details by Transaction ID", "description": "This endpoint is used to retrieve payment details with the Transaction ID (transId).", "operationId": "getPaymentDetailsByTransactionId", "parameters": [ { "name": "id", "in": "path", "description": "ID of transaction", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/paymentDetailsResponse" }, "examples": { "Alipay": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "ALIPAY", "alipay": { "paymentGuarantee": "VALIDATED", "paymentPurpose": "Goods and services", "providerTransactionId": "alipay-transaction-id-20251016" } } } }, "AmazonPay": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "status": "SUCCESS", "responseDescription": "Transaction authorized successfully", "responseCode": "000000000", "amount": { "value": 1000, "capturedValue": 800, "refundedValue": 200 }, "customerInfo": { "firstName": "John", "phone": { "countryCode": "49", "number": "123654789" } }, "billingAddress": { "streetName": "Main Street 123", "postalCode": "10115", "city": "Berlin", "state": "BE", "country": "DE" }, "shipping": { "address": { "firstName": "Jane", "streetName": "Second Street 45", "postalCode": "20095", "city": "Hamburg", "state": "HH", "country": "DE", "phone": { "countryCode": "49", "number": "123654789" } } }, "paymentMethods": { "type": "AMAZONPAY", "amazonPay": { "buyerId": "amzn-buyer-001", "buyerName": "John Doe", "buyerEmail": "john.doe@example.com", "buyerPhoneNumber": "+49123456789", "merchantCountryCode": "EU", "amazonMerchantId": "amzn-merchant-999", "providerStatus": "Authorized", "redirectUrl": "https://www.example-shop.com/redirect", "checkoutSessionId": "session-987654321", "amazonPaymentDescriptor": "Amazon Pay Order #1234", "chargeId": "charge-123456", "chargePermissionId": "perm-654321" } } } }, "ApplePay": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "order": { "invoiceId": "ABC123", "merchantReference": "XYZ123" }, "customerInfo": { "merchantCustomerId": "XXX123" }, "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "APPLEPAY", "applePay": { "schemeReferenceId": "abc123xyz456" } } } }, "Bancontact": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "BANCONTACT", "bancontact": { "paymentPurpose": "Purchase of goods", "account": { "paymentGuarantee": "FULL" }, "providerResponseText": "Transaction approved", "providerTransactionId": "txn123456789", "first6Digits": "123456", "last4Digits": "7890", "expiryDate": "01.01.2025", "checkoutToken": "card-token-abc123xyz456" } } } }, "Bizum": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "paymentMethods": { "type": "BIZUM", "bizum": { "account": { "accountHolderName": "John Doe", "number": "DE89370400440532013000", "bankName": "Example Bank", "accountHolderIdentification": "ES12345678A", "accountNumber": "ES9121000418450200051332", "code": "COBADEFFXXX" }, "paymentGuarantee": "VALIDATED", "providerTransactionId": "bizum-transaction-id-20251016" } } } }, "Blik": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "BLIK", "blik": { "paymentPurpose": "Payment for Online Shopping", "paymentGuarantee": "VALIDATED", "providerResponseText": "Transaction Successful", "providerTransactionId": "blik-transaction-id-20251016" } } } }, "Boleto": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "BOLETO", "boleto": { "paymentSlipLink": "https://example.com/payment-form?transactionId=12345", "paymentGuarantee": "VALIDATED", "paymentPurpose": "Goods and services", "providerResponseText": "SUCCESS", "providerTransactionId": "boleto-transaction-id-20251016" } } } }, "Card": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "order": { "invoiceId": "ABC123", "merchantReference": "XYZ123" }, "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "CARD", "card": { "cardholderName": "John Doe", "pseudoCardNumber": "1234567890123456", "cardholderConsentToStore": true, "first6Digits": "123456", "last4Digits": "7890", "expiryDate": "01.01.2025", "brand": "visa", "product": "Business Premium Debit", "source": "CREDIT", "type": "Gold", "issuer": "Bank of Example", "country": "US", "bin": { "accountBin": "123456", "accountRangeLow": "100000", "accountRangeHigh": "999999" }, "versioningData": { "threeDSServerTransId": "server12345", "acsStartProtocolVersion": "1.0", "acsEndProtocolVersion": "2.1", "dsStartProtocolVersion": "1.0", "dsEndProtocolVersion": "2.1", "threeDSMethodDataForm": "POST", "threeDSMethodUrl": "https://method-url.com", "threeDSMethodData": { "threeDSMethodNotificationUrl": "https://notification-url.com", "threeDSServerTransId": "server12345" } }, "fraudData": { "zone": "US", "ipZone": "US", "ipZoneA2": "US", "ipState": "California", "ipCity": "San Francisco", "ipLongitude": "-122.4194", "ipLatitude": "37.7749", "fsStatus": "ACCEPT", "fsCode": "<0100>" }, "authenticationData": { "threeDSServerTransId": "server12345", "acsChallengeMandated": true, "acsDecConInd": false, "acsOperatorId": "operator123", "acsReferenceNumber": "ref12345", "acsRenderingType": { "acsInterface": "HTML", "acsUiTemplate": "template1" }, "acsSignedContent": "signedContentData", "acsTransId": "acsTrans123", "acsURL": "https://acs-url.com", "authenticationType": "3DS2", "authenticationValue": "authValue123", "broadInfo": "info", "cardholderInfo": "holder123", "dsReferenceNumber": "dsRef123", "dsTransId": "dsTrans123", "eci": "05", "messageExtension": "extensionData", "messageType": "Request", "messageVersion": "2.1", "sdkTransId": "sdkTrans123", "transStatus": "Success", "transStatusReason": "Transaction approved", "whiteListStatus": "Approved", "whiteListStatusSource": "Issuer", "challengeRequest": { "threeDSServerTransId": "server12345", "acsTransId": "acsTrans123", "challengeWindowSize": "04", "messageVersion": "2.1", "messageType": "Challenge" }, "base64EncodedChallengeRequest": "encodedData", "threeDSCompInd": "Y" }, "schemeReferenceId": "xyz123456", "providerApprovalCode": "APPROVED123", "providerResponseCode": "00", "providerResponseMessage": "Transaction approved", "providerTransactionId": "txn123456789", "providerToken": "token123456", "providerMerchantId": "merchant123", "providerTerminalId": "terminal123", "providerOrderId": "order123456", "issuerResponseCode": "00", "issuerResponseMessage": "Success", "dccInfo": { "dccSelected": true, "provider": "Nets", "rate": { "exchangeRate": "1,2313", "markupPercentage": "3,5", "timestamp": "20241129" }, "amounts": { "merchant": { "value": 10000, "currency": "EUR" }, "cardholder": { "value": 12313, "currency": "USD", "decimalValue": "123,13" } } } } } } }, "DirectDebit": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "DIRECTDEBIT", "directDebit": { "method": "ELV", "service": "Subscription Service", "sellingPoint": "Online Store", "mandateId": "SEPA123456789", "dateOfSignature": "2025-02-25", "account": { "code": "DE123456789", "number": "DE89370400440532013000", "pseudoBankNumber": "9876543210", "accountHolderName": "John Doe", "bankName": "Bank of Example" }, "providerResponseCode": "00", "providerResponseText": "Transaction successful" } } } }, "EasyCollect": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "EASYCOLLECT", "easyCollect": { "method": "ELV", "service": "Subscription Service", "sellingPoint": "Online Store", "mandateId": "SEPA123456789", "dateOfSignature": "2025-02-25", "account": { "code": "DE123456789", "number": "DE89370400440532013000", "pseudoBankNumber": "9876543210", "accountHolderName": "John Doe", "bankName": "Bank of Example" }, "providerResponseCode": "00", "providerResponseText": "Transaction successful" } } } }, "EPS": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "paymentMethods": { "type": "EPS", "eps": { "account": { "accountHolderName": "John Doe", "number": "DE89370400440532013000", "code": "COBADEFFXXX" }, "paymentGuarantee": "VALIDATED", "providerTransactionId": "eps-transaction-id-20251016" } } } }, "Floapay": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "FAILED", "responseCode": "2000000", "responseDescription": "failed", "refNr": "refNr01", "paymentMethods": { "type": "FLOAPAY", "floapay": { "providerResponseCode": "500", "providerResponseText": "Transaction failed" } } } }, "GooglePay": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "order": { "invoiceId": "ABC123", "merchantReference": "XYZ123" }, "customerInfo": { "merchantCustomerId": "XXX123" }, "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "GOOGLEPAY", "googlePay": { "schemeReferenceId": "abc123xyz456" } } } }, "Ideal": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103121913554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "IDEAL", "ideal": { "account": { "bankName": "Sample Bank", "accountHolderName": "John Doe", "number": "NL20INGB0001234567", "code": "INGBNL2A", "paymentGuarantee": "VALIDATED" }, "paymentPurpose": "Payment for Online Shopping", "providerResponseText": "Transaction Successful", "providerTransactionId": "trans1234567890" } } } }, "Instanea": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "amount": { "currency": "EUR", "value": 1000 }, "paymentMethods": { "type": "INSTANEA", "instanea": { "providerResponseText": "SUCCESS", "providerTransactionId": "t:Vxkm6qwHFATUqioF1WpScETzxyitTCdHSDG1j2ia5aa:ZhBVAJSH8DeU1" } } } }, "Klarna": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "KLARNA", "klarna": { "providerResponseCode": "200", "providerResponseText": "Transaction successful", "providerToken": "consumerToken12345", "providerTransactionId": "klarnaRef123456" } } } }, "Limonetik": { "description": "", "value": { "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "paymentMethods": { "type": "LIMONETIK", "limonetik": { "refPayId": "ed7773c09f314c45b2a0de47a1994e1d", "providerTransaction": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "fundingSources": [ { "type": "PaperVoucher", "brand": "e-Chèque Vacances - ANCV", "authorizedAmount": 5000 }, { "type": "PaperVoucher", "brand": "e-Chèque Vacances - ANCV", "authorizedAmount": 5000 } ] } } } }, "MbWay": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "MBWAY", "mbWay": { "account": { "paymentGuarantee": "VALIDATED", "paymentPurpose": "Goods and services", "providerTransactionId": "mbWay-transaction-id-20251016" } } } } }, "Multibanco": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "MULTIBANCO", "multibanco": { "paymentGuarantee": "VALIDATED", "paymentPurpose": "Goods and services", "providerTransactionId": "multibanco-transaction-id-20251016" } } } }, "MyBank": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "MYBANK", "myBank": { "paymentGuarantee": "VALIDATED", "paymentPurpose": "Goods and services", "providerTransactionId": "mybank-transaction-id-20251016" } } } }, "PayPal": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "PAYPAL", "payPal": { "orderId": "PAY123456789", "providerResponseCode": "200", "payerStatus": "VERIFIED", "infoText": "Transaction successful", "payerId": "A1B2C3D4E5F6", "grossAmount": "100.00", "feeAmount": "2.50", "settleAmount": "97.50", "taxAmount": "5.00", "exchangeRate": "1.12", "mcFee": "2.50", "mcGross": "102.50", "providerCaptureId": "CAPTURE123456789" } } } }, "pfConnect": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "PFCONNECT", "pfConnect": { "providerResponseCode": "200", "providerResponseText": "Transaction successful", "applicationId": "PFConnect-12345-ABCDE" } } } }, "przelewy24": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "FAILED", "responseDescription": "failed", "responseCode": "2000000", "refNr": "REF123456", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "PRZELEWY24", "przelewy24": { "subType": "PAY_LATER", "paymentPurpose": "Payment for Online Shopping", "providerResponseText": "Transaction Failed", "paymentGuarantee": "NONE", "providerTransactionId": "P24-987654321" } } } }, "Ratepay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "type": "RATEPAY", "ratepay": { "authorizationExpiry": "2025-05-22T14:30:00+02:00", "account": { "bankName": "Sample Bank", "code": "DE1234567890", "number": "DE89370400440532013000", "accountHolderName": "John Doe" }, "paymentReference": "Invoice #12345", "providerTransactionId": "txn-9876543210" } } } }, "Riverty": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "RIVERTY", "riverty": { "providerResponseCode": 200, "providerResponseText": "Transaction successful", "subType": "INVOICE", "billingCareOf": "Jane c/o John", "shippingCareOf": "John c/o Jane", "account": { "code": "DE123456789", "number": "DE12345678901234567890" }, "profileNumber": "PROF123456", "orderRisk": { "channelType": "INTERNET", "deliveryType": "NORMAL", "ticketDeliveryMethod": "POST" }, "customerRisk": { "existingCustomer": true, "verifiedCustomerIdentification": true, "marketingOptIn": false, "customerSince": "01.01.2020", "customerClassification": "VIP", "acquistionChannel": "ADVERTISEMENT", "hasCustomerCard": true, "customerCardSince": "05.05.2021", "customerCardClassification": "Gold Member", "profileTrackingId": "TRACK123456", "numberOfTransactions": 15, "customerIndividualScore": 85, "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36", "amountOfTransactions": 5000, "otherpaymentMethod": false } } } } }, "Twint": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "type": "TWINT", "twint": { "paymentPurpose": "Purchase of goods", "paymentGuarantee": "FULL", "providerResponseText": "Transaction approved", "providerTransactionId": "txn-9876543210" } } } }, "UnionPay": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "UNIONPAY", "unionPay": { "paymentGuarantee": "VALIDATED", "paymentPurpose": "Invoice payment", "providerTransactionId": "unionPay-transaction-id-20251016" } } } }, "WeChat": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "WECHAT", "weChat": { "paymentGuarantee": "VALIDATED", "paymentPurpose": "Goods and services", "providerTransactionId": "weChat-transaction-id-20251016" } } } }, "Wero": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "type": "WERO", "wero": { "walletId": "WALLET_987654321", "payplan": "payplan_test", "consentId": "AMB-1058479328", "paymentId": "AMB-1058479328", "captureId": "XXZ-7947204730", "refundId": "PTL-64927490573" } } } } } } } }, "400": { "description": "Invalid ID supplied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "404": { "description": "Payment not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processingNotFoundProblemDetails" }, "examples": { "Default": { "description": "", "value": { "merchantId": "test_merchant_id", "payId": "00000000000000000000000000000000", "xId": "", "transId": "ed7773c09f314c45b2a0de47a1994e1d", "refNr": "", "status": "FAILED", "responseCode": "20600061", "responseDescription": "PAYMENT NOT FOUND" } } } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payments/getByPayId/{id}": { "get": { "tags": [ "Payments" ], "summary": "Retrieve payment details by Payment ID", "description": "Returns all details about existing payment.", "operationId": "getPaymentDetailsByPaymentId", "parameters": [ { "name": "id", "in": "path", "description": "ID of payment", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/paymentDetailsResponse" }, "examples": { "Alipay": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "ALIPAY", "alipay": { "paymentGuarantee": "VALIDATED", "paymentPurpose": "Goods and services", "providerTransactionId": "alipay-transaction-id-20251016" } } } }, "AmazonPay": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "status": "SUCCESS", "responseDescription": "Transaction authorized successfully", "responseCode": "000000000", "amount": { "value": 1000, "capturedValue": 800, "refundedValue": 200 }, "customerInfo": { "firstName": "John", "phone": { "countryCode": "49", "number": "123654789" } }, "billingAddress": { "streetName": "Main Street 123", "postalCode": "10115", "city": "Berlin", "state": "BE", "country": "DE" }, "shipping": { "address": { "firstName": "Jane", "streetName": "Second Street 45", "postalCode": "20095", "city": "Hamburg", "state": "HH", "country": "DE", "phone": { "countryCode": "49", "number": "123654789" } } }, "paymentMethods": { "type": "AMAZONPAY", "amazonPay": { "buyerId": "amzn-buyer-001", "buyerName": "John Doe", "buyerEmail": "john.doe@example.com", "buyerPhoneNumber": "+49123456789", "merchantCountryCode": "EU", "amazonMerchantId": "amzn-merchant-999", "providerStatus": "Authorized", "redirectUrl": "https://www.example-shop.com/redirect", "checkoutSessionId": "session-987654321", "amazonPaymentDescriptor": "Amazon Pay Order #1234", "chargeId": "charge-123456", "chargePermissionId": "perm-654321" } } } }, "ApplePay": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "order": { "invoiceId": "ABC123", "merchantReference": "XYZ123" }, "customerInfo": { "merchantCustomerId": "XXX123" }, "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "APPLEPAY", "applePay": { "schemeReferenceId": "abc123xyz456" } } } }, "Bancontact": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "BANCONTACT", "bancontact": { "paymentPurpose": "Purchase of goods", "account": { "paymentGuarantee": "FULL" }, "providerResponseText": "Transaction approved", "providerTransactionId": "txn123456789", "first6Digits": "123456", "last4Digits": "7890", "expiryDate": "01.01.2025", "checkoutToken": "card-token-abc123xyz456" } } } }, "Bizum": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "paymentMethods": { "type": "BIZUM", "bizum": { "account": { "accountHolderName": "John Doe", "number": "DE89370400440532013000", "bankName": "Example Bank", "accountHolderIdentification": "ES12345678A", "accountNumber": "ES9121000418450200051332", "code": "COBADEFFXXX" }, "paymentGuarantee": "VALIDATED", "providerTransactionId": "bizum-transaction-id-20251016" } } } }, "Blik": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "BLIK", "blik": { "paymentPurpose": "Payment for Online Shopping", "paymentGuarantee": "VALIDATED", "providerResponseText": "Transaction Successful", "providerTransactionId": "blik-transaction-id-20251016" } } } }, "Boleto": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "BOLETO", "boleto": { "paymentSlipLink": "https://example.com/payment-form?transactionId=12345", "paymentGuarantee": "VALIDATED", "paymentPurpose": "Goods and services", "providerTransactionId": "boleto-transaction-id-20251016" } } } }, "Card": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "order": { "invoiceId": "ABC123", "merchantReference": "XYZ123" }, "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "CARD", "card": { "cardholderName": "John Doe", "pseudoCardNumber": "1234567890123456", "cardholderConsentToStore": true, "first6Digits": "123456", "last4Digits": "7890", "expiryDate": "01.01.2025", "brand": "visa", "product": "Business Premium Debit", "source": "CREDIT", "type": "Gold", "issuer": "Bank of Example", "country": "US", "bin": { "accountBin": "123456", "accountRangeLow": "100000", "accountRangeHigh": "999999" }, "versioningData": { "threeDSServerTransId": "server12345", "acsStartProtocolVersion": "1.0", "acsEndProtocolVersion": "2.1", "dsStartProtocolVersion": "1.0", "dsEndProtocolVersion": "2.1", "threeDSMethodDataForm": "POST", "threeDSMethodUrl": "https://method-url.com", "threeDSMethodData": { "threeDSMethodNotificationUrl": "https://notification-url.com", "threeDSServerTransId": "server12345" } }, "fraudData": { "zone": "US", "ipZone": "US", "ipZoneA2": "US", "ipState": "California", "ipCity": "San Francisco", "ipLongitude": "-122.4194", "ipLatitude": "37.7749", "fsStatus": "ACCEPT", "fsCode": "<0100>" }, "authenticationData": { "threeDSServerTransId": "server12345", "acsChallengeMandated": true, "acsDecConInd": false, "acsOperatorId": "operator123", "acsReferenceNumber": "ref12345", "acsRenderingType": { "acsInterface": "HTML", "acsUiTemplate": "template1" }, "acsSignedContent": "signedContentData", "acsTransId": "acsTrans123", "acsURL": "https://acs-url.com", "authenticationType": "3DS2", "authenticationValue": "authValue123", "broadInfo": "info", "cardholderInfo": "holder123", "dsReferenceNumber": "dsRef123", "dsTransId": "dsTrans123", "eci": "05", "messageExtension": "extensionData", "messageType": "Request", "messageVersion": "2.1", "sdkTransId": "sdkTrans123", "transStatus": "Success", "transStatusReason": "Transaction approved", "whiteListStatus": "Approved", "whiteListStatusSource": "Issuer", "challengeRequest": { "threeDSServerTransId": "server12345", "acsTransId": "acsTrans123", "challengeWindowSize": "04", "messageVersion": "2.1", "messageType": "Challenge" }, "base64EncodedChallengeRequest": "encodedData", "threeDSCompInd": "Y" }, "schemeReferenceId": "xyz123456", "providerApprovalCode": "APPROVED123", "providerResponseCode": "00", "providerResponseMessage": "Transaction approved", "providerTransactionId": "txn123456789", "providerToken": "token123456", "providerMerchantId": "merchant123", "providerTerminalId": "terminal123", "providerOrderId": "order123456", "issuerResponseCode": "00", "issuerResponseMessage": "Success", "dccInfo": { "dccSelected": true, "provider": "Nets", "rate": { "exchangeRate": "1,2313", "markupPercentage": "3,5", "timestamp": "20241129" }, "amounts": { "merchant": { "value": 10000, "currency": "EUR" }, "cardholder": { "value": 12313, "currency": "USD", "decimalValue": "123,13" } } } } } } }, "DirectDebit": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "DIRECTDEBIT", "directDebit": { "method": "ELV", "service": "Subscription Service", "sellingPoint": "Online Store", "mandateId": "SEPA123456789", "dateOfSignature": "2025-05-22", "account": { "code": "DE123456789", "number": "DE89370400440532013000", "pseudoBankNumber": "9876543210", "accountHolderName": "John Doe", "bankName": "Bank of Example" }, "providerResponseCode": "00", "providerResponseText": "Transaction successful" } } } }, "EasyCollect": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "EASYCOLLECT", "easyCollect": { "method": "ELV", "service": "Subscription Service", "sellingPoint": "Online Store", "mandateId": "SEPA123456789", "dateOfSignature": "2025-02-25", "account": { "code": "DE123456789", "number": "DE89370400440532013000", "pseudoBankNumber": "9876543210", "accountHolderName": "John Doe", "bankName": "Bank of Example" }, "providerResponseCode": "00", "providerResponseText": "Transaction successful" } } } }, "EPS": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "paymentMethods": { "type": "EPS", "eps": { "account": { "accountHolderName": "John Doe", "number": "DE89370400440532013000", "code": "COBADEFFXXX" }, "paymentGuarantee": "VALIDATED", "providerTransactionId": "eps-transaction-id-20251016" } } } }, "Floapay": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "FAILED", "responseCode": "2000000", "responseDescription": "failed", "refNr": "refNr01", "paymentMethods": { "type": "FLOAPAY", "floapay": { "providerResponseCode": "500", "providerResponseText": "Transaction failed" } } } }, "GooglePay": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "order": { "invoiceId": "ABC123", "merchantReference": "XYZ123" }, "customerInfo": { "merchantCustomerId": "XXX123" }, "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "GOOGLEPAY", "googlePay": { "schemeReferenceId": "abc123xyz456" } } } }, "Ideal": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103121913554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "IDEAL", "ideal": { "account": { "bankName": "Sample Bank", "accountHolderName": "John Doe", "number": "NL20INGB0001234567", "code": "INGBNL2A", "paymentGuarantee": "VALIDATED" }, "paymentPurpose": "Payment for Online Shopping", "providerResponseText": "Transaction Successful", "providerTransactionId": "trans1234567890" } } } }, "Instanea": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "amount": { "currency": "EUR", "value": 1000 }, "paymentMethods": { "type": "INSTANEA", "instanea": { "providerResponseText": "SUCCESS", "providerTransactionId": "t:Vxkm6qwHFATUqioF1WpScETzxyitTCdHSDG1j2ia5aa:ZhBVAJSH8DeU1" } } } }, "Klarna": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "KLARNA", "klarna": { "providerResponseCode": "200", "providerResponseText": "Transaction successful", "providerToken": "consumerToken12345", "providerTransactionId": "klarnaRef123456" } } } }, "Limonetik": { "description": "", "value": { "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "paymentMethods": { "type": "LIMONETIK", "limonetik": { "refPayId": "ed7773c09f314c45b2a0de47a1994e1d", "providerTransaction": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "fundingSources": [ { "type": "PaperVoucher", "brand": "e-Chèque Vacances - ANCV", "authorizedAmount": 5000 }, { "type": "PaperVoucher", "brand": "e-Chèque Vacances - ANCV", "authorizedAmount": 5000 } ] } } } }, "MbWay": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "MBWAY", "mbWay": { "account": { "paymentGuarantee": "VALIDATED", "paymentPurpose": "Goods and services", "providerTransactionId": "mbWay-transaction-id-20251016" } } } } }, "Multibanco": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "MULTIBANCO", "multibanco": { "paymentGuarantee": "VALIDATED", "paymentPurpose": "Goods and services", "providerResponseText": "SUCCESS", "providerTransactionId": "multibanco-transaction-id-20251016" } } } }, "MyBank": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "MYBANK", "myBank": { "paymentGuarantee": "VALIDATED", "paymentPurpose": "Goods and services", "providerResponseText": "SUCCESS", "providerTransactionId": "mybank-transaction-id-20251016" } } } }, "PayPal": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "PAYPAL", "payPal": { "orderId": "PAY123456789", "providerResponseCode": "200", "payerStatus": "VERIFIED", "infoText": "Transaction successful", "payerId": "A1B2C3D4E5F6", "grossAmount": "100.00", "feeAmount": "2.50", "settleAmount": "97.50", "taxAmount": "5.00", "exchangeRate": "1.12", "mcFee": "2.50", "mcGross": "102.50", "providerCaptureId": "CAPTURE123456789" } } } }, "pfConnect": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "PFCONNECT", "pfConnect": { "providerResponseCode": "200", "providerResponseText": "Transaction successful", "applicationId": "PFConnect-12345-ABCDE" } } } }, "przelewy24": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "FAILED", "responseDescription": "failed", "responseCode": "2000000", "refNr": "REF123456", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "PRZELEWY24", "przelewy24": { "subType": "PAY_LATER", "paymentPurpose": "Payment for Online Shopping", "providerResponseText": "Transaction Failed", "paymentGuarantee": "NONE", "providerTransactionId": "P24-987654321" } } } }, "Ratepay": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "type": "RATEPAY", "ratepay": { "authorizationExpiry": "2025-05-22T14:30:00+02:00", "account": { "bankName": "Sample Bank", "code": "DE1234567890", "number": "DE89370400440532013000", "accountHolderName": "John Doe" }, "paymentReference": "Invoice #12345", "providerTransactionId": "txn-9876543210" } } } }, "Riverty": { "description": "", "value": { "amount": { "currency": "EUR", "value": 1000 }, "externalIntegrationId": "12345-abcde-67890-fghij", "language": "en", "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "RIVERTY", "riverty": { "providerResponseCode": 200, "providerResponseText": "Transaction successful", "subType": "INVOICE", "billingCareOf": "Jane c/o John", "shippingCareOf": "John c/o Jane", "account": { "code": "DE123456789", "number": "DE12345678901234567890" }, "profileNumber": "PROF123456", "orderRisk": { "channelType": "INTERNET", "deliveryType": "NORMAL", "ticketDeliveryMethod": "POST" }, "customerRisk": { "existingCustomer": true, "verifiedCustomerIdentification": true, "marketingOptIn": false, "customerSince": "01.01.2020", "customerClassification": "VIP", "acquistionChannel": "ADVERTISEMENT", "hasCustomerCard": true, "customerCardSince": "05.05.2021", "customerCardClassification": "Gold Member", "profileTrackingId": "TRACK123456", "numberOfTransactions": 15, "customerIndividualScore": 85, "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36", "amountOfTransactions": 5000, "otherpaymentMethod": false } } } } }, "Twint": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "type": "TWINT", "twint": { "paymentPurpose": "Purchase of goods", "paymentGuarantee": "FULL", "providerResponseText": "Transaction approved", "providerTransactionId": "txn-9876543210" } } } }, "UnionPay": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "UNIONPAY", "unionPay": { "paymentGuarantee": "VALIDATED", "paymentPurpose": "Invoice payment", "providerTransactionId": "unionPay-transaction-id-20251016" } } } }, "WeChat": { "description": "", "value": { "payId": "ed7773c09f314c45b2a0de47a1994e1d", "xId": "86a8198cc9da4b4d9fbcdb15a5ddd6ca", "transId": "20240103-121913-554", "merchantId": "MerchantIdTest", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "refNr01", "metadata": { "userData": "my user data", "plain": "some plain text", "key1": "value1", "key2": "value2" }, "paymentMethods": { "type": "WECHAT", "weChat": { "paymentGuarantee": "VALIDATED", "paymentPurpose": "Goods and services", "providerTransactionId": "weChat-transaction-id-20251016" } } } }, "Wero": { "description": "", "value": { "merchantId": "MerchantIdTest", "payId": "6B29FC4093DD010662DE", "xId": "6B29FC4093DD010662DB", "transId": "6B29FC4093DD010662DC", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "refNr": "6C21FC4093DD0108765", "paymentMethods": { "type": "WERO", "wero": { "walletId": "WALLET_987654321", "payplan": "payplan_test", "consentId": "AMB-1058479328", "paymentId": "AMB-1058479328", "captureId": "XXZ-7947204730", "refundId": "PTL-64927490573" } } } } } } } }, "400": { "description": "Invalid ID supplied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "404": { "description": "Payment not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processingNotFoundProblemDetails" }, "examples": { "Default": { "description": "", "value": { "merchantId": "test_merchant_id", "payId": "00000000000000000000000000000000", "xId": "", "transId": "ed7773c09f314c45b2a0de47a1994e1d", "refNr": "", "status": "FAILED", "responseCode": "20600061", "responseDescription": "PAYMENT NOT FOUND" } } } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payments/{id}": { "patch": { "tags": [ "Payments" ], "summary": "Update payment details", "description": "Update details about existing payment.", "operationId": "updatePaymentDetails", "parameters": [ { "name": "id", "in": "path", "description": "PayId assigned by Axepta Online in the initial request.", "required": true, "schema": { "type": "string" } }, { "name": "Idempotency-Key", "in": "header", "description": "A unique key provided by you to ensure that a particular operation is not processed multiple times in case of retries.", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updateRequest" }, "examples": { "AmazonPay": { "description": "", "value": { "amount": { "value": 1000, "currency": "EUR" }, "paymentMethods": { "amazonPay": { "merchantCountryCode": "EU" } } } }, "Default": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1000, "currency": "USD" }, "refNr": "unique-reference-number-91011", "billingAddress": { "streetName": "Main St", "streetNumber": "123", "city": "New York", "postalCode": "10001", "country": "USA", "addressLine2": "Suite 4B", "addressLine3": "Building 12", "state": "NY" }, "shipping": { "address": { "streetName": "Park Ave", "streetNumber": "456", "city": "New York", "postalCode": "10002", "country": "USA", "addressLine2": "Apt 7C", "addressLine3": "Apt 4B", "state": "NY" }, "type": "CLICK_AND_COLLECT" }, "eventToken": "UPDATE_ORDER_DETAILS" } }, "Klarna": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "amount": { "value": 1000, "currency": "USD" }, "refNr": "unique-reference-number-91011", "shipping": { "address": { "streetName": "Park Ave", "streetNumber": "456", "city": "New York", "postalCode": "10002", "country": "USA", "addressLine2": "Apt 7C", "addressLine3": "Apt 4B", "state": "NY" }, "type": "CLICK_AND_COLLECT" }, "customerInfo": { "title": "Dr", "firstName": "Emily", "lastName": "Thompson", "companyName": "Thompson Health Solutions", "email": "test@gmail.com", "phone": { "countryCode": "49", "number": "321654789" } }, "eventToken": "UPDATE_ADDRESS" } } } } }, "required": true }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/updateResponse" }, "examples": { "Default": { "description": "", "value": { "merchantId": "test_merchant_id", "payId": "6c7c66e5352241c19d82c175a01f713a", "xId": "93c4093c6d3644fcb6c60484f7a831fd", "transId": "98582271-63d2-4b90-9422-5fb597a4c41d", "status": "OK", "responseCode": "00000000", "responseDescription": "success" } }, "Klarna": { "description": "", "value": { "payId": "1234567890abcdef", "merchantId": "merchant_987654321", "transId": "6B29FC40-1067-B31D-00DD010662DA", "xId": "xId_67890", "refNr": "ref_54321", "status": "AUTHORIZED", "responseDescription": "Transaction approved.", "responseCode": 200, "paymentMethods": { "klarna": { "providerResponseCode": "200", "providerResponseText": "Klarna payment approved." } } } }, "PayPal": { "description": "", "value": { "payId": "1234567890abcdef", "merchantId": "merchant_987654321", "transId": "6B29FC40-1067-B31D-00DD010662DA", "xId": "xId_67890", "refNr": "ref_54321", "status": "AUTHORIZED", "responseDescription": "Transaction approved.", "responseCode": 200, "paymentMethods": { "payPal": { "providerResponseCode": 200 } } } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "404": { "description": "Payment not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payments/links": { "post": { "tags": [ "Payments" ], "summary": "Create payment link", "description": "This endpoint allows you to generate a payment link that can be shared with customers via email, SMS, or other channels. When customers click the link, they are redirected to a hosted payment page where they can select their preferred payment method and complete the transaction.", "operationId": "createPaymentLink", "parameters": [ { "name": "Idempotency-Key", "in": "header", "description": "A unique key provided by you to ensure that a particular operation is not processed multiple times in case of retries.", "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/linkRequest" }, "examples": { "Example": { "description": "", "value": { "transId": "6B29FC40-1067-B31D-00DD010662DA", "partialPayment": false, "refNr": "24235345432", "amount": { "currency": "EUR", "value": 10000 }, "language": "de", "template": { "name": "hpp_template", "customFields": { "customField1": "Field 1 Data", "customField2": "Field 2 Data", "customField3": "Field 3 Data", "customField4": "Field 4 Data", "customField5": "Field 5 Data", "customField6": "Field 6 Data", "customField7": "Field 7 Data", "customField8": "Field 8 Data", "customField9": "Field 9 Data", "customField10": "Field 10 Data", "customField11": "Field 11 Data", "customField12": "Field 12 Data", "customField13": "Field 13 Data", "customField14": "Field 14 Data" } }, "captureMethod": { "type": "AUTOMATIC" }, "order": { "merchantReference": "112-445-34567", "numberOfArticles": 1, "creationDate": "2025-03-31T11:58:37Z", "invoiceId": "555-333-2222", "items": [ { "id": "1", "sku": "19-402-DEU", "name": "BatteryPowerPack", "quantity": 1, "quantityUnit": "pcs", "taxRate": 0, "netPrice": 1000, "grossPrice": 1000, "taxAmount": 0, "discountAmount": 0, "description": "BatteryPowerPack", "type": "physical", "productInfo": { "brand": "Intel", "categories": [ "Electronics Store", "Computers", "Desktops" ], "globalTradeItemNumber": "EAN", "manufacturerPartNumber": "BOXNUC5CPYA", "imageUrl": "https://www.exampleobjects.com/logo.png", "productUrl": "https://www.estore.com/products/f2a8d7e34" } } ] }, "urls": { "return": "https://my.callback.url.com/success", "cancel": "https://my.callback.url.com/cancel", "webhook": "https://my.callback.url.com/webhook" }, "billingAddress": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" }, "shipping": { "address": { "streetName": "Schwarzenbergstr", "streetNumber": "4", "city": "Bamberg", "country": "DEU", "postalCode": "96050" } }, "statementDescriptor": "gadgets shop", "customerInfo": { "merchantCustomerId": "cus_1234567890abcdef", "customerType": "individual", "firstName": "Max", "lastName": "Mustermann", "email": "customer@example.com", "phone": { "countryCode": "+49", "number": "1236547890" }, "salutation": "Ms", "title": "Dr", "gender": "female", "maidenName": "Mustermann", "middleName": "sam", "birthDate": "2001-01-01", "birthPlace": "Bamberg", "socialSecurityNumber": "123443534" }, "invoiceAttachment": "JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFsgMyAwIFIgXSAvQ291bnQgMSA+PgplbmRvYmoKMyAwIG9iago8PCAvVHlwZSAvUGFnZSAvUGFyZW50IDIgMCBSIC9NZWRpYUJveCBbMCAwIDMwMCAxNDQgXSAvQ29udGVudHMgNCAwIFIgL1Jlc291cmNlcyA8PCAvRm9udCA8PCAvRjEgNSAwIFIgPj4gPj4gPj4KZW5kb2JqCjQgMCBvYmoKPDwgL0xlbmd0aCA0NCA+PgpzdHJlYW0KQlQgL0YxIDEyIFRmIDUwIDgwIFRkIChUZXN0IFBERikgVGogRVQKZW5kc3RyZWFtCmVuZG9iago1IDAgb2JqCjw8IC9UeXBlIC9Gb250IC9TdWJ0eXBlIC9UeXBlMSAvQmFzZUZvbnQgL0hlbHZldGljYSA+PgplbmRvYmoKeHJlZgowIDYKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDkzIDAwMDAwIG4gCjAwMDAwMDAxNjQgMDAwMDAgbiAKMDAwMDAwMDI3NSAwMDAwMCBuIAowMDAwMDAwNDY2IDAwMDAwIG4gCjAwMDAwMDA1NzUgMDAwMDAgbiAKdHJhaWxlcgo8PCAvU2l6ZSA2IC9Sb290IDEgMCBSID4+CnN0YXJ0eHJlZgo2ODQKJSVFT0YK", "invoiceAttachmentName": "test.pdf", "allowedPaymentMethods": [ "BANCONTACT", "BOLETO", "CARD", "DIRECTDEBIT", "EASYCOLLECT", "EPS", "INSTANEA", "KLARNA", "MULTIBANCO", "MYBANK", "PAYPAL", "PRZELEWY24", "TRUSTLY", "TWINT", "VIPPSMOBILEPAY", "WERO" ], "paymentMethods": { "bancontact": { "x-bancontact": true, "sellingPoint": "Online Store", "account": { "accountHolderName": "Max Mustermann" }, "checkoutToken": "UlkWjd0MDNwUWs2r45fwf43" }, "boleto": { "x-boleto": true, "service": "BatteryPowerPack" }, "card": { "subType": [ "VISA", "MASTERCARD" ], "template": { "name": "card_template", "fontSize": 11, "textColor": "#FFFFFF", "customFields": { "customField1": "Field 1 Data", "customField2": "Field 2 Data", "customField3": "Field 3 Data", "customField4": "Field 4 Data", "customField5": "Field 5 Data", "customField6": "Field 6 Data", "customField7": "Field 7 Data", "customField8": "Field 8 Data", "customField9": "Field 9 Data", "customField10": "Field 10 Data", "customField11": "Field 11 Data", "customField12": "Field 12 Data", "customField13": "Field 13 Data", "customField14": "Field 14 Data" } } }, "directDebit": { "x-directdebit": true, "method": "ELV", "debitDelay": 2, "sellingPoint": "Online Store", "template": { "name": "direct_debit_template", "backgroundColor": "#0000FF", "backgroundImage": "https://example.com/background.jpg", "textColor": "#FFFFFF", "fontName": "Arial", "fontSize": 14, "tableWidth": 600, "tableHeight": 400, "customFields": { "customField1": "Field 1 Data", "customField2": "Field 2 Data", "customField3": "Field 3 Data", "customField4": "Field 4 Data", "customField5": "Field 5 Data", "customField6": "Field 6 Data", "customField7": "Field 7 Data", "customField8": "Field 8 Data", "customField9": "Field 9 Data", "customField10": "Field 10 Data", "customField11": "Field 11 Data", "customField12": "Field 12 Data", "customField13": "Field 13 Data", "customField14": "Field 14 Data" } } }, "easyCollect": { "x-easycollect": true, "accountId": "test_account_123", "contractId": "CTR-20250609-001", "contractDescription": "Direct debit authorization for monthly service fee", "businessIdentifier": "DE123456789", "signatureAgreementType": "SMS", "documentSignature": true, "googleAnalyticsConsent": true, "signatureBySca": false, "sps": true, "validation": true, "customerType": "KNOWN", "mandateType": "CORE", "eventToken": "PAYMENT_ONLY", "dueDate": "2025-07-15", "mandateId": "MANDATE123456789", "signerPositionOccupied": "Chief Financial Officer", "template": { "name": "standard-template" } }, "floapay": { "x-floapay": true, "merchantShopUrl": "https://merchant.com/shop", "travelDetails": { "travelType": "TWO_WAY", "departureDate": "2023-05-12T11:40", "returnDate": "2023-05-20T19:20" } }, "instanea": { "x-instanea": true, "subType": "SEPA_INSTANT", "returnRefundAccount": true }, "klarna": { "layout": { "showSubTotalDetail": "HIDE", "logoUrl": "https://example.com/logo.svg", "pageTitle": "Secure Payment with Klarna" }, "accountId": "exmple_id", "enhancedData": [ { "productCategory": "Test product category", "productName": "Test product name" } ] }, "multibanco": { "sellingPoint": "sp", "account": { "accountHolder": "John Doe" } }, "myBank": { "x-mybank": true, "sellingPoint": "sp", "account": { "accountHolderName": "John Doe" } }, "payPal": { "accountId": "customer@example.com", "hideAddress": false }, "przelewy24": { "x-przelewy24": true, "subType": "BLIK", "authenticationCode": "123456", "termsAndConditions": true, "sellingPoint": "sp", "account": { "accountHolderName": "John Doe" } }, "trustly": { "x-trustly": true, "templateUrl": "https://trustly.com/payment-template/abc123" }, "twint": { "x-twint": true, "sellingPoint": "Post office", "service": "DHL", "account": { "accountHolderName": "John Doe" } }, "vippsMobilePay": { "x-vippsmobilepay": true, "minAge": 21, "termUrl": "https://example.com/manage-agreement", "billingAgreementId": "BA123456789", "eventToken": "RECURRING_AGREEMENT", "campaign": { "type": "EVENT_CAMPAIGN", "price": 9999, "end": "2025-12-31", "period": { "unit": "MONTH", "count": 12 }, "eventDate": "2025-12-25", "eventText": "Christmas Discount" } }, "eps": { "account": { "accountHolderName": "John Doe", "number": "DE89370400440532013000", "code": "COBADEFFXXX" }, "optionDate": "2025-10-20", "sellingPoint": "Some selling point", "service": "Some service" } } } } } } }, "required": true }, "responses": { "202": { "description": "Accepted", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/linkResponse" }, "examples": { "Live Environment": { "description": "", "value": { "_links": { "redirect": { "href": "https://paymentpage.axepta.bnpparibas?token=7186c6fbec6d43d3b1b731dff5497ffe", "type": "text/html" } } } }, "Test Environment": { "description": "", "value": { "_links": { "redirect": { "href": "https://test.paymentpage.axepta.bnpparibas?token=7186c6fbec6d43d3b1b731dff5497ffe", "type": "text/html" } } } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "422": { "description": "Unprocessable Entity, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/processingProblemDetails" } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payment-plans/{paymentPlanId}/charge": { "post": { "tags": [ "PaymentPlans" ], "summary": "Create payment within payment plan", "description": "Create payment within payment plan", "operationId": "chargePaymentPlan", "parameters": [ { "name": "paymentPlanId", "in": "path", "description": "The Id of payment plan", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/paymentPlansChargeRequest" } } }, "required": true }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/createChargeApiResponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payment-plans/{paymentPlanId}/cancel": { "post": { "tags": [ "PaymentPlans" ], "summary": "Cancel payment plan", "description": "Cancel payment plan", "operationId": "cancelPaymentPlan", "parameters": [ { "name": "paymentPlanId", "in": "path", "description": "The Id of payment plan", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/paymentPlansCancelSuccessResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payment-plans": { "get": { "tags": [ "PaymentPlans" ], "summary": "Get list of payment plans", "description": "Get list of payment plans", "operationId": "getPaymentPlans", "parameters": [ { "name": "Page", "in": "query", "description": "Specifies page number", "schema": { "type": "integer", "format": "int32", "example": 2 } }, { "name": "CreatedAtFrom", "in": "query", "description": "The createdAt date time lower limit", "schema": { "format": "date-time", "example": "2025-05-12" } }, { "name": "CreatedAtTo", "in": "query", "description": "The createdAt date time upper limit", "schema": { "format": "date-time", "example": "2025-05-15" } }, { "name": "LastBillingFrom", "in": "query", "description": "The last billing date time lower limit", "schema": { "format": "date-time", "example": "2025-05-12" } }, { "name": "LastBillingTo", "in": "query", "description": "The last billing date time upper limit", "schema": { "format": "date-time", "example": "2025-05-15" } }, { "name": "PaymentPlanId", "in": "query", "description": "The Id of payment plan", "schema": { "type": "string", "example": "c12e7a1524d2462fabf0839a7cf7dd09" } }, { "name": "MerchantCustomerId", "in": "query", "description": "The merchant customer id", "schema": { "type": "string", "example": "Test_Merchant" } }, { "name": "Currency", "in": "query", "description": "Currency", "schema": { "type": "string", "example": "EUR" } }, { "name": "AmountFrom", "in": "query", "description": "Lower limit of the amount", "schema": { "type": "integer", "format": "int32", "example": 100 } }, { "name": "AmountTo", "in": "query", "description": "Upper limit of the amount", "schema": { "type": "integer", "format": "int32", "example": 100 } }, { "name": "Amount", "in": "query", "description": "Exact amount value", "schema": { "type": "integer", "format": "int32", "example": 100 } }, { "name": "PlanStatus", "in": "query", "description": "Payment plan status", "schema": { "enum": [ "ACTIVE", "CANCELLED", "INVALID", "COMPLETED", "RETRY" ], "type": "string", "example": "ACTIVE" } }, { "name": "PlanType", "in": "query", "description": "Payment plan status", "schema": { "enum": [ "RECURRING", "INSTALLMENTS", "DELAYED_SHIPMENT", "UNSCHEDULED_MIT" ], "type": "string", "example": "RECURRING" } } ], "responses": { "200": { "description": "Payment plans successfully retrieved", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/paymentPlansListResponse" }, "examples": { "Default": { "description": "", "value": { "totalNumberOfPages": 5, "totalNumberOfItems": 82, "page": 5, "pageSize": 20, "data": [ { "id": "ffa39856fbc54bb2a5f5916c324fa3c1", "paymentPlanType": "RECURRING", "lastBillingDate": "2026-02-26T13:28:29.857+01:00", "amount": { "value": 1000, "currency": "EUR" }, "planStatus": "ACTIVE", "description": "test:payment" }, { "id": "f861b00dd4464356b8b6f6a4977c50ee", "paymentPlanType": "UNSCHEDULED_MIT", "lastBillingDate": "2026-02-25T09:08:16.183+01:00", "amount": { "value": 1000, "currency": "EUR" }, "planStatus": "ACTIVE", "description": "test:payment" } ] } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payment-plans/{paymentPlanId}": { "get": { "tags": [ "PaymentPlans" ], "summary": "Get payment plan by id", "description": "Get payment plan by id", "operationId": "GetPaymentPlanById", "parameters": [ { "name": "paymentPlanId", "in": "path", "description": "", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Payment plan successfully retrieved", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/paymentPlan" }, "examples": { "Default": { "description": "", "value": { "Default": { "id": "1082fdd2f2304d479557683731cb8f41", "planStatus": "ACTIVE", "paymentPlanType": "UNSCHEDULED_MIT", "lastBillingDate": "2026-02-18T11:56:52.123+01:00", "amount": { "value": 1000, "currency": "EUR" }, "merchantCustomerId": "FLE_6767_001", "description": "test:payment", "triggerType": "MANUAL", "purchaseAmountInstallment": "0", "nbrInstallments": "0", "frequency": "0", "ceationDate": "2026-02-18T11:56:52.123", "expirationDate": "9999-12-31T23:59:59.997", "cancellationDate": "2026-02-18T11:56:52.123", "paymentMethod": { "type": "CARD", "card": { "last4Digits": "4444", "cardHolderName": "Trsddsfsdf", "brand": "MasterCard", "expiryDate": "9999-12-31T23:59:59.997" } } } } } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "404": { "description": "Payment plan not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payment-plans/{paymentPlanId}/payments": { "get": { "tags": [ "PaymentPlans" ], "summary": "List payments within a payment plan", "description": "Returns a paginated list of payments that belong to the given payment plan.", "operationId": "listPaymentsWithinPaymentPlan", "parameters": [ { "name": "paymentPlanId", "in": "path", "description": "The Id of payment plan", "required": true, "schema": { "type": "string" } }, { "name": "Page", "in": "query", "description": "Specifies page number", "schema": { "type": "integer", "format": "int32", "example": 1 } } ], "responses": { "200": { "description": "Payments successfully retrieved", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/paymentPlansPaymentsListResponse" }, "examples": { "Default": { "description": "", "value": { "totalNumberOfPages": 2, "totalNumberOfItems": 21, "page": 1, "pageSize": 20, "data": [ { "payId": "c6901a439e7b44b1a88f2e7b8a7d473f", "status": "OK", "billingDate": "2026-03-06T07:15:41.437+01:00", "amount": { "value": 1000, "currency": "EUR" } }, { "payId": "e94fa9b4571e4f278c93e73043c399ec", "status": "FAILED", "billingDate": "2026-03-06T09:18:47.330+01:00", "amount": { "value": 4199, "currency": "USD" } } ] } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/payment-plans/unscheduled-mit": { "post": { "tags": [ "PaymentPlans" ], "summary": "Create unscheduled MIT", "operationId": "createUnscheduledMit", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/unscheduledMitRequest" } } }, "required": true }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/unscheduledMitResponse" } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/validationProblemDetails" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/problemDetails" } } } } }, "security": [ { "bearer": [] } ] } }, "/services/duplicationCheck": { "post": { "tags": [ "Services" ], "summary": "Duplication Check", "description": "This endpoint is used to detect duplicate submissions before initiating a new payment, preventing customers from being charged more than once for the same transaction.", "operationId": "duplicationCheck", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/duplicationCheckRequest" }, "examples": { "Default": { "description": "", "value": { "order": { "merchantReference": "orderId467", "invoiceId": "invoiceId2345" }, "customerInfo": { "merchantCustomerId": "customerId_123" }, "partialPayment": false, "amount": { "value": 10000, "currency": "EUR" } } } } } }, "required": true }, "responses": { "200": { "description": "Successfully received and processed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/duplicationCheckResponse" }, "examples": { "Default": { "description": "", "value": { "status": "FAILED", "responseCode": "20001550", "responseDescription": "Already Paid", "payId": "99087ff050ee4eadb8292b4dc74b77d0", "merchantId": "merchanttest", "transId": "46954730-79a1-4c03-924a-e6c9eb378649", "xId": "c0d9347ac0b14feba4fd9bc0c4505d54", "refNr": "24235345432" } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "404": { "description": "Not Found" }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/services/accountUpdater": { "post": { "tags": [ "Services" ], "summary": "Account Updater", "description": "This endpoint is used to check updates and sends updated credit card data back in response.", "operationId": "accountUpdater", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/accountUpdateRequest" }, "examples": { "Default": { "description": "", "value": { "services": "MDC", "transId": "f9020fbd-2b28-4003-9653-d9d6d0d6723e", "cardNumbers": [ "0123456789012908", "0123456789012001", "4561409090001386" ] } } } } }, "required": true }, "responses": { "200": { "description": "Successfully received and processed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/accountUpdateResponse" }, "examples": { "Default": { "description": "", "value": { "transId": "f9020fbd-2b28-4003-9653-d9d6d0d6723e", "status": "OK", "responseCode": "00000000", "responseDescription": "success", "cardNumbers": [ { "oldCardNumber": "99990123456789012908", "responseCode": 800, "errorDetail": "oldPan" }, { "oldCardNumber": "99990123456789012001", "responseCode": 800, "errorDetail": "oldPan" }, { "oldCardNumber": "4561409090001386", "newCardNumber": "0933792933792384", "newExpiryDate": "33/08", "responseCode": "000" } ] } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopValidationProblemDetails" } } } }, "404": { "description": "Not Found" }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/computopProblemDetails" } } } } }, "security": [ { "bearer": [], "basic": [], "apiKey": [] } ] } }, "/authorization/oauth/token": { "post": { "tags": [ "Authentication" ], "summary": "Request OAuth Token", "description": "This endpoint is to generate a short-lived JSON Web token (JWT)", "operationId": "authorizationService", "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "required": [ "grant_type", "client_id", "client_secret" ], "type": "object", "properties": { "grant_type": { "enum": [ "client_credentials", "payment_intents" ], "type": "string", "description": "Possible values:" }, "client_id": { "type": "string", "description": "Client ID provided by Computop. This is your merchant ID" }, "client_secret": { "type": "string", "description": "Client secret provided by Computop. This is your API key" }, "payment_intent_id": { "type": "string" } } }, "examples": { "Default": { "description": "", "value": { "grant_type": "client_credentials", "client_id": "MerchantId", "client_secret": "ApiKey" } } } } }, "required": true }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "access_token": { "type": "string" }, "token_type": { "enum": [ "bearer" ], "type": "string" }, "expires_in": { "type": "number", "description": "Token expiry time in seconds" } } }, "examples": { "Default": { "description": "", "value": { "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IkZGQzlEM0JEQzY2Mjc3MUYwNzYxRUJDRTkwOTMyMDMyQjdGOTQ1NTQiLCJ4NXQiOiJfOG5UdmNaaWR4OEhZZXZPa0pNZ01yZjVSVlEiLCJ0eXAiOiJhdCtqd3QifQ.eyJpc3MiOiJodHRwczovL2xvY2FsaG9zdDo3MTIxLyIsImV4cCI6MTc0MDQ3NTUwNCwiaWF0IjoxNzQwNDcxOTA0LCJqdGkiOiJiZjU3YmUwMi05YThiLTQxYjctYjNjNi02NzlmMTcxNDU2ZjAiLCJzdWIiOiJDVF9Mb2dlZWNvbV90ZXN0IiwibmFtZSI6IkNUX0xvZ2VlY29tX3Rlc3QiLCJtYXJrZXRwbGFjZUlkIjoiQ1RfTG9nZWVjb21fdGVzdF9NYXJrZXRwbGFjZSIsIm1hcmtldHBsYWNlQWN0aXZlIjpmYWxzZSwib2lfcHJzdCI6IkNUX0xvZ2VlY29tX3Rlc3QiLCJjbGllbnRfaWQiOiJDVF9Mb2dlZWNvbV90ZXN0Iiwib2lfdGtuX2lkIjoiMjEwMWUxNTgtNzY0NC00OGU4LWIzNmYtYmZhNzczNWJmYjAyIn0.Xgtb81-GBPGnQ2tSJKXIlA38koRqlVa2oLhT902t-ICocWYD4_35bTAiPfU2A4HWwQpg1PZTrdf4riSoA_v_5bWSM-rdHAb-Y7fNwQTYAUYDxkcrw9qc5JcjwBGlOgXGTzJR2xyPDTq2sO4qAxo00lhCVjhEQR47yqOFta9rkcCmg1i6T6BxF7ZO6tBECfo7NSJ0wgN7G5_Unmd5MgWuG8V5VdvDxhXa1p_sBQdmy6nBCRi2d2bh1BOrz_uT5U2zngVBPzZBXv046j7971JXZbR20JFpkqwrULCGR6fy78NvkrHNC4U8ZDHmbejBbObMGCb_8pWMnaLhIg0A1k2x0Q", "token_type": "Bearer", "expires_in": 3600 } } } } } }, "400": { "description": "Bad request, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400)", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "example": "Invalid payment_intent_id" } } } } } }, "401": { "description": "Unauthorized, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/401)", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "example": "unsupported_grant_type" }, "error_description": { "type": "string", "example": "The specified 'grant_type' is not supported." }, "error_uri": { "type": "string", "example": "https://documentation.openiddict.com/errors/ID2032" } } } } } }, "500": { "description": "Internal Server Error, [https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500)", "content": { "application/json": { "schema": { "type": "object", "properties": { "responseCode": { "type": "string", "example": "A specific identifier for the error cause" }, "responseDescription": { "type": "string", "example": "A brief message explaining the error" } } } } } } } }, "servers": [ { "url": "https://test.paymentpage.axepta.bnpparibas" }, { "url": "https://paymentpage.axepta.bnpparibas" } ] } }, "components": { "schemas": { "account": { "type": "object", "properties": { "accountHolderName": { "type": "string", "description": "Name of account holder." } } }, "accountCreateDirectDebit": { "type": "object", "properties": { "pseudoBankNumber": { "type": "string", "description": "Pseudo Bank Account Number (PBAN) returned by Paygate during the initial payment that you can use for follow up payments, if applicable." }, "number": { "type": "string", "description": "International Bank Account Number or Mandatory when mandateId is not present." }, "code": { "type": "string", "description": "Bank Identifier Code." }, "bankName": { "type": "string", "description": "Bank name." }, "accountHolderName": { "type": "string", "description": "Account holder name. Mandatory when mandateId is not present." } } }, "accountDetails": { "type": "object", "properties": { "accountHolderName": { "type": "string", "description": "Name of account holder." }, "number": { "type": "string", "description": "International Bank Account Number." }, "code": { "type": "string", "description": "Bank Identifier Code." }, "bankName": { "type": "string", "description": "Bank name, Bank Code." }, "accountHolderIdentification": { "type": "string", "description": "Identification of the financial institution of the account holder." }, "accountNumber": { "type": "string", "description": "Customer's account number." } } }, "accountDirectDebitRequest": { "type": "object", "properties": { "number": { "type": "string", "description": "International Bank Account Number." }, "code": { "type": "string", "description": "Bank Identifier Code." }, "bankName": { "type": "string", "description": "Bank name." }, "accountHolderName": { "type": "string", "description": "Account holder name." } } }, "accountDirectDebitResponse": { "type": "object", "properties": { "number": { "type": "string", "description": "International bank account number." }, "code": { "type": "string", "description": "Bank identifier code." }, "bankName": { "type": "string", "description": "Bank name." }, "accountHolderName": { "type": "string", "description": "Account holder name." }, "pseudoBankNumber": { "type": "string", "description": "Pseudo bank number if the service is active." } } }, "accountEasyCollect": { "type": "object", "properties": { "number": { "type": "string", "description": "International Bank Account number (IBAN). Pass this to prefill the mandate form with IBAN." } } }, "accountEasyCollectLink": { "type": "object", "properties": { "number": { "type": "string" } } }, "accountEasyCollectRequest": { "type": "object", "properties": { "code": { "type": "string", "description": "Bank Identifier Code." }, "bankName": { "type": "string", "description": "Bank name." }, "accountHolderName": { "type": "string", "description": "Account holder name. Mandatory when mandateId is not present." }, "number": { "type": "string", "description": "International Bank Account Number." } } }, "accountEasyCollectResponse": { "type": "object", "properties": { "number": { "type": "string", "description": "International bank account number." }, "code": { "type": "string", "description": "Bank identifier code." }, "bankName": { "type": "string", "description": "Bank name." }, "accountHolderName": { "type": "string", "description": "Account holder name." }, "pseudoBankNumber": { "type": "string", "description": "Pseudo bank number if the service is active." } } }, "accountEps": { "type": "object", "properties": { "accountHolderName": { "type": "string", "description": "Name of account holder." }, "number": { "type": "string", "description": "International Bank Account Number for SEPA." }, "code": { "type": "string", "description": "Bank Identifier Code for SEPA." } } }, "accountInfo": { "type": "object", "properties": { "id": { "type": "string", "description": "The account ID of the cardholder within merchant environment / website (e.g. customer number)." }, "authenticationInfo": { "$ref": "#/components/schemas/authenticationInfo" }, "ageIndicator": { "enum": [ "GUEST_CHECKOUT", "THIS_TRANSACTION", "LESS_THAN_30_DAYS", "FROM_30_TO_60_DAYS", "MORE_THAN_60_DAYS" ], "type": "string", "description": "Length of time that the customer has had the payment instrument / payment account with the merchant." }, "changeDate": { "description": "Date that the customer's payment instrument (account) with the merchant was last changed, including billing or shipping address, new payment account, or new user(s) added (YYYY-MM-DD).", "format": "date-time" }, "changeIndicator": { "enum": [ "THIS_TRANSACTION", "LESS_THAN_30_DAYS", "FROM_30_TO_60_DAYS", "MORE_THAN_60_DAYS" ], "type": "string", "description": "Length of time since the customer’s account information with the merchant was last changed, including billing or shipping address, new payment account, or new user(s) added." }, "creationDate": { "description": "Date that the customer opened the account with the merchant in format YYYY-MM-DD.", "format": "date-time" }, "passwordChangeDate": { "description": "Date that customer's account with the merchant had a password change or account reset in format YYYY-MM-DD.", "format": "date-time" }, "passwordChangeDateIndicator": { "enum": [ "NO_CHANGE", "THIS_TRANSACTION", "LESS_THAN_30_DAYS", "FROM_30_TO_60_DAYS", "MORE_THAN_60_DAYS" ], "type": "string", "description": "Indicates the length of time since the customer account had a password change or account reset." }, "numberOfPurchases": { "type": "integer", "description": "Number of purchases in the last 6 months", "format": "int32" }, "addCardAttemptsDay": { "type": "integer", "description": "Number of Add Card attempts in the last 24 hours.", "format": "int32" }, "numberTransactionsDay": { "type": "integer", "description": "Number of transactions (successful and abandoned) in the previous 24 hours.", "format": "int32" }, "numberTransactionsYear": { "type": "integer", "description": "Number of transactions (successful and abandoned) in the previous year.", "format": "int32" }, "paymentAccountAge": { "description": "Date that the payment account was enrolled in the customer account in format YYYY-MM-DD.", "format": "date-time" }, "paymentAccountAgeIndicator": { "enum": [ "GUEST_CHECKOUT", "THIS_TRANSACTION", "LESS_THAN_30_DAYS", "FROM_30_TO_60_DAYS", "MORE_THAN_60_DAYS" ], "type": "string", "description": "Indicates the length of time that the payment account was enrolled in the customer account." }, "shipAddressUsageDate": { "description": "Date when the shipping address used for this transaction was first used in format YYYY-MM-DD.", "format": "date-time" }, "shipAddressUsageIndicator": { "enum": [ "THIS_TRANSACTION", "LESS_THAN_30_DAYS", "FROM_30_TO_60_DAYS", "MORE_THAN_60_DAYS" ], "type": "string", "description": "Indicates when the shipping address used for this transaction was first used." }, "suspiciousAccountActivity": { "type": "boolean", "description": "Indicates whether the merchant has experienced suspicious activity (including previous fraud) on the customer account." } }, "description": "The account information contains optional information about the customer account with the merchant." }, "accountRatepay": { "type": "object", "properties": { "accountHolderName": { "type": "string", "description": "Name of account holder. Mandatory when transferType is SEPA_DIRECT_DEBIT." }, "code": { "type": "string", "description": "Bank identifier code." }, "number": { "type": "string", "description": "International Bank Account Number. Mandatory when transferType is SEPA_DIRECT_DEBIT." } } }, "accountRatepayResponse": { "type": "object", "properties": { "bankName": { "type": "string", "description": "Bank name of the bank account the customer has to transfer the money to. Provided only when paymentMethod.ratepay.transferType is sent as BANK_TRANSFER in request." }, "code": { "type": "string", "description": "Bank identifier code of the bank account the customer has to transfer the money to. Provided only when paymentMethod.ratepay.transferType is sent as BANK_TRANSFER in request." }, "number": { "type": "string", "description": "International bank account number of the bank account the customer has to transfer the money to. Provided only when paymentMethod.ratepay.transferType is sent as BANK_TRANSFER in request." }, "accountHolderName": { "type": "string", "description": "Account holder of the bank account the customer has to transfer the money to. Provided only when paymentMethod.ratepay.transferType is sent as BANK_TRANSFER in request." } } }, "accountUpdateRequest": { "required": [ "transId", "cardNumbers" ], "type": "object", "properties": { "service": { "enum": [ "MDC" ], "type": "string", "description": "Type of account updater service." }, "transId": { "maxLength": 64, "type": "string", "description": "Unique transaction ID from your system." }, "cardNumbers": { "type": "array", "items": { "type": "string" }, "description": "List of old card numbers for which the update is being requested." } } }, "accountUpdateResponse": { "type": "object", "properties": { "transId": { "type": "string", "description": "Transaction ID provided by you in the request." }, "status": { "type": "string", "description": "Status of the transaction." }, "responseCode": { "type": "string", "description": "Response code of the transaction." }, "responseDescription": { "type": "string", "description": "Response description associated with the response code." }, "cardNumbers": { "type": "array", "items": { "$ref": "#/components/schemas/cardAccountUpdaterResponse" } } } }, "additionalAmount": { "type": "object", "properties": { "amountTypeCode": { "type": "string" }, "transactionType": { "enum": [ "DEBIT", "CREDIT" ], "type": "string" }, "amounts": { "$ref": "#/components/schemas/amountCapture" }, "tax": { "$ref": "#/components/schemas/tax" } } }, "additionalField": { "type": "object", "properties": { "index": { "type": "integer", "description": "Field Index.", "format": "int32" }, "value": { "type": "string", "description": "Field value." }, "type": { "enum": [ "N", "T" ], "type": "string", "description": "type of the field." } } }, "address": { "type": "object", "properties": { "street": { "type": "string" }, "city": { "type": "string" }, "zipCode": { "type": "string" }, "state": { "type": "string" }, "country": { "type": "string" } } }, "addressRestriction": { "type": "object", "properties": { "type": { "enum": [ "ALLOWED", "NOT_ALLOWED" ], "type": "string", "description": "Specifies whether addresses that match restrictions configuration should or should not be restricted." }, "restrictions": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/countryRestriction" }, "description": "A dictionary where the key is the ISO country code, and the value defines restrictions by states/regions and/or zip codes." } } }, "airPlus": { "type": "object", "properties": { "rentalInformation": { "$ref": "#/components/schemas/rentalInformation" }, "mileageUnit": { "enum": [ "KM", "MI" ], "type": "string" }, "billingAndInvoiceInformation": { "$ref": "#/components/schemas/billingAndInvoiceInformation" }, "odometerStart": { "type": "integer", "format": "int32" }, "odometerReturn": { "type": "integer", "format": "int32" }, "telcoUnits": { "type": "integer", "format": "int32" }, "carSharing": { "$ref": "#/components/schemas/carSharing" }, "lineItems": { "type": "array", "items": { "$ref": "#/components/schemas/airPlusLineItem" } } } }, "airPlusLineItem": { "type": "object", "properties": { "description": { "enum": [ "C9", "CB", "CC", "CG", "CI", "CJ", "CT", "CU", "CV", "CW", "CX", "CY", "D4", "D7", "D8", "D9", "DA", "O6", "OQ" ], "type": "string" }, "amounts": { "$ref": "#/components/schemas/amountCapture" }, "tax": { "$ref": "#/components/schemas/tax" } } }, "alipayCreateSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." }, "hotelInfo": { "$ref": "#/components/schemas/hotelInfo" } } }, "alipayDetailsSpecificFields": { "type": "object", "properties": { "paymentPurpose": { "type": "string", "description": "Purpose of payment." }, "paymentGuarantee": { "type": "string", "description": "This parameter is only returned if the Status=OK." }, "providerResponseText": { "type": "string", "description": "Is returned only if Status=FAILED. Detailed error PPRO message." }, "providerTransactionId": { "type": "string", "description": "Unique transaction number from PPRO." } } }, "alipaySessionSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." }, "hotelInfo": { "$ref": "#/components/schemas/hotelInfo" } } }, "amazonPayCaptureSpecificFields": { "type": "object", "properties": { "amazonPaySimulationCode": { "type": "string", "description": "A parameter used to simulate specific payment scenarios or behaviors during testing." } } }, "amazonPayCaptureSpecificResponse": { "type": "object", "properties": { "chargeId": { "type": "string" }, "providerStatus": { "type": "string" }, "chargePermissionId": { "type": "string" }, "providerResponseCode": { "type": "string" } } }, "amazonPayCreateSpecificFields": { "type": "object", "properties": { "merchantCountryCode": { "enum": [ "EU", "US", "JP" ], "type": "string", "description": "Country code of merchant. Options EU, US and JP." }, "shopUrl": { "type": "string", "description": "Order review page where customer is redirected after confirming customer's preferred payment instrument and optionally shipping address on the Amazon Pay-hosted page" }, "buyerCurrency": { "type": "string", "description": "Three character ISO currency code in which buyer will be charged. Only possible for Amazon EU and UK markets." }, "buyerDetailsScope": { "enum": [ "NAME", "EMAIL", "PHONE_NUMBER", "BILLING_ADDRESS" ], "type": "string", "description": "The buyer details that you are requesting access to. If not included, all buyer information is requested." }, "amazonPaySimulationCode": { "type": "string", "description": "A parameter used to simulate specific payment scenarios or behaviors during testing." }, "addressRestriction": { "$ref": "#/components/schemas/addressRestriction" }, "chargePermissionId": { "type": "string", "description": "Charge Permission ID that you received in the response to the initial payment in the series. Applicable only for subsequent recurring transactions." }, "eventToken": { "enum": [ "PROCESS_ORDER" ], "type": "string", "description": "Pass this value to invoke the Additional Payment Button integration." } } }, "amazonPayCreateSpecificResponse": { "type": "object", "properties": { "buttonSignature": { "type": "string" }, "buttonPayload": { "type": "string" }, "buttonPublicKeyId": { "type": "string" } } }, "amazonPayDetailsSpecificFields": { "type": "object", "properties": { "buyerId": { "type": "string", "description": "Unique amazon pay buyer identifier." }, "buyerName": { "type": "string", "description": "Buyer name." }, "buyerEmail": { "type": "string", "description": "Buyer's email." }, "merchantCountryCode": { "type": "string", "description": "Country code of merchant. Options EU, US and JP." }, "buyerPhoneNumber": { "type": "string", "description": "Buyer phone number." }, "amazonMerchantId": { "type": "string", "description": "Amazon Merchant ID." }, "providerStatus": { "type": "string", "description": "Status of the transaction from Amazon." }, "redirectUrl": { "type": "string", "description": "URL provided by Amazon Pay." }, "checkoutSessionId": { "type": "string", "description": "Amazon's checkout session ID." }, "amazonPaymentDescriptor": { "type": "string", "description": "Payment descriptor from Amazon." }, "chargeId": { "type": "string", "description": "Charge ID assigned by Amazon." }, "chargePermissionId": { "type": "string", "description": "Charge Permission ID assigned by Amazon." } } }, "amazonPayRefundSpecificFields": { "type": "object", "properties": { "amazonPaySimulationCode": { "type": "string", "description": "A parameter used to simulate specific payment scenarios or behaviors during testing." } } }, "amazonPayRefundSpecificResponse": { "type": "object", "properties": { "chargeId": { "type": "string" }, "providerStatus": { "type": "string" }, "refundId": { "type": "string" }, "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" } } }, "amazonPayReversalSpecificFields": { "type": "object", "properties": { "reversalReason": { "type": "string", "description": "Reason for reversal." } } }, "amazonPayUpdateSpecificFields": { "type": "object", "properties": { "merchantCountryCode": { "enum": [ "EU", "US", "JP" ], "type": "string", "description": "Country code of merchant." } } }, "amex": { "type": "object", "properties": { "cancellationReason": { "type": "string" }, "bookingSourceCode": { "enum": [ "ONLINE_BOOKING", "SELF_BOOKING_TOOL", "AFTER_HOURS_BOOKING", "PHONE_BOOKING" ], "type": "string" }, "mediaCode": { "enum": [ "CARDMEMBER_SIGNATURE_ON_FILE", "PHONE_ORDER", "MAIL_ORDER", "INTERNET_ORDER", "RECURRING_BILLING" ], "type": "string" }, "globalDistributionSystem": { "enum": [ "AMADEUS", "SABRE", "GALILEO" ], "type": "string" }, "originalAmount": { "type": "integer", "format": "int32" }, "originalCurrencyCode": { "type": "string" }, "additionalAmounts": { "type": "array", "items": { "$ref": "#/components/schemas/additionalAmount" } }, "destination": { "type": "string" }, "departureDate": { "description": "In format: YYYY-MM-DD", "format": "date-time" }, "travellers": { "type": "array", "items": { "$ref": "#/components/schemas/person" } }, "consultant": { "type": "string" }, "mileageUnit": { "enum": [ "KM", "MI" ], "type": "string" }, "milesDriven": { "type": "integer", "format": "int32" }, "supplier": { "$ref": "#/components/schemas/supplier" }, "provider": { "$ref": "#/components/schemas/provider" }, "bookingSystem": { "$ref": "#/components/schemas/bookingSystem" }, "customerReference": { "type": "array", "items": { "$ref": "#/components/schemas/reference" } }, "lineItems": { "type": "array", "items": { "$ref": "#/components/schemas/amexLineItem" } } } }, "amexLineItem": { "type": "object", "properties": { "number": { "type": "string" }, "description": { "type": "string" }, "reference": { "type": "string" }, "statementIndicator": { "enum": [ "N", "Y", "R" ], "type": "string" }, "grossAmount": { "type": "integer", "format": "int32" }, "transactionType": { "enum": [ "DEBIT", "CREDIT" ], "type": "string" }, "additionalAmounts": { "type": "array", "items": { "$ref": "#/components/schemas/additionalAmount" } } } }, "amount": { "type": "object", "properties": { "value": { "type": "integer", "description": "Total order amount in the smallest currency unit, including taxes, shipping costs, discounts, etc.", "format": "int32" }, "currency": { "type": "string", "description": "3-character ISO currency code." }, "taxTotal": { "type": "integer", "description": "Total tax amount.", "format": "int32" }, "netItemTotal": { "type": "integer", "description": "Total net amount of the products as part of the order, excluding shipping costs.", "format": "int32" }, "netShippingAmount": { "type": "integer", "description": "Net shipping costs.", "format": "int32" }, "grossShippingAmount": { "type": "integer", "description": "Gross shipping costs.", "format": "int32" }, "netDiscount": { "type": "integer", "description": "Net discount amount.", "format": "int32" }, "grossDiscount": { "type": "integer", "description": "Gross discount amount.", "format": "int32" } }, "description": "Test description" }, "amountCapture": { "type": "object", "properties": { "grossAmount": { "type": "integer", "format": "int32" }, "netAmount": { "type": "integer", "format": "int32" }, "taxAmount": { "type": "integer", "format": "int32" } } }, "amountDuplicationCheck": { "type": "object", "properties": { "value": { "type": "integer", "description": "Total order amount in the smallest currency unit, including taxes, shipping costs, discounts, etc.", "format": "int32" }, "currency": { "type": "string", "description": "3-character ISO currency code." } } }, "amountMini": { "type": "object", "properties": { "value": { "type": "integer", "description": "Total order amount in the smallest currency unit, including taxes, shipping costs, discounts, etc.", "format": "int32" }, "currency": { "type": "string", "description": "3-character ISO currency code." } }, "description": "Amount object of the payment plan." }, "amountPaymentDetails": { "type": "object", "properties": { "value": { "type": "integer", "description": "Total order amount in the smallest currency unit, including taxes, shipping costs, discounts, etc.", "format": "int32" }, "currency": { "type": "string", "description": "3-character ISO currency code." }, "capturedValue": { "type": "integer", "description": "Amount captured", "format": "int32" }, "refundedValue": { "type": "integer", "description": "Amount refunded", "format": "int32" }, "taxTotal": { "type": "integer", "description": "Total tax amount.", "format": "int32" }, "netItemTotal": { "type": "integer", "description": "Total net amount of the products as part of the order, excluding shipping costs.", "format": "int32" }, "netShippingAmount": { "type": "integer", "description": "Net shipping costs.", "format": "int32" }, "grossShippingAmount": { "type": "integer", "description": "Gross shipping costs.", "format": "int32" }, "netDiscount": { "type": "integer", "description": "Net discount amount.", "format": "int32" }, "grossDiscount": { "type": "integer", "description": "Gross discount amount.", "format": "int32" } } }, "amountPaymentPlans": { "type": "object", "properties": { "value": { "type": "integer", "description": "Amount to be charged. Only applicable for Unscheduled MIT use case. For installment it should be optional. Not applicable for recurring as amount is fixed.", "format": "int32" } } }, "amounts": { "type": "object", "properties": { "merchant": { "$ref": "#/components/schemas/merchantAmount" }, "cardholder": { "$ref": "#/components/schemas/cardholderAmount" } } }, "applePayCreateSpecificFields": { "type": "object", "properties": { "token": { "type": "string", "description": "PKPayment token received by you from Apple. Data should be submitted Base64 encoded." }, "merchantIdentifierOfPublicKey": { "type": "string", "description": "Merchant Identifier of Public Key. Mandatory if more then one Merchant Identifiers are stored with Computop." } } }, "applePayCreateSpecificResponse": { "type": "object", "properties": { "schemeReferenceId": { "type": "string" } } }, "applePayDetailsSpecificFields": { "type": "object", "properties": { "schemeReferenceId": { "type": "string", "description": "Unique identifier assigned by card schemes that is required to be sent in subsequent credential on file transactions." }, "tokenizedCard": { "$ref": "#/components/schemas/applePayTokenizedCard" } } }, "applePayTokenizedCard": { "type": "object", "properties": { "pseudoCardNumber": { "type": "string", "description": "Pseudo Card Number." }, "expiryDate": { "type": "string", "description": "The expiration date of the card in YYYYMM format." }, "brand": { "type": "string", "description": "The brand or network of the card, such as \"visa\", \"mastercard\"" } } }, "authenticationData": { "type": "object", "properties": { "source": { "type": "string", "description": "Describes the source of authentication in the 3DS flow.\r\n\r\nPossible values:\r\n\r\n* AUTHENTICATION_RESPONSE : Authentication data received during the authentication flow (AReq/ARes).\r\n\r\n * RESULTS_RESPONSE : Authentication data received during Challenge flow (RReq/RRes)." }, "threeDSServerTransId": { "type": "string", "description": "payId assigned by Axepta Online." }, "acsChallengeMandated": { "type": "boolean", "description": "Indication of whether a challenge is required for the transaction to be authorised due to local/regional mandates or other variable:\r\n\r\ntrue → Challenge is mandated by local/regional regulations\r\n\r\nfalse → Challenge is not mandated by local/regional regulations, but is deemed necessary by the ACS" }, "acsDecConInd": { "type": "boolean", "description": "Indicates whether the ACS confirms utilisation of Decoupled Authentication and agrees to utilise Decoupled Authentication to authenticate the cardholder. Required if Transaction Status = D." }, "acsOperatorId": { "type": "string", "description": "DS assigned ACS identifier. Each DS can provide a unique ID to each ACS on an individual basis. Requirements for the presence of this field are DS specific." }, "acsReferenceNumber": { "type": "string", "description": "Unique identifier assigned by the EMVCo Secretariat upon Testing and Approval." }, "acsRenderingType": { "$ref": "#/components/schemas/renderingType" }, "acsSignedContent": { "type": "string", "description": "App-based only. Contains the JWS object (represented as a string) created by the ACS for the ARes message. Required if the Transaction Status = C." }, "acsTransId": { "type": "string", "description": "Universally Unique transaction identifier assigned by the ACS to identify a single transaction" }, "acsURL": { "type": "string", "description": "Fully qualified URL of the ACS to be used to post the Challenge Request. For App-based, this data element is contained within the ACS Signed Content JWS Object. Required if Transaction Status = C." }, "authenticationType": { "type": "string", "description": "Indicates the type of authentication method the Issuer will use to challenge the cardholder. Required if the Transaction Status = C or D.\r\n\r\nValues accepted:\r\n\r\nFuture implementation. Protocol Version 2.2.0 onwards -\r\n\r\n- 04 = decoupled" }, "authenticationValue": { "type": "string", "description": "Payment System-specific value provided by the ACS or the DS to provide proof of authentication. Required if Transaction Status = Y or A. Conditional based on DS rules if Transaction Status = I." }, "broadInfo": { "type": "string", "description": "Unstructured information sent between the 3DS Server, the DS and the ACS. Requirements for the presence of this field are DS specific." }, "cardholderInfo": { "type": "string", "description": "Text provided by the ACS/Issuer to Cardholder during a Frictionless or Decoupled transaction. The Issuer can provide information to Cardholder. For example, “Additional authentication is needed for this transaction, please contact (Issuer Name) at xxx-xxx-xxxx.” Required if ACS Decoupled Confirmation Indicator = true Otherwise, Optional for the ACS." }, "challengeCancel": { "type": "string" }, "challengeRequestInd": { "type": "string" }, "dsReferenceNumber": { "type": "string", "description": "EMVCo-assigned unique identifier to track approved DS." }, "dsScore": { "type": "string", "description": "Directory Server (scheme) scoring result of the transaction during authentication. Format and value are DS specific." }, "dsTransId": { "type": "string", "description": "Universally unique transaction identifier assigned by the DS to identify a single transaction." }, "eci": { "type": "string", "description": "Payment System-specific value provided by the ACS or DS to indicate the results of the attempt to authenticate the Cardholder. The requirements for the presence of this field are DS specific." }, "interactionCounter": { "type": "string", "description": "Indicates the number of authentication cycles attempted by the Cardholder." }, "messageCategory": { "type": "string", "description": "Identifies the category of the message for a specific use case.\r\n\r\nValues accepted:" }, "messageExtension": { "type": "string", "description": "Data necessary to support requirements not otherwise defined in the 3-D Secure message are carried in a Message Extension. Conditions to be set by each DS." }, "messageType": { "type": "string", "description": "Identifies the type of message that failed in case of an error.\r\n\r\nValues accepted:" }, "messageVersion": { "type": "string", "description": "Protocol version identifier" }, "sdkTransId": { "type": "string", "description": "Future use. Universally unique transaction identifier assigned by the 3DS SDK to identify a single transaction." }, "transStatus": { "type": "string", "description": "Indicates whether a transaction qualifies as an authenticated transaction.\r\n\r\nValues accepted:" }, "transStatusReason": { "type": "string", "description": "Provides information on why the Transaction Status field has the specified value. Required if the Transaction Status field = N, U, or R.\r\n\r\nValues accepted:" }, "whiteListStatus": { "type": "string", "description": "Only supported with protocol version 2.2.0 onwards. Enables the communication of trusted beneficiary/whitelist status.\r\n\r\nValues accepted:" }, "whiteListStatusSource": { "type": "string", "description": "Only supported with protocol version 2.2.0 onwards. This data element will be populated by the system setting Whitelist Status.\r\n\r\nValues accepted:" }, "challengeRequest": { "$ref": "#/components/schemas/challengeRequest" }, "base64EncodedChallengeRequest": { "type": "string", "description": "Base64-encoded Challenge Request object in case the authentication response message indicates that further cardholder interaction is required to complete the authentication" }, "threeDSCompInd": { "type": "string", "description": "Indicates whether the 3DS Method successfully completed." } }, "description": "Specific object for Card payment method." }, "authenticationInfo": { "type": "object", "properties": { "method": { "enum": [ "GUEST", "MERCHANT_CREDENTIALS", "FEDERATED_ID", "ISSUER_CREDENTIALS", "THIRD_PARTY_AUTHENTICATION", "FIDO", "SIGNED_FIDO", "SRC_ASSURANCE_DATA" ], "type": "string", "description": "This data element specifies the mechanism used by the Cardholder to authenticate to the merchant." }, "timestamp": { "description": "Date and time (see RFC 3339) in UTC of the cardholder authentication. YYYY-MM-DDTHH:MM:SS+00:00.", "format": "date-time" }, "data": { "type": "string", "description": "This data element can carry specific authentication attestation data such as FIDO if applicable." } } }, "bancontactCreateSpecificFields": { "type": "object", "properties": { "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." }, "account": { "$ref": "#/components/schemas/account" }, "checkoutToken": { "type": "string", "description": "Card Token that merchant should store and provide in request to subsequent actions like Bancontact Recurring or One-Click Payment.Unique identifier of a card linked to the merchant. Can be used in subsequent WIP transactions only if the initial transaction has succeeded." }, "paymentFlow": { "enum": [ "CARD_ENTRY", "QR_SCAN" ], "type": "string" }, "threeDsPolicy": { "$ref": "#/components/schemas/threeDsPolicy" }, "template": { "$ref": "#/components/schemas/templateLink" }, "prefillInfo": { "$ref": "#/components/schemas/prefillInfoCard" }, "number": { "type": "string", "description": "The card number, pseudo card number or the network token of the payment card.Mandatory when paymentMethod.integrationType=DIRECT." }, "cardHolderName": { "type": "string", "description": "The name of the cardholder as it appears on the payment card.Mandatory when paymentMethod.integrationType=DIRECT." }, "expiryDate": { "type": "string", "description": "The expiration date of the card in YYYYMM format.Mandatory when paymentMethod.integrationType=DIRECT." }, "brand": { "type": "string", "description": "The brand or network of the card, such as \"visa\", \"mastercard\".Applicable only when paymentMethod.integrationType=DIRECT." }, "securityCode": { "type": "string", "description": "The Card Security Code, also known as CVV or CVC." }, "brandSelection": { "enum": [ "CUSTOMER", "MERCHANT" ], "type": "string", "description": "Indicates the party that made the card brand choice during the payment. Applicable only when paymentMethods.integrationType=DIRECT\r\n Possible values:\r\n\r\n- CUSTOMER: Customer made the brand choice during the payment\r\n - MERCHANT: Originally selected brand by the merchant was not overriden by the customer during the payment" }, "schemeReferenceId": { "type": "string", "description": "A unique identifier assigned by the card network to track the transaction or card across its lifecycle. It is required to send this information for credential on file transactions when intialPayment is false." }, "priorAuthenticationInfo": { "$ref": "#/components/schemas/priorAuthenticationInfo" }, "threeDsData": { "$ref": "#/components/schemas/threeDsData" }, "threeDsSDK": { "$ref": "#/components/schemas/threeDsSDK" } } }, "bancontactErrorSpecificResponse": { "type": "object", "properties": { "providerResponseText": { "type": "string" } } }, "bancontactLinkSpecificFields": { "type": "object", "properties": { "sellingPoint": { "type": "string", "description": "Selling point." }, "account": { "$ref": "#/components/schemas/account" } } }, "bancontactSessionSpecificFields": { "type": "object", "properties": { "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." }, "account": { "$ref": "#/components/schemas/account" }, "eventToken": { "enum": [ "PRE_AUTH", "PLBS", "ORDER", "ACCOUNT_VERIFICATION" ], "type": "string" }, "template": { "$ref": "#/components/schemas/templateLink" }, "threeDsPolicy": { "$ref": "#/components/schemas/threeDsPolicy" }, "prefillInfo": { "$ref": "#/components/schemas/prefillInfoCard" } } }, "bancontactSpecificResponse": { "type": "object", "properties": { "paymentPurpose": { "type": "string", "description": "Purpose of payment." }, "paymentGuarantee": { "type": "string" }, "providerResponseText": { "type": "string", "description": "Provider response message." }, "providerTransactionId": { "type": "string", "description": "Provider transaction ID." }, "cardHolderName": { "type": "string" }, "pseudoCardNumber": { "type": "string" }, "first6Digits": { "type": "string", "description": "First 6 digits of card." }, "last4Digits": { "type": "string", "description": "Last 4 digits of the card." }, "expiryDate": { "type": "string", "description": "The expiration date of the card in YYYYMM format." }, "brand": { "type": "string" }, "product": { "type": "string" }, "source": { "type": "string" }, "type": { "type": "string" }, "issuer": { "type": "string" }, "country": { "type": "string" }, "bin": { "$ref": "#/components/schemas/bin" }, "versioningData": { "$ref": "#/components/schemas/versioningData" }, "checkoutToken": { "type": "string", "description": "Card Token that merchant should store and provide in request to subsequent actions like Bancontact Recurring or One-Click Payment.Unique identifier of a card linked to the merchant. Can be used in subsequent WIP transactions only if the initial transaction has succeeded." }, "qrData": { "type": "string" }, "urlIntent": { "type": "string" } } }, "baseCustomerData": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique identifier of the customer assigned by Paygate." }, "merchantCustomerId": { "type": "string", "description": "Unique identifier of the customer assigned by merchant." }, "firstName": { "type": "string", "description": "First name of the customer. Present if passed by merchant in Payment." }, "lastName": { "type": "string", "description": "Last name of the customer. Present if passed by merchant in Payment." }, "companyName": { "type": "string", "description": "Last name of the customer. Present if passed by merchant in Payment." }, "email": { "type": "string", "description": "E-mail address of the customer. Present if passed by merchant in Payment." }, "phone": { "$ref": "#/components/schemas/phone" }, "scope": { "type": "string", "description": "Scope of customer vault. Present if configured for the merchant in MAT." }, "createdAt": { "description": "Creation date and time in ISO 8601 format.", "format": "date-time" }, "updatedAt": { "description": "Update date and time in ISO 8601 format.", "format": "date-time" } } }, "baseUrls": { "type": "object", "properties": { "return": { "type": "string", "description": "The URL to which the customer is redirected after successfully completing the payment process." }, "cancel": { "type": "string", "description": "The URL to which the customer is redirected if they cancel the payment process before completion." }, "webhook": { "type": "string", "description": "The URL endpoint on the merchant's server that receives asynchronous notifications about the outcome of the payment." } } }, "billingAddress": { "type": "object", "properties": { "streetName": { "type": "string", "description": "Street name of billing address." }, "streetNumber": { "type": "string", "description": "Street number of billing address." }, "addressLine2": { "type": "string", "description": "Address line 2 of billing address." }, "addressLine3": { "type": "string", "description": "Address line 3 of billing address." }, "city": { "type": "string", "description": "City of billing address." }, "state": { "type": "string", "description": "State of billing address." }, "country": { "maxLength": 3, "minLength": 3, "type": "string", "description": "3 character ISO country code of billing address." }, "postalCode": { "type": "string", "description": "Postal code of billing address." } } }, "billingAddressCustomer": { "type": "object", "properties": { "streetName": { "type": "string", "description": "Street name of billing address. Present if passed by merchant in Payment." }, "streetNumber": { "type": "string", "description": "Street number of billing address. Present if passed by merchant in Payment." }, "city": { "type": "string", "description": "City of billing address. Present if passed by merchant in Payment." }, "postalCode": { "type": "string", "description": "Postal code of billing address. Present if passed by merchant in Payment." }, "state": { "type": "string", "description": "State of billing address. Present if passed by merchant in Payment." }, "country": { "type": "string", "description": "Country of billing address. Present if passed by merchant in Payment." } } }, "billingAndInvoiceInformation": { "type": "object", "properties": { "accountingUnit": { "type": "string" }, "businessUnit": { "type": "string" }, "actionNumber": { "type": "string" }, "voucherNumber": { "type": "string" }, "department": { "type": "string" }, "discountNumber": { "type": "string" }, "internalAccountNumber": { "type": "string" }, "costCenter": { "type": "string" }, "customerNumber": { "type": "string" }, "customerReference": { "type": "string" }, "employeeNumber": { "type": "string" }, "projectNumber": { "type": "string" }, "invoiceDate": { "description": "In format: YYYY-MM-DD", "format": "date-time" }, "invoiceNumber": { "type": "string" }, "destination": { "type": "string" }, "taxRegistrationNumber": { "type": "string" }, "comments": { "type": "string" }, "misc": { "type": "string" }, "countryCode": { "type": "string" } } }, "bin": { "type": "object", "properties": { "accountBin": { "type": "string", "description": "The leading six digits of the account number also known as bank identification number (BIN). The BIN consists of 6 to 8 digits – because of PCI DSS rules a maximum of the first 6 digits may be output." }, "accountRangeLow": { "type": "string", "description": "The account number at the low end of the account range." }, "accountRangeHigh": { "type": "string", "description": "The account number at the high end of the account range." } } }, "binLookupRequest": { "required": [ "bin" ], "type": "object", "properties": { "bin": { "maxLength": 10, "minLength": 10, "pattern": "^[0-9]+$", "type": "string" } } }, "binLookupResponse": { "type": "object", "properties": { "cardInfo": { "$ref": "#/components/schemas/cardInfo" } } }, "bizumCreateSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "bizumDetailsSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/accountDetails" }, "paymentPurpose": { "type": "string", "description": "Purpose of payment." }, "paymentGuarantee": { "type": "string", "description": "This parameter is only returned if the Status=OK." }, "providerResponseText": { "type": "string", "description": "Is returned only if Status=FAILED. Detailed error PPRO message." }, "providerTransactionId": { "type": "string", "description": "Unique transaction number from PPRO." } } }, "bizumSessionSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "blikCreateSpecificFields": { "type": "object", "properties": { "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." }, "account": { "$ref": "#/components/schemas/account" } } }, "blikDetailsSpecificFields": { "type": "object", "properties": { "paymentPurpose": { "type": "string", "description": "Purpose of payment." }, "paymentGuarantee": { "type": "string", "description": "NONE= no payment guarantee; VALIDATED= customer account valid, but no payment guarantee; FULL= payment guarantee." }, "providerResponseText": { "type": "string", "description": "Response text from the provider." }, "providerTransactionId": { "type": "string", "description": "Transaction ID assigned by the provider." } } }, "blikSessionSpecificFields": { "type": "object", "properties": { "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." }, "account": { "$ref": "#/components/schemas/account" } } }, "boletoCreateSpecificFields": { "type": "object", "properties": { "sellingPoint": { "type": "string" }, "service": { "type": "string", "description": "Products or service sold." } } }, "boletoCreateSpecificResponse": { "type": "object", "properties": { "paymentSlipLink": { "type": "string" } } }, "boletoDetailsSpecificFields": { "type": "object", "properties": { "paymentSlipLink": { "type": "string", "description": "Complete URL (URL-encoded) for the page which presents the payment form. This link should be displayed to the customer on the confirmation page." }, "paymentPurpose": { "type": "string", "description": "Purpose of payment." }, "paymentGuarantee": { "type": "string", "description": "This parameter is only returned if the Status=OK." }, "providerResponseText": { "type": "string", "description": "Is returned only if Status=FAILED. Detailed error PPRO message." }, "providerTransactionId": { "type": "string", "description": "Unique transaction number from PPRO." } } }, "boletoLinkSpecificFields": { "type": "object", "properties": { "sellingPoint": { "type": "string" } } }, "boletoRefundSpecificFields": { "type": "object", "properties": { "bankName": { "type": "string", "description": "Bank name of the customer. Relevant only when processing Boleto via Pagbrasil." }, "accountNumber": { "type": "string", "description": "Customer's account number (must contain a hyphen, e.g. 12345-6). Relevant only when processing Boleto via Pagbrasil." }, "bankSortCode": { "type": "string", "description": "Bank sort code or rather branch number of the bank. Relevant only when processing Boleto via Pagbrasil." } } }, "boletoRefundSpecificResponse": { "type": "object", "properties": { "providerResponseText": { "type": "string" } } }, "boletoSessionSpecificFields": { "type": "object", "properties": { "sellingPoint": { "type": "string" }, "service": { "type": "string", "description": "Products or service sold." } } }, "bookingSystem": { "type": "object", "properties": { "bookingSystemReference": { "type": "string" }, "invoice": { "$ref": "#/components/schemas/invoiceCapture" } } }, "browserInfo": { "type": "object", "properties": { "acceptHeaders": { "type": "string", "description": "Exact content of the HTTP accept headers as sent from the customer’s browser." }, "ipAddress": { "type": "string", "description": "IP address of the browser as returned by the HTTP headers." }, "javaEnabled": { "type": "boolean", "description": "Represents the ability of the customer's browser to execute Java. Required when Browser JavaScript Enabled = true; otherwise Optional." }, "javaScriptEnabled": { "type": "boolean", "description": "Represents the ability of the customer's browser to execute JavaScript." }, "language": { "type": "string", "description": "Value representing the browser language as defined in IETF BCP47, returned from navigator.language property, e.g. \"en\", \"de\", \"fr\", \"en-US\", \"en-GB\", \"de-DE\", \"de-AT\", etc." }, "colorDepth": { "type": "integer", "description": "Value representing the bit depth of the colour palette for displaying images, in bits per pixel. Required when Browser JavaScript Enabled = true; otherwise optional.", "format": "int32" }, "screenHeight": { "type": "integer", "description": "Total height of the Cardholder’s screen in pixels. Required when Browser JavaScript Enabled = true; otherwise optional.", "format": "int32" }, "screenWidth": { "type": "integer", "description": "Total width of the cardholder’s screen in pixels. Required when Browser JavaScript Enabled = true; otherwise optional.", "format": "int32" }, "timeZoneOffset": { "maxLength": 5, "type": "string", "description": "Time-zone offset in minutes between UTC and the Cardholder browser local time. Required when Browser JavaScript Enabled = true; otherwise optional." }, "userAgent": { "type": "string", "description": "Exact content of the HTTP user-agent header." } } }, "browserInfoRefundEx": { "type": "object", "properties": { "acceptHeaders": { "type": "string", "description": "Exact content of the HTTP accept headers as sent from the customer’s browser." }, "ipAddress": { "type": "string" }, "sessionId": { "type": "string", "description": "Customer´s Session ID." } } }, "campaign": { "type": "object", "properties": { "type": { "enum": [ "PRICE_CAMPAIGN", "PERIOD_CAMPAIGN", "EVENT_CAMPAIGN" ], "type": "string", "description": "PRICE_CAMPAIGN = Special price until end date; PERIOD_CAMPAIGN = Special price for defined intervals; EVENT_CAMPAIGN = Special price until event date." }, "price": { "type": "integer", "description": "Campaign price in smallest currency unit. Required if CampaignType specified.", "format": "int32" }, "end": { "description": "Required for PRICE_CAMPAIGN: Campaign end date. Format: YYYY-MM-DD", "format": "date-time" }, "period": { "$ref": "#/components/schemas/period" }, "eventDate": { "description": "Required for EVENT_CAMPAIGN: Event date. Format: YYYY-MM-DD", "format": "date-time" }, "eventText": { "type": "string", "description": "Required for EVENT_CAMPAIGN: Event description." } } }, "captureMethod": { "required": [ "type" ], "type": "object", "properties": { "type": { "enum": [ "AUTOMATIC", "MANUAL", "DELAYED" ], "type": "string", "description": "Specifies the type of capture method being used." }, "delayed": { "$ref": "#/components/schemas/delayed" } } }, "captureMethodCapture": { "type": "object", "properties": { "manual": { "$ref": "#/components/schemas/manual" } } }, "captureRequest": { "required": [ "transId", "amount" ], "type": "object", "properties": { "transId": { "maxLength": 64, "type": "string", "description": "Transaction ID created in your system. It should be unique for each payment.", "example": "test-TransactionId01" }, "amount": { "$ref": "#/components/schemas/amount" }, "refNr": { "type": "string", "description": "Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually." }, "order": { "$ref": "#/components/schemas/order" }, "statementDescriptor": { "type": "string", "description": "Short, clear description of the transaction that appears on the customer's statement. It is recommend sending a maximum of 22 characters. Allowed characters: a-z, A-Z, 0-9, spaces, and special characters / - ? : ( ) . , +" }, "captureMethod": { "$ref": "#/components/schemas/captureMethodCapture" }, "enhancedData": { "$ref": "#/components/schemas/enhancedDataCapture" }, "paymentMethods": { "$ref": "#/components/schemas/paymentCapture" } } }, "captureResponse": { "type": "object", "properties": { "payId": { "type": "string", "description": "A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation." }, "merchantId": { "type": "string", "description": "Merchant ID assigned by Axepta Online." }, "transId": { "type": "string", "description": "Transaction ID provided by you in the request." }, "xId": { "type": "string", "description": "A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same." }, "refNr": { "type": "string", "description": "Reference number provided by you in the request." }, "status": { "type": "string", "description": "Status of the transaction." }, "responseCode": { "type": "string", "description": "Response code of the transaction." }, "responseDescription": { "type": "string", "description": "Response description associated with the response code." }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs as you passed in the request." }, "paymentMethods": { "$ref": "#/components/schemas/paymentDataResponseBase" } } }, "card": { "type": "object", "properties": { "last4Digits": { "type": "string", "description": "Last 4 digits of the card." }, "cardHolderName": { "type": "string", "description": "Cardholder Name." }, "brand": { "type": "string", "description": "Card Brand." }, "expiryDate": { "type": "string", "description": "Card expiry date." } } }, "cardAccountUpdaterResponse": { "type": "object", "properties": { "oldCardNumber": { "type": "string", "description": "Old card number." }, "newCardNumber": { "type": "string", "description": "New updated card number." }, "newExpiryDate": { "type": "string", "description": "Expiry date of the new card." }, "responseCode": { "type": "string", "description": "Response code for the specific card update request." }, "errorDetail": { "type": "string", "description": "Response error details." } } }, "cardCaptureSpecificFields": { "type": "object", "properties": { "finishAuth": { "type": "boolean", "description": "Transmit value in order to stop the renewal of guaranteed authorisations and rest amounts after partial captures. Use this parameter only if you are using the additional function ETM (Extended Transactions Managament)." } } }, "cardCaptureSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" }, "providerTransactionId": { "type": "string" }, "providerApprovalCode": { "type": "string" } } }, "cardCloudPos": { "type": "object", "properties": { "fist6Digits": { "type": "string" }, "last4Digits": { "type": "string" }, "cardSequenceNumber": { "type": "string" }, "brand": { "type": "string" }, "pseudoCardNumber": { "type": "string" }, "expiryDate": { "type": "string" }, "schemeReferenceId": { "type": "string" } } }, "cardConfirmIntentSpecificFields": { "type": "object", "properties": { "number": { "type": "string" }, "cardHolderName": { "type": "string" }, "expiryDate": { "type": "string" }, "brand": { "type": "string" }, "securityCode": { "type": "string" }, "startDate": { "type": "string" }, "sequenceNumber": { "type": "string" }, "threeDsSDK": { "$ref": "#/components/schemas/threeDsSDK" } } }, "cardConfirmSpecificFields": { "type": "object", "properties": { "eventToken": { "enum": [ "ORDER" ], "type": "string", "description": "Defines specific use cases of card payments, if applicable.\r\n\r\n- DELAYED_SHIPMENT: Passed to confirm the payment after the shipment is sent.\r\n - ORDER: Pass this to confirm the payment if you created the payment previously purely for authentication." } } }, "cardCreateIntentSpecificFields": { "type": "object", "properties": { "eventToken": { "enum": [ "PRE_AUTH", "PLBS", "ORDER", "REAUTHORIZATION", "RESUBMISSION", "DELAYED_CHARGES", "NO_SHOW", "ACCOUNT_VERIFICATION", "ADDITIONAL_CHARGES", "FINAL_AUTH" ], "type": "string" }, "dccEnabled": { "type": "boolean" }, "dcc": { "$ref": "#/components/schemas/dcc" }, "threeDsPolicy": { "$ref": "#/components/schemas/threeDsPolicy" } } }, "cardCreateSpecificFields": { "type": "object", "properties": { "subType": { "type": "array", "items": { "enum": [ "AIRPLUS", "AMEX", "ARGENCARD", "AURA", "BANCONTACT", "CABAL", "CARTESBANCAIRES", "CBN", "CENCOSUD", "COMFORTCARD", "CUP", "DANKORT", "DINERS", "DISCOVER", "ELO", "HIPERCARD", "JCB", "LASER", "MAESTRO", "MASTERCARD", "NARANJA", "RUPAY", "SHOPPING", "TOTAL", "VISA" ], "type": "string" }, "description": "Used to define the card payment methods that needs to be shown on the payment form. The values here override your default configuration at merchant level." }, "threeDsPolicy": { "$ref": "#/components/schemas/threeDsPolicy" }, "template": { "$ref": "#/components/schemas/creditCardTemplate" }, "prefillInfo": { "$ref": "#/components/schemas/prefillInfoCard" }, "eventToken": { "enum": [ "PRE_AUTH", "PLBS", "ORDER", "REAUTHORIZATION", "RESUBMISSION", "DELAYED_CHARGES", "NO_SHOW", "ACCOUNT_VERIFICATION", "ADDITIONAL_CHARGES", "FINAL_AUTH" ], "type": "string", "description": "Defines specific use cases of card payments, if applicable.\r\n\r\n- DELAYED_SHIPMENT: Passed in initial request, if you intend to capture the request after the shipment is sent.\r\n - PRE_AUTH: Passed in initial request, if the initial payment is a preauthorization.\r\n - PLBS: Passed in initial request, if the payment is related to rental of goods and services and is being initiated as a preauthorization.\r\n - ORDER: Pass if you want to perform authentication and payment in 2 steps. If you pass it, then the payment should be confirmed by calling the Confirm payment endpoint.\r\n - REAUTHORIZATION: Passed in subsequent merchant initiated transaction. You can initiate a re-authorization when the \r\ncompletion or fulfillment of the original order or service extends beyond the authorization validity limit set by Visa.There\r\nare two common re-authorization scenarios:\r\n - Split or delayed shipments at eCommerce retailers. A split shipment occurs when not all the goods ordered are\r\n available for shipment at the time of purchase. If the fulfillment of the goods takes place after the authorization\r\n validity limit set by Visa, eCommerce merchants perform a separate authorization to ensure that consumer funds are \r\n available.\r\n - Extended stay hotels, car rentals, and cruise lines. A re-authorization is used for stays, voyages, and/or rentals that\r\n extend beyond the authorization validity period set by Visa.\r\n - RESUBMISSION: Passed in subsequent merchant initiated transaction. You perform a re-submission in cases where it requested an authorization, but received a decline due to insufficient funds; however, the goods or services were already delivered to the cardholder.\r\n In such scenarios you can resubmit the request to recover outstanding debt from cardholders.\r\n - DELAYED_CHARGES: Delayed charges are performed to process a supplemental account charge after original services have been rendered and respective payment has been processed.\r\n - NO_SHOW: Passed in subsequent merchant initated transaction. Cardholders can use their Visa cards to make a guaranteed reservation with certain merchant segments. A guaranteed reservation ensures that the reservation will be honored and allows you to perform a No Show transaction to charge the cardholder a penalty according to the your cancellation policy.\r\n - ACCOUNT_VERIFICATION: Pass this if you want to verify card account without initiating a payment transaction. Amount is optional when this value is sent.\r\n - ADDITIONAL_CHARGES" }, "number": { "type": "string", "description": "The card number, pseudo card number or the network token of the payment card.Mandatory when paymentMethod.integrationType=DIRECT." }, "cardHolderName": { "type": "string", "description": "The name of the cardholder as it appears on the payment card.Mandatory when paymentMethod.integrationType=DIRECT." }, "expiryDate": { "type": "string", "description": "The expiration date of the card in YYYYMM format.Mandatory when paymentMethod.integrationType=DIRECT." }, "brand": { "type": "string", "description": "The brand or network of the card, such as \"visa\", \"mastercard\".Applicable only when paymentMethod.integrationType=DIRECT." }, "securityCode": { "type": "string", "description": "The Card Security Code, also known as CVV or CVC." }, "brandSelection": { "enum": [ "CUSTOMER", "MERCHANT" ], "type": "string", "description": "Indicates the party that made the card brand choice during the payment. Applicable only when paymentMethods.integrationType=DIRECT\r\n Possible values:\r\n\r\n- CUSTOMER: Customer made the brand choice during the payment\r\n - MERCHANT: Originally selected brand by the merchant was not overriden by the customer during the payment" }, "startDate": { "type": "string", "description": "The start date of the card, if applicable. Applicable for some UK debit cards.Applicable only when paymentMethod.integrationType=DIRECT." }, "sequenceNumber": { "type": "string", "description": "A number assigned to specific cards by issuers to distinguish between multiple versions of the same card. Applicable for some UK debit cards.Applicable only when paymentMethod.integrationType=DIRECT." }, "tokenData": { "$ref": "#/components/schemas/tokenData" }, "schemeReferenceId": { "type": "string", "description": "A unique identifier assigned by the card network to track the transaction or card across its lifecycle. It is required to send this information for credential on file transactions when intialPayment is false." }, "approvalCodeTel": { "type": "string", "description": "For 3-D Secure: Telephone authorisation code." }, "priorAuthenticationInfo": { "$ref": "#/components/schemas/priorAuthenticationInfo" }, "threeDsData": { "$ref": "#/components/schemas/threeDsData" }, "threeDsSDK": { "$ref": "#/components/schemas/threeDsSDK" }, "dccEnabled": { "type": "boolean", "description": "Defines DCC behavior for integration type hosted: true - forces DCC eligibility check; false - disables DCC; omitted - the merchant’s default MAT configuration is applied." }, "dcc": { "$ref": "#/components/schemas/dcc" } } }, "cardDetailsSpecificFields": { "type": "object", "properties": { "cardHolderName": { "type": "string", "description": "The name of the cardholder as it appears on the payment card." }, "cardholderConsentToStore": { "type": "boolean", "description": "Indicates that the customer explicitly opted in to store their card data for future purchases on the hosted credit card form." }, "pseudoCardNumber": { "type": "string", "description": "Pseudo card number generated by Axepta Online, if the service is activated." }, "first6Digits": { "type": "string", "description": "First 6 digits of card." }, "last4Digits": { "type": "string", "description": "Last 4 digits of the card." }, "expiryDate": { "type": "string", "description": "The expiration date of the card in YYYYMM format." }, "brand": { "type": "string", "description": "The brand or network of the card, such as \"visa\", \"mastercard\"." }, "product": { "type": "string", "description": "Card product name (if available) (e.g. 'Business Premium Debit')." }, "source": { "type": "string", "description": "Card funding source (if available)." }, "type": { "type": "string", "description": "The card type specifies the program, application or card level attached to the card if any (e.g. Classic, Standard, Gold, Business etc.)." }, "issuer": { "type": "string", "description": "Card issuer (if available)." }, "country": { "type": "string", "description": "Country the card was issued in." }, "bin": { "$ref": "#/components/schemas/bin" }, "versioningData": { "$ref": "#/components/schemas/versioningData" }, "fraudData": { "$ref": "#/components/schemas/fraudDataCard" }, "authenticationData": { "$ref": "#/components/schemas/authenticationData" }, "schemeReferenceId": { "type": "string", "description": "Unique identifier assigned by card schemes that is required to be sent in subsequent credential on file transactions." }, "providerApprovalCode": { "type": "string", "description": "Approval code of the transaction." }, "providerResponseCode": { "type": "string", "description": "Provider response code." }, "providerResponseMessage": { "type": "string", "description": "Provider response text." }, "providerTransactionId": { "type": "string", "description": "Transaction ID assigned by the provider." }, "providerToken": { "type": "string", "description": "Provider's token." }, "providerMerchantId": { "type": "string", "description": "Provider Merchant ID." }, "providerTerminalId": { "type": "string", "description": "Provider Terminal ID." }, "providerOrderId": { "type": "string", "description": "Provider Order ID." }, "issuerResponseCode": { "type": "string", "description": "Issuer response code." }, "issuerResponseMessage": { "type": "string", "description": "Issuer response text." }, "dccInfo": { "$ref": "#/components/schemas/dccInfoCard" }, "surcharge": { "$ref": "#/components/schemas/surcharge" } } }, "cardDirectCreateSpecificResponse": { "type": "object", "properties": { "cardHolderName": { "type": "string" }, "pseudoCardNumber": { "type": "string" }, "first6Digits": { "type": "string" }, "last4Digits": { "type": "string" }, "expiryDate": { "type": "string" }, "brand": { "type": "string" }, "product": { "type": "string" }, "source": { "type": "string" }, "type": { "type": "string" }, "issuer": { "type": "string" }, "country": { "type": "string" }, "bin": { "$ref": "#/components/schemas/bin" }, "versioningData": { "$ref": "#/components/schemas/versioningData" }, "fraudData": { "$ref": "#/components/schemas/fraudDataCard" }, "authenticationData": { "$ref": "#/components/schemas/authenticationData" }, "schemeReferenceId": { "type": "string" }, "providerApprovalCode": { "type": "string" }, "providerResponseCode": { "type": "string" }, "providerResponseMessage": { "type": "string" }, "providerTransactionId": { "type": "string" }, "providerToken": { "type": "string" }, "providerMerchantId": { "type": "string" }, "providerTerminalId": { "type": "string" }, "providerOrderId": { "type": "string" }, "issuerResponseCode": { "type": "string" }, "issuerResponseMessage": { "type": "string" } } }, "cardErrorSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string", "description": "Returned only when Acquirer is Clearhaus or MasaPay." }, "providerResponseText": { "type": "string", "description": "Returned only when Acquirer is Clearhaus or MasaPay. Information is passed only when status is FAILED." }, "issuerResponseCode": { "type": "string", "description": "Issuer response code." }, "issuerResponseMessage": { "type": "string", "description": "Issuer response text." } } }, "cardholderAmount": { "type": "object", "properties": { "decimalValue": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": "number", "description": "Cardholder amount converted from merchant amount, expressed with decimal precision.", "format": "double" }, "currency": { "type": "string", "description": "Cardholder currency (ISO 4217 alphabetic code) determined based on the card BIN." }, "value": { "type": "integer", "description": "Cardholder amount converted from merchant amount, expressed as integer value.", "format": "int32" } } }, "cardInfo": { "type": "object", "properties": { "country": { "type": "string" } } }, "cardLinkSpecificFields": { "type": "object", "properties": { "eventToken": { "enum": [ "PRE_AUTH", "PLBS", "ORDER", "ACCOUNT_VERIFICATION", "FINAL_AUTH" ], "type": "string", "description": "Defines specific use cases of card payments, if applicable.\r\n\r\n- DELAYED_SHIPMENT: Passed in initial request, if you intend to capture the request after the shipment is sent.\r\n - PRE_AUTH: Passed in initial request, if the initial payment is a preauthorization.\r\n - PLBS: Passed in initial request, if the payment is related to rental of goods and services and is being initiated as a preauthorization.\r\n - ORDER: Pass if you want to perform authentication and payment in 2 steps. If you pass it, then the payment should be confirmed by calling the Confirm payment endpoint.\r\n - ACCOUNT_VERIFICATION: Pass this if you want to verify card account without initiating a payment transaction. Amount is optional when this value is sent." }, "subType": { "type": "array", "items": { "enum": [ "AIRPLUS", "AMEX", "ARGENCARD", "AURA", "BANCONTACT", "CABAL", "CARTESBANCAIRES", "CBN", "CENCOSUD", "COMFORTCARD", "CUP", "DANKORT", "DINERS", "DISCOVER", "ELO", "HIPERCARD", "JCB", "LASER", "MAESTRO", "MASTERCARD", "NARANJA", "RUPAY", "SHOPPING", "TOTAL", "VISA" ], "type": "string" }, "description": "Used to define the card payment methods that needs to be shown on the payment form. The values here override your default configuration at merchant level." }, "threeDsPolicy": { "$ref": "#/components/schemas/threeDsPolicy" }, "template": { "$ref": "#/components/schemas/creditCardTemplate" }, "prefillInfo": { "$ref": "#/components/schemas/prefillInfoCard" } } }, "cardRefundExSpecificFields": { "type": "object", "properties": { "number": { "type": "string", "description": "The card number or the pseudo card number of the payment card." }, "cardHolderName": { "type": "string" }, "expiryDate": { "type": "string", "description": "The expiration date of the card in YYYYMM format." }, "brand": { "type": "string", "description": "The brand or network of the card, such as \"visa\", \"mastercard\"." }, "securityCode": { "type": "string", "description": "The Card Security Code, also known as CVV or CVC." }, "paymentOfWinnings": { "type": "boolean", "description": "In the case of the acquirer EMS (Omnipay) the merchant can control CFT credit notes in this way.Transfer PaymentOfWinnings=True to credit a win rather than simply repaying a paid amount." }, "paymentData": { "$ref": "#/components/schemas/paymentData" } } }, "cardRefundExSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" }, "providerTransactionId": { "type": "string" }, "providerApprovalCode": { "type": "string" } } }, "cardRefundSpecificFields": { "type": "object", "properties": { "providerTransactionId": { "type": "string", "description": "Transaction ID returned by the provider in the capture response. This is needed for the use cases of multiple captures and if you want to refund a specific capture. If the parameter is not submitted then the last capture will be credited." } } }, "cardRefundSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" }, "providerApprovalCode": { "type": "string" }, "providerTransactionId": { "type": "string" } } }, "cardReversalSpecificFields": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" }, "providerApprovalCode": { "type": "string" }, "providerTransactionId": { "type": "string" } } }, "cardSessionSpecificFields": { "type": "object", "properties": { "eventToken": { "enum": [ "PRE_AUTH", "PLBS", "ORDER", "ACCOUNT_VERIFICATION", "FINAL_AUTH" ], "type": "string", "description": "Defines specific use cases of card payments, if applicable.\r\n\r\n- DELAYED_SHIPMENT: Passed in initial request, if you intend to capture the request after the shipment is sent.\r\n - PRE_AUTH: Passed in initial request, if the initial payment is a preauthorization.\r\n - PLBS: Passed in initial request, if the payment is related to rental of goods and services and is being initiated as a preauthorization.\r\n - ORDER: Pass if you want to perform authentication and payment in 2 steps. If you pass it, then the payment should be confirmed by calling the Confirm payment endpoint.\r\n - ACCOUNT_VERIFICATION: Pass this if you want to verify card account without initiating a payment transaction. Amount is optional when this value is sent." }, "subType": { "type": "array", "items": { "enum": [ "AIRPLUS", "AMEX", "ARGENCARD", "AURA", "BANCONTACT", "CABAL", "CARTESBANCAIRES", "CBN", "CENCOSUD", "COMFORTCARD", "CUP", "DANKORT", "DINERS", "DISCOVER", "ELO", "HIPERCARD", "JCB", "LASER", "MAESTRO", "MASTERCARD", "NARANJA", "RUPAY", "SHOPPING", "TOTAL", "VISA" ], "type": "string" }, "description": "Used to define the card payment methods that needs to be shown on the payment form. The values here override your default configuration at merchant level." }, "threeDsPolicy": { "$ref": "#/components/schemas/threeDsPolicy" }, "template": { "$ref": "#/components/schemas/creditCardTemplate" }, "prefillInfo": { "$ref": "#/components/schemas/prefillInfoCard" }, "dccEnabled": { "type": "boolean", "description": "Defines DCC behavior: true - forces DCC eligibility check; false - disables DCC; omitted - the merchant’s default MAT configuration is applied." } } }, "carRental": { "type": "object", "properties": { "common": { "$ref": "#/components/schemas/carRentalCommon" }, "airPlus": { "$ref": "#/components/schemas/airPlus" }, "amex": { "$ref": "#/components/schemas/amex" } } }, "carRentalCommon": { "type": "object", "properties": { "rentalAgreementNumber": { "type": "string" }, "rentalStart": { "description": "Date and Time are both passed.", "format": "date-time" }, "return": { "description": "Date and Time are both passed.", "format": "date-time" }, "pickupLocation": { "$ref": "#/components/schemas/address" }, "dropOffLocation": { "$ref": "#/components/schemas/address" }, "daysHired": { "type": "integer", "format": "int32" }, "carClass": { "type": "string" }, "carRegistrationNumber": { "type": "string" }, "renterName": { "type": "string" }, "renterAddress": { "$ref": "#/components/schemas/address" }, "noShowIndicator": { "type": "boolean" }, "reservationNumber": { "type": "string" }, "rentalDetails": { "$ref": "#/components/schemas/rentalDetails" }, "extraCharges": { "$ref": "#/components/schemas/extraCharges" }, "pointOfSale": { "$ref": "#/components/schemas/pointOfSale" } } }, "carSharing": { "type": "object", "properties": { "amounts": { "$ref": "#/components/schemas/amountCapture" }, "nonVATableNetAmount": { "type": "integer", "format": "int32" }, "tax": { "$ref": "#/components/schemas/tax" }, "taxTypeIndicator": { "enum": [ "NOVAT", "NONDEDUCTIBLE_CITY_VAT", "NONDEDUCTIBLE_STATE", "DEDUCTIBLE_CITY_VAT", "DEDUCTIBLE_STATE", "DEDUCTIBLE_NATIONAL_VAT", "EU_REVERSE_CHARGE" ], "type": "string" }, "documentNumber": { "type": "string", "description": "Size: 10, internal document number of the related service as printed on the voucher, train-ticket, etc." }, "serviceDescription": { "type": "string", "description": "Size: 135, will be parsed into 3 sub-fields with 45 digits each" }, "serviceType": { "type": "string" }, "hotelBookingDetails": { "$ref": "#/components/schemas/hotelBookingDetails" } } }, "challengeRequest": { "type": "object", "properties": { "threeDSServerTransId": { "type": "string", "description": "payId." }, "acsTransID": { "type": "string" }, "challengeWindowSize": { "type": "string", "description": "Dimensions of the challenge window that will be displayed to the Cardholder. The ACS shall reply with content that is formatted to appropriately render in this window to provide the best possible user experience.\r\n\r\nPreconfigured sizes are width x height in pixels of the window displayed in the Cardholder browser window.\r\n\r\nValues accepted:\r\n\r\nPaygate will determine the best window size according to the browserInfo for server-to-server requests." }, "messageVersion": { "type": "string", "description": "Protocol version identifier" }, "messageType": { "type": "string", "description": "Identifies the Message Type.\r\n\r\nValues accepted:" } } }, "cloudPOSRequest": { "required": [ "transId", "messageType", "amount", "posTerminalId", "localDateTime" ], "type": "object", "properties": { "transId": { "type": "string" }, "messageType": { "enum": [ "SALE", "REVERSE", "CREDIT", "AUTHORISATION_OR_RESERVATION", "CAPTURE", "CARD_READ", "DIAGNOSE", "TERMINAL_STARTUP" ], "type": "string" }, "refNr": { "type": "string" }, "amount": { "$ref": "#/components/schemas/amountMini" }, "posTerminalId": { "type": "string" }, "cardReadMode": { "enum": [ "MSR" ], "type": "string" }, "localDateTime": { "format": "date-time" }, "traceNr": { "type": "string" }, "approvalCode": { "type": "string" }, "credentialOnFile": { "$ref": "#/components/schemas/credentialOnFileCloudPos" }, "contractId": { "type": "string" } } }, "cloudPOSResponse": { "type": "object", "properties": { "status": { "type": "string" }, "responseCode": { "type": "string" }, "responseDescription": { "type": "string" }, "refNr": { "type": "string" }, "payId": { "type": "string" }, "merchantId": { "type": "string" }, "transId": { "type": "string" }, "contractId": { "type": "string" }, "terminalId": { "type": "string" }, "posTerminalId": { "type": "string" }, "providerResponseCode": { "type": "string" }, "traceNr": { "type": "string" }, "vuNr": { "type": "string" }, "additionalResponseData": { "type": "string" }, "approvalCode": { "type": "string" }, "localDateTime": { "format": "date-time" }, "aidParameters": { "type": "string" }, "verificationCode": { "type": "string" }, "receipt": { "$ref": "#/components/schemas/receipt" }, "dcc": { "$ref": "#/components/schemas/dccCloudPos" }, "credentialOnFile": { "$ref": "#/components/schemas/credentialOnFileCloudPos" }, "paymentMethod": { "$ref": "#/components/schemas/paymentMethodCloudPos" } } }, "common": { "type": "object", "properties": { "amounts": { "$ref": "#/components/schemas/amountCapture" }, "tax": { "$ref": "#/components/schemas/tax" } } }, "computopProblemDetails": { "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "string" }, "detail": { "type": "string" }, "instance": { "type": "string" } } }, "computopValidationProblemDetails": { "type": "object", "properties": { "errors": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } }, "description": " \"Object\": [\r\n \"Error 1\",\r\n \"Error 2\"\r\n ]\r\n}`", "example": { "Object": [ "Error 1", "Error 2" ] } }, "type": { "type": "string", "description": "A URI reference that identifies the problem type", "example": "https://tools.ietf.org/html/rfc9110#section-15.5.1" }, "title": { "type": "string", "description": "A short, human-readable summary of the problem type", "example": "One or more validation errors occurred." }, "status": { "type": "string", "description": "The HTTP status code", "example": 400 }, "detail": { "type": "string" }, "instance": { "type": "string" } } }, "confirmIntentApiRequest": { "required": [ "paymentMethods" ], "type": "object", "properties": { "channel": { "enum": [ "ECOM", "MOTO", "APP", "PAYBYLINK", "POS" ], "type": "string" }, "cardholderConsentToStore": { "type": "boolean" }, "credentialOnFile": { "$ref": "#/components/schemas/credentialOnFile" }, "urls": { "$ref": "#/components/schemas/confirmIntentUrls" }, "paymentMethods": { "$ref": "#/components/schemas/confirmIntentPaymentMethods" } } }, "confirmIntentPaymentMethods": { "type": "object", "properties": { "type": { "type": "string" }, "integrationType": { "enum": [ "DIRECT", "HOSTED" ], "type": "string" }, "card": { "$ref": "#/components/schemas/cardConfirmIntentSpecificFields" }, "applePay": { "$ref": "#/components/schemas/applePayCreateSpecificFields" }, "googlePay": { "$ref": "#/components/schemas/googlePayCreateSpecificFields" } } }, "confirmIntentUrls": { "type": "object", "properties": { "return": { "type": "string" }, "cancel": { "type": "string" }, "appRedirect": { "type": "string" } } }, "confirmRequest": { "required": [ "transId", "amount" ], "type": "object", "properties": { "transId": { "maxLength": 64, "type": "string", "description": "Transaction ID created in your system. It should be unique for each payment." }, "amount": { "$ref": "#/components/schemas/amount" }, "refNr": { "type": "string", "description": "Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually." }, "captureMethod": { "$ref": "#/components/schemas/captureMethod" }, "expirationTime": { "description": "Transaction expiry timestamp (UTC).", "format": "date-time", "example": "2025-02-07T16:00:00Z" }, "order": { "$ref": "#/components/schemas/order" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs passed by you. Paygate will return the data as it is in the response." }, "billingAddress": { "$ref": "#/components/schemas/billingAddress" }, "shipping": { "$ref": "#/components/schemas/shipping" }, "paymentMethods": { "$ref": "#/components/schemas/paymentConfirm" }, "credentialOnFile": { "$ref": "#/components/schemas/credentialOnFile" } } }, "confirmResponse": { "type": "object", "properties": { "order": { "$ref": "#/components/schemas/order" }, "customerInfo": { "$ref": "#/components/schemas/customerInfo" }, "payId": { "type": "string", "description": "A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation." }, "merchantId": { "type": "string", "description": "Merchant ID assigned by Axepta Online." }, "transId": { "type": "string", "description": "Transaction ID provided by you in the request." }, "xId": { "type": "string", "description": "A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same." }, "refNr": { "type": "string", "description": "Reference number provided by you in the request." }, "status": { "type": "string", "description": "Status of the transaction." }, "responseCode": { "type": "string", "description": "Response code of the transaction." }, "responseDescription": { "type": "string", "description": "Response description associated with the response code." }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs as you passed in the request." }, "paymentMethods": { "$ref": "#/components/schemas/paymentDataResponseBase" } } }, "countryRestriction": { "type": "object", "properties": { "statesOrRegions": { "type": "array", "items": { "type": "string" } }, "zipCodes": { "type": "array", "items": { "type": "string" } } } }, "createChargeApiResponse": { "type": "object", "properties": { "paymentPlanId": { "type": "string", "description": "The Id of payment plan" }, "payId": { "type": "string", "description": "A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation." }, "merchantId": { "type": "string", "description": "Merchant ID assigned by Axepta Online." }, "transId": { "type": "string", "description": "Transaction ID provided by you in the request." }, "xId": { "type": "string", "description": "A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same." }, "refNr": { "type": "string", "description": "Reference number provided by you in the request." }, "status": { "type": "string", "description": "Status of the transaction." }, "responseCode": { "type": "string", "description": "Response code of the transaction." }, "responseDescription": { "type": "string", "description": "Response description associated with the response code." }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs as you passed in the request." }, "paymentMethods": { "$ref": "#/components/schemas/paymentDataResponseBase" } } }, "createIntentApiRequest": { "type": "object", "properties": { "transId": { "type": "string" }, "externalIntegrationId": { "type": "string" }, "refNr": { "type": "string" }, "amount": { "$ref": "#/components/schemas/amount" }, "language": { "type": "string" }, "captureMethod": { "$ref": "#/components/schemas/captureMethod" }, "order": { "$ref": "#/components/schemas/order" }, "urls": { "$ref": "#/components/schemas/intentUrls" }, "billingAddress": { "$ref": "#/components/schemas/billingAddress" }, "shipping": { "$ref": "#/components/schemas/shipping" }, "statementDescriptor": { "type": "string" }, "customerInfo": { "$ref": "#/components/schemas/customerInfo" }, "expirationTime": { "format": "date-time" }, "fraudData": { "$ref": "#/components/schemas/fraudData" }, "paymentFacilitator": { "$ref": "#/components/schemas/paymentFacilitator" }, "partialPayment": { "type": "boolean" }, "device": { "$ref": "#/components/schemas/device" }, "credentialOnFile": { "$ref": "#/components/schemas/credentialOnFile" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "paymentMethods": { "$ref": "#/components/schemas/paymentCreateIntent" } } }, "createPaymentIntentSuccessResponse": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "string" } } }, "createPseudoNumberRequest": { "required": [ "accountNumber" ], "type": "object", "properties": { "transId": { "maxLength": 64, "type": "string" }, "accountNumber": { "type": "string" }, "accountType": { "type": "string" } } }, "createPseudoNumberResponse": { "type": "object", "properties": { "pseudoAccountNumber": { "type": "string" }, "accountType": { "type": "string" }, "status": { "type": "string" }, "code": { "type": "string" }, "description": { "type": "string" } } }, "createResponse": { "type": "object", "properties": { "paymentPlanId": { "type": "string" }, "payId": { "type": "string" }, "merchantId": { "type": "string" }, "transId": { "type": "string" }, "xId": { "type": "string" }, "refNr": { "type": "string" }, "status": { "type": "string" }, "responseCode": { "type": "string" }, "responseDescription": { "type": "string" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "paymentMethods": { "$ref": "#/components/schemas/paymentDataResponseBase" } } }, "credentialOnFile": { "required": [ "type" ], "type": "object", "properties": { "type": { "enum": [ "RECURRING", "UNSCHEDULED", "INSTALLMENTS", "DELAYED_SHIPMENT" ], "type": "string", "description": "Indicates the type of credential-on-file transaction." }, "initialPayment": { "type": "boolean", "description": "Specifies whether the transaction is the initial payment in a credential-on-file setup." }, "recurring": { "$ref": "#/components/schemas/recurring" }, "unscheduled": { "$ref": "#/components/schemas/credentialOnFileTypeUnscheduled" }, "installments": { "$ref": "#/components/schemas/installments" } } }, "credentialOnFileCloudPos": { "type": "object", "properties": { "type": { "enum": [ "RECURRING", "UNSCHEDULED" ], "type": "string" }, "initialPayment": { "type": "boolean" }, "unscheduled": { "$ref": "#/components/schemas/credentialOnFileTypeUnscheduledCloudPos" } } }, "credentialOnFileTypeUnscheduled": { "type": "object", "properties": { "subType": { "enum": [ "CIT", "MIT" ], "type": "string", "description": "Specifies the sub-type of an unscheduled credential-on-file transaction." } } }, "credentialOnFileTypeUnscheduledCloudPos": { "type": "object", "properties": { "subType": { "enum": [ "CIT" ], "type": "string" } } }, "creditCardTemplate": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the card template being used for customization." }, "backgroundColor": { "type": "string", "description": "The background color of the card template, specified in hexadecimal format." }, "backgroundImage": { "type": "string", "description": "A URL pointing to an image used as the background of the card template." }, "textColor": { "type": "string", "description": "The color of the text on the card template, specified in hexadecimal format." }, "fontName": { "type": "string", "description": "The name of the font used for text on the card template." }, "fontSize": { "type": "integer", "description": "The size of the text on the card template, specified in pixels (px).", "format": "int32" }, "tableWidth": { "type": "integer", "description": "Specifies the width of a table element within the card template layout, specified in pixels (px).", "format": "int32" }, "tableHeight": { "type": "integer", "description": "Specifies the height of a table element within the card template layout, specified in pixels (px).", "format": "int32" }, "customFields": { "$ref": "#/components/schemas/customFields" } }, "description": "Applicable only when paymentMethods.integrationType=HOSTED." }, "customerDetailsResponse": { "type": "object", "properties": { "billingAddress": { "$ref": "#/components/schemas/billingAddressCustomer" }, "lastUsedAt": { "description": "Last used date and time in ISO 8601 format.", "format": "date-time" }, "id": { "type": "string", "description": "Unique identifier of the customer assigned by Paygate." }, "merchantCustomerId": { "type": "string", "description": "Unique identifier of the customer assigned by merchant." }, "firstName": { "type": "string", "description": "First name of the customer. Present if passed by merchant in Payment." }, "lastName": { "type": "string", "description": "Last name of the customer. Present if passed by merchant in Payment." }, "companyName": { "type": "string", "description": "Last name of the customer. Present if passed by merchant in Payment." }, "email": { "type": "string", "description": "E-mail address of the customer. Present if passed by merchant in Payment." }, "phone": { "$ref": "#/components/schemas/phone" }, "scope": { "type": "string", "description": "Scope of customer vault. Present if configured for the merchant in MAT." }, "createdAt": { "description": "Creation date and time in ISO 8601 format.", "format": "date-time" }, "updatedAt": { "description": "Update date and time in ISO 8601 format.", "format": "date-time" } } }, "customerHistory": { "type": "object", "properties": { "canceledOrderAmount": { "type": "integer", "description": "Total amount in cents of orders cancelled in the last 2 years.", "format": "int32" }, "canceledOrderCount": { "type": "integer", "description": "Number of orders placed and cancelled by the customer in the last 2 years.", "format": "int32" }, "firstOrderDate": { "description": "Date of first customer order in format DD/MM/YYYY.", "format": "date-time" }, "fraudAlertCount": { "type": "integer", "description": "Number of fraud alerts regarding customer orders in the last 2 years.", "format": "int32" }, "lastOrderDate": { "description": "Date of last customer order in format DD/MM/YYYY.", "format": "date-time" }, "paymentIncidentCount": { "type": "integer", "description": "Number of payment incidents involving customer orders in the last 2 years.", "format": "int32" }, "refusedManyTimesOrderCount": { "type": "integer", "description": "Number of orders whose payment in instalments has been refused in the last 2 years.", "format": "int32" }, "unvalidatedOrderCount": { "type": "integer", "description": "Number of orders refused in the validation phase in the last 2 years.", "format": "int32" }, "validatedOneTimeOrderCount": { "type": "integer", "description": "Number of orders paid in 1 installment in the last 2 years.", "format": "int32" }, "validatedOrderCount": { "type": "integer", "description": "Number of orders validated in the last 2 years.", "format": "int32" }, "clientIpAddressRecurrence": { "type": "integer", "description": "Customer IP address recurrence in the last 2 years.", "format": "int32" }, "ongoingLitigationOrderAmount": { "type": "integer", "description": "Current amounts in dispute not settled.", "format": "int32" }, "paidLitigationOrderAmount": { "type": "integer", "description": "Amount of litigation settled in the last 2 years.", "format": "int32" }, "scoreSimulationCount": { "type": "integer", "description": "Number of simulated scores in the last 7 days.", "format": "int32" } } }, "customerInfo": { "type": "object", "properties": { "merchantCustomerId": { "type": "string", "description": "A unique identifier for the customer, assigned by the merchant's system." }, "customerType": { "enum": [ "BUSINESS", "INDIVIDUAL" ], "type": "string", "description": "Specifies the type of customer, such as \"individual\" or \"business\"." }, "firstName": { "maxLength": 50, "type": "string", "description": "First name of the customer." }, "lastName": { "maxLength": 50, "type": "string", "description": "Last name (surname) of the customer." }, "email": { "maxLength": 256, "type": "string", "description": "Email address of the customer." }, "phone": { "$ref": "#/components/schemas/phone" }, "salutation": { "type": "string", "description": "Salutation used to address the customer, such as \"Mr\", \"Mrs\", \"Miss \"." }, "title": { "type": "string", "description": "Any additional title or designation associated with the customer, such as \"Dr\", etc." }, "gender": { "type": "string", "description": "Gender of the customer." }, "maidenName": { "type": "string", "description": "Maiden name of the customer." }, "middleName": { "type": "string", "description": "Middle name of the customer." }, "birthDate": { "description": "Birth date of the customer in YYYY-MM-DD format.", "format": "date-time" }, "birthPlace": { "type": "string", "description": "Place of birth of the customer." }, "socialSecurityNumber": { "type": "string", "description": "Customer's Social Security Number." }, "taxId": { "type": "string", "description": "Tax identification number associated with the customer." }, "companyName": { "maxLength": 50, "type": "string", "description": "Name of the company if the customer is a business entity." }, "positionOccupied": { "type": "string", "description": "Position or role occupied by the individual within their company." }, "companyRegistrationNumber": { "type": "string", "description": "Official registration number of the company in its country of incorporation." }, "companyVatId": { "type": "string", "description": "Value Added Tax (VAT) identification number for the company." }, "companyLegalForm": { "type": "string", "description": "The legal form or structure of the company." } }, "description": "Information about the customer." }, "customerInfoDuplicationCheck": { "type": "object", "properties": { "merchantCustomerId": { "type": "string", "description": "A unique identifier for the customer, assigned by the merchant's system." } }, "description": "Information about the customer." }, "customerInfoRefundEx": { "type": "object", "properties": { "merchantCustomerId": { "type": "string", "description": "A unique identifier for the customer, assigned by the merchant's system." }, "customerType": { "enum": [ "BUSINESS", "INDIVIDUAL" ], "type": "string", "description": "Specifies the type of customer, such as \"individual\" or \"business\"." }, "firstName": { "type": "string", "description": "First name of the customer." }, "lastName": { "type": "string", "description": "Last name (surname) of the customer." }, "email": { "type": "string", "description": "Email address of the customer." }, "phone": { "$ref": "#/components/schemas/phone" }, "birthDate": { "description": "Birth date of the customer in YYYY-MM-DD format.", "format": "date-time" } } }, "customerInfoUpdate": { "type": "object", "properties": { "title": { "type": "string", "description": "Any additional title or designation associated with the customer, such as \"Dr\", etc." }, "firstName": { "type": "string", "description": "First name of the customer." }, "lastName": { "type": "string", "description": "Last name (surname) of the customer." }, "companyName": { "type": "string", "description": "Name of the company if the customer is a business entity." }, "email": { "type": "string", "description": "Email address of the customer." }, "phone": { "$ref": "#/components/schemas/phone" } }, "description": "Information about the customer." }, "customersDetailsResponse": { "type": "object", "properties": { "totalNumberOfPages": { "type": "integer", "description": "Indicates total number of pages that exist.", "format": "int32" }, "totalNumberOfItems": { "type": "integer", "description": "Indicates total number of items that exist.", "format": "int32" }, "page": { "type": "integer", "description": "Indicates number of page that is retrieved.", "format": "int32" }, "pageSize": { "type": "integer", "description": "Indicates max number of items on page.", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/baseCustomerData" } } } }, "customersPaymentMethodsResponse": { "type": "object", "properties": { "gatewayCustomerId": { "type": "string" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/paymentMethodsResponse" } } } }, "customFields": { "type": "object", "properties": { "customField1": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField2": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField3": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField4": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField5": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField6": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField7": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField8": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField9": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField10": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField11": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField12": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField13": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." }, "customField14": { "type": "string", "description": "Customizable fields that can store additional data or display specific information on a card template." } }, "description": "Customizable fields that can store additional data or display specific information on the Hosted Payment Page template." }, "dcc": { "type": "object", "properties": { "selected": { "type": "boolean", "description": "Customer decision: true = opted in, false = opted out. Required if dcc object is present." }, "dccRequestId": { "type": "string", "description": "Identifier of the DCC quote. Required if selected is true." } }, "description": "Carries the customer’s DCC decision for integration type direct. Required when the customer opts into DCC." }, "dccCloudPos": { "type": "object", "properties": { "foreignAmount": { "type": "integer", "format": "int32" }, "foreignCurrencyCode": { "type": "string" }, "commission": { "type": "string" }, "margin": { "type": "string" }, "rateValue": { "type": "string" }, "source": { "type": "string" }, "timestamp": { "type": "string" }, "disclaimerText": { "type": "string" } } }, "dccInfo": { "type": "object", "properties": { "status": { "enum": [ "AVAILABLE", "NOT_AVAILABLE" ], "type": "string" }, "provider": { "type": "string" }, "dccRequestId": { "type": "string" }, "rate": { "$ref": "#/components/schemas/rate" }, "amounts": { "$ref": "#/components/schemas/amounts" } } }, "dccInfoCard": { "type": "object", "properties": { "dccSelected": { "type": "boolean", "description": "Indicates the cardholder chose DCC and the transaction was processed in the cardholder currency." }, "provider": { "type": "string", "description": "DCC service provider identifier." }, "rate": { "$ref": "#/components/schemas/rate" }, "amounts": { "$ref": "#/components/schemas/amounts" } } }, "dccQuoteRequest": { "required": [ "amount" ], "type": "object", "properties": { "bin": { "maxLength": 10, "minLength": 10, "pattern": "^[0-9]+$", "type": "string" }, "pseudoCardNumber": { "type": "string" }, "amount": { "$ref": "#/components/schemas/amountMini" } } }, "dccQuoteResponse": { "type": "object", "properties": { "dccInfo": { "$ref": "#/components/schemas/dccInfo" } } }, "delayed": { "type": "object", "properties": { "delayedHours": { "type": "integer", "description": "Defines the delay period, in hours, before an authorized payment is automatically captured. Required if type is delayed. Minimum: 1, maximum: 696", "format": "int32" } } }, "deleteCustomerResponse": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique identifier of the customer assigned by Paygate." }, "deleted": { "type": "boolean", "description": "Indicates if the payment method record was deleted or not." } } }, "deletePaymentMethodResponse": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique ID assigned by Paygate for the payment method record." }, "deleted": { "type": "boolean", "description": "Indicates if the payment method record was deleted or not." } } }, "device": { "type": "object", "properties": { "deviceId": { "type": "string", "description": "Unique Device-ID." }, "deviceType": { "enum": [ "DESKTOP", "TABLET", "SMARTPHONE" ], "type": "string" }, "deviceOs": { "enum": [ "ANDROID", "IOS", "OTHERS" ], "type": "string" }, "ipAddress": { "type": "string", "description": "The device's IP address." }, "confidence": { "type": "integer", "description": "A numerical value that indicates the level of confidence in the identification or verification of the customer's device. 0=no allocation, 100=absolutely safe allocation.", "format": "int32" }, "newDevice": { "type": "boolean", "description": "Indicates whether the device being used is new or has not been previously recognized by the system." }, "isAnonymousProxyUsed": { "type": "boolean", "description": "Specifies whether the customer is using an anonymous proxy to mask their IP address." }, "isProxyUsed": { "type": "boolean", "description": "Indicates whether any kind of proxy is being used by the customer." }, "country": { "type": "string", "description": "The country associated with the device's IP address." }, "city": { "type": "string", "description": "The city associated with the device's IP address." }, "latitude": { "type": "string", "description": "The latitude coordinate of the device's location." }, "longitude": { "type": "string", "description": "The longitude coordinate of the device's location." }, "fraudScore": { "type": "integer", "description": "A numerical score that indicates the likelihood of fraudulent activity associated with the device.", "format": "int32" }, "fraudScoreRules": { "type": "array", "items": { "type": "string" }, "description": "A list or description of the rules or criteria that contributed to the fraud score calculation for the device." }, "browserLanguages": { "type": "array", "items": { "type": "string" }, "description": "A list of languages configured in the browser being used on the device." }, "isMobileDevice": { "type": "boolean", "description": "Indicates whether the device being used is a mobile device." }, "fraud": { "type": "string", "description": "Indicates whether the device has been flagged as potentially fraudulent based on predefined criteria. e.g. fraud, suspicion, nofraud." } } }, "directDebit": { "type": "object", "properties": { "accountNumber": { "type": "string" } } }, "directDebitCaptureSpecificFields": { "type": "object", "properties": { "mandateId": { "type": "string", "description": "for SEPA: SEPA mandate number (compulsory in the case of SEPA). Should be unique, is not case-sensitive. Permissible characters: numbers 0-9, upper case letters A-Z, lower case letters a-z, apostrophe, colon, question mark, comma, full stop, plus sign, minus sign, forward slash, left and right bracket." }, "dateOfSignature": { "description": "for SEPA: Date of issuing the mandate in the format YYYY-MM-DD (obligatory when transferring the MandateID).", "format": "date-time" } } }, "directDebitCreateSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/accountCreateDirectDebit" }, "mandate": { "$ref": "#/components/schemas/mandate" }, "method": { "enum": [ "ELV", "ENL", "EEV" ], "type": "string", "description": "Direct debit in Germany=ELV, Netherlands=ENL, Austria=EEV" }, "debitDelay": { "type": "integer", "description": "For SEPA: Number of bank working days >0 which has to be added for the execution date of direct debit.", "format": "int32" }, "service": { "type": "string", "description": "Products or service sold." }, "sellingPoint": { "type": "string", "description": "Selling point." }, "template": { "$ref": "#/components/schemas/directDebitTemplate" }, "prefillInfo": { "$ref": "#/components/schemas/prefillInfoDirectDebit" } } }, "directDebitCreateSpecificResponse": { "type": "object", "properties": { "mandateId": { "type": "string" }, "dateOfSignature": { "type": "string" }, "account": { "$ref": "#/components/schemas/accountDirectDebitResponse" }, "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" } } }, "directDebitDetailsSpecificFields": { "type": "object", "properties": { "method": { "type": "string", "description": "Direct debit in Germany:=ELV, Netherlands=ENL, Austria=EEV." }, "service": { "type": "string", "description": "Products or service sold." }, "sellingPoint": { "type": "string", "description": "Selling point." }, "mandateId": { "type": "string", "description": "SEPA Mandate ID for the transaction." }, "dateOfSignature": { "type": "string", "description": "Date of issuing the mandate in format YYYY-MM-DD." }, "account": { "$ref": "#/components/schemas/accountDirectDebitResponse" }, "providerResponseCode": { "type": "string", "description": "Provider response code" }, "providerResponseText": { "type": "string", "description": "Provider response text." } } }, "directDebitErrorSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string", "description": "Provider response code." }, "providerResponseText": { "type": "string", "description": "Provider response text." } } }, "directDebitLinkSpecificFields": { "type": "object", "properties": { "method": { "enum": [ "ELV", "ENL", "EEV" ], "type": "string", "description": "Direct debit in Germany=ELV, Netherlands=ENL, Austria=EEV" }, "debitDelay": { "type": "integer", "description": "For SEPA: Number of bank working days >0 which has to be added for the execution date of direct debit.", "format": "int32" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "mandate": { "$ref": "#/components/schemas/sessionAndLinkMandate" }, "template": { "$ref": "#/components/schemas/directDebitTemplate" }, "prefillInfo": { "$ref": "#/components/schemas/sessionAndLinkPrefillInfo" } } }, "directDebitRefundExSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/accountDirectDebitRequest" } } }, "directDebitSessionSpecificFields": { "type": "object", "properties": { "method": { "enum": [ "ELV", "ENL", "EEV" ], "type": "string", "description": "Direct debit in Germany=ELV, Netherlands=ENL, Austria=EEV" }, "debitDelay": { "type": "integer", "description": "For SEPA: Number of bank working days >0 which has to be added for the execution date of direct debit.", "format": "int32" }, "service": { "type": "string", "description": "Products or service sold." }, "sellingPoint": { "type": "string", "description": "Selling point." }, "mandate": { "$ref": "#/components/schemas/sessionAndLinkMandate" }, "template": { "$ref": "#/components/schemas/directDebitTemplate" }, "prefillInfo": { "$ref": "#/components/schemas/sessionAndLinkPrefillInfo" } } }, "directDebitTemplate": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the card template being used for customization." }, "backgroundColor": { "type": "string", "description": "The background color of the card template, specified in hexadecimal format." }, "backgroundImage": { "type": "string", "description": "A URL pointing to an image used as the background of the card template." }, "textColor": { "type": "string", "description": "The color of the text on the card template, specified in hexadecimal format." }, "fontName": { "type": "string", "description": "The name of the font used for text on the card template." }, "fontSize": { "type": "integer", "description": "The size of the text on the card template, specified in pixels (px).", "format": "int32" }, "tableWidth": { "type": "integer", "description": "Specifies the width of a table element within the card template layout, specified in pixels (px).", "format": "int32" }, "tableHeight": { "type": "integer", "description": "Specifies the height of a table element within the card template layout, specified in pixels (px).", "format": "int32" }, "customFields": { "$ref": "#/components/schemas/customFields" } } }, "duplicationCheckRequest": { "type": "object", "properties": { "partialPayment": { "type": "boolean", "description": "Defines if the payment is a partial payment. Possible values: true or false." }, "amount": { "$ref": "#/components/schemas/amountDuplicationCheck" }, "customerInfo": { "$ref": "#/components/schemas/customerInfoDuplicationCheck" }, "order": { "$ref": "#/components/schemas/orderDuplicationCheck" } } }, "duplicationCheckResponse": { "type": "object", "properties": { "status": { "type": "string", "description": "Status of the transaction." }, "responseCode": { "type": "string", "description": "Response code of the transaction." }, "responseDescription": { "type": "string", "description": "Response description associated with the response code." }, "payId": { "type": "string", "description": "A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation." }, "merchantId": { "type": "string", "description": "Merchant ID assigned by Axepta Online." }, "transId": { "type": "string", "description": "Transaction ID provided by you in the request." }, "xId": { "type": "string", "description": "A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same." }, "refNr": { "type": "string", "description": "Reference number provided by you in the request." }, "transactionDate": { "type": "string", "description": "Date that the transaction was created in format YYYY-MM-DD." } } }, "easyCollectCreateSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/accountEasyCollectRequest" }, "accountId": { "type": "string" }, "contractId": { "type": "string", "description": "Underlying contract identifier." }, "contractDescription": { "type": "string", "description": "Underlying contract description." }, "signatureAgreementType": { "enum": [ "SMS", "EMAIL" ], "type": "string", "description": "The way how the OneTimePassword (OTP) will be forwarded to the customer." }, "documentSignature": { "type": "boolean", "description": "The stamp is added on the last page of the mandate document." }, "googleAnalyticsConsent": { "type": "boolean", "description": "Debtor consent to use google analytics." }, "signatureBySca": { "type": "boolean", "description": "If \"true\" customer will be authenticated by AccountIdentificationService." }, "sps": { "type": "boolean", "description": "Allows to identify that WS call comes from SPS." }, "validation": { "type": "boolean", "description": "If Validation = TRUE --> ORG / If Validation = FALSE --> OTU" }, "customerType": { "enum": [ "Known", "Prospect" ], "type": "string", "description": "Type of customer." }, "dueDate": { "description": "DueDate of this transaction. If missing the current day will be used. Pattern: YYYY-MM-DD", "format": "date-time" }, "mandateId": { "type": "string", "description": "The mandate id which has been retrieved via EasyCollect." }, "mandateType": { "enum": [ "B2B", "CORE", "CORE_BUSINESS" ], "type": "string", "description": "Indicates whether the mandate is a business-to-business mandate or a customer-to-business mandate." }, "eventToken": { "enum": [ "PAYMENT_ONLY", "MANDATE_ONLY", "MANDATE_WITH_PAYMENT" ], "type": "string", "description": "Creates a new mandate and first direct debit transaction simultaneously." }, "template": { "$ref": "#/components/schemas/easyCollectTemplate" } } }, "easyCollectCreateSpecificResponse": { "type": "object", "properties": { "mandateId": { "type": "string" }, "dateOfSignature": { "type": "string" }, "account": { "$ref": "#/components/schemas/accountEasyCollectResponse" }, "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" } } }, "easyCollectDetailsSpecificFields": { "type": "object", "properties": { "method": { "type": "string", "description": "Direct debit in Germany:=ELV, Netherlands=ENL, Austria=EEV." }, "service": { "type": "string", "description": "Products or service sold." }, "sellingPoint": { "type": "string", "description": "Selling point." }, "mandateId": { "type": "string", "description": "SEPA Mandate ID for the transaction." }, "dateOfSignature": { "type": "string", "description": "Date of issuing the mandate in format YYYY-MM-DD." }, "account": { "$ref": "#/components/schemas/accountEasyCollectResponse" }, "providerResponseCode": { "type": "string", "description": "Provider response code" }, "providerResponseText": { "type": "string", "description": "Provider response text." } } }, "easyCollectErrorSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string", "description": "Provider response code." }, "providerResponseText": { "type": "string", "description": "Provider response text." } } }, "easyCollectLinkSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/accountEasyCollectLink" }, "accountId": { "type": "string" }, "contractId": { "type": "string", "description": "Underlying contract identifier." }, "contractDescription": { "type": "string", "description": "Underlying contract description." }, "signatureAgreementType": { "enum": [ "SMS", "EMAIL" ], "type": "string", "description": "The way how the OneTimePassword (OTP) will be forwarded to the customer." }, "documentSignature": { "type": "boolean", "description": "The stamp is added on the last page of the mandate document." }, "googleAnalyticsConsent": { "type": "boolean", "description": "Debtor consent to use google analytics." }, "signatureBySca": { "type": "boolean", "description": "If \"true\" customer will be authenticated by AccountIdentificationService." }, "sps": { "type": "boolean", "description": "Allows to identify that WS call comes from SPS." }, "validation": { "type": "boolean", "description": "If Validation = TRUE --> ORG / If Validation = FALSE --> OTU" }, "customerType": { "enum": [ "Known", "Prospect" ], "type": "string", "description": "Type of customer." }, "dueDate": { "description": "DueDate of this transaction. If missing the current day will be used. Pattern: YYYY-MM-DD", "format": "date-time" }, "mandateId": { "type": "string", "description": "The mandate id which has been retrieved via EasyCollect." }, "mandateType": { "enum": [ "B2B", "CORE", "CORE_BUSINESS" ], "type": "string", "description": "Indicates whether the mandate is a business-to-business mandate or a customer-to-business mandate." }, "eventToken": { "enum": [ "PAYMENT_ONLY", "MANDATE_ONLY", "MANDATE_WITH_PAYMENT" ], "type": "string", "description": "Creates a new mandate and first direct debit transaction simultaneously." }, "template": { "$ref": "#/components/schemas/easyCollectTemplate" } } }, "easyCollectSessionSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/accountEasyCollect" }, "accountId": { "type": "string" }, "contractId": { "type": "string", "description": "Underlying contract identifier." }, "contractDescription": { "type": "string", "description": "Underlying contract description." }, "signatureAgreementType": { "enum": [ "SMS", "EMAIL" ], "type": "string", "description": "The way how the OneTimePassword (OTP) will be forwarded to the customer." }, "documentSignature": { "type": "boolean", "description": "The stamp is added on the last page of the mandate document." }, "googleAnalyticsConsent": { "type": "boolean", "description": "Debtor consent to use google analytics." }, "signatureBySca": { "type": "boolean", "description": "If \"true\" customer will be authenticated by AccountIdentificationService." }, "sps": { "type": "boolean", "description": "Allows to identify that WS call comes from SPS." }, "validation": { "type": "boolean", "description": "If Validation = TRUE --> ORG / If Validation = FALSE --> OTU" }, "customerType": { "enum": [ "Known", "Prospect" ], "type": "string", "description": "Type of customer." }, "dueDate": { "description": "DueDate of this transaction. If missing the current day will be used. Pattern: YYYY-MM-DD", "format": "date-time" }, "mandateId": { "type": "string", "description": "The mandate id which has been retrieved via EasyCollect." }, "mandateType": { "enum": [ "B2B", "CORE", "CORE_BUSINESS" ], "type": "string", "description": "Indicates whether the mandate is a business-to-business mandate or a customer-to-business mandate." }, "eventToken": { "enum": [ "PAYMENT_ONLY", "MANDATE_ONLY", "MANDATE_WITH_PAYMENT" ], "type": "string", "description": "Creates a new mandate and first direct debit transaction simultaneously." }, "template": { "$ref": "#/components/schemas/easyCollectTemplate" } } }, "easyCollectTemplate": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of a XSLT template to get an individual layout for your EasyCollect form which matches with your shop layout." }, "customFields": { "$ref": "#/components/schemas/customFields" } } }, "enhancedDataCapture": { "required": [ "common" ], "type": "object", "properties": { "common": { "$ref": "#/components/schemas/common" }, "carRental": { "$ref": "#/components/schemas/carRental" } } }, "enhancedDataKlarna": { "type": "object", "properties": { "productCategory": { "type": "string" }, "productName": { "type": "string" } } }, "enhancedWebhookPaymentMethod": { "required": [ "type" ], "type": "object", "properties": { "type": { "enum": [ "APPLEPAY", "BANCONTACT", "BOLETO", "CARD", "DIRECTDEBIT", "EASYCOLLECT", "FLOAPAY", "GOOGLEPAY", "IDEAL", "INSTANEA", "KLARNA", "MOBILEPAY", "MULTIBANCO", "MYBANK", "PAYPAL", "PAYU", "PFCONNECT", "RATEPAY", "RIVERTY", "SWISH", "WERO" ], "type": "string" } } }, "epsCreateSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/accountEps" }, "optionDate": { "description": "Desired payment execution date in the format YYYY-MM-DD.", "format": "date-time" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "epsDetailsSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/accountEps" }, "paymentPurpose": { "type": "string", "description": "Purpose of payment." }, "paymentGuarantee": { "type": "string", "description": "This parameter is only returned if the Status=OK." }, "providerResponseText": { "type": "string", "description": "Is returned only if Status=FAILED. Detailed error PPRO message." }, "providerTransactionId": { "type": "string", "description": "Unique transaction number from PPRO." } } }, "epsErrorSpecificResponse": { "type": "object", "properties": { "providerResponseText": { "type": "string", "description": "Is returned only if Status=FAILED. Detailed PPRO error message." } } }, "epsLinkSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/accountEps" }, "optionDate": { "description": "Desired payment execution date in the format YYYY-MM-DD.", "format": "date-time" }, "sellingPoint": { "type": "string", "description": "Selling point." } } }, "epsSessionSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/accountEps" }, "optionDate": { "description": "Desired payment execution date in the format YYYY-MM-DD.", "format": "date-time" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "errorDetails": { "type": "object", "properties": { "threeDSServerTransId": { "type": "string", "description": "payId." }, "errorCode": { "type": "string" }, "errorComponent": { "type": "string" }, "errorDescription": { "type": "string" } } }, "exemption": { "type": "object", "properties": { "reason": { "enum": [ "TRANSACTION_RISK_ANALYSIS", "DELEGATE_AUTHORITY", "LOW_VALUE", "TRUSTED_BENEFICIARY", "SECURE_CORPORATE_PAYMENT" ], "type": "string", "description": "Specifies the reason for requesting an exemption from 3DS authentication." }, "merchantFraudRate": { "type": "integer", "description": "Merchant fraud rate in bps taking into account all Merchant sites and card volumes, calculated as per PSD2 RTS Article 19. The merchant fraud rate is optional and has to be calculated by the Acquirer.", "format": "int32" } } }, "extraCharges": { "type": "object", "properties": { "amount": { "type": "integer", "format": "int32" }, "reason": { "enum": [ "NONE", "FUEL", "EXTRA_MILEAGE", "LATE_RETURN", "ONE_WAY_SERVICE", "PARKING_VIOLATION" ], "type": "string" } } }, "floapayCaptureSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" } } }, "floapayCreateSpecificFields": { "type": "object", "properties": { "providerMerchantId": { "type": "string", "description": "MerchantID provided by FLOA Pay." }, "providerMerchantSiteId": { "type": "string", "description": "MerchantSiteID provided by FLOA Pay." }, "merchantShopUrl": { "type": "string", "description": "URL of the homepage of the merchant site." }, "activationDelay": { "type": "integer", "description": "Number of days of deferral.", "format": "int32" }, "customerHistory": { "$ref": "#/components/schemas/customerHistory" }, "travelDetails": { "$ref": "#/components/schemas/travelDetails" }, "stayDetails": { "$ref": "#/components/schemas/stayDetails" }, "productDetails": { "$ref": "#/components/schemas/productDetails" }, "additionalFields": { "type": "array", "items": { "$ref": "#/components/schemas/additionalField" } } } }, "floapayCreateSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" }, "paymentDetails": { "$ref": "#/components/schemas/paymentDetailsFloapay" }, "form": { "type": "string" } } }, "floapayDetailsSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string", "description": "Error code from FLOA Pay." }, "providerResponseText": { "type": "string", "description": "Error text from FLOA Pay." } } }, "floapayLinkSpecificFields": { "type": "object", "properties": { "merchantShopUrl": { "type": "string", "description": "URL of the homepage of the merchant site." }, "activationDelay": { "type": "integer", "description": "Number of days of deferral.", "format": "int32" }, "customerHistory": { "$ref": "#/components/schemas/customerHistory" }, "travelDetails": { "$ref": "#/components/schemas/travelDetails" }, "stayDetails": { "$ref": "#/components/schemas/stayDetails" }, "productDetails": { "$ref": "#/components/schemas/productDetails" }, "additionalFields": { "type": "array", "items": { "$ref": "#/components/schemas/additionalField" } } } }, "floapayRefundSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" } } }, "floapayReversalSpecificFields": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" } } }, "floapaySessionSpecificFields": { "type": "object", "properties": { "merchantShopUrl": { "type": "string", "description": "URL of the homepage of the merchant site." }, "activationDelay": { "type": "integer", "description": "Number of days of deferral.", "format": "int32" }, "customerHistory": { "$ref": "#/components/schemas/customerHistory" }, "travelDetails": { "$ref": "#/components/schemas/travelDetails" }, "stayDetails": { "$ref": "#/components/schemas/stayDetails" }, "productDetails": { "$ref": "#/components/schemas/productDetails" }, "additionalFields": { "type": "array", "items": { "$ref": "#/components/schemas/additionalField" } } } }, "fraudData": { "type": "object", "properties": { "accountInfo": { "$ref": "#/components/schemas/accountInfo" }, "deliveryEmail": { "type": "string", "description": "For Electronic delivery, the email address to which the merchandise was delivered." }, "deliveryTimeframe": { "type": "string", "description": "Indicates the merchandise delivery timeframe." }, "giftCardAmount": { "type": "integer", "description": "For prepaid or gift card purchase, the purchase amount total of prepaid or gift cards in smallest currency unit.", "format": "int32" }, "giftCardCount": { "type": "integer", "description": "For prepaid or gift card purchase, total count of individual prepaid or gift cards/codes purchased.", "format": "int32" }, "giftCardCurrency": { "type": "integer", "description": "For prepaid or gift card purchase, ISO 4217 three-digits numeric currency code of the gift card, e.g. 978.", "format": "int32" }, "preOrderDate": { "description": "For a pre-ordered purchase, the expected date that the merchandise will be available (YYYY-MM-DD).", "format": "date-time" }, "preOrderPurchaseIndicator": { "type": "boolean", "description": "Indicates whether customer is placing an order for merchandise with a future availability or release date." }, "reorderItemsIndicator": { "type": "boolean", "description": "Indicates whether the customer is reordering previously purchased merchandise." }, "shippingAddressIndicator": { "type": "string", "description": "Indicates shipping method chosen for the transaction. If one or more items are included in the sale, use the Shipping Indicator code for the physical goods, or if all digital goods, use the Shipping Indicator code that describes the most expensive item." }, "ipZone": { "type": "string", "description": "Codes of countries from which you accept orders, 3 digits numeric according to ISO 3166-1. Separate several countries by commas: 036,040,124." }, "zone": { "type": "string", "description": "Codes of countries where you accept credit cards, 3 digits numeric or alphanumeric according to ISO 3166-1. Separate several countries by commas: 036,040,124." } } }, "fraudDataCard": { "type": "object", "properties": { "zone": { "type": "string", "description": "If country codes have been entered in Zone Paygate returns the country code for the credit card or \"UNKNOWN\"." }, "ipZone": { "type": "string", "description": "If IP-countries are transmitted in IPZone in the case of the inquiry Paygate returns the country code of the IP address or \"UNKNOWN\"." }, "ipZoneA2": { "type": "string", "description": "If IPZone is submitted within the request Paygate returns the two-character country code of the IP address or \"UNKNOWN\". (DE=Germany, FR=France etc.)" }, "ipState": { "type": "string", "description": "If IPZone is submitted in the request Paygate returns the federal state from which the IP address of your customer originates." }, "ipCity": { "type": "string", "description": "If IPZone is submitted in the request Paygate returns the town/city from which the IP address of your customer originates." }, "ipLongitude": { "type": "string", "description": "If IPZone is submitted in the request Paygate returns the geographical longitude (floating point, decimal) of the dial-in node (PoP) of your customer." }, "ipLatitude": { "type": "string", "description": "If IPZone is submitted in the request Paygate returns the geographical latitude (floating point, decimal) of the dial-in node (PoP) of your customer." }, "fsStatus": { "type": "string", "description": "Only with EVO Payments International: ACCEPT=no suspicion of card fraud, DENY=refusal recommended, CHALLENGE= verification recommended, NOSCORE=No risk analysis, ENETFP=Exceptional error in the network, ERROR=Error in the data processing centre, ETMOUT=Timeout." }, "fsCode": { "type": "string", "description": "Only with EVO Payments International: Recommended action: <0000> no result, <0100> accept, <0150> always accept, <0200> deny, <0250> always deny, <0300> suspicious, <0330> please check, <0400> suspicious ReD blacklist, <0500> questionable, <0600> questionable ReD blacklist, <0700> threshold exceeded, <0800> unusual usage, <901> intern ebitGuard error, <902> format error." } } }, "fundingSource": { "type": "object", "properties": { "type": { "type": "string" }, "brand": { "type": "string" }, "authorizedAmount": { "type": "string" } } }, "getPaymentPlansResponseForCustomer": { "type": "object", "properties": { "totalNumberOfPages": { "type": "integer", "description": "Indicates total number of pages that exist.", "format": "int32" }, "totalNumberOfItems": { "type": "integer", "description": "Indicates total number of items that exist.", "format": "int32" }, "page": { "type": "integer", "description": "Indicates number of page that is retrieved.", "format": "int32" }, "pageSize": { "type": "integer", "description": "Indicates max number of items on page.", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/paymentPlanItemForCustomer" } } } }, "googlePayCreateSpecificFields": { "type": "object", "properties": { "token": { "type": "string", "description": "Token as received by you from Google. Data should be submitted Base64 encoded." } } }, "googlePayCreateSpecificResponse": { "type": "object", "properties": { "schemeReferenceId": { "type": "string" } } }, "googlePayDetailsSpecificFields": { "type": "object", "properties": { "schemeReferenceId": { "type": "string", "description": "Unique identifier assigned by card schemes that is required to be sent in subsequent credential on file transactions" }, "tokenizedCard": { "$ref": "#/components/schemas/googlePayTokenizedCard" } } }, "googlePayTokenizedCard": { "type": "object", "properties": { "first6Digits": { "type": "string", "description": "First 6 digits of card." }, "source": { "type": "string", "description": "Card funding source (if available)." }, "issuer": { "type": "string", "description": "Card issuer (if available)." }, "country": { "type": "string", "description": "Country the card was issued in." }, "pseudoCardNumber": { "type": "string", "description": "Pseudo card number." }, "expiryDate": { "type": "string", "description": "The expiration date of the card in YYYYMM format." }, "brand": { "type": "string", "description": "The brand or network of the card, such as \"visa\", \"mastercard\"." } } }, "hotelBookingDetails": { "type": "object", "properties": { "name": { "type": "string" }, "checkInDate": { "description": "In format: YYYY-MM-DD", "format": "date-time" }, "locationCity": { "type": "string" }, "roomNights": { "type": "string" } } }, "hotelInfo": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of the hotel for which the reservation is for. Mandatory in case the merchant’s business type is Hotel." }, "checkInTime": { "type": "array", "description": "Date of the check-in expressed in GMT+8, in format: YYYY-MM-DD. Mandatory in case the merchant’s business type is Hotel. In case of multiple entries, they should be separated by a ‘|’." }, "checkOutTime": { "type": "array", "description": "Date of the check-out expressed in GMT+8, in format: YYYY-MM-DD. Mandatory in case the merchant’s business type is Hotel. In case of multiple entries, they should be separated by a ‘|’." } } }, "idealCreateSpecificFields": { "type": "object", "properties": { "subType": { "enum": [ "IDEAL", "IDEALPP", "IDEALRABO" ], "type": "string", "description": "Indicates the provider via which iDEAL payment should be processed.\r\n\r\nPossible values:" } } }, "incrementalRequest": { "required": [ "transId", "amount" ], "type": "object", "properties": { "transId": { "maxLength": 64, "type": "string", "description": "Transaction ID created in your system. It should be unique for each payment." }, "order": { "$ref": "#/components/schemas/order" }, "refNr": { "type": "string", "description": "Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually." }, "amount": { "$ref": "#/components/schemas/amount" }, "duration": { "type": "integer", "description": "Indicates the additional number of days to be added to the stay or rental. Valid only for merchants operating in specific industries like Hotel/Car rental.", "format": "int32" } } }, "incrementalResponse": { "type": "object", "properties": { "payId": { "type": "string", "description": "A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation." }, "merchantId": { "type": "string", "description": "Merchant ID assigned by Axepta Online." }, "transId": { "type": "string", "description": "Transaction ID provided by you in the request." }, "xId": { "type": "string", "description": "A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same." }, "refNr": { "type": "string", "description": "Reference number provided by you in the request." }, "status": { "type": "string", "description": "Status of the transaction." }, "responseCode": { "type": "string", "description": "Response code of the transaction." }, "responseDescription": { "type": "string", "description": "Response description associated with the response code." }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "paymentMethods": { "$ref": "#/components/schemas/paymentDataResponseBase" } } }, "installments": { "type": "object", "properties": { "total": { "type": "integer", "description": "Total number of installments for a purchase.", "format": "int32" }, "curIdx": { "type": "integer", "description": "The index or sequence number of the current installment in the series.", "format": "int32" }, "purchaseAmount": { "type": "integer", "description": "The total purchase amount being paid in installments.", "format": "int32" }, "frequency": { "enum": [ "DAILY", "WEEKLY", "BIWEEKLY", "MONTHLY", "BIMONTHLY", "QUARTERLY", "YEARLY" ], "type": "string", "description": "The frequency of installment payments, such as \"daily\", \"weekly\", \"monthly\", or \"yearly\"." }, "expiryDate": { "type": "string", "description": "The date when the installment plan ends or expires in YYYY-MM-DD format.", "format": "date" } } }, "instaneaCreateSpecificFields": { "type": "object", "properties": { "subType": { "enum": [ "SEPA", "SEPA_INSTANT" ], "type": "string", "description": "Defines type of Instanea payment. 'sepa' or 'sepaInstant' value: Instanea type 'sepaInstant' is used default, if not specified" }, "returnRefundAccount": { "type": "boolean", "description": "Optional parameter to return consumers bank account data in order to create a manual refund." } } }, "instaneaDetailsSpecificFields": { "type": "object", "properties": { "providerResponseCode": { "type": "string", "description": "Provider response code." }, "providerResponseText": { "type": "string", "description": "Provider response message." }, "providerTransactionId": { "type": "string", "description": "Provider transaction ID." } } }, "instaneaLinkSpecificFields": { "type": "object", "properties": { "subType": { "enum": [ "SEPA", "SEPA_INSTANT" ], "type": "string", "description": "Defines type of Instanea payment. 'sepa' or 'sepaInstant' value: Instanea type 'sepaInstant' is used default, if not specified" }, "returnRefundAccount": { "type": "boolean", "description": "Optional parameter to return consumers bank account data in order to create a manual refund." } } }, "instaneaSessionSpecificFields": { "type": "object", "properties": { "subType": { "enum": [ "SEPA", "SEPA_INSTANT" ], "type": "string", "description": "Defines type of Instanea payment. 'sepa' or 'sepaInstant' value: Instanea type 'sepaInstant' is used default, if not specified" }, "returnRefundAccount": { "type": "boolean", "description": "Optional parameter to return consumers bank account data in order to create a manual refund." } } }, "intentUrls": { "type": "object", "properties": { "webhook": { "type": "string" } } }, "invoiceCapture": { "type": "object", "properties": { "number": { "type": "string" }, "date": { "description": "In format: YYYY-MM-DD", "format": "date-time" }, "associatedNumber": { "type": "string" } } }, "klarnaCaptureSpecificFields": { "type": "object", "properties": { "shippingInfo": { "$ref": "#/components/schemas/shippingInfo" }, "completeType": { "type": "string", "description": "With this parameter during a partial capture it is possible to reverse the remaining amount simultaneously. Possible value \"YES\". If the order was processed completely this parameter will cause an error, because a remaining amount of 0 cannot be reversed." } } }, "klarnaCaptureSpecificResponse": { "type": "object", "properties": { "invoiceNumber": { "type": "string" }, "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" } } }, "klarnaConfirmSpecificFields": { "type": "object", "properties": { "accessToken": { "type": "string", "description": "Client token from Klarna received as a response to Create Payment request. Note: Access token is valid for 60 minutes. If you attempt to initiate confirm payment after 60 minutes, it will be rejected by Klarna." } } }, "klarnaConfirmSpecificResponse": { "type": "object", "properties": { "providerTransactionId": { "type": "string" }, "billingAgreementId": { "type": "string" }, "redirectUrl": { "type": "string" }, "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" } } }, "klarnaCreateIntentSpecificFields": { "type": "object", "properties": { "layout": { "$ref": "#/components/schemas/layout" }, "accountId": { "type": "string" }, "enhancedData": { "type": "array", "items": { "$ref": "#/components/schemas/enhancedDataKlarna" } }, "description": { "type": "string" } } }, "klarnaCreateSpecificFields": { "type": "object", "properties": { "layout": { "$ref": "#/components/schemas/layoutCreate" }, "accountId": { "type": "string", "description": "Within Paygate several Klarna user names can be stored on one MerchantID and controlled by the parameter Account. By default, please use the value \"0\", if you have several Klarna accounts, the values must be agreed with Axepta Online Helpdesk." }, "enhancedData": { "type": "array", "items": { "$ref": "#/components/schemas/enhancedDataKlarna" } }, "description": { "type": "string", "description": "Description of the purpose of the token. Required when credentialOnfile.Type is recurring.InitialPayment is true." }, "billingAgreementId": { "type": "string", "description": "Provider Token returned in the response of initial payment of recurring flow. Required when credentialOnfile.Type is recurring and credentialOnfile.InitialPayment is false." } } }, "klarnaCreateSpecificResponse": { "type": "object", "properties": { "accessToken": { "type": "string" }, "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" }, "subType": { "type": "array", "items": { "type": "string" } } } }, "klarnaDetailsSpecificFields": { "type": "object", "properties": { "providerResponseCode": { "type": "string", "description": "Response code from Klarna" }, "providerResponseText": { "type": "string" }, "billingAgreementId": { "type": "string", "description": "Billing Agreement ID from Klarna which must be additionally transferred for recurring payments. This information is returned only when the initial request was sent with credentialOnFile.type as recurring and credentialOnFile.initialPayment as true." }, "providerTransactionId": { "type": "string", "description": "Reference number from Klarna system." } } }, "klarnaErrorSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string", "description": "Response code from Klarna\t." }, "providerResponseText": { "type": "string", "description": "Response description from Klarna\t." } } }, "klarnaLinkSpecificFields": { "type": "object", "properties": { "layout": { "$ref": "#/components/schemas/layout" }, "accountId": { "type": "string", "description": "Within Paygate several Klarna account names can be stored on one MerchantID and controlled by the parameter Account. By default, please use the value \"0\", if you have several Klarna accounts, the values must be agreed with Axepta Online Helpdesk." }, "enhancedData": { "type": "array", "items": { "$ref": "#/components/schemas/enhancedDataKlarna" } }, "description": { "type": "string", "description": "Description of the purpose of the token. Required when credentialOnfile. Type is recurring." } } }, "klarnaRefundSpecificResponse": { "type": "object", "properties": { "invoiceNumber": { "type": "string" }, "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" } } }, "klarnaReversalSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" } } }, "klarnaSessionSpecificFields": { "type": "object", "properties": { "layout": { "$ref": "#/components/schemas/layout" }, "accountId": { "type": "string", "description": "Within Paygate several Klarna account names can be stored on one MerchantID and controlled by the parameter Account. By default, please use the value \"0\", if you have several Klarna accounts, the values must be agreed with Axepta Online Helpdesk." }, "enhancedData": { "type": "array", "items": { "$ref": "#/components/schemas/enhancedDataKlarna" } }, "description": { "type": "string", "description": "Description of the purpose of the token. Required when credentialOnfile. Type is recurring." } } }, "klarnaUpdateSpecificFields": { "type": "object", "properties": { "invoiceNumber": { "type": "string", "description": "Invoice/booking number from Klarna. This number is needed for example for resending the E-Mail with payment and order information." } } }, "klarnaUpdateSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" } } }, "layout": { "type": "object", "properties": { "showSubTotalDetail": { "type": "string", "description": "If the value is passed as \"HIDE\" then hides the item positions on the Klarna's hosted payment page." }, "logoUrl": { "type": "string", "description": "URL of the logo to be displayed." }, "pageTitle": { "type": "string", "description": "Title for the Payment Page." } } }, "layoutCreate": { "type": "object", "properties": { "borderColor": { "type": "string", "description": "Color for the border of elements within the iFrame. Value should be a CSS hex color, e.g. \"#FF9900\"." }, "borderColorSelected": { "type": "string", "description": "Color for the border of elements within the iFrame when selected by the customer. Value should be a CSS hex color, e.g. \"#FF9900\"." }, "detailsColor": { "type": "string", "description": "Defines the color used for additional details or informational text." }, "borderRadius": { "type": "string", "description": "Radius for the border of elements within the iFrame." }, "showSubTotalDetail": { "type": "string", "description": "If the value is passed as \"HIDE\" then hides the item positions on the Klarna's hosted payment page." }, "logoUrl": { "type": "string", "description": "URL of the logo to be displayed." }, "pageTitle": { "type": "string", "description": "Title for the Payment Page." } }, "description": "Layout parameters for Klarna widgets." }, "limonetikCreateSpecificFields": { "type": "object", "properties": { "subType": { "enum": [ "COFIDIS3XCB", "COFIDIS4XCB", "ONEEURO", "ECHEQUEVACANCES", "FACILYPAYTHREEX", "FACILYPAYTHREEXSANSFRAIS", "FACILYPAYFOURX", "FACILYPAYFOURXSANSFRAIS", "CVCONNECT", "CETELEM3XCB", "CETELEM4XCB", "UPCHEQUEDEJEUNER", "APETIZ", "PASSRESTAURANT", "SOFINCO2XCB", "SOFINCO2XCBSANSFRAIS", "SOFINCO3XCB", "SOFINCO3XCBSANSFRAIS", "SOFINCO4XCB", "SOFINCO4XCBSANSFRAIS", "GIFTCARDBANQUEACCORD" ], "type": "string", "description": "Indicates Limonetik sub payment method type." }, "customerInformation": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom information about the customer." }, "deliveryDetails": { "$ref": "#/components/schemas/limonetikDeliveryDetails" } } }, "limonetikDeliveryDetails": { "type": "object", "properties": { "description": { "type": "string", "description": "Order delivery description." }, "speed": { "enum": [ "EXPRESS", "STANDARD" ], "type": "string", "description": "Order delivery speed." }, "expectedDate": { "description": "Expected date of delivery.", "format": "date-time", "example": "2025-02-07T16:00:00Z" }, "expectedDelay": { "type": "integer", "description": "Expected delivery delay.", "format": "int32" } } }, "limonetikDetailsSpecificFields": { "type": "object", "properties": { "refPayId": { "type": "string", "description": "Reference Pay ID of the connected transaction. Applicable only when multiple funding sources are used to pay for the transaction." }, "providerTransactionId": { "type": "string" }, "fundingSources": { "type": "array", "items": { "$ref": "#/components/schemas/fundingSource" } } } }, "limonetikSessionSpecificFields": { "type": "object", "properties": { "subType": { "enum": [ "COFIDIS3XCB", "COFIDIS4XCB", "ONEEURO", "ECHEQUEVACANCES", "FACILYPAYTHREEX", "FACILYPAYTHREEXSANSFRAIS", "FACILYPAYFOURX", "FACILYPAYFOURXSANSFRAIS", "CVCONNECT", "CETELEM3XCB", "CETELEM4XCB", "UPCHEQUEDEJEUNER", "APETIZ", "PASSRESTAURANT", "SOFINCO2XCB", "SOFINCO2XCBSANSFRAIS", "SOFINCO3XCB", "SOFINCO3XCBSANSFRAIS", "SOFINCO4XCB", "SOFINCO4XCBSANSFRAIS", "GIFTCARDBANQUEACCORD" ], "type": "string", "description": "Indicates Limonetik sub payment method type." }, "customerInformation": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom information about the customer." }, "deliveryDetails": { "$ref": "#/components/schemas/limonetikDeliveryDetails" } } }, "link": { "required": [ "href", "type" ], "type": "object", "properties": { "href": { "type": "string", "description": "The URL to which the customer should be redirected to complete the payment." }, "type": { "type": "string", "description": "Specifies the type of redirect link." } }, "description": "This link is present when redirection to payment page must be done in order to complete the payment process. Decoded URL value with the exception of PagBrasil Boleto Bancario, where the encoded URL value is returned." }, "linkRequest": { "required": [ "transId", "amount" ], "type": "object", "properties": { "transId": { "maxLength": 64, "type": "string", "description": "Transaction ID created in your system. It should be unique for each payment." }, "externalIntegrationId": { "type": "string", "description": "External integration identifier" }, "refNr": { "type": "string", "description": "Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually." }, "amount": { "$ref": "#/components/schemas/amount" }, "language": { "type": "string", "description": "Language code to determine the language of the payment form and customer communication where applicable." }, "captureMethod": { "$ref": "#/components/schemas/captureMethod" }, "credentialOnFile": { "$ref": "#/components/schemas/credentialOnFile" }, "order": { "$ref": "#/components/schemas/order" }, "urls": { "$ref": "#/components/schemas/baseUrls" }, "billingAddress": { "$ref": "#/components/schemas/billingAddress" }, "shipping": { "$ref": "#/components/schemas/shipping" }, "statementDescriptor": { "type": "string", "description": "Short, clear description of the transaction that appears on the customer's statement. It is recommend sending a maximum of 22 characters. Allowed characters: a-z, A-Z, 0-9, spaces, and special characters / - ? : ( ) . , +" }, "customerInfo": { "$ref": "#/components/schemas/customerInfo" }, "expirationTime": { "description": "Transaction expiry timestamp (UTC).", "format": "date-time", "example": "2025-02-07T16:00:00Z" }, "fraudData": { "$ref": "#/components/schemas/fraudData" }, "paymentFacilitator": { "$ref": "#/components/schemas/paymentFacilitator" }, "browserInfo": { "$ref": "#/components/schemas/browserInfo" }, "device": { "$ref": "#/components/schemas/device" }, "channel": { "enum": [ "ECOM", "MOTO", "APP", "PAYBYLINK", "POS" ], "type": "string", "description": "Specifies the sales or interaction channel through which the transaction is initiated." }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs passed by you. Paygate will return the data as it is in the response." }, "template": { "$ref": "#/components/schemas/templateLink" }, "serviceType": { "enum": [ "LINK", "SMS", "EMAIL" ], "type": "string" }, "externalTemplate": { "type": "string" }, "customValue": { "type": "string" }, "lifetime": { "type": "integer", "format": "int32" }, "allowedPaymentMethods": { "type": "array", "items": { "enum": [ "AMAZONPAY", "APPLEPAY", "BOLETO", "BANCONTACT", "DIRECTDEBIT", "EASYCOLLECT", "EPS", "FLOAPAY", "CARD", "GOOGLEPAY", "IDEAL", "INSTANEA", "KLARNA", "MULTIBANCO", "MYBANK", "PAYPAL", "PRZELEWY24", "TRUSTLY", "TWINT", "VIPPSMOBILEPAY", "WERO" ], "type": "string" }, "description": "Indicates list of allowed payment methods that should be shown on the hosted payment page. If not passed default merchant level configuration is used to display the allowed payment methods." }, "partialPayment": { "type": "boolean", "description": "Defines if the payment is a partial payment. Possible values: true or false." }, "invoiceAttachment": { "type": "string", "description": "Invoice attachment associated to the order. It must be sent as base64 encoded." }, "invoiceAttachmentName": { "type": "string", "description": "Invoice attachment name. File name can contain letters, numbers, underscore ( _ ) and a dash ( - )." }, "paymentMethods": { "$ref": "#/components/schemas/paymentMethodsLink" } } }, "linkResponse": { "type": "object", "properties": { "_links": { "$ref": "#/components/schemas/links" } } }, "links": { "type": "object", "properties": { "redirect": { "$ref": "#/components/schemas/link" } } }, "mandate": { "type": "object", "properties": { "mandateUrl": { "type": "string", "description": "Valid URL pointing to the SEPA mandate, needs to be accessible by PPRO risk and compliance department. Required only in case of PPRO integration. Mandatory when credentialOnfile.type is UNSCHEDULED or RECURRING and credentialOnFile.initialPayment is true. Also mandatory when one off mandates are setup i.e. credentialOnFile object is not passed." }, "mandateId": { "type": "string", "description": "SEPA Mandate number." }, "dateOfSignature": { "description": "Date of issuing the mandate in the format YYYY-MM-DD.", "format": "date-time" } } }, "manual": { "type": "object", "properties": { "currentSequence": { "type": "integer", "description": "Represents the sequence number of the current manual capture in a series of captures for a single transaction. Relevant for multiple partial captures.", "format": "int32" }, "final": { "type": "boolean", "description": "Indicates whether the current manual capture is the final capture for the transaction. Relevant for multiple partial captures.True means final capture.False means not a final capture." }, "total": { "type": "integer", "description": "Indicates the total number of partial captures will be sent.", "format": "int32" } } }, "mbWayCreateSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "mbWayDetailsSpecificFields": { "type": "object", "properties": { "paymentPurpose": { "type": "string", "description": "Purpose of payment." }, "paymentGuarantee": { "type": "string", "description": "This parameter is only returned if the Status=OK." }, "providerResponseText": { "type": "string", "description": "Is returned only if Status=FAILED. Detailed error PPRO message." }, "providerTransactionId": { "type": "string", "description": "Unique transaction number from PPRO." } } }, "mbWaySessionSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "merchantAmount": { "type": "object", "properties": { "value": { "type": "integer", "description": "Merchant transaction amount as provided in the request.", "format": "int32" }, "currency": { "type": "string", "description": "Merchant base currency as provided in the request." } } }, "mobilePayCaptureSpecificFields": { "type": "object", "properties": { "finishAuth": { "type": "boolean", "description": "Transmit value Y in order to stop the prolongation of guaranteed authorizations and rest amounts after partial captures." }, "textField1": { "type": "string" }, "textField2": { "type": "string" } } }, "mobilePayRefundSpecificFields": { "type": "object", "properties": { "textField1": { "type": "string" }, "textField2": { "type": "string" } } }, "multibancoCreateSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point" }, "service": { "type": "string", "description": "products or service sold" } } }, "multibancoDetailsSpecificFields": { "type": "object", "properties": { "paymentPurpose": { "type": "string", "description": "Purpose of payment." }, "paymentGuarantee": { "type": "string", "description": "This parameter is only returned if the Status=OK." }, "providerResponseText": { "type": "string", "description": "Is returned only if Status=FAILED. Detailed error PPRO message." }, "providerTransactionId": { "type": "string", "description": "Unique transaction number from PPRO." } } }, "multibancoLinkSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point" } } }, "multibancoSessionSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point" }, "service": { "type": "string", "description": "products or service sold" } } }, "myBankCreateSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "myBankDetailsSpecificFields": { "type": "object", "properties": { "paymentPurpose": { "type": "string", "description": "Purpose of payment." }, "paymentGuarantee": { "type": "string", "description": "This parameter is only returned if the Status=OK." }, "providerResponseText": { "type": "string", "description": "Is returned only if Status=FAILED. Detailed error PPRO message." }, "providerTransactionId": { "type": "string", "description": "Unique transaction number from PPRO." } } }, "myBankLinkSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." } } }, "myBankRefundSpecificResponse": { "type": "object", "properties": { "providerResponseText": { "type": "string" } } }, "myBankSessionSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "order": { "type": "object", "properties": { "merchantReference": { "type": "string", "description": "A unique identifier for the order, assigned by your system." }, "invoiceId": { "type": "string", "description": "ID of the invoice generated for the order." }, "numberOfArticles": { "type": "integer", "description": "The total number of articles (items) included in the order.", "format": "int32" }, "description": { "type": "string", "description": "A short, description of the order (e.g. main product or order summary). In order to trigger a test payment that you want to run in simulation you can pass the simulation string. For example: \"test:0000\" to simulate a successful transaction." }, "creationDate": { "description": "The date and time when the order was created.", "format": "date-time" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/orderItem" } } } }, "orderDuplicationCheck": { "type": "object", "properties": { "merchantReference": { "type": "string", "description": "A unique identifier for the order, assigned by your system." }, "invoiceId": { "type": "string", "description": "ID of the invoice generated for the order." } } }, "orderItem": { "type": "object", "properties": { "id": { "type": "string", "description": "A unique identifier for the specific item in the order." }, "sku": { "type": "string", "description": "The Stock Keeping Unit (SKU) of the item, used to uniquely identify the product within the merchant's inventory." }, "name": { "type": "string", "description": "The name or title of the item being purchased." }, "type": { "type": "string", "description": "The type of item, such as \"physical\", \"digital\", \"discount\", \"sales_tax\", \"shipping_fee\", \"discount\", \"gift_card\", \"store_credit\", etc." }, "quantity": { "type": "integer", "description": "The quantity of this item being purchased in the order.", "format": "int32" }, "quantityUnit": { "type": "string", "description": "The unit of measurement for the quantity, such as \"pcs\", \"kg\", or \"liters\"." }, "taxRate": { "type": "integer", "description": "The tax rate applied to this item. Percentage sign must be replaced with two zeros. For example: A tax rate of 25% should be sent as 2500.", "format": "int32" }, "netPrice": { "type": "integer", "description": "The net price of a single unit of this item, excluding tax and discounts.", "format": "int32" }, "grossPrice": { "type": "integer", "description": "The gross price of a single unit of this item, including taxes but excluding discounts.", "format": "int32" }, "discountAmount": { "type": "integer", "description": "Discount amount applied to single unit of this item.", "format": "int32" }, "taxAmount": { "type": "integer", "description": "Tax amount applied to single unit of this item.", "format": "int32" }, "merchantData": { "type": "string", "description": "Additional data or metadata provided by the merchant about this item." }, "description": { "type": "string", "description": "Detailed description of the item." }, "marketplaceSellerId": { "type": "string", "description": "An identifier for the seller in a marketplace context." }, "lineNumber": { "type": "integer", "description": "A sequential line number assigned to this item in the order for reference purposes.", "format": "int32" }, "merchantProductType": { "type": "string", "description": "A classification or type assigned to this product by you." }, "googleProductCategory": { "type": "string", "description": "Indicates the category of the item based on the Google product taxonomy." }, "googleProductCategoryId": { "type": "integer", "description": "Google product category ID.", "format": "int32" }, "groupId": { "type": "string", "description": "An identifier used to group related items together." }, "taxCategory": { "type": "string", "description": "Specifies the tax category applicable to this item." }, "additionalDescription": { "type": "string", "description": "Any additional descriptive information about this item not covered elsewhere." }, "productInfo": { "$ref": "#/components/schemas/productInfo" } } }, "orderMini": { "required": [ "merchantReference", "invoiceId" ], "type": "object", "properties": { "merchantReference": { "type": "string", "description": "A unique identifier for the order, assigned by your system." }, "invoiceId": { "type": "string", "description": "ID of the invoice generated for the order." } } }, "orderPaymentPlans": { "type": "object", "properties": { "merchantReference": { "type": "string", "description": "A unique identifier for the order." }, "invoiceId": { "type": "string", "description": "ID of the invoice generated for the order." }, "description": { "type": "string" } } }, "pagBrasilPLCreateSpecificFields": { "type": "object", "properties": { "productName": { "type": "string" }, "payType": { "type": "array", "items": { "type": "string" }, "description": "C = Credit card, D = Débito Flash™, B = Boleto Flash®, X = PagBrasil Pix" } } }, "paymentByIdResponse": { "type": "object", "properties": { "type": { "type": "string", "description": "Indicates the payment method used for this transaction." }, "alipay": { "$ref": "#/components/schemas/alipayDetailsSpecificFields" }, "amazonPay": { "$ref": "#/components/schemas/amazonPayDetailsSpecificFields" }, "applePay": { "$ref": "#/components/schemas/applePayDetailsSpecificFields" }, "bancontact": { "$ref": "#/components/schemas/bancontactSpecificResponse" }, "bizum": { "$ref": "#/components/schemas/bizumDetailsSpecificFields" }, "blik": { "$ref": "#/components/schemas/blikDetailsSpecificFields" }, "boleto": { "$ref": "#/components/schemas/boletoDetailsSpecificFields" }, "card": { "$ref": "#/components/schemas/cardDetailsSpecificFields" }, "directDebit": { "$ref": "#/components/schemas/directDebitDetailsSpecificFields" }, "easyCollect": { "$ref": "#/components/schemas/easyCollectDetailsSpecificFields" }, "eps": { "$ref": "#/components/schemas/epsDetailsSpecificFields" }, "floapay": { "$ref": "#/components/schemas/floapayDetailsSpecificResponse" }, "googlePay": { "$ref": "#/components/schemas/googlePayDetailsSpecificFields" }, "instanea": { "$ref": "#/components/schemas/instaneaDetailsSpecificFields" }, "multibanco": { "$ref": "#/components/schemas/multibancoDetailsSpecificFields" }, "myBank": { "$ref": "#/components/schemas/myBankDetailsSpecificFields" }, "mbWay": { "$ref": "#/components/schemas/mbWayDetailsSpecificFields" }, "klarna": { "$ref": "#/components/schemas/klarnaDetailsSpecificFields" }, "payPal": { "$ref": "#/components/schemas/payPalDetailsSpecificFields" }, "pfConnect": { "$ref": "#/components/schemas/pFConnectDetailsSpecificFields" }, "ratepay": { "$ref": "#/components/schemas/ratepayDetailsSpecificFields" }, "swish": { "$ref": "#/components/schemas/swishDetailsSpecificFields" }, "twint": { "$ref": "#/components/schemas/twintDetailsSpecificFields" }, "wero": { "$ref": "#/components/schemas/wERODetailsSpecificFields" }, "unionPay": { "$ref": "#/components/schemas/unionPayDetailsSpecificFields" }, "weChat": { "$ref": "#/components/schemas/weChatDetailsSpecificFields" }, "limonetik": { "$ref": "#/components/schemas/limonetikDetailsSpecificFields" } } }, "paymentCapture": { "type": "object", "properties": { "amazonPay": { "$ref": "#/components/schemas/amazonPayCaptureSpecificFields" }, "card": { "$ref": "#/components/schemas/cardCaptureSpecificFields" }, "directDebit": { "$ref": "#/components/schemas/directDebitCaptureSpecificFields" }, "klarna": { "$ref": "#/components/schemas/klarnaCaptureSpecificFields" }, "mobilePay": { "$ref": "#/components/schemas/mobilePayCaptureSpecificFields" }, "payPal": { "$ref": "#/components/schemas/payPalCaptureSpecificFields" }, "twint": { "$ref": "#/components/schemas/twintCaptureSpecificFields" }, "wero": { "$ref": "#/components/schemas/wEROCaptureSpecificFields" } } }, "paymentConfirm": { "type": "object", "properties": { "card": { "$ref": "#/components/schemas/cardConfirmSpecificFields" }, "klarna": { "$ref": "#/components/schemas/klarnaConfirmSpecificFields" } } }, "paymentCreate": { "type": "object", "properties": { "type": { "enum": [ "ALIPAY", "AMAZONPAY", "APPLEPAY", "BANCONTACT", "BIZUM", "BLIK", "BOLETO", "CARD", "DIRECTDEBIT", "EASYCOLLECT", "EPS", "FLOAPAY", "GOOGLEPAY", "IDEAL", "INSTANEA", "KLARNA", "LIMONETIK", "MBWAY", "MOBILEPAY", "MULTIBANCO", "MYBANK", "PAGBRASILPL", "PAYPAL", "PFCONNECT", "PRZELEWY24", "RATEPAY", "SWISH", "TRUSTLY", "TWINT", "UNIONPAY", "VIPPSMOBILEPAY", "WECHAT", "WERO" ], "type": "string", "description": "Specifies the type of payment method being used." }, "integrationType": { "enum": [ "DIRECT", "HOSTED" ], "type": "string", "description": "Indicates the integration approach for the payment method.\r\n\r\n- HOSTED: customer is redirected to a payment page,\r\n - DIRECT: server to server communication" }, "alipay": { "$ref": "#/components/schemas/alipayCreateSpecificFields" }, "amazonPay": { "$ref": "#/components/schemas/amazonPayCreateSpecificFields" }, "applePay": { "$ref": "#/components/schemas/applePayCreateSpecificFields" }, "bancontact": { "$ref": "#/components/schemas/bancontactCreateSpecificFields" }, "blik": { "$ref": "#/components/schemas/blikCreateSpecificFields" }, "bizum": { "$ref": "#/components/schemas/bizumCreateSpecificFields" }, "boleto": { "$ref": "#/components/schemas/boletoCreateSpecificFields" }, "card": { "$ref": "#/components/schemas/cardCreateSpecificFields" }, "directDebit": { "$ref": "#/components/schemas/directDebitCreateSpecificFields" }, "floapay": { "$ref": "#/components/schemas/floapayCreateSpecificFields" }, "easyCollect": { "$ref": "#/components/schemas/easyCollectCreateSpecificFields" }, "eps": { "$ref": "#/components/schemas/epsCreateSpecificFields" }, "googlePay": { "$ref": "#/components/schemas/googlePayCreateSpecificFields" }, "ideal": { "$ref": "#/components/schemas/idealCreateSpecificFields" }, "mbWay": { "$ref": "#/components/schemas/mbWayCreateSpecificFields" }, "multibanco": { "$ref": "#/components/schemas/multibancoCreateSpecificFields" }, "myBank": { "$ref": "#/components/schemas/myBankCreateSpecificFields" }, "instanea": { "$ref": "#/components/schemas/instaneaCreateSpecificFields" }, "pagBrasilPL": { "$ref": "#/components/schemas/pagBrasilPLCreateSpecificFields" }, "payPal": { "$ref": "#/components/schemas/payPalCreateSpecificFields" }, "przelewy24": { "$ref": "#/components/schemas/przelewy24CreateSpecificFields" }, "klarna": { "$ref": "#/components/schemas/klarnaCreateSpecificFields" }, "pfConnect": { "$ref": "#/components/schemas/pFConnectCreateSpecificFields" }, "ratepay": { "$ref": "#/components/schemas/ratepayCreateSpecificFields" }, "vippsMobilePay": { "$ref": "#/components/schemas/vIPPSMobilePayCreateSpecificFields" }, "trustly": { "$ref": "#/components/schemas/trustlyCreateSpecificFields" }, "twint": { "$ref": "#/components/schemas/twintCreateSpecificFields" }, "unionPay": { "$ref": "#/components/schemas/unionPayCreateSpecificFields" }, "wero": { "$ref": "#/components/schemas/wEROCreateSpecificFields" }, "weChat": { "$ref": "#/components/schemas/weChatCreateSpecificFields" }, "limonetik": { "$ref": "#/components/schemas/limonetikCreateSpecificFields" } } }, "paymentCreateIntent": { "type": "object", "properties": { "card": { "$ref": "#/components/schemas/cardCreateIntentSpecificFields" }, "payPal": { "$ref": "#/components/schemas/payPalCreateIntentSpecificFields" }, "klarna": { "$ref": "#/components/schemas/klarnaCreateIntentSpecificFields" }, "vippsMobilePay": { "$ref": "#/components/schemas/vIPPSMobilePayCreateIntentSpecificFields" }, "trustly": { "$ref": "#/components/schemas/trustlyCreateIntentSpecificFields" } } }, "paymentData": { "type": "object", "properties": { "senderData": { "$ref": "#/components/schemas/senderData" }, "recipientData": { "$ref": "#/components/schemas/recipientData" } }, "description": "Additional data if PaymentOfWinnings=True." }, "paymentDataResponseBase": { "required": [ "$type" ], "type": "object", "anyOf": [ { "$ref": "#/components/schemas/paymentDataResponseBasepaymentCaptureResponse" }, { "$ref": "#/components/schemas/paymentDataResponseBasepaymentConfirmResponse" }, { "$ref": "#/components/schemas/paymentDataResponseBasepaymentRefundResponse" }, { "$ref": "#/components/schemas/paymentDataResponseBasepaymentRefundExResponse" }, { "$ref": "#/components/schemas/paymentDataResponseBasepaymentReversalResponse" }, { "$ref": "#/components/schemas/paymentDataResponseBasepaymentUpdateResponse" }, { "$ref": "#/components/schemas/paymentDataResponseBasepaymentCreateResponse" }, { "$ref": "#/components/schemas/paymentDataResponseBasepaymentIncrementalResponse" } ], "discriminator": { "propertyName": "$type", "mapping": { "Capture payment": "#/components/schemas/paymentDataResponseBasepaymentCaptureResponse", "Confirm payment": "#/components/schemas/paymentDataResponseBasepaymentConfirmResponse", "Refund payment with reference": "#/components/schemas/paymentDataResponseBasepaymentRefundResponse", "Refund payment without reference": "#/components/schemas/paymentDataResponseBasepaymentRefundExResponse", "Reverse payment": "#/components/schemas/paymentDataResponseBasepaymentReversalResponse", "Update payment details": "#/components/schemas/paymentDataResponseBasepaymentUpdateResponse", "Create payment": "#/components/schemas/paymentDataResponseBasepaymentCreateResponse", "Incremental authorization": "#/components/schemas/paymentDataResponseBasepaymentIncrementalResponse" } } }, "paymentDataResponseBasepaymentCaptureResponse": { "properties": { "$type": { "enum": [ "Capture payment" ], "type": "string" }, "amazonPay": { "$ref": "#/components/schemas/amazonPayCaptureSpecificResponse" }, "card": { "$ref": "#/components/schemas/cardCaptureSpecificResponse" }, "floapay": { "$ref": "#/components/schemas/floapayCaptureSpecificResponse" }, "klarna": { "$ref": "#/components/schemas/klarnaCaptureSpecificResponse" }, "payPal": { "$ref": "#/components/schemas/payPalCaptureSpecificResponse" }, "ratepay": { "$ref": "#/components/schemas/ratepayCaptureSpecificResponse" }, "wero": { "$ref": "#/components/schemas/wEROCaptureSpecificResponse" } } }, "paymentDataResponseBasepaymentConfirmResponse": { "properties": { "$type": { "enum": [ "Confirm payment" ], "type": "string" }, "klarna": { "$ref": "#/components/schemas/klarnaConfirmSpecificResponse" }, "order": { "$ref": "#/components/schemas/order" } } }, "paymentDataResponseBasepaymentCreateResponse": { "properties": { "$type": { "enum": [ "Create payment" ], "type": "string" }, "card": { "$ref": "#/components/schemas/cardDirectCreateSpecificResponse" }, "amazonPay": { "$ref": "#/components/schemas/amazonPayCreateSpecificResponse" }, "applePay": { "$ref": "#/components/schemas/applePayCreateSpecificResponse" }, "bancontact": { "$ref": "#/components/schemas/bancontactSpecificResponse" }, "boleto": { "$ref": "#/components/schemas/boletoCreateSpecificResponse" }, "directDebit": { "$ref": "#/components/schemas/directDebitCreateSpecificResponse" }, "floapay": { "$ref": "#/components/schemas/floapayCreateSpecificResponse" }, "googlePay": { "$ref": "#/components/schemas/googlePayCreateSpecificResponse" }, "klarna": { "$ref": "#/components/schemas/klarnaCreateSpecificResponse" }, "payPal": { "$ref": "#/components/schemas/payPalCreateSpecificResponse" }, "pfConnect": { "$ref": "#/components/schemas/pFConnectCreateSpecificResponse" }, "ratepay": { "$ref": "#/components/schemas/ratepayCreateSpecificResponse" }, "easyCollect": { "$ref": "#/components/schemas/easyCollectCreateSpecificResponse" }, "swish": { "$ref": "#/components/schemas/swishCreateSpecificResponse" } } }, "paymentDataResponseBasepaymentIncrementalResponse": { "properties": { "$type": { "enum": [ "Incremental authorization" ], "type": "string" }, "ratepay": { "$ref": "#/components/schemas/ratepayIncrementalSpecificResponse" } } }, "paymentDataResponseBasepaymentRefundExResponse": { "properties": { "$type": { "enum": [ "Refund payment without reference" ], "type": "string" }, "card": { "$ref": "#/components/schemas/cardRefundExSpecificResponse" } } }, "paymentDataResponseBasepaymentRefundResponse": { "properties": { "$type": { "enum": [ "Refund payment with reference" ], "type": "string" }, "amazonPay": { "$ref": "#/components/schemas/amazonPayRefundSpecificResponse" }, "boleto": { "$ref": "#/components/schemas/boletoRefundSpecificResponse" }, "card": { "$ref": "#/components/schemas/cardRefundSpecificResponse" }, "floapay": { "$ref": "#/components/schemas/floapayRefundSpecificResponse" }, "klarna": { "$ref": "#/components/schemas/klarnaRefundSpecificResponse" }, "myBank": { "$ref": "#/components/schemas/myBankRefundSpecificResponse" }, "payPal": { "$ref": "#/components/schemas/payPalRefundSpecificResponse" }, "ratepay": { "$ref": "#/components/schemas/ratepayRefundSpecificResponse" }, "twint": { "$ref": "#/components/schemas/twintRefundSpecificResponse" } } }, "paymentDataResponseBasepaymentReversalResponse": { "properties": { "$type": { "enum": [ "Reverse payment" ], "type": "string" }, "amazonPay": { "$ref": "#/components/schemas/amazonPayCaptureSpecificResponse" }, "card": { "$ref": "#/components/schemas/cardReversalSpecificFields" }, "floapay": { "$ref": "#/components/schemas/floapayReversalSpecificFields" }, "klarna": { "$ref": "#/components/schemas/klarnaReversalSpecificResponse" }, "payPal": { "$ref": "#/components/schemas/payPalReversalSpecificFields" }, "ratepay": { "$ref": "#/components/schemas/ratepayReversalSpecificResponse" } } }, "paymentDataResponseBasepaymentUpdateResponse": { "properties": { "$type": { "enum": [ "Update payment details" ], "type": "string" }, "payPal": { "$ref": "#/components/schemas/payPalUpdateSpecificFields" }, "klarna": { "$ref": "#/components/schemas/klarnaUpdateSpecificResponse" } } }, "paymentDetailsCustomerInfo": { "type": "object", "properties": { "gatewayCustomerId": { "type": "string", "description": "Unique identifier for the customer assigned by Axepta Online. Populated if Customer Vault feature is enabled" }, "merchantCustomerId": { "type": "string", "description": "A unique identifier for the customer, assigned by the merchant's system." }, "customerType": { "enum": [ "BUSINESS", "INDIVIDUAL" ], "type": "string", "description": "Specifies the type of customer, such as \"individual\" or \"business\"." }, "firstName": { "type": "string", "description": "First name of the customer." }, "lastName": { "type": "string", "description": "Last name (surname) of the customer." }, "email": { "type": "string", "description": "Email address of the customer." }, "phone": { "$ref": "#/components/schemas/phone" }, "salutation": { "type": "string", "description": "Salutation used to address the customer, such as \"Mr\", \"Mrs\", \"Miss \"." }, "title": { "type": "string", "description": "Any additional title or designation associated with the customer, such as \"Dr\", etc." }, "gender": { "type": "string", "description": "Gender of the customer." }, "maidenName": { "type": "string", "description": "Maiden name of the customer." }, "middleName": { "type": "string", "description": "Middle name of the customer." }, "birthDate": { "description": "Birth date of the customer in YYYY-MM-DD format.", "format": "date-time" }, "birthPlace": { "type": "string", "description": "Place of birth of the customer." }, "socialSecurityNumber": { "type": "string", "description": "Customer's Social Security Number." }, "taxId": { "type": "string", "description": "Tax identification number associated with the customer." }, "companyName": { "type": "string", "description": "Name of the company if the customer is a business entity." }, "positionOccupied": { "type": "string", "description": "Position or role occupied by the individual within their company." }, "companyRegistrationNumber": { "type": "string", "description": "Official registration number of the company in its country of incorporation." }, "companyVatId": { "type": "string", "description": "Value Added Tax (VAT) identification number for the company." }, "companyLegalForm": { "type": "string", "description": "The legal form or structure of the company." } } }, "paymentDetailsFloapay": { "type": "object", "properties": { "totalAmount": { "type": "integer", "format": "int32" }, "schedule": { "type": "array", "items": { "$ref": "#/components/schemas/schedule" } } } }, "paymentDetailsResponse": { "type": "object", "properties": { "externalIntegrationId": { "type": "string", "description": "External integration identifier" }, "cardholderConsentToStore": { "type": "boolean" }, "amount": { "$ref": "#/components/schemas/amountPaymentDetails" }, "language": { "type": "string", "description": "Language code to determine the language of the payment form and customer communication where applicable." }, "captureMethod": { "$ref": "#/components/schemas/captureMethod" }, "credentialOnFile": { "$ref": "#/components/schemas/credentialOnFile" }, "order": { "$ref": "#/components/schemas/order" }, "urls": { "$ref": "#/components/schemas/baseUrls" }, "billingAddress": { "$ref": "#/components/schemas/shippingAddress" }, "shipping": { "$ref": "#/components/schemas/shipping" }, "statementDescriptor": { "type": "string", "description": "Short, clear description of the transaction that appears on the customer's statement. It is recommend sending a maximum of 22 characters. Allowed characters: a-z, A-Z, 0-9, spaces, and special characters / - ? : ( ) . , +" }, "customerInfo": { "$ref": "#/components/schemas/paymentDetailsCustomerInfo" }, "expirationTime": { "description": "Transaction expiry timestamp (UTC).", "format": "date-time", "example": "2025-02-07T16:00:00Z" }, "fraudData": { "$ref": "#/components/schemas/fraudData" }, "paymentFacilitator": { "$ref": "#/components/schemas/paymentFacilitator" }, "browserInfo": { "$ref": "#/components/schemas/browserInfo" }, "device": { "$ref": "#/components/schemas/device" }, "channel": { "type": "string", "description": "Specifies the sales or interaction channel through which the transaction is initiated." }, "paymentPlanId": { "type": "string", "description": "Payment plan unique id." }, "payId": { "type": "string", "description": "A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation." }, "merchantId": { "type": "string" }, "transId": { "type": "string", "description": "Transaction ID created in your system. It should be unique for each payment." }, "xId": { "type": "string", "description": "A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same." }, "refNr": { "type": "string", "description": "Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually." }, "status": { "type": "string", "description": "Status of the transaction." }, "responseCode": { "type": "string", "description": "Response code of the transaction." }, "responseDescription": { "type": "string", "description": "Response description associated with the response code." }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs passed by you. Paygate will return the data as it is in the response." }, "paymentMethods": { "$ref": "#/components/schemas/paymentByIdResponse" } } }, "paymentDirectResponse": { "type": "object", "properties": { "order": { "$ref": "#/components/schemas/order" }, "customerInfo": { "$ref": "#/components/schemas/customerInfo" }, "paymentPlanId": { "type": "string", "description": "Payment plan unique id." }, "payId": { "type": "string", "description": "A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation." }, "merchantId": { "type": "string", "description": "Merchant ID assigned by Axepta Online." }, "transId": { "type": "string", "description": "Transaction ID provided by you in the request." }, "xId": { "type": "string", "description": "A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same." }, "refNr": { "type": "string", "description": "Reference number provided by you in the request." }, "status": { "type": "string", "description": "Status of the transaction." }, "responseCode": { "type": "string", "description": "Response code of the transaction." }, "responseDescription": { "type": "string", "description": "Response description associated with the response code." }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs as you passed in the request." }, "paymentMethods": { "$ref": "#/components/schemas/paymentDataResponseBase" } } }, "paymentErrorResponse": { "type": "object", "properties": { "card": { "$ref": "#/components/schemas/cardErrorSpecificResponse" }, "directDebit": { "$ref": "#/components/schemas/directDebitErrorSpecificResponse" }, "easyCollect": { "$ref": "#/components/schemas/easyCollectErrorSpecificResponse" }, "eps": { "$ref": "#/components/schemas/epsErrorSpecificResponse" }, "bancontact": { "$ref": "#/components/schemas/bancontactErrorSpecificResponse" }, "klarna": { "$ref": "#/components/schemas/klarnaErrorSpecificResponse" }, "ratepay": { "$ref": "#/components/schemas/ratepayErrorSpecificResponse" }, "payPal": { "$ref": "#/components/schemas/payPalErrorSpecificResponse" }, "wero": { "$ref": "#/components/schemas/wEROErrorSpecificResponse" } } }, "paymentFacilitator": { "type": "object", "properties": { "subMerchantId": { "type": "string", "description": "SubMerchantID assigned by the Payment Facilitator." }, "subMerchantName": { "type": "string", "description": "Name of the SubMerchantID." }, "subMerchantCity": { "type": "string", "description": "City of the SubMerchantID." }, "subMerchantCountry": { "maxLength": 3, "minLength": 3, "type": "string", "description": "Country code of the SubMerchantID according to ISO-3166-1, alphanumeric 2 chars." }, "subMerchantStreet": { "type": "string", "description": "Street of the SubMerchantID." }, "subMerchantZip": { "type": "string", "description": "Postcode of the SubMerchantID." }, "subMerchantState": { "type": "string", "description": "State of the SubMerchantID." } }, "description": "Object specifying SubMerchant (Payment Facilitator) details." }, "paymentHostedResponse": { "type": "object", "properties": { "_links": { "$ref": "#/components/schemas/links" }, "paymentPlanId": { "type": "string", "description": "Payment plan unique id." }, "payId": { "type": "string" }, "merchantId": { "type": "string" }, "transId": { "type": "string" }, "xId": { "type": "string" }, "refNr": { "type": "string" }, "status": { "type": "string" }, "responseCode": { "type": "string" }, "responseDescription": { "type": "string" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "paymentMethods": { "$ref": "#/components/schemas/paymentDataResponseBase" } } }, "paymentMethod": { "type": "object", "properties": { "type": { "enum": [ "CARD" ], "type": "string", "description": "Specifies the type of payment method being used." }, "card": { "$ref": "#/components/schemas/card" } } }, "paymentMethodCloudPos": { "type": "object", "properties": { "card": { "$ref": "#/components/schemas/cardCloudPos" }, "directDebit": { "$ref": "#/components/schemas/directDebit" } } }, "paymentMethodsLink": { "type": "object", "properties": { "card": { "$ref": "#/components/schemas/cardLinkSpecificFields" }, "bancontact": { "$ref": "#/components/schemas/bancontactLinkSpecificFields" }, "boleto": { "$ref": "#/components/schemas/boletoLinkSpecificFields" }, "directDebit": { "$ref": "#/components/schemas/directDebitLinkSpecificFields" }, "eps": { "$ref": "#/components/schemas/epsLinkSpecificFields" }, "floapay": { "$ref": "#/components/schemas/floapayLinkSpecificFields" }, "klarna": { "$ref": "#/components/schemas/klarnaLinkSpecificFields" }, "instanea": { "$ref": "#/components/schemas/instaneaLinkSpecificFields" }, "easyCollect": { "$ref": "#/components/schemas/easyCollectLinkSpecificFields" }, "multibanco": { "$ref": "#/components/schemas/multibancoLinkSpecificFields" }, "myBank": { "$ref": "#/components/schemas/myBankLinkSpecificFields" }, "payPal": { "$ref": "#/components/schemas/payPalLinkSpecificFields" }, "przelewy24": { "$ref": "#/components/schemas/przelewy24LinkSpecificFields" }, "trustly": { "$ref": "#/components/schemas/trustlyCreateLinkSpecificFields" }, "twint": { "$ref": "#/components/schemas/twintLinkSpecificFields" }, "vippsMobilePay": { "$ref": "#/components/schemas/vIPPSMobilePayLinkSpecificFields" } } }, "paymentMethodsResponse": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique ID assigned by Paygate for the payment method record." }, "type": { "type": "string", "description": "Determines type of payment method. CARD, SEPA_DD. For now only CARD is in scope." }, "last4Digits": { "type": "string" }, "pseudoCardNumber": { "type": "string" }, "cardHolderName": { "type": "string" }, "brand": { "type": "string" }, "expiryDate": { "type": "string" }, "createdAt": { "description": "Creation date and time in ISO 8601 format.", "format": "date-time" }, "updatedAt": { "description": "Update date and time in ISO 8601 format.", "format": "date-time" }, "lastUsedAt": { "description": "Last used date and time in ISO 8601 format.", "format": "date-time" } } }, "paymentMethodsSession": { "type": "object", "properties": { "alipay": { "$ref": "#/components/schemas/alipaySessionSpecificFields" }, "card": { "$ref": "#/components/schemas/cardSessionSpecificFields" }, "bancontact": { "$ref": "#/components/schemas/bancontactSessionSpecificFields" }, "bizum": { "$ref": "#/components/schemas/bizumSessionSpecificFields" }, "blik": { "$ref": "#/components/schemas/blikSessionSpecificFields" }, "boleto": { "$ref": "#/components/schemas/boletoSessionSpecificFields" }, "directDebit": { "$ref": "#/components/schemas/directDebitSessionSpecificFields" }, "eps": { "$ref": "#/components/schemas/epsSessionSpecificFields" }, "floapay": { "$ref": "#/components/schemas/floapaySessionSpecificFields" }, "klarna": { "$ref": "#/components/schemas/klarnaSessionSpecificFields" }, "instanea": { "$ref": "#/components/schemas/instaneaSessionSpecificFields" }, "easyCollect": { "$ref": "#/components/schemas/easyCollectSessionSpecificFields" }, "mbWay": { "$ref": "#/components/schemas/mbWaySessionSpecificFields" }, "multibanco": { "$ref": "#/components/schemas/multibancoSessionSpecificFields" }, "myBank": { "$ref": "#/components/schemas/myBankSessionSpecificFields" }, "payPal": { "$ref": "#/components/schemas/payPalSessionSpecificFields" }, "przelewy24": { "$ref": "#/components/schemas/przelewy24SessionSpecificFields" }, "vippsMobilePay": { "$ref": "#/components/schemas/vIPPSMobilePaySessionSpecificFields" }, "trustly": { "$ref": "#/components/schemas/trustlySessionSpecificFields" }, "twint": { "$ref": "#/components/schemas/twintSessionSpecificFields" }, "unionPay": { "$ref": "#/components/schemas/unionPaySessionSpecificFields" }, "weChat": { "$ref": "#/components/schemas/weChatSessionSpecificFields" }, "limonetik": { "$ref": "#/components/schemas/limonetikSessionSpecificFields" }, "wero": { "$ref": "#/components/schemas/wEROSessionSpecificFields" } } }, "paymentPlan": { "type": "object", "properties": { "id": { "type": "string", "description": "Payment plan id." }, "planStatus": { "enum": [ "ACTIVE", "CANCELLED", "INVALID", "COMPLETED", "RETRY" ], "type": "string", "description": "Status of the payment plan.", "example": "ACTIVE" }, "paymentPlanType": { "enum": [ "RECURRING", "INSTALLMENTS", "DELAYED_SHIPMENT", "UNSCHEDULED_MIT" ], "type": "string", "description": "Payment plan type", "example": "RECURRING" }, "triggerType": { "type": "string", "description": "Returns whether the payment plan is manual or automatic." }, "merchantCustomerId": { "type": "string", "description": "Unique identifier of the customer assigned by merchant." }, "description": { "type": "string", "description": "Description" }, "creationDate": { "description": "Date when the payment plan record is created in Paygate.", "format": "date-time" }, "cancellationDate": { "description": "Date when the payment plan was cancelled. Applicable only for recurring and installment payment plans.", "format": "date-time" }, "lastBillingDate": { "description": "Last billing date of the payment plan in ISO 8601 format.", "format": "date-time" }, "order": { "$ref": "#/components/schemas/orderMini" }, "paymentMethod": { "$ref": "#/components/schemas/paymentMethod" }, "recurring": { "$ref": "#/components/schemas/paymentPlanRecurring" }, "installments": { "$ref": "#/components/schemas/paymentPlanInstallments" }, "delayedShipment": { "$ref": "#/components/schemas/paymentPlanDelayedShipment" }, "unscheduledMit": { "$ref": "#/components/schemas/paymentPlanUnscheduledMit" } } }, "paymentPlanDelayedShipment": { "type": "object", "properties": { "authenticatedAmount": { "$ref": "#/components/schemas/amountMini" }, "paidToDate": { "$ref": "#/components/schemas/amountMini" } } }, "paymentPlanInstallments": { "type": "object", "properties": { "totalPurchaseAmount": { "$ref": "#/components/schemas/amountMini" }, "paidToDate": { "$ref": "#/components/schemas/amountMini" }, "totalInstallments": { "type": "integer", "description": "Total number of installments.", "format": "int32" }, "paidInstallments": { "type": "integer", "description": "Total number of installments paid.", "format": "int32" }, "frequency": { "enum": [ "DAILY", "WEEKLY", "BIWEEKLY", "MONTHLY", "BIMONTHLY", "QUARTERLY", "YEARLY" ], "type": "string", "description": "Defines the frequency of installment payments." }, "nextPaymentDate": { "description": "Date when the next payment will be initiated for the installment transaction. Format `YYYY-MM-DDTHH:MM:SS.milliseconds`.", "format": "date-time" }, "expirationDate": { "description": "Date when the installment transaction expires. Format `YYYY-MM-DDTHH:MM:SS.milliseconds`.", "format": "date-time" } } }, "paymentPlanItem": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique identifier of the payment plan." }, "paymentPlanType": { "enum": [ "RECURRING", "INSTALLMENTS", "DELAYED_SHIPMENT", "UNSCHEDULED_MIT" ], "type": "string", "description": "Payment plan type", "example": "RECURRING" }, "lastBillingDate": { "description": "Last billing date of the payment plan in ISO 8601 format.", "format": "date-time" }, "amount": { "$ref": "#/components/schemas/amountMini" }, "merchantCustomerId": { "type": "string", "description": "Unique identifier of the customer assigned by merchant." }, "planStatus": { "enum": [ "ACTIVE", "CANCELLED", "INVALID", "COMPLETED", "RETRY" ], "type": "string", "description": "Status of the payment plan.", "example": "ACTIVE" }, "description": { "type": "string" } } }, "paymentPlanItemForCustomer": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique identifier of the payment plan." }, "paymentPlanType": { "enum": [ "RECURRING", "INSTALLMENTS", "DELAYED_SHIPMENT", "UNSCHEDULED_MIT" ], "type": "string", "description": "Payment plan type", "example": "RECURRING" }, "amount": { "$ref": "#/components/schemas/amountMini" }, "planStatus": { "enum": [ "ACTIVE", "CANCELLED", "INVALID", "COMPLETED", "RETRY" ], "type": "string", "description": "Status of the payment plan.", "example": "ACTIVE" }, "description": { "type": "string" }, "frequency": { "enum": [ "DAILY", "WEEKLY", "BIWEEKLY", "MONTHLY", "BIMONTHLY", "QUARTERLY", "YEARLY" ], "type": "string" }, "creationDate": { "format": "date-time" } } }, "paymentPlanPaymentAmount": { "type": "object", "properties": { "value": { "type": "integer", "description": "Value of the amount.", "format": "int32" }, "currency": { "type": "string", "description": "Currency of the amount." } }, "description": "Amount object of the payment." }, "paymentPlanPaymentItem": { "type": "object", "properties": { "payId": { "type": "string", "description": "PayID of the payment created within the payment plan." }, "status": { "type": "string", "description": "Status of the payment (as returned by backend)." }, "amount": { "$ref": "#/components/schemas/paymentPlanPaymentAmount" }, "billingDate": { "description": "Billing/creation date of the payment in ISO 8601 format.", "format": "date-time" } } }, "paymentPlanRecurring": { "type": "object", "properties": { "amount": { "$ref": "#/components/schemas/amountMini" }, "frequency": { "enum": [ "DAILY", "WEEKLY", "BIWEEKLY", "MONTHLY", "BIMONTHLY", "QUARTERLY", "YEARLY" ], "type": "string", "description": "Defines the frequency of recurring payments." }, "nextPaymentDate": { "description": "Date when the next payment will be initiated for the recurring transaction. Format `YYYY-MM-DDTHH:MM:SS.milliseconds`.", "format": "date-time" }, "expirationDate": { "description": "Date when the recurring transaction expires. Format `YYYY-MM-DDTHH:MM:SS.milliseconds`.", "format": "date-time" } } }, "paymentPlansCancelSuccessResponse": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique identifer of the payment plan." }, "planStatus": { "enum": [ "ACTIVE", "CANCELLED", "INVALID", "COMPLETED", "RETRY" ], "type": "string", "description": "Indicates if the payment method record was cancelled." }, "cancellationDate": { "description": "Indicates the date when the payment plan was cancelled.", "format": "date-time" } } }, "paymentPlansChargeRequest": { "required": [ "transId" ], "type": "object", "properties": { "transId": { "maxLength": 64, "type": "string", "description": "Transaction ID created in merchant's system. It should be unique for each payment." }, "refNr": { "type": "string", "description": "Merchant's unique reference number for the specific operation." }, "amount": { "$ref": "#/components/schemas/amountPaymentPlans" }, "statementDescriptor": { "type": "string", "description": "Statement descriptor of the specific MIT." }, "order": { "$ref": "#/components/schemas/orderPaymentPlans" } } }, "paymentPlansListResponse": { "type": "object", "properties": { "totalNumberOfPages": { "type": "integer", "description": "Indicates total number of pages that exist.", "format": "int32" }, "totalNumberOfItems": { "type": "integer", "description": "Indicates total number of items that exist.", "format": "int32" }, "page": { "type": "integer", "description": "Indicates number of page that is retrieved.", "format": "int32" }, "pageSize": { "type": "integer", "description": "Indicates max number of items on page.", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/paymentPlanItem" } } } }, "paymentPlansPaymentsListResponse": { "type": "object", "properties": { "totalNumberOfPages": { "type": "integer", "description": "Total number of pages.", "format": "int32" }, "totalNumberOfItems": { "type": "integer", "description": "Total number of items.", "format": "int32" }, "page": { "type": "integer", "description": "Current page number.", "format": "int32" }, "pageSize": { "type": "integer", "description": "Page size used by backend.", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/paymentPlanPaymentItem" }, "description": "List of payments within the payment plan." } } }, "paymentPlanUnscheduledMit": { "type": "object", "properties": { "currency": { "type": "string", "description": "3 character ISO currency code." } } }, "paymentRefund": { "type": "object", "properties": { "amazonPay": { "$ref": "#/components/schemas/amazonPayRefundSpecificFields" }, "boleto": { "$ref": "#/components/schemas/boletoRefundSpecificFields" }, "card": { "$ref": "#/components/schemas/cardRefundSpecificFields" }, "mobilePay": { "$ref": "#/components/schemas/mobilePayRefundSpecificFields" }, "payPal": { "$ref": "#/components/schemas/payPalRefundSpecificFields" }, "wero": { "$ref": "#/components/schemas/wERORefundSpecificFields" } } }, "paymentRefundEx": { "type": "object", "properties": { "type": { "type": "string" }, "card": { "$ref": "#/components/schemas/cardRefundExSpecificFields" }, "directDebit": { "$ref": "#/components/schemas/directDebitRefundExSpecificFields" } } }, "paymentRequest": { "required": [ "transId", "paymentMethods" ], "type": "object", "properties": { "transId": { "maxLength": 64, "type": "string", "description": "Transaction ID created in your system. It should be unique for each payment.\r\n\r\nFor iDEAL only a-z, A-Z, 0-9 characters are permitted and the length should be <= 24" }, "externalIntegrationId": { "type": "string", "description": "External integration identifier" }, "refNr": { "type": "string", "description": "Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually." }, "amount": { "$ref": "#/components/schemas/amount" }, "language": { "maxLength": 2, "minLength": 2, "type": "string", "description": "Language code to determine the language of the payment form and customer communication where applicable." }, "captureMethod": { "$ref": "#/components/schemas/captureMethod" }, "credentialOnFile": { "$ref": "#/components/schemas/credentialOnFile" }, "order": { "$ref": "#/components/schemas/order" }, "urls": { "$ref": "#/components/schemas/urls" }, "billingAddress": { "$ref": "#/components/schemas/billingAddress" }, "shipping": { "$ref": "#/components/schemas/shipping" }, "statementDescriptor": { "type": "string", "description": "Short, clear description of the transaction that appears on the customer's statement. It is recommend sending a maximum of 22 characters. Allowed characters: a-z, A-Z, 0-9, spaces, and special characters / - ? : ( ) . , +" }, "customerInfo": { "$ref": "#/components/schemas/customerInfo" }, "expirationTime": { "description": "Transaction expiry timestamp (UTC).", "format": "date-time", "example": "2025-02-07T16:00:00Z" }, "fraudData": { "$ref": "#/components/schemas/fraudData" }, "paymentFacilitator": { "$ref": "#/components/schemas/paymentFacilitator" }, "browserInfo": { "$ref": "#/components/schemas/browserInfo" }, "device": { "$ref": "#/components/schemas/device" }, "channel": { "enum": [ "ECOM", "MOTO", "APP", "PAYBYLINK", "POS" ], "type": "string", "description": "Specifies the sales or interaction channel through which the transaction is initiated." }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs passed by you. Paygate will return the data as it is in the response." }, "referencePayId": { "type": "string", "description": "Payment ID referring to the previous related request. Only applicable for PFConnect Authorization and Subsequent card installment payments." }, "partialPayment": { "type": "boolean", "description": "Defines if the payment is a partial payment. Possible values: true or false." }, "paymentMethods": { "$ref": "#/components/schemas/paymentCreate" } } }, "paymentReversal": { "type": "object", "properties": { "amazonPay": { "$ref": "#/components/schemas/amazonPayReversalSpecificFields" } } }, "paymentUpdate": { "type": "object", "properties": { "klarna": { "$ref": "#/components/schemas/klarnaUpdateSpecificFields" }, "amazonPay": { "$ref": "#/components/schemas/amazonPayUpdateSpecificFields" } } }, "payPalCaptureSpecificFields": { "type": "object", "properties": { "completeType": { "type": "boolean", "description": "Defines the completeness of capture for an open Paypal order. If sent as true, order is closed for capture. Reason: a 115% capture is permissible on the part of PayPal. If a capture reached 100%, Paygate automatically sends a request to close the payment." } } }, "payPalCaptureSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerTransactionId": { "type": "string" } } }, "payPalCreateIntentSpecificFields": { "type": "object", "properties": { "accountId": { "type": "string" }, "hideAddress": { "type": "boolean" } } }, "payPalCreateSpecificFields": { "type": "object", "properties": { "accountId": { "type": "string", "description": "Your Paypal account ID. It can be ID or email address associated with the Paypal account. This parameter can be passed to override the static merchant configuration if you have multiple Paypal accounts." }, "hideAddress": { "type": "boolean", "description": "Indicates if shipping address stored on customer's Paypal account should be hidden." }, "expressCheckout": { "type": "boolean", "description": "Indicates if the expressCheckout option of Paypal should be used. Default value false." }, "riskEvaluationData": { "type": "object", "additionalProperties": { "type": "string" } } } }, "payPalCreateSpecificResponse": { "type": "object", "properties": { "orderId": { "type": "string" } } }, "payPalDetailsSpecificFields": { "type": "object", "properties": { "orderId": { "type": "string", "description": "Unique order identifier assigned by Paypal that should be used to construct the URL for the smart button." }, "providerResponseCode": { "type": "string", "description": "Response code from Paypal." }, "payerStatus": { "type": "string", "description": "Status of buyer." }, "infoText": { "type": "string", "description": "Response message to the merchant." }, "payerId": { "type": "string", "description": "Unique identification number of customer account at PayPal." }, "grossAmount": { "type": "string", "description": "Final amount charged, including any shipping and taxes from your Merchant profile." }, "feeAmount": { "type": "string", "description": "PayPal fee amount charged for the transaction." }, "settleAmount": { "type": "string", "description": "Amount deposited in your PayPal account after a currency conversion, if any." }, "taxAmount": { "type": "string", "description": "Tax charged on the transaction." }, "exchangeRate": { "type": "string", "description": "Exchange rate if a currency conversion occurred." }, "mcFee": { "type": "string", "description": "Transaction fee associated with the payment. mc_gross minus mc_fee equals the amount deposited into the receiver_email account. Equivalent to payment_fee for USD payments. If this amount is negative, it signifies a refund or reversal, and either of those payment statuses can be for the full or partial amount of the original transaction fee." }, "mcGross": { "type": "string", "description": "Full amount of the customer's payment before transaction fee is subtracted. Equivalent to payment_gross for USD payments. If this amount is negative, it signifies a refund or reversal, and either of those payment statuses can be for the full or partial amount of the original transaction." }, "providerCaptureId": { "type": "string", "description": "Unique PayPal-generated Capture ID. The value is required for a refund after several partial captures." } } }, "payPalErrorSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string" } } }, "payPalLinkSpecificFields": { "type": "object", "properties": { "accountId": { "type": "string" }, "hideAddress": { "type": "boolean" }, "riskEvaluationData": { "type": "object", "additionalProperties": { "type": "string" } } } }, "payPalRefundSpecificFields": { "type": "object", "properties": { "providerTransactionId": { "type": "string", "description": "Transaction ID returned by Paypal in the capture response. This is needed for the use cases of multiple captures and if you want to refund a specific capture." } } }, "payPalRefundSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "feeRefundAmount": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": "number", "format": "double" }, "grossRefundAmount": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": "number", "format": "double" }, "netRefundAmount": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": "number", "format": "double" } } }, "payPalReversalSpecificFields": { "type": "object", "properties": { "providerResponseCode": { "type": "string" } } }, "payPalSessionSpecificFields": { "type": "object", "properties": { "accountId": { "type": "string", "description": "Your Paypal account ID. It can be ID or email address associated with the Paypal account. This parameter can be passed to override the static merchant configuration if you have multiple Paypal accounts." }, "hideAddress": { "type": "boolean", "description": "Indicates if shipping address stored on customer's Paypal account should be hidden." }, "riskEvaluationData": { "type": "object", "additionalProperties": { "type": "string" } } } }, "payPalUpdateSpecificFields": { "type": "object", "properties": { "providerResponseCode": { "type": "string" } } }, "period": { "type": "object", "properties": { "unit": { "enum": [ "YEAR", "MONTH", "WEEK", "DAY" ], "type": "string", "description": "Required for PERIOD_CAMPAIGN: Unit for period: YEAR, MONTH, WEEK, DAY" }, "count": { "type": "integer", "description": "Required for PERIOD_CAMPAIGN: Number of units (1-31).", "format": "int32" } } }, "person": { "type": "object", "properties": { "firstName": { "type": "string" }, "middleName": { "type": "string" }, "lastName": { "type": "string" } } }, "pFConnectCreateSpecificFields": { "type": "object", "properties": { "merchantCountryCode": { "enum": [ "FR", "IT" ], "type": "string", "description": "Country, where merchant operates." }, "financialProductId": { "type": "integer", "description": "Financial product identifier.", "format": "int32" }, "shoppingBasketAmount": { "type": "integer", "description": "Shopping basket amount. Mandatory only if also DownPaymentAmount is valorized.", "format": "int32" }, "downPaymentAmount": { "type": "integer", "description": "Downpayment amount. Mandatory only if also ShoppingBasketAmount field is valorized.", "format": "int32" }, "deliveryDate": { "type": "string", "description": "Estimated delivery date. Mandatory if the merchant is operating in France.", "format": "date" }, "customerRole": { "enum": [ "OWNER", "THIRD", "CUSTOMER" ], "type": "string", "description": "Identifier role of the customer." }, "partnerStoreId": { "type": "string", "description": "Merchant identifier assigned by PF. Mandatory for the merchants, which operates in Spain and Italy." }, "aboId": { "type": "integer", "description": "SubscriptionID on PSP side. It will be used by axepta to identfy its merchant.Mandatory for the merchants, which operates in France.", "format": "int32" }, "applicationDate": { "type": "string", "description": "Date of the application for financing.Mandatory for merchants operating in France and optional for those operating in Spain." }, "customValue": { "type": "string", "description": "Value of the customProperties MerchantData." }, "programId": { "type": "string", "description": "Financial program ID." }, "quotationId": { "type": "string", "description": "ID of the quotation (value transmitted on the response of the CalculateQuotation).Mandatory for merchants operating in France." } } }, "pFConnectCreateSpecificResponse": { "type": "object", "properties": { "financingScenarioDetail": { "type": "string" } } }, "pFConnectDetailsSpecificFields": { "type": "object", "properties": { "providerResponseCode": { "type": "string", "description": "Provider response code." }, "providerResponseText": { "type": "string", "description": "Provider response message." }, "applicationId": { "type": "string", "description": "PF Connect identifier." } } }, "phone": { "type": "object", "properties": { "countryCode": { "type": "string", "description": "Country Code/Area code of the phone number. Allows up to 3 digits. Must not contain the '+' prefix." }, "number": { "type": "string", "description": "Phone number of the customer." } }, "description": "Phone number of the customer." }, "pointOfSale": { "type": "object", "properties": { "type": { "type": "string" }, "url": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" } } }, "prefillInfoCard": { "type": "object", "properties": { "number": { "type": "string", "description": "The card number or the pseudo card number of the payment card to prefill the form." }, "cardHolderName": { "type": "string" }, "expiryDate": { "type": "string", "description": "The expiration date of the card in YYYYMM format to prefill the form." }, "brand": { "type": "string", "description": "The brand or network of the card, such as \"visa\", \"mastercard\" to prefill the form." }, "securityCode": { "type": "string", "description": "The Card Security Code, also known as CVV or CVC to prefill the form." } }, "description": "Applicable only when paymentMethods.integrationType=HOSTED." }, "prefillInfoDirectDebit": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/accountDirectDebitRequest" } } }, "priorAuthenticationInfo": { "type": "object", "properties": { "data": { "type": "string", "description": "Data that documents and supports a specific authentication process performed by the merchant such as FIDO" }, "method": { "enum": [ "FRICTIONLESS", "ACS_CHALLENGE", "AVS_VERIFIED", "OTHER" ], "type": "string", "description": "The method used for prior authentication." }, "timestamp": { "description": "The timestamp of the prior authentication event in YYYY-MM-DDTHH:MM:SS+00:00 format", "format": "date-time" }, "reference": { "type": "string", "description": "A reference to the prior authentication event. It should contain the ACS Transaction ID. For example: the first recurring transaction that was authenticated with the cardholder." } }, "description": "Prior Transaction Authentication Information contains optional information about a 3DS cardholder authentication that occurred prior to the current transaction" }, "problemDetails": { "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "detail": { "type": "string" }, "instance": { "type": "string" } } }, "processingNotFoundProblemDetails": { "type": "object", "properties": { "merchantId": { "type": "string", "description": "Merchant ID assigned by Axepta Online." }, "payId": { "type": "string", "description": "A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation." }, "xId": { "type": "string", "description": "A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same." }, "transId": { "type": "string", "description": "Transaction ID created in your system. It should be unique for each payment." }, "refNr": { "type": "string", "description": "Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually." }, "responseCode": { "type": "string", "description": "Response code of the transaction." }, "responseDescription": { "type": "string", "description": "Response description associated with the response code." }, "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "string", "description": "Status of the transaction." }, "detail": { "type": "string" }, "instance": { "type": "string" } } }, "processingProblemDetails": { "type": "object", "properties": { "merchantId": { "type": "string", "description": "Merchant ID assigned by Axepta Online." }, "payId": { "type": "string", "description": "A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation.", "example": 0 }, "xId": { "type": "string", "description": "A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same." }, "transId": { "type": "string", "description": "Transaction ID provided by you in the request." }, "refNr": { "type": "string", "description": "Reference number provided by you in the request." }, "responseCode": { "type": "string", "description": "Response code of the transaction.", "example": 422 }, "responseDescription": { "type": "string", "description": "Response description associated with the response code.", "example": "Payment could not be processed." }, "paymentPlanId": { "type": "string" }, "paymentMethods": { "$ref": "#/components/schemas/paymentErrorResponse" }, "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "string", "description": "Status of the transaction." }, "detail": { "type": "string" }, "instance": { "type": "string" } } }, "productDetails": { "type": "object", "properties": { "category1": { "type": "string", "description": "Product category number 1." }, "category2": { "type": "string", "description": "Product category number 2." }, "category3": { "type": "string", "description": "Product category number 3." } } }, "productInfo": { "type": "object", "properties": { "brand": { "type": "string", "description": "The brand name associated with this product." }, "categories": { "type": "array", "items": { "type": "string" }, "description": "The product's category path as used in the your webshop" }, "globalTradeItemNumber": { "enum": [ "EAN", "ISBN", "UPC" ], "type": "string", "description": "The product's Global Trade Item Number (GTIN)." }, "manufacturerPartNumber": { "type": "string", "description": "The product's Manufacturer Part Number (MPN), which - together with the brand - uniquely identifies a product. Only submit MPNs assigned by a manufacturer and use the most specific MPN possible." }, "imageUrl": { "type": "string", "description": "A URL pointing to an image of this product." }, "productUrl": { "type": "string", "description": "A URL linking to a detailed product page on the merchant's website." } } }, "provider": { "type": "object", "properties": { "travelAgencyCode": { "type": "string" }, "travelOfficeCode": { "type": "string" }, "transactionReference": { "type": "string" }, "invoiceIndicator": { "enum": [ "N", "Y", "R" ], "type": "string" }, "invoice": { "$ref": "#/components/schemas/invoiceCapture" }, "iataNumber": { "type": "integer", "format": "int32" }, "serviceCentre": { "type": "string" }, "terminalId": { "type": "string" }, "providerReference": { "type": "string" }, "electronicInvoiceLocation": { "type": "string" } } }, "przelewy24CreateSpecificFields": { "type": "object", "properties": { "subType": { "enum": [ "BLIK" ], "type": "string", "description": "Payment method. Available values: BLIK." }, "authenticationCode": { "type": "string", "description": "6-digit, one-time BLIK code generated in the app." }, "termsAndConditions": { "type": "boolean", "description": "Acceptance of Przelewy24 regulations." }, "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "przelewy24LinkSpecificFields": { "type": "object", "properties": { "subType": { "enum": [ "BLIK" ], "type": "string", "description": "Payment method. Available values: BLIK." }, "authenticationCode": { "type": "string", "description": "6-digit, one-time BLIK code generated in the app." }, "termsAndConditions": { "type": "boolean", "description": "Acceptance of Przelewy24 regulations." }, "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." } } }, "przelewy24SessionSpecificFields": { "type": "object", "properties": { "subType": { "enum": [ "BLIK" ], "type": "string", "description": "Payment method. Available values: BLIK." }, "authenticationCode": { "type": "string", "description": "6-digit, one-time BLIK code generated in the app." }, "termsAndConditions": { "type": "boolean", "description": "Acceptance of Przelewy24 regulations." }, "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "rate": { "type": "object", "properties": { "timestamp": { "type": "string", "description": "Timestamp indicating when the DCC rate was generated." }, "exchangeRate": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": "number", "description": "Applied exchange rate used for the DCC calculation.", "format": "double" }, "markupPercentage": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": "number", "description": "Markup percentage applied on top of the base exchange rate.", "format": "double" } } }, "ratepayCaptureSpecificResponse": { "type": "object", "properties": { "authorizationExpiry": { "type": "string" }, "account": { "$ref": "#/components/schemas/accountRatepayResponse" }, "paymentReference": { "type": "string" }, "providerTransactionId": { "type": "string" } } }, "ratepayCreateSpecificFields": { "type": "object", "properties": { "accountId": { "type": "string" }, "subType": { "enum": [ "OPEN_INVOICE", "PAY_NOW" ], "type": "string", "description": "The payment option the buyer selected." }, "transferType": { "enum": [ "BANK_TRANSFER", "SEPA_DIRECT_DEBIT" ], "type": "string", "description": "The transfer type the buyer selected." }, "deviceToken": { "type": "string", "description": "Device token generated by Ratepay's fingerprinting feature. Include the generated token if you are using the device fingerprinting feature in your integration." }, "account": { "$ref": "#/components/schemas/accountRatepay" } } }, "ratepayCreateSpecificResponse": { "type": "object", "properties": { "authorizationExpiry": { "type": "string" }, "account": { "$ref": "#/components/schemas/accountRatepayResponse" }, "paymentReference": { "type": "string" }, "providerTransactionId": { "type": "string" } } }, "ratepayDetailsSpecificFields": { "type": "object", "properties": { "authorizationExpiry": { "type": "string", "description": "The date and time when remaining un-cancelled and un-captured authorized amount will be automatically cancelled. Available only for successful responses HTTP 201." }, "account": { "$ref": "#/components/schemas/accountRatepayResponse" }, "paymentReference": { "type": "string", "description": "Purpose to be indicated in the bank transfer (generated by Ratepay). Provided only when paymentMethod.ratepay.transferType is sent as BANK_TRANSFER in request." }, "providerTransactionId": { "type": "string", "description": "ID of transaction generated by Ratepay during authorization. A transaction ID is generated for both accepted and declined transactions." }, "providerDeclineCategory": { "type": "string", "description": "Decline category provider by Ratepay. See Decline Categories for details." }, "providerResponseText": { "type": "string", "description": "A message from Ratepay describing which constraint was violated." }, "providerResponseCode": { "type": "string", "description": "List of none, one or multiple reasons why the request was declined. See Decline Categories to learn about possible reasons for each decline category." } } }, "ratepayErrorSpecificResponse": { "type": "object", "properties": { "providerDeclineCategory": { "type": "string", "description": "Decline category provider by Ratepay. See Decline Categories for details." }, "providerResponseText": { "type": "string", "description": "A message from Ratepay describing which constraint was violated." }, "providerResponseCode": { "type": "string", "description": "List of none, one or multiple reasons why the request was declined. See Decline Categories to learn about possible reasons for each decline category." }, "providerTransactionId": { "type": "string" } } }, "ratepayIncrementalSpecificResponse": { "type": "object", "properties": { "authorizationExpiry": { "type": "string" }, "account": { "$ref": "#/components/schemas/accountRatepayResponse" }, "paymentReference": { "type": "string" }, "providerTransactionId": { "type": "string" } } }, "ratepayRefundSpecificResponse": { "type": "object", "properties": { "authorizationExpiry": { "type": "string" }, "account": { "$ref": "#/components/schemas/accountRatepayResponse" }, "paymentReference": { "type": "string" }, "providerTransactionId": { "type": "string" } } }, "ratepayReversalSpecificResponse": { "type": "object", "properties": { "authorizationExpiry": { "type": "string" }, "account": { "$ref": "#/components/schemas/accountRatepayResponse" }, "paymentReference": { "type": "string" }, "providerTransactionId": { "type": "string" } } }, "receipt": { "type": "object", "properties": { "receiptNr": { "type": "string" }, "receiptMerchant": { "type": "string" }, "receiptCustomer": { "type": "string" }, "receiptCopies": { "type": "integer", "format": "int32" }, "receiptsNumber": { "type": "integer", "format": "int32" } } }, "recipientData": { "type": "object", "properties": { "name": { "type": "string" } } }, "recurring": { "type": "object", "properties": { "useCase": { "enum": [ "FIXED", "FLEXIBLE_AMOUNT", "FLEXIBLE_FREQUENCY" ], "type": "string", "description": "Describes the use case for the unscheduled transaction." }, "frequency": { "enum": [ "DAILY", "WEEKLY", "BIWEEKLY", "MONTHLY", "BIMONTHLY", "QUARTERLY", "YEARLY" ], "type": "string", "description": "Defines the frequency of recurring payments." }, "startDate": { "type": "string", "description": "The date when the recurring payment schedule begins in YYYY-MM-DD format.", "format": "date" }, "expiryDate": { "type": "string", "description": "The date when the recurring payment schedule ends or expires in YYYY-MM-DD format.", "format": "date" } } }, "reference": { "type": "object", "properties": { "statementField": { "type": "string", "description": "The number indicates which reference field on the statement that the customer wishes to see this data in" }, "typeCode": { "enum": [ "COST_CENTRE", "EMPLOYEE_ID", "TRAVEL_BOOKER_NAME", "JOB_NUMBER", "PROJECT_CODE", "BUSINESS_UNIT", "OTHER" ], "type": "string" }, "data": { "type": "string" } } }, "refundExRequest": { "required": [ "transId", "amount", "paymentMethods" ], "type": "object", "properties": { "transId": { "maxLength": 64, "type": "string", "description": "Transaction ID created in your system. It should be unique for each payment.", "example": "test-TransactionId01" }, "amount": { "$ref": "#/components/schemas/amount" }, "refNr": { "type": "string", "description": "Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually." }, "language": { "maxLength": 2, "minLength": 2, "type": "string" }, "order": { "$ref": "#/components/schemas/order" }, "billingAddress": { "$ref": "#/components/schemas/shippingAddress" }, "shipping": { "$ref": "#/components/schemas/shipping" }, "statementDescriptor": { "type": "string", "description": "Short, clear description of the transaction that appears on the customer's statement. It is recommend sending a maximum of 22 characters. Allowed characters: a-z, A-Z, 0-9, spaces, and special characters / - ? : ( ) . , +" }, "customerInfo": { "$ref": "#/components/schemas/customerInfoRefundEx" }, "browserInfo": { "$ref": "#/components/schemas/browserInfoRefundEx" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by the merchant to store extra information about the transaction. This is a set of JSON key value pairs passed by the merchant. Paygate will return the data as it is in the response." }, "paymentMethods": { "$ref": "#/components/schemas/paymentRefundEx" } } }, "refundExResponse": { "type": "object", "properties": { "payId": { "type": "string" }, "merchantId": { "type": "string" }, "transId": { "type": "string" }, "xId": { "type": "string" }, "refNr": { "type": "string" }, "status": { "type": "string" }, "responseCode": { "type": "string" }, "responseDescription": { "type": "string" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "paymentMethods": { "$ref": "#/components/schemas/paymentDataResponseBase" } } }, "refundRequest": { "required": [ "transId", "amount" ], "type": "object", "properties": { "transId": { "maxLength": 64, "type": "string", "description": "Transaction ID created in your system. It should be unique for each payment.", "example": "test-TransactionId01" }, "amount": { "$ref": "#/components/schemas/amount" }, "refNr": { "type": "string", "description": "Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually." }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs passed by you. Paygate will return the data as it is in the response." }, "order": { "$ref": "#/components/schemas/order" }, "statementDescriptor": { "type": "string", "description": "Short, clear description of the transaction that appears on the customer's statement. It is recommend sending a maximum of 22 characters. Allowed characters: a-z, A-Z, 0-9, spaces, and special characters / - ? : ( ) . , +" }, "paymentMethods": { "$ref": "#/components/schemas/paymentRefund" } } }, "refundResponse": { "type": "object", "properties": { "payId": { "type": "string" }, "merchantId": { "type": "string" }, "transId": { "type": "string" }, "xId": { "type": "string" }, "refNr": { "type": "string" }, "status": { "type": "string" }, "responseCode": { "type": "string" }, "responseDescription": { "type": "string" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "paymentMethods": { "$ref": "#/components/schemas/paymentDataResponseBase" } } }, "renderingType": { "type": "object", "properties": { "acsInterface": { "type": "string", "description": "This the ACS interface that the challenge will present to the cardholder.\r\n\r\nValues accepted:" }, "acsUiTemplate": { "type": "string", "description": "Identifies the UI Template format that the ACS first presents to the consumer.\r\n\r\nValues accepted:\r\n\r\n* text\r\n\r\n * singleSelect\r\n\r\n * multiSelect\r\n\r\n * oob\r\n\r\n * htmlOther\r\n\r\nhtmlOther is only valid in combination with html UI (see acsInterface)." } }, "description": "App-based only. Identifies the ACS UI Template that the ACS will first present to the consumer. Required if Transaction Status = C." }, "rentalDetails": { "type": "object", "properties": { "salesIndicator": { "enum": [ "D", "F", "R" ], "type": "string" }, "rentalRate": { "type": "string" }, "orderNumber": { "type": "string" }, "folioNumber": { "type": "string" }, "serviceDescription": { "type": "string" }, "oneWayServiceCharge": { "type": "integer", "format": "int32" } } }, "rentalInformation": { "type": "object", "properties": { "carMake": { "type": "string" }, "departureDate": { "description": "In format: YYYY-MM-DD", "format": "date-time" }, "fuelConsumption": { "type": "integer", "format": "int32" }, "customerOrderNumber": { "type": "string" }, "costPerMile": { "type": "integer", "format": "int32" }, "milesDriven": { "type": "integer", "format": "int32" }, "driver": { "$ref": "#/components/schemas/person" }, "vehicleGroup": { "type": "string" }, "carRentalCompanyId": { "enum": [ "D", "F", "G", "H", "M", "O", "P", "T", "W", "Y", "Z" ], "type": "string" } } }, "requestBasicWebhooks": { "type": "object", "properties": { "payId": { "type": "string" } } }, "requestEnhancedWebhooks": { "required": [ "payId", "transId", "status", "responseCode", "responseDescription", "amount", "paymentMethods", "creationDate" ], "type": "object", "properties": { "payId": { "type": "string" }, "transId": { "type": "string" }, "refNr": { "type": "string" }, "status": { "type": "string" }, "responseCode": { "type": "string" }, "responseDescription": { "type": "string" }, "amount": { "$ref": "#/components/schemas/requestEnhancedWebhooksAmount" }, "paymentMethods": { "type": "array", "items": { "$ref": "#/components/schemas/enhancedWebhookPaymentMethod" } }, "creationDate": { "type": "string", "format": "date-time" } } }, "requestEnhancedWebhooksAmount": { "required": [ "value", "currency" ], "type": "object", "properties": { "value": { "type": "integer" }, "currency": { "type": "string" } } }, "reversalRequest": { "required": [ "transId", "amount" ], "type": "object", "properties": { "transId": { "maxLength": 64, "type": "string", "description": "Transaction ID created in your system. It should be unique for each payment." }, "amount": { "$ref": "#/components/schemas/amount" }, "refNr": { "type": "string", "description": "Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually." }, "order": { "$ref": "#/components/schemas/order" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs passed by you. Paygate will return the data as it is in the response." }, "paymentMethods": { "$ref": "#/components/schemas/paymentReversal" } } }, "reversalResponse": { "type": "object", "properties": { "payId": { "type": "string", "description": "A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation." }, "merchantId": { "type": "string", "description": "Merchant ID assigned by Axepta Online." }, "transId": { "type": "string", "description": "Transaction ID provided by you in the request." }, "xId": { "type": "string", "description": "A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same." }, "refNr": { "type": "string", "description": "Reference number provided by you in the request." }, "status": { "type": "string", "description": "Status of the transaction." }, "responseCode": { "type": "string", "description": "Response code of the transaction." }, "responseDescription": { "type": "string", "description": "Response description associated with the response code." }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs as you passed in the request." }, "paymentMethods": { "$ref": "#/components/schemas/paymentDataResponseBase" } } }, "schedule": { "type": "object", "properties": { "scheduleNumber": { "type": "integer", "format": "int32" }, "repaymentDate": { "format": "date-time" }, "repaymentAmount": { "type": "integer", "format": "int32" } } }, "senderData": { "type": "object", "properties": { "accountNumber": { "type": "string", "description": "Contains the sender’s bank account number from which the funds are to be taken." }, "name": { "type": "string", "description": "Contains the name of the person or business for the account from which funds are to be taken." }, "address": { "type": "string", "description": "Contains the address of the person or business for the account from which funds are to be taken." }, "city": { "type": "string", "description": "Contains the city of the person or business for the account from which funds are to be taken." }, "countryCode": { "type": "string", "description": "Contains the country of the person or business’s account from which funds are to be taken. To be sent in number 3 Digit ISO standard." }, "transactionMethod": { "enum": [ "CREDIT", "DEBIT", "PREPAID", "CASH", "DEPOSIT_ACCOUNT", "MOBILE_MONEY_ACCOUNT" ], "type": "string", "description": "It indicates the method used by the sender to fund a Payment of winning transaction." }, "accountType": { "enum": [ "RTN_AND_BANK_ACCOUNT_NUMBER", "IBAN", "CARD_ACCOUNT", "IBAN_AND_BIC" ], "type": "string" } } }, "sessionAndLinkAccount": { "type": "object", "properties": { "pseudoBankNumber": { "type": "string", "description": "Pseudo Bank Account Number (PBAN) returned by Paygate during the initial payment that you can use for follow up payments, if applicable." }, "number": { "type": "string", "description": "International Bank Account Number or Mandatory when mandateId is not present." }, "code": { "type": "string", "description": "Bank Identifier Code." }, "bankName": { "type": "string", "description": "Bank name." }, "accountHolderName": { "type": "string", "description": "Account holder name. Mandatory when mandateId is not present." } } }, "sessionAndLinkMandate": { "type": "object", "properties": { "mandateId": { "type": "string", "description": "SEPA Mandate number." }, "dateOfSignature": { "description": "Date of issuing the mandate in the format YYYY-MM-DD.", "format": "date-time" } } }, "sessionAndLinkPrefillInfo": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/sessionAndLinkAccount" } } }, "sessionRequest": { "required": [ "transId", "amount", "urls" ], "type": "object", "properties": { "transId": { "maxLength": 64, "type": "string", "description": "Transaction ID created in your system. It should be unique for each payment." }, "externalIntegrationId": { "type": "string", "description": "External integration identifier" }, "refNr": { "type": "string", "description": "Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually." }, "amount": { "$ref": "#/components/schemas/amount" }, "language": { "type": "string", "description": "Language code to determine the language of the payment form and customer communication where applicable." }, "captureMethod": { "$ref": "#/components/schemas/captureMethod" }, "credentialOnFile": { "$ref": "#/components/schemas/credentialOnFile" }, "order": { "$ref": "#/components/schemas/order" }, "urls": { "$ref": "#/components/schemas/urls" }, "billingAddress": { "$ref": "#/components/schemas/billingAddress" }, "shipping": { "$ref": "#/components/schemas/shipping" }, "statementDescriptor": { "type": "string", "description": "Short, clear description of the transaction that appears on the customer's statement. It is recommend sending a maximum of 22 characters. Allowed characters: a-z, A-Z, 0-9, spaces, and special characters / - ? : ( ) . , +" }, "customerInfo": { "$ref": "#/components/schemas/customerInfo" }, "expirationTime": { "description": "Transaction expiry timestamp (UTC).", "format": "date-time", "example": "2025-02-07T16:00:00Z" }, "fraudData": { "$ref": "#/components/schemas/fraudData" }, "paymentFacilitator": { "$ref": "#/components/schemas/paymentFacilitator" }, "browserInfo": { "$ref": "#/components/schemas/browserInfo" }, "device": { "$ref": "#/components/schemas/device" }, "channel": { "enum": [ "ECOM", "MOTO", "APP", "PAYBYLINK", "POS" ], "type": "string", "description": "Specifies the sales or interaction channel through which the transaction is initiated." }, "metadata": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs passed by you. Paygate will return the data as it is in the response." }, "template": { "$ref": "#/components/schemas/sessionTemplate" }, "allowedPaymentMethods": { "type": "array", "items": { "enum": [ "ALIPAY", "AMAZONPAY", "APPLEPAY", "BOLETO", "BANCONTACT", "BIZUM", "BLIK", "DIRECTDEBIT", "EASYCOLLECT", "EPS", "FLOAPAY", "CARD", "GOOGLEPAY", "IDEAL", "INSTANEA", "KLARNA", "MBWAY", "MULTIBANCO", "MYBANK", "PAYPAL", "PRZELEWY24", "SWISH", "TRUSTLY", "TWINT", "VIPPSMOBILEPAY", "UNIONPAY", "WECHAT", "WERO", "LIMONETIK" ], "type": "string" }, "description": "Indicates list of allowed payment methods that should be shown on the hosted payment page. If not passed default merchant level configuration is used to display the allowed payment methods." }, "partialPayment": { "type": "boolean", "description": "Defines if the payment is a partial payment. Possible values: true or false." }, "paymentMethods": { "$ref": "#/components/schemas/paymentMethodsSession" } } }, "sessionResponse": { "type": "object", "properties": { "_links": { "$ref": "#/components/schemas/links" } } }, "sessionTemplate": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of template to customize the Hosted Payment Page." }, "customFields": { "$ref": "#/components/schemas/customFields" } } }, "shipping": { "type": "object", "properties": { "address": { "$ref": "#/components/schemas/shippingAddress" }, "type": { "type": "string", "description": "Shipping method." } } }, "shippingAddress": { "type": "object", "properties": { "firstName": { "type": "string", "description": "Shipping first name." }, "lastName": { "type": "string", "description": "Shipping last name." }, "companyName": { "type": "string", "description": "Shipping company name. Applicable, when the entity where the goods are being delivered is a business entity." }, "phone": { "$ref": "#/components/schemas/phone" }, "salutation": { "type": "string" }, "streetName": { "type": "string", "description": "Shipping street." }, "streetNumber": { "type": "string", "description": "Shipping street number." }, "addressLine2": { "type": "string", "description": "Address line 2 of shipping address." }, "addressLine3": { "type": "string", "description": "Address line 3 of shipping address." }, "city": { "type": "string", "description": "Shipping city." }, "state": { "type": "string", "description": "State of shipping address." }, "country": { "type": "string", "description": "3 character ISO country code of shipping address." }, "postalCode": { "type": "string", "description": "Shipping postal code." } } }, "shippingInfo": { "type": "object", "properties": { "trackingId": { "type": "string", "description": "Tracking number for the shipment." }, "shippingMethod": { "type": "string", "description": "Shipping method." }, "shippingCompany": { "type": "string", "description": "Identifier of the shipping company. The value should be a valid SHIPPING_COMPANY from the Carrier list: [https://docs.klarna.com/payments/after-payments/order-management/more-actions/klarna-carrier-partner-list/](https://docs.klarna.com/payments/after-payments/order-management/more-actions/klarna-carrier-partner-list/)" }, "trackingUrl": { "type": "string", "description": "URL where the customer can track their shipment." }, "returnTrackingId": { "type": "string", "description": "Tracking number for the return shipment." }, "returnShippingCompany": { "type": "string", "description": "Identifier of the shipping company. The value should be a valid SHIPPING_COMPANY from the Carrier list: [https://docs.klarna.com/payments/after-payments/order-management/more-actions/klarna-carrier-partner-list/](https://docs.klarna.com/payments/after-payments/order-management/more-actions/klarna-carrier-partner-list/)" }, "returnTrackingUrl": { "type": "string", "description": "URL where the customer can track the return shipment." } } }, "stayDetails": { "type": "object", "properties": { "company": { "type": "string", "description": "Shipowner/Operator/Hotel chain." }, "destination": { "type": "string", "description": "Destination city." }, "nightNumber": { "type": "integer", "description": "Number of overnight stays.", "format": "int32" }, "roomRange": { "type": "integer", "description": "Room range.", "format": "int32" } } }, "supplier": { "type": "object", "properties": { "name": { "type": "string" }, "taxRegistrationNumber": { "type": "string" }, "matchCode": { "type": "string" }, "legalName": { "type": "string" }, "address": { "$ref": "#/components/schemas/address" } } }, "surcharge": { "type": "object", "properties": { "status": { "type": "string" }, "costs": { "$ref": "#/components/schemas/surchargeCosts" }, "amount": { "type": "integer", "format": "int32" }, "totalAmount": { "type": "integer", "format": "int32" } } }, "surchargeCosts": { "type": "object", "properties": { "fixedAmount": { "type": "integer", "format": "int32" }, "percentageRate": { "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d+)?$", "type": "number", "format": "double" } } }, "swishCreateSpecificResponse": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" }, "providerTransactionId": { "type": "string" }, "providerToken": { "type": "string" } } }, "swishDetailsSpecificFields": { "type": "object", "properties": { "providerResponseCode": { "type": "string" }, "providerResponseText": { "type": "string" }, "providerTransactionId": { "type": "string" }, "providerToken": { "type": "string" } } }, "tax": { "type": "object", "properties": { "taxRate": { "type": "integer", "format": "int32" }, "taxTypeIndicator": { "enum": [ "VALUE_ADDED_TAX", "SALES_TAX", "OTHER" ], "type": "string" } } }, "templateLink": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of template to customize the Hosted Payment Page." }, "customFields": { "$ref": "#/components/schemas/customFields" } } }, "threeDsData": { "type": "object", "properties": { "acsProtocolVersion": { "type": "string", "description": "The protocol version used for authentication." }, "eci": { "type": "string", "description": "Payment system specific Electronic Commerce Indicator." }, "authenticationValue": { "type": "string", "description": "Payment system specific value to provide proof of authentication." }, "cavvAlgorithm": { "type": "string", "description": "3DS 2.0 only with Cartes Bancaires." }, "serverTransactionId": { "type": "string", "description": "3DS 2.0 only. Universally unique transaction identifier assigned by the 3DS Server." }, "acsXid": { "type": "string", "description": "3DS 1.0 only. ACS assigned transaction ID." }, "dsTransactionId": { "type": "string", "description": "3DS 2.0 only. Universally unique transaction identifier assigned by the DS to identify a single transaction." }, "intermediateStatus": { "enum": [ "Y", "N", "U", "A", "C", "D", "I" ], "type": "string", "description": "This is the transaction status transStatus from the Authentication Response (ARes)." }, "finalStatus": { "enum": [ "Y", "U", "A" ], "type": "string", "description": "This is the transaction status transStatus from the Result Request (RReq)." }, "challengeRequestIndicator": { "enum": [ "NO_PREFERENCE", "NO_AUTHENTICATION", "AUTHENTICATION_REQUESTED", "AUTHENTICATION_REQUIRED_MANDATE", "NO_AUTHENTICATION_TRANSACTION_RISK_PERFORMED", "NO_AUTHENTICATION_DATA_SHARE_ONLY", "NO_AUTHENTICATION_SCA_PERFORMED", "NO_AUTHENTICATION_WHITELIST", "AUTHENTICATION_REQUIRED_WHITELIST" ], "type": "string", "description": "Specifies value for \"3DS Requestor Challenge Indicator\"" }, "challengeCancellationIndicator": { "enum": [ "CARDHOLDER_SELECTED", "THREE_DS_REQUESTED", "TRANSACTION_ABANDONED", "TRANSACTION_TIMED_OUT_OTHER", "TRANSACTION_TIMED_OUT_NOT_RECEIVED", "TRANSACTION_ERROR", "UNKNOWN" ], "type": "string", "description": "Specifies value for \"Challenge Cancellation Indicator\"" }, "dsScore": { "type": "string", "description": "Specifies value for \"DS Score\", scoring returned by the CB DS." }, "transactionStatusReason": { "type": "string", "description": "Specifies value for \"Transaction Status Reason Code\"." } } }, "threeDSMethodData": { "type": "object", "properties": { "threeDSMethodNotificationURL": { "type": "string" }, "threeDSServerTransId": { "type": "string", "description": "payId." } } }, "threeDsPolicy": { "type": "object", "properties": { "skip": { "enum": [ "THIS_TRANSACTION", "OUT_OF_SCOPE", "DATA_ONLY" ], "type": "string", "description": "Indicates whether and under which conditions authentication should be skipped or performed as data share only (dataOnly). By default, all transactions and SCA exemptions will be requested through EMV 3DS if not specified otherwise." }, "exemption": { "$ref": "#/components/schemas/exemption" }, "challengePreference": { "enum": [ "NO_PREFERENCE", "NO_CHALLENGE", "REQUEST_CHALLENGE", "MANDATE_CHALLENGE" ], "type": "string", "description": "Indicates the merchant's preference for a 3DS challenge." } }, "description": "Object specifying authentication policies and exemption handling strategies." }, "threeDsSDK": { "type": "object", "properties": { "sdkApplicationId": { "type": "string", "description": "A unique identifier for the 3D Secure (3DS) SDK application used to facilitate authentication on the customer's device." }, "deviceData": { "type": "string", "description": "Data collected from the customer's device during the 3DS authentication process." }, "sdkEphemeralPublicKey": { "type": "string", "description": "The ephemeral public key generated by the 3DS SDK." }, "sdkReferenceNumber": { "type": "string", "description": "A reference number assigned to the 3DS SDK." }, "sdkTransactionId": { "type": "string", "description": "Unique identifier for the transaction generated by the 3DS SDK." }, "messageVersion": { "type": "string", "description": "The version of the 3D Secure protocol being used by the SDK." } } }, "tokenData": { "type": "object", "properties": { "cryptogram": { "type": "string", "description": "Cryptogram as received from Tokenization Service." }, "eci": { "type": "string", "description": "Payment system specific Electronic Commerce Indicator." }, "tokenRequestor": { "enum": [ "APPLEPAY", "GOOGLEPAY", "MERCHANT_TOKENIZATION" ], "type": "string", "description": "Token Requestor." }, "tokenRequestorId": { "type": "string", "description": "Token Requestor ID assigned by the card scheme.Required when tokenRequestor is MERCHANT_TOKENIZATION and MasterCard transaction." } }, "description": "Token data if you are connected to MDES and VTS directly." }, "travelDetails": { "type": "object", "properties": { "insuranceType": { "type": "string", "description": "Type of supplementary insurance chosen by the customer." }, "travelType": { "enum": [ "UNKNOWN", "ONE_WAY", "TWO_WAY", "MULTIPLE" ], "type": "string" }, "departureDate": { "description": "Mandatory for tour operators, Optional for all others: Start date in format: DD/MM/YYYY HH:MM.", "format": "date-time" }, "returnDate": { "description": "Mandatory for tour operators, Optional for all others: Return date in format: DD/MM/YYYY HH:MM.", "format": "date-time" }, "destinationCountry": { "type": "string", "description": "Mandatory for tour operators, Optional for all others: Alpha-2 ISO code of the destination country." }, "ticketCount": { "type": "integer", "description": "Number of tickets.", "format": "int32" }, "travellerCount": { "type": "integer", "description": "Mandatory for tour operators, Optional for all others: Number of passengers.", "format": "int32" }, "travelClass": { "enum": [ "UNKNOWN", "ECONOMY", "PREMIUM_ECONOMY", "BUSINESS", "FIRST", "OTHERS" ], "type": "string" }, "ownTicket": { "type": "boolean", "description": "Indicator to identify whether the holder of the credit card used to fund the trip is participating." }, "mainDepartureCompany": { "type": "string", "description": "Airline Company One Way Flight." }, "travellerPassports": { "type": "array", "items": { "$ref": "#/components/schemas/travellerPassport" }, "description": "Information concerning the passport(s) of the traveler(s)." }, "departureAirport": { "type": "string", "description": "IATA code of the airport of departure." }, "arrivalAirport": { "type": "string", "description": "IATA code of the arrival airport." }, "discountCode": { "type": "string" }, "luggageSupplement": { "type": "string" }, "modificationCancellation": { "type": "boolean" } } }, "travellerPassport": { "type": "object", "properties": { "expirationDate": { "description": "Passport expiration date in format DD/MM/YYYY.", "format": "date-time" }, "issuanceCountry": { "type": "string", "description": "Alpha-2 ISO code of the country of issue of the passport." } } }, "trustlyCreateIntentSpecificFields": { "type": "object", "properties": { "templateUrl": { "type": "string" } } }, "trustlyCreateLinkSpecificFields": { "type": "object", "properties": { "templateUrl": { "type": "string", "description": "URL of your individual layout for the payment form." } } }, "trustlyCreateSpecificFields": { "type": "object", "properties": { "templateUrl": { "type": "string", "description": "URL of your individual layout for the payment form." } } }, "trustlySessionSpecificFields": { "type": "object", "properties": { "templateUrl": { "type": "string", "description": "URL of your individual layout for the payment form." } } }, "twintCaptureSpecificFields": { "type": "object", "properties": { "completeType": { "type": "boolean", "description": "Specifies whether only a partial amount is being confirmed and authorization should be kept open. If \"YES\" is transferred, the possible open order is closed on capture." } } }, "twintCreateSpecificFields": { "type": "object", "properties": { "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." }, "account": { "$ref": "#/components/schemas/account" } } }, "twintDetailsSpecificFields": { "type": "object", "properties": { "paymentPurpose": { "type": "string", "description": "Purpose of payment." }, "paymentGuarantee": { "type": "string", "description": "NONE= no payment guarantee;VALIDATED= customer account valid, but no payment guarantee;FULL= payment guarantee." }, "providerTransactionId": { "type": "string", "description": "Provider transaction ID." }, "providerResponseText": { "type": "string", "description": "Provider response text." } } }, "twintLinkSpecificFields": { "type": "object", "properties": { "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." }, "account": { "$ref": "#/components/schemas/account" } } }, "twintRefundSpecificResponse": { "type": "object", "properties": { "providerResponseText": { "type": "string" } } }, "twintSessionSpecificFields": { "type": "object", "properties": { "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." }, "account": { "$ref": "#/components/schemas/account" } } }, "unionPayCreateSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "unionPayDetailsSpecificFields": { "type": "object", "properties": { "paymentPurpose": { "type": "string", "description": "Purpose of payment." }, "paymentGuarantee": { "type": "string", "description": "This parameter is only returned if the Status=OK." }, "providerResponseText": { "type": "string", "description": "Is returned only if Status=FAILED. Detailed error PPRO message." }, "providerTransactionId": { "type": "string", "description": "Unique transaction number from PPRO." } } }, "unionPaySessionSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "unscheduledMitRequest": { "required": [ "merchantId", "cardNumber", "cardExpiry", "cardBrand", "schemeReferenceId", "description" ], "type": "object", "properties": { "merchantId": { "maxLength": 30, "type": "string" }, "cardNumber": { "maxLength": 19, "minLength": 13, "type": "string" }, "cardExpiry": { "type": "string" }, "cardBrand": { "type": "string" }, "schemeReferenceId": { "maxLength": 56, "type": "string" }, "description": { "maxLength": 64, "type": "string" }, "cardHolderName": { "maxLength": 128, "type": "string" } } }, "unscheduledMitResponse": { "type": "object", "properties": { "paymentPlanId": { "type": "string" }, "created": { "type": "boolean" }, "warning": { "type": "string" } } }, "updateCustomerRequest": { "type": "object", "properties": { "firstName": { "type": "string", "description": "First name of the customer. Must be present if companyName is not present." }, "lastName": { "type": "string", "description": "Last name of the customer. Must be present if companyName is not present." }, "companyName": { "type": "string", "description": "Company name of the customer. Must be present if firstName and lastName are not present." }, "email": { "type": "string", "description": "E-mail address of the customer." }, "phone": { "$ref": "#/components/schemas/phone" }, "billingAddress": { "$ref": "#/components/schemas/billingAddressCustomer" } } }, "updateRequest": { "type": "object", "properties": { "transId": { "maxLength": 64, "type": "string", "description": "Transaction ID provided by you which should be unique for each payment." }, "amount": { "$ref": "#/components/schemas/amountMini" }, "refNr": { "type": "string", "description": "Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually." }, "order": { "$ref": "#/components/schemas/order" }, "billingAddress": { "$ref": "#/components/schemas/billingAddress" }, "shipping": { "$ref": "#/components/schemas/shipping" }, "customerInfo": { "$ref": "#/components/schemas/customerInfoUpdate" }, "eventToken": { "enum": [ "UPDATE_ORDER_DETAILS", "UPDATE_ADDRESS", "UPDATE_REFERENCE", "RESEND_INVOICE", "DELETE_PERSONAL_DATA" ], "type": "string", "description": "Intent of the updating the payment details.Note: Not all event tokens are applicable for all payment method types. Refer payment method specific pages in our product guide to know the relevant event tokens for a specific payment method." }, "paymentMethods": { "$ref": "#/components/schemas/paymentUpdate" } } }, "updateResponse": { "type": "object", "properties": { "payId": { "type": "string", "description": "A unique identifier assigned by Axepta Online to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation." }, "merchantId": { "type": "string", "description": "Merchant ID assigned by Axepta Online." }, "transId": { "type": "string", "description": "Transaction ID provided by you in the request." }, "xId": { "type": "string", "description": "A unique identifier assigned by Axepta Online for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same." }, "refNr": { "type": "string", "description": "Reference number provided by you in the request." }, "status": { "type": "string", "description": "Status of the transaction." }, "responseCode": { "type": "string", "description": "Response code of the transaction." }, "responseDescription": { "type": "string", "description": "Response description associated with the response code." }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "paymentMethods": { "$ref": "#/components/schemas/paymentDataResponseBase" } } }, "urls": { "type": "object", "properties": { "appRedirect": { "type": "string", "description": "The URL used in Instanea payments to provide the merchant’s base app URL for redirection." }, "return": { "type": "string", "description": "Mandatory when paymentMethods.integrationType=HOSTED. Not applicable for paymentMethods.integrationType=DIRECT." }, "cancel": { "type": "string", "description": "Mandatory when paymentMethods.integrationType=HOSTED. Not applicable for paymentMethods.integrationType=DIRECT." }, "webhook": { "type": "string", "description": "Mandatory when paymentMethods.integrationType=HOSTED. Not applicable for paymentMethods.integrationType=DIRECT." } } }, "validationProblemDetails": { "type": "object", "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "detail": { "type": "string" }, "instance": { "type": "string" }, "errors": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } } } }, "versioningData": { "type": "object", "properties": { "threeDSServerTransId": { "type": "string" }, "acsStartProtocolVersion": { "type": "string" }, "acsEndProtocolVersion": { "type": "string" }, "dsStartProtocolVersion": { "type": "string" }, "dsEndProtocolVersion": { "type": "string" }, "threeDSMethodDataForm": { "type": "string" }, "threeDSMethodUrl": { "type": "string" }, "threeDSMethodData": { "$ref": "#/components/schemas/threeDSMethodData" }, "errorDetails": { "$ref": "#/components/schemas/errorDetails" } }, "description": "Specific object for Card payment method." }, "vIPPSMobilePayCreateIntentSpecificFields": { "type": "object", "properties": { "minAge": { "type": "integer", "format": "int32" }, "termUrl": { "type": "string" }, "eventToken": { "enum": [ "RECURRING_AGREEMENT", "RECURRING_AGREEMENT_WITH_CHARGE" ], "type": "string" }, "campaign": { "$ref": "#/components/schemas/campaign" } } }, "vIPPSMobilePayCreateSpecificFields": { "type": "object", "properties": { "minAge": { "type": "integer", "description": "Minimum age required for purchase. If specified, VIPPS will verify the customer's age before accepting payment.", "format": "int32" }, "termUrl": { "type": "string", "description": "URL where customer can manage subscription. Mandatory for Norway. Must offer actual management capabilities, not just contact info." }, "billingAgreementId": { "type": "string", "description": "Agreement identifier assigned by VIPPS." }, "campaign": { "$ref": "#/components/schemas/campaign" }, "eventToken": { "enum": [ "RECURRING_AGREEMENT", "RECURRING_AGREEMENT_WITH_CHARGE" ], "type": "string", "description": "Specifies the type of recurring transaction event for Vipps MobilePay." } } }, "vIPPSMobilePayLinkSpecificFields": { "type": "object", "properties": { "minAge": { "type": "integer", "description": "Minimum age required for purchase. If specified, VIPPS will verify the customer's age before accepting payment.", "format": "int32" }, "termUrl": { "type": "string", "description": "URL where customer can manage subscription. Mandatory for Norway. Must offer actual management capabilities, not just contact info." }, "billingAgreementId": { "type": "string", "description": "Agreement identifier assigned by VIPPS." }, "campaign": { "$ref": "#/components/schemas/campaign" }, "eventToken": { "enum": [ "RECURRING_AGREEMENT", "RECURRING_AGREEMENT_WITH_CHARGE" ], "type": "string", "description": "Specifies the type of recurring transaction event for Vipps MobilePay." } } }, "vIPPSMobilePaySessionSpecificFields": { "type": "object", "properties": { "minAge": { "type": "integer", "description": "Minimum age required for purchase. If specified, VIPPS will verify the customer's age before accepting payment.", "format": "int32" }, "termUrl": { "type": "string", "description": "URL where customer can manage subscription. Mandatory for Norway. Must offer actual management capabilities, not just contact info." }, "billingAgreementId": { "type": "string", "description": "Agreement identifier assigned by VIPPS." }, "campaign": { "$ref": "#/components/schemas/campaign" }, "eventToken": { "enum": [ "RECURRING_AGREEMENT", "RECURRING_AGREEMENT_WITH_CHARGE" ], "type": "string", "description": "Specifies the type of recurring transaction event for Vipps MobilePay." } } }, "weChatCreateSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "weChatDetailsSpecificFields": { "type": "object", "properties": { "paymentPurpose": { "type": "string", "description": "Purpose of payment." }, "paymentGuarantee": { "type": "string", "description": "This parameter is only returned if the Status=OK." }, "providerResponseText": { "type": "string", "description": "Is returned only if Status=FAILED. Detailed error PPRO message." }, "providerTransactionId": { "type": "string", "description": "Unique transaction number from PPRO." } } }, "weChatSessionSpecificFields": { "type": "object", "properties": { "account": { "$ref": "#/components/schemas/account" }, "sellingPoint": { "type": "string", "description": "Selling point." }, "service": { "type": "string", "description": "Products or service sold." } } }, "wEROCaptureSpecificFields": { "type": "object", "properties": { "providerTransactionId": { "type": "string" } } }, "wEROCaptureSpecificResponse": { "type": "object", "properties": { "providerTransactionId": { "type": "string" }, "providerResponseText": { "type": "string" }, "providerResponseCode": { "type": "string" } } }, "wEROCreateSpecificFields": { "type": "object", "properties": { "walletId": { "type": "string", "description": "EPI provided Wallet ID identifying the Consumer Wallet used during a Wero payment" } } }, "wERODetailsSpecificFields": { "type": "object", "properties": { "walletId": { "type": "string", "description": "EPI provided Wallet ID identifying the Consumer Wallet used during a Wero payment." }, "payplan": { "type": "string", "description": "Describes the payment type performed i.e SingleImmediate or Event Dependent etc." }, "consentId": { "type": "string", "description": "EPI assigned Consent ID." }, "paymentId": { "type": "string", "description": "EPI assigned Payment Request ID." }, "captureId": { "type": "string", "description": "EPI assigned Capture ID." }, "refundId": { "type": "string", "description": "EPI assigned Refund ID." } } }, "wEROErrorSpecificResponse": { "type": "object", "properties": { "providerResponseText": { "type": "string" }, "providerResponseCode": { "type": "string" } } }, "wERORefundSpecificFields": { "type": "object", "properties": { "providerTransactionId": { "type": "string" } } }, "wEROSessionSpecificFields": { "type": "object", "properties": { "walletId": { "type": "string", "description": "EPI provided Wallet ID identifying the Consumer Wallet used during a Wero payment" } } } }, "securitySchemes": { "bearer": { "type": "http", "description": "JWT Authorization header using the Bearer scheme. Enter your token in the format: Bearer {token}", "scheme": "bearer", "bearerFormat": "JWT" }, "basic": { "type": "http", "description": "Basic Authentication using username and password", "scheme": "basic" }, "apiKey": { "type": "apiKey", "description": "API Key authentication using X-API-Key header", "name": "X-API-Key", "in": "header" } } }, "tags": [ { "name": "Guide", "description": "This API specification is focused on the technical integration, all the capabilities and how they link to the API specification are described in [Product Guide](https://docs.axepta.bnpparibas/display/DOCBNP/Axepta+BNP+Paribas+REST+API)" }, { "name": "Authentication", "description": "**Securely authenticate API requests using Basic Auth or OAuth 2.0**\r\n\r\nThe Axepta Online API supports two authentication methods to ensure secure access to payment processing and management endpoints. Choose the approach that aligns with your integration needs:\r\n\r\n**Basic Authentication**\r\n\r\nUse your Merchant ID as the username and API Key as the password. Combine them in the format `MerchantID:APIKey`, encode the string using Base64, and include it in the Authorization header with the `Basic` prefix for direct access to endpoints.\r\n\r\n**OAuth 2.0**\r\n\r\nGenerate a short-lived JSON Web token (JWT) by authenticating with your API key via the `authorization/oauth/token` endpoint." }, { "name": "Payments", "description": "**Create checkout session**\r\n\r\nThis endpoint generates a URL for a hosted payment page where customers can securely select their preferred payment method and complete their transaction.\r\n\r\n**Create payment**\r\n\r\nThis endpoint is used to initiate a payment for a specific payment method. You can choose between two integration types:\r\n\r\n- HOSTED: Returns a URL for a payment method-specific hosted form, where the customer is redirected to securely complete the payment.\r\n - DIRECT: Enables server-to-server communication, where you manage the payment UI and directly interacts with the API to process payments.\r\n\r\nNote that not all payment methods support both HOSTED and DIRECT integration types. Some support only one of these options, while others support both. For detailed information about the supported integration types for each payment method, refer to the payment method-specific documentation in our product guide.\r\n\r\n**Confirm payment**\r\n\r\nThis endpoint is used for payment methods that require a multi-step payment flow. It allows you to confirm a previously created payment instance (initiated via the Create Payment endpoint) to complete the transaction. This step is essential for certain payment methods to finalize the payment process.\r\n\r\n**Incremental authorization**\r\n\r\nThis endpoint allows you to increase the authorized amount for an existing card transaction when the initial authorization is insufficient. The additional amount is appended to the original authorization, and the total authorized amount reflects both.\r\n\r\n**Reverse payment**\r\n\r\nThis endpoint is used to reverse a payment that has not yet been captured, effectively canceling the authorization.\r\n\r\n**Capture payment**\r\n\r\nThis endpoint is used to capture an existing authorized payment.\r\n\r\n**Refund payment**\r\n\r\nThis endpoint is used to refund a captured payment.\r\n\r\n**Refund payment without reference**\r\n\r\nThis endpoint is used to refund a payment without reference.\r\n\r\n**Retrieve payment details by Payment ID**\r\n\r\nThis endpoint is used to retrieve payment details with the Payment ID (payId)\r\n\r\n**Retrieve payment details by Transaction ID**\r\n\r\nThis endpoint is used to retrieve payment details with the Transaction ID (transId)\r\n\r\n**Update payment details**\r\n\r\nThis endpoint is used to update payment details\r\n\r\n**Create payment link**\r\n\r\nThis endpoint allows you to generate a payment link that can be shared with customers via email, SMS, or other channels. When customers click the link, they are redirected to a hosted payment page where they can select their preferred payment method and complete the transaction." }, { "name": "Webhooks", "description": "**Receive payment result notifications via Webhooks**\r\n\r\nThe Axepta Online API enables asynchronous event notifications through Webhooks, allowing your system to automatically receive the final result of a payment for hosted integration types, without the need for continuous polling.\r\n\r\n**Basic Webhook**\r\n\r\nSends only the payId, allowing your system to fetch full payment details afterward.\r\n\r\n**Enhanced Webhook**\r\n\r\nSends the complete payment information directly within the webhook payload.\r\n\r\nFor information on securing webhook communication, see the _Security & verification_ section in the [documentation](https://docs.axepta.bnpparibas/display/DOCBNP/Callback+and+Payment+Notification+Management)." }, { "name": "PaymentPlans", "description": "**Retrieve List of Payment Plans**\r\n\r\nThis endpoint is used to retrieve list of Payment Plans\r\n\r\n**Retrieve a Payment Plan**\r\n\r\nThis endpoint is used to retrieve a specific Payment Plan using the `paymentPlanId`\r\n\r\n**Create a Payment within Payment Plan**\r\n\r\nThis endpoint is used to create a payment using the `paymentPlanId`\r\n\r\n**Cancel Payment Plan**\r\n\r\nThis endpoint is used to cancel a Payment Plan\r\n\r\n**List payments within a Payment Plan**\r\n\r\nThis endpoint is used to list all the payments within a Payment Plan" }, { "name": "Customers", "description": "**Retrieve customers**\r\n\r\nThis endpoint is used to retrieve a list of customers.\r\n\r\n**Retrieve customer**\r\n\r\nThis endpoint is used to retrieve details of a specific customer.\r\n\r\n**Update customer data**\r\n\r\nThis endpoint is used to update customer data.\r\n\r\n**Delete customer**\r\n\r\nThis endpoint is used to delete a specific customer and associated payment methods.\r\n\r\n**Retrieve payment methods**\r\n\r\nThis endpoint is used to retrieve all payment methods for a specific customer.\r\n\r\n**Retrieve payment method**\r\n\r\nThis endpoint is used to retrieve details of a specific payment method.\r\n\r\n**Delete payment method**\r\n\r\nThis endpoint is used to delete a specific payment method." }, { "name": "Services", "description": "**Duplication Check**\r\n\r\nThis endpoint is used to check for duplicate transactions based on specific criteria.\r\n\r\n**Account Updater**\r\n\r\nThis endpoint is used to check updates and sends updated credit card data back in response." }, { "name": "Change log", "description": "2.5.0\r\n\r\n- Introduced new object called tokenizedCard in Retrieve payment details response for Apple pay and Google pay.\r\n - Added the support to delete personal details in a transaction using Update payment details.\r\n - Fixed the issue that caused authentication data not being returned in Retrieve payment details response after authorization is completed.\r\n - Unified the error response specification in all endpoints.\r\n\r\n2.4.0\r\n\r\n- Added support for the Duplication Check endpoint\r\n - Added support for the Account Updater endpoint\r\n - Added support for the 'LIMONETIK' payment method\r\n - Added support for the 'BLIK' payment method via 'PPRO'\r\n - Enhanced the create payment request for the `PayPal` payment method (expressCheckout parameter)\r\n - Added WalletId in create checkout session endpoint for the 'Wero' payment method\r\n\r\n 2.3.0\r\n\r\n - Payment Plans\r\n\r\n 2.2.0\r\n\r\n - Fix 400 error code response body specs\r\n - Return order.invoiceId and order.merchantReference in Response if sent in request\r\n - Add order.description property to provide overall description for the order\r\n\r\n 2.1.0\r\n\r\n - Changed the name of the VIPPS payment method to `VIPPSMOBILEPAY` and add recurring payment support\r\n - Enhanced the get payment details response for the `WERO` payment method\r\n - Enhanced the card payment method response with `cardholderConsentToStore`\r\n - Updated the Bancontact payment method acquirer logic\r\n - Fixed the `RATEPAY` payment method tax rate calculation\r\n - Fixed the Customer Vault `pseudoCardNumber` and `last4Digits` issues\r\n - Removed unnecessary recurring object validation\r\n - Added support for the `BIZUM` payment method\r\n - Added support for the `UNIONPAY` payment method via `PPRO`\r\n - Added support for the `ALIPAY` payment method via `PPRO`\r\n - Added support for the `WECHAT` payment method via `PPRO`\r\n - Added support for the `MBWAY` payment method via `PPRO`\r\n - Added services/dcc/quote endpoint\r\n - Added services/dcc/bin-check endpoint\r\n - Enhanced the get payment details response for the `CARD` payment method (dccInfo object)\r\n - Enhanced the create payment hosted (dccEnabled parameter) and direct (dcc object) requests for the `CARD` payment method\r\n - Enhanced the create session request for the `CARD` payment method (dccEnabled parameter)\r\n\r\n 2.0.0\r\n\r\n - Initial version of REST API V2 Specification" } ], "webhooks": { "/{merchantEnhancedWebhookUrl}": { "post": { "tags": [ "Webhooks" ], "summary": "Enhanced Webhook", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/requestEnhancedWebhooks" } } }, "required": true }, "responses": { "2xx": { "description": "Successfully received and processed by merchant system" }, "4xx": { "description": "Delivery will be retried according to Computop retry policy" }, "5xx": { "description": "Delivery will be retried according to Computop retry policy" } } } }, "/{merchantBasicWebhookUrl}": { "post": { "tags": [ "Webhooks" ], "summary": "Basic Webhook", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/requestBasicWebhooks" } } }, "required": true }, "responses": { "2xx": { "description": "Successfully received and processed by merchant system" }, "4xx": { "description": "Delivery will be retried according to Computop retry policy" }, "5xx": { "description": "Delivery will be retried according to Computop retry policy" } } } } } }