System Callback
Collection Callback
When a user successfully makes a payment, the system will notify the merchant via the callback URL in the order (please note that callbacks may be sent multiple times; if the order has already been processed in your system, please ignore these callback requests).
- Method: POST JSON
- Request Parameters:
| Name | Type | Description |
|---|---|---|
| id | string | Platform unique order ID |
| mch_id | number | Merchant ID |
| trans_id | string | Merchant order ID |
| channel | string | Channel |
| order_amount | number | Order amount |
| payed_amount | number | Actual paid amount by user. If this amount is different from order_amount, do not credit the account |
| created_at | string | Order creation time |
| payed_at | string | Order payment time (only present when order is successful) |
| status | number | Order status: 60 for success, 20 for processing, others are failure |
| sign | string | Parameter signature. See Signature Algorithm |
Callback Notes:
- For a successful callback, please return the string
success- Timeout and retry: The current system callback timeout is 10 seconds. Please return within this period. If the first callback fails, the system will retry every 30 seconds. After five consecutive failures, it will stop retrying automatically.
- Please pay attention to the payed_amount field, which is the actual amount paid by the user. This amount may not always match the order amount (e.g., if the user changes the payment amount). When receiving the callback, be sure to check if it matches the order amount before crediting the account.
Payout Callback
After a payout is successful, the system will notify the merchant via the callback URL in the order (please note that callbacks may be sent multiple times; if the order has already been processed in your system, please ignore these callback requests).
- Method: POST JSON
- Request Parameters:
| Name | Type | Description |
|---|---|---|
| id | string | Platform unique order ID |
| mch_id | number | Merchant ID |
| trans_id | string | Merchant order ID |
| order_amount | number | Order amount |
| created_at | string | Order creation time |
| canceled_at | string | Order cancellation time (only present if canceled) |
| payed_at | string | Order payment time (only present when successful) |
| status | number | Order status: 60 for success, 20 for processing, others are failure |
| sign | string | Parameter signature. See Signature Algorithm |
Callback Notes:
- For a successful callback, please return the string
success- Timeout and retry: The current system callback timeout is 10 seconds. Please return within this period. If the first callback fails, the system will retry every 30 seconds. After five consecutive failures, it will stop retrying automatically.