Withdraw Transaction Notification
The system sends transaction results to the callback URL provided by the merchant.
Request Information
- Request URL: The
notify_urlprovided by the merchant when creating the withdrawal order - Request Method:
POST - Content-Type:
application/json;charset=utf-8
Request Parameters (Sent by System to Merchant)
| Parameter | Required | Type | Description |
|---|---|---|---|
| payout_id | Yes | String | System order ID |
| payout_cl_id | Yes | String | Merchant order ID |
| platform_id | Yes | String | Merchant ID |
| amount | Yes | Integer | Order amount (in cents) |
| real_amount | Yes | Integer | Actual received amount (in cents) |
| fee | Yes | Integer | Transaction fee |
| status | Yes | Integer | Transaction status |
| create_time | Yes | Integer | Creation time (Unix timestamp in seconds) |
| update_time | Yes | Integer | Update time (Unix timestamp in seconds) |
| sign | Yes | String | Order signature |
Request Example
{
"payout_id": "POT00000102",
"payout_cl_id": "97a968b4a9db497c8c03198e395a38c6",
"platform_id": "PF0014",
"amount": 400000,
"real_amount": 400000,
"fee": 3200,
"status": 2,
"create_time": 1567614049,
"update_time": 1567614111,
"sign": "d2e4534fce8c1d1053bbf59fd8ae4464"
}
Merchant Response Example
After receiving the notification, the merchant should return JSON format data to confirm receipt.
{
"error_code": "0000"
}
Response Parameter Description
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Return "0000" to indicate the platform has processed successfully |
Remarks
- This interface is implemented by the merchant. The system will call this interface when the order is completed.
- Within one hour after order completion, the system will retry notification up to 10 times. Notifications will stop once the merchant returns success.
- It is recommended that the merchant implements signature verification to ensure content has not been tampered with.
- This interface may receive duplicate notifications. The merchant should determine whether to execute business logic to avoid duplicate crediting.
- For order status, refer to: Order Status List