Create

Special Notes:

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.
If a network timeout occurs, you may retry after 2 minutes.

The payout flowchart

Request URL

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

Request Method

POST

Request Parameters

Parameter	Must	Type	Explanation
mch_id	Yes	string	Merchant ID
mch_order_no	Yes	string	Merchant Order NO.
currency	Yes	string	Supports CNY, JPY, PHP, THB, SGD, etc. For a complete list of supported currencies, please refer to the merchant backoffice.
amount	Yes	string	Amount
pay_method	Yes	string	Payment method
account_name	Optional	string	Account Name with Fiat Currency, No need for Crypto Currency
account_no	Yes	string	Account No. for Fiat. Address for Crypto Currency
notify_url	No	string	Notify URL
bank_code	No	string	[OPTIONAL] For India INR, please provide the IFSC code. For details, please refer to the India Payout Request Parameters Description. For other currencies, please provide the bank code for the [bank card channel] Bank List. If you have any questions, please feel free to contact us.
bank_branch	No	string	[OPTIONAL]Bank Branch
timestamp	Yes	string	timestamp millisecond
version	Yes	string	v3.0
uuid	Yes	string	Request ID: 550e8400-e29b-41d4-a716-446655440000
sign	Yes	string	Signatrue

Response data

Parameter	Must	Type	Explanation
mch_id	Yes	string	Merchant ID
mch_order_no	Yes	string	Merchant Order NO.
order_no	Yes	string	Order NO.
currency	Yes	string	CNY、 THB、PHP、VND… See more at backoffice
amount	Yes	string	Amount
fee	Yes	string	Fee
status	Yes	status	CONFIRMING, PENDING, DEALING, SUCCESS, FAIL
paid_at	No	string	if the order SUCCESS, will have paid time
error	No	string	if 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

Parameter	Must	Type	Explanation
mch_id	Yes	string	Merchant ID.
mch_order_no	Yes	string	Merchant Order No.
currency	Yes	string	Currency: PHP
amount	Yes	string	Amount
pay_method	Yes	string	Payment Method: BANK
account_name	Yes	string	Account Name.
account_no	Yes	string	Account No.
bank_code	Yes	string	IFSC
notify_url	否	string	Notify URL
timestamp	Yes	string	Timestamp millisecond
version	Yes	string	Version: v3.0
uuid	Yes	string	Request ID: 550e8400-e29b-41d4-a716-446655440000
sign	Yes	string	Signatrue

Philippine（PHP）Payout Request Parameters

Parameter	Must	Type	Explanation
mch_id	Yes	string	Merchant ID.
mch_order_no	Yes	string	Merchant Order No.
currency	Yes	string	Currency: PHP
amount	Yes	string	Amount
pay_method	Yes	string	Payment Method: BANK
account_name	Yes	string	Account Name.
account_no	Yes	string	Account No.
bank_code	Yes	string	Bank Codes
notify_url	否	string	Notify URL
timestamp	Yes	string	Timestamp millisecond
version	Yes	string	Version: v3.0
uuid	Yes	string	Request ID: 550e8400-e29b-41d4-a716-446655440000
sign	Yes	string	Signatrue

Mexico（MXN）Payout Request Parameters

Parameter	Must	Type	Explanation
mch_id	Yes	string	Merchant ID.
mch_order_no	Yes	string	Merchant Order No.
currency	Yes	string	Currency: MXN
amount	Yes	string	Amount
pay_method	Yes	string	Payment Method: BANK
account_name	Yes	string	Account Name.
account_no	Yes	string	Account No.
bank_code	Yes	string	Bank Codes
notify_url	否	string	Notify URL
timestamp	Yes	string	Timestamp millisecond
version	Yes	string	Version: v3.0
uuid	Yes	string	Request ID: 550e8400-e29b-41d4-a716-446655440000
sign	Yes	string	Signatrue

Quickstart

Balance

Payin

Payout

Reference

The payout flowchart

Request URL

Request Method

Request Parameters

Response data

For example

Indian（INR）Payout Request Parameters

Philippine（PHP）Payout Request Parameters

Mexico（MXN）Payout Request Parameters

​The payout flowchart

​Request URL

​Request Method

​Request Parameters

​Response data

​For example

​Indian（INR）Payout Request Parameters

​Philippine（PHP）Payout Request Parameters

​Mexico（MXN）Payout Request Parameters

The payout flowchart

Request URL

Request Method

Request Parameters

Response data

For example

Indian（INR）Payout Request Parameters

Philippine（PHP）Payout Request Parameters

Mexico（MXN）Payout Request Parameters