Payout API
Tips
Payout API is used to initiate transfer requests to e-wallets or bank accounts.
- All requests are
Post
requests, and the data format isjson
Brief Description
(This section is intentionally left blank for brevity.)
Request URL
/v1/paypro/payOut
Request Method
- POST
Header
Header | Required | Type | Description |
---|---|---|---|
merchantNo | Yes | string | N/A |
Request Body Parameters
Parameter | Required | Type | Description |
---|---|---|---|
sign | Yes | string | Compose the remaining fields (excluding sign) in alphabetical order as key1=value1key2=value2, use the app secret as the salt for MD5 encryption, and the final sign should be in lowercase letters. |
timestamp | Yes | integer | Timestamp (e.g., 1715941383720) |
tradeNo | Yes | string | Uniqueness (recommended format: YYYYMMDDHHMMSS+random number) |
amount | Yes | string | Payment amount (ecimals are not recommended) |
accountName | Yes | string | Account holder name |
bankName | Yes | string | Bank name (Refer to the bank code field of the bank list) |
bankNumber | Yes | string | Recipient, bank account number, or recipient phone number |
notifyUrl | Yes | string | Asynchronous callback URL |
remark | No | string | Remarks, this field will be returned in the callback |
Request Parameter Example
{
"amount": "100",
"bankName": "Maya",
"bankNumber": "09539077075",
"accountName": "09539077075",
"tradeNo": "993332112131",
"notifyUrl": "https://www.111.com/",
"sign": "801b55d19b3b99b49704adcd4751c4bf",
"timestamp": 1729947433293
}
Response Result
Parameter | Required | Type | Description |
---|---|---|---|
msg | Yes | string | Request result (when "success" is returned, it only indicates the success of this request and cannot be used for merchant-side logical judgment) |
code | Yes | string | Request response code (when "0000" is returned, it only indicates the success of this request and cannot be used for merchant-side logical judgment). For specific error codes, please refer to the business error code enumeration. |
timestamp | Yes | string | Transaction timestamp |
success | Yes | string | Transaction result |
data | Yes | Object | Returned object |
data.platFormTradeNo | Yes | string | Unique platform order number |
data.status | Yes | string | Request result, which merchants can use for logical processing. When the result is "0000", it indicates a successful transaction; "0015" indicates processing; other codes indicate errors and can be treated as failures. |
data.desc | Yes | string | Error description |
data.remark | Yes | string | Remarks |
Success Response Example
{
"msg": "success",
"code": "0000",
"timestamp": 1729947461317,
"success": true,
"data": {
"platFormTradeNo": "8rlfud1oh1ruceq7",
"status": "0100119",
"desc": "fail"
}
}