Special Notes:

  1. When calling the payout API, network timeouts or unknown exceptions (with a response code of 5000) may occur. In such cases, the result of the transaction is unknown, and it is necessary to query the payout order status later to obtain the latest update.

  2. If a network timeout occurs, you may retry after 2 minutes.

​
Request URL

  • https://gateway.pay247.io/gateway/payout/create

​
Request Method

  • POST

​
Request Parameters

ParameterMustTypeExplanation
mch_idYesstringMerchant ID
mch_order_noYesstringMerchant Order NO.
currencyYesstringCurrency [PHP, JPY, INR, USD…]
amountYesstringAmount
pay_methodYesstringPayment method
account_nameYesstringAccouont Name
account_noYesstringAccount No.
notify_urlNostringNotify URL
bank_codeNostring【OPTIONAL】Bank Code for pay_method = bank
bank_branchNostring【OPTIONAL】Bank Branch
timestampYesstringtimestamp millisecond
versionYesstringv1.0
uuidYesstringRequest ID: 550e8400-e29b-41d4-a716-446655440000
signYesstringSignatrue

​
Response data

ParameterMustTypeExplanation
mch_idYesstringMerchant ID
mch_order_noYesstringMerchant Order NO.
order_noYesstringOrder NO.
currencyYesstringCNY、 THB、PHP、VND… See more at backoffice
amountYesstringAmount
feeYesstringFee
statusYesstatusPENDING, DEALING, CLOSED, SUCCESS, FAIL
paid_atNostringif the order SUCCESS, will have paid time
errorNostringif the order FAIL, maybe have error info

​
For example

{
    "code": 0,
    "message": "Success",
    "timestamp": 1594099906123,
    "uuid": "7eb3c9e-5a1d-4a19-be2a-c80eac39830a",
    "data": {
        "mch_id": "X3DSKDKII2343",
        "mch_order_no": "R898543254325432",
        "order_no": "202007070427475133333",
        "currency": "USD",
        "amount": "99.11",
        "pay_method": "BANK",
        "status": "PENDING",
        "fee": "3.60",
        "paid_at": 1594223431233,
        "error": ""
    }
}

​
Indian（INR）Payout Request Parameters

ParameterMustTypeExplanation
mch_idYesstringMerchant ID.
mch_order_noYesstringMerchant Order No.
currencyYesstringCurrency: PHP
amountYesstringAmount
pay_methodYesstringPayment Method: BANK
account_noYesstringAccount No.
bank_codeYesstringIFSC
notify_url否stringNotify URL
timestampYesstringTimestamp millisecond
versionYesstringVersion: v1.0
uuidYesstringRequest ID: 550e8400-e29b-41d4-a716-446655440000
signYesstringSignatrue

​
Philippine（PHP）Payout Request Parameters

ParameterMustTypeExplanation
mch_idYesstringMerchant ID.
mch_order_noYesstringMerchant Order No.
currencyYesstringCurrency: PHP
amountYesstringAmount
pay_methodYesstringPayment Method: BANK
account_noYesstringAccount No.
bank_codeYesstring Bank Codes
notify_url否stringNotify URL
timestampYesstringTimestamp millisecond
versionYesstringVersion: v1.0
uuidYesstringRequest ID: 550e8400-e29b-41d4-a716-446655440000
signYesstringSignatrue