PerTransfer API

Testing Env

https://testpay.onlinepay.ai

POST

/payment

OnlinePay will obtain the HTTP Header referrer 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": 111111,
  "merOrderNo": "222222",
  "currencyCode": "USD",
  "sourceAmount": "100.05",
  "returnUrl": "https://example.com",
  "notifyUrl": "https://example.com/notify",
  "sign": "906FDF4880B00B00281F2AB61AE9A721",
  "ipAddress": "192.168.1.1",
  "version": "V3.0.0",
  "userId": "123421",
  "email": "test@test.com",
  "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.131 Safari/537.36",
  "billingFirstName": "John",
  "billingLastName": "Doe",
  "billingPhone": "123456789",
  "billingEmail": "test@test.com",
  "customerIdentificationType": "00",
  "customerIdentification": "123456789"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://testpay.onlinepay.ai/payment' \
--header 'paymentType: PER_TRANSFER' \
--header 'Content-Type: application/json' \
--data-raw '{
  "merNo": 111111,
  "merOrderNo": "222222",
  "currencyCode": "USD",
  "sourceAmount": "100.05",
  "returnUrl": "https://example.com",
  "notifyUrl": "https://example.com/notify",
  "sign": "906FDF4880B00B00281F2AB61AE9A721",
  "ipAddress": "192.168.1.1",
  "version": "V3.0.0",
  "userId": "123421",
  "email": "test@test.com",
  "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.131 Safari/537.36",
  "billingFirstName": "John",
  "billingLastName": "Doe",
  "billingPhone": "123456789",
  "billingEmail": "test@test.com",
  "customerIdentificationType": "00",
  "customerIdentification": "123456789"
}'

Responses

🟢200OK

application/json

Body

Example

{
    "code":"00000",
    "message":"SUCCESS",
    "data":{
        "payCode":0,
        "tradeNo":"3333333",
        "merorderNo":"222222",
        "payUrl":"https://abc.com/"
     }
}

🟠400Invalid status value

Modified at 2025-07-04 06:43:44

GCash API

PIX API