Supplement Payee Info API

Testing Env

https://testpay.onlinepay.ai

POST

/v2/supplementPayeeInfo

Use this API to supplement the payee IBAN and BIC/SWIFT information before initiating or completing a virtual account payout. The request must pass V2 RSA256 signature verification.

Request

Header Params

Body Params application/jsonRequired

Examples

Standard requestSignature plain text example

Complete request body for supplementing payee bank details.

{
    "merNo": "104001001",
    "tradeNo": "T2026060500001",
    "accountNum": "GB29NWBK60161331926819",
    "bicSwift": "NWBKGB2L",
    "sign": "U0lHTkFUVVJFX0JBU0U2NF9TVFJJTkc=",
    "signType": "RSA256",
    "version": "V2.0.0"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Standard requestSignature plain text example

curl --location 'https://testpay.onlinepay.ai/v2/supplementPayeeInfo' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...' \
--header 'lang: en-US' \
--header 'Content-Type: application/json' \
--data '{
    "merNo": "104001001",
    "tradeNo": "T2026060500001",
    "accountNum": "GB29NWBK60161331926819",
    "bicSwift": "NWBKGB2L",
    "sign": "U0lHTkFUVVJFX0JBU0U2NF9TVFJJTkc=",
    "signType": "RSA256",
    "version": "V2.0.0"
}'

Responses

🟢200

application/json

The request has been processed. Check the response code to determine the business result.

Bodyapplication/json

{
    "code": "00000",
    "message": "SUCCESS"
}

Modified at 2026-06-05 09:17:38

Upload SEPA File API

Refund API