SEPA Virtual Account API

Testing Env

https://testpay.onlinepay.ai

POST

/v2/payment

OnlinePay will obtain the HTTP Header referer to verify the website source. The website source must be configured by OnlinePay to be verified. If you do not access the interface through a browser, you need to actively add a referer.

Request

Header Params

Body Params application/json

Example

{
    "merNo": -68046323,
    "merOrderNo": "eiusmod pariatur",
    "currencyCode": "ZMW",
    "sourceAmount": "870.15",
    "returnUrl": "https://closed-design.org/",
    "notifyUrl": "https://unfit-swing.name/",
    "sign": "Duis",
    "ipAddress": "8f90:3eb7:396f:cffd:f621:78be:db85:2fee",
    "userId": "19",
    "email": "Johnny_Dicki97@gmail.com",
    "userAgent": "Mozilla/5.0 (Windows NT 6.2; rv:10.8) Gecko/20100101 Firefox/10.8.5",
    "billingFirstName": "Dennis",
    "billingLastName": "Jacobson",
    "billingAddress1": "351 Jerald Plaza",
    "billingAddress2": "magna in et",
    "billingCity": "Luettgenworth",
    "billingCountry": "labore aute",
    "dateOfBirth": "2027-04-04",
    "iban": "BE08473979000314",
    "bicSwift": "QPWJNIN8XXX",
    "idFiles": [
        "file_id_identity_front",
        "file_id_identity_back"
    ],
    "bankStatementFiles": [
        "file_id_bank_statement"
    ],
    "kycReportFiles": [
        "file_id_kyc_liveness_selfie_report"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://testpay.onlinepay.ai/v2/payment' \
--header 'paymentType: SEPA Virtual Account' \
--header 'Referer: https://example.com' \
--header 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...' \
--header 'lang: en-US' \
--header 'orderType;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merNo": -68046323,
    "merOrderNo": "eiusmod pariatur",
    "currencyCode": "ZMW",
    "sourceAmount": "870.15",
    "returnUrl": "https://closed-design.org/",
    "notifyUrl": "https://unfit-swing.name/",
    "sign": "Duis",
    "ipAddress": "8f90:3eb7:396f:cffd:f621:78be:db85:2fee",
    "userId": "19",
    "email": "Johnny_Dicki97@gmail.com",
    "userAgent": "Mozilla/5.0 (Windows NT 6.2; rv:10.8) Gecko/20100101 Firefox/10.8.5",
    "billingFirstName": "Dennis",
    "billingLastName": "Jacobson",
    "billingAddress1": "351 Jerald Plaza",
    "billingAddress2": "magna in et",
    "billingCity": "Luettgenworth",
    "billingCountry": "labore aute",
    "dateOfBirth": "2027-04-04",
    "iban": "BE08473979000314",
    "bicSwift": "QPWJNIN8XXX",
    "idFiles": [
        "file_id_identity_front",
        "file_id_identity_back"
    ],
    "bankStatementFiles": [
        "file_id_bank_statement"
    ],
    "kycReportFiles": [
        "file_id_kyc_liveness_selfie_report"
    ]
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "code": "00000",
    "message": "SUCCESS",
    "data": {
        "payCode": 2,
        "tradeNo": "T20260519001",
        "merOrderNo": "ORDER001",
        "beneficialName": "Peter Master",
        "iban": "DK4689000029415728",
        "bankAddress": "DK",
        "reference": "REF1760000000000",
        "bic": "SXPYDKKKXXX",
        "bankName": "Banking Circle"
    }
}

Modified at 2026-06-15 12:13:58

SEPA Master Account API

Credit Card API