Create Payout

WARNING

Note: if the response times out or returns a non-200 HTTP status code, confirm the order status with operations before resubmitting

WARNING

Important: name + phone + email + amount are used to identify distinct customers. Follow these notes to avoid incorrect risk-control decisions.

1. Do not hard-code name, phone, and email together
2. Use the same name + phone + email for the same customer

Endpoint

POST /cashout/mex/order/create

Request Parameters

Field	Type	Required	Description
name	string	Yes	Customer name — More realistic values improve success rate and reduce risk-control flags
phone	string	Yes	Customer mobile number — More realistic values improve success rate and reduce risk-control flags
email	string	Yes	Customer email — More realistic values improve success rate and reduce risk-control flags
bankCode	string	Yes	Bank code
account	string	Yes	Bank account number
amount	number	Yes	Amount — Up to 2 decimal places (rounded). Trailing zeros after the decimal are omitted in the pre-sign string for float amounts
notifyUrl	string	Yes	Notification callback URL — Sandbox supports automatic callbacks: odd last digit of phone → success; even → failure
sign	string	Yes	Signature
appId	string	Yes	Merchant appId
mchOrderNo	string	Yes	Merchant order number
mchId	integer	Yes	Merchant ID
txChannel	string	Yes	Transaction channel — Fixed value: TX_MEX_001
timestamp	integer	Yes	Current timestamp — Unix timestamp in seconds

Request Example

"{\r\n \"mchId\": 10001,\r\n \"txChannel\": \"TX_MEX_001\"\r\n \"appId\": \"10001\",\r\n \"timestamp\": 16624500121,\r\n \"mchOrderNo\": \"payout_1662112069\",\r\n \"name\": \"Charles Clark\",\r\n \"phone\": \"18133533117\",\r\n \"email\": \"vumls@nipdvy.lk\",\r\n \"bankCode\": \"BANCOMEXT\",\r\n \"account\": \"646180110400000001\",\r\n \"amount\": 180.34,\r\n \"notifyUrl\": \"http://tfcxggxrvz.com/oksgk\",\r\n \"sign\": \"xxxxxxxx\"\r\n}"

Response Parameters

Field	Type	Required	Description
status	integer	Yes	Status — 200 success
msg	string	Yes	Message
data	object	Yes
data.applyTime	integer	Yes	Application time
data.amount	number	Yes	Credited amount
data.platOrderNo	string	Yes	Platform order number
data.mchOrderNo	string	Yes	Merchant order number
data.orderStatus	string	Yes	Order status

Response Example

{
 "status": 200,
 "msg": null,
 "data": {
 "mchOrderNo": "payout_1662104438",
 "platOrderNo": "wussXUCOoXO3yptr7rQV",
 "applyTime": 1662104742,
 "amount": 180.34,
 "orderStatus": "PENDING"
 }
}

Related

• Mexico
• Signature & Verification
• Payout Webhook