Deposit Transaction Result 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 deposit order - Method:
POST - Content-Type:
application/json;charset=utf-8
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| payment_id | Yes | String | System Order ID |
| payment_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 (seconds) |
| update_time | Yes | Integer | Update time (seconds) |
| sign_type | No | String | Signature type: HMAC-SHA256 |
| sign | Yes | String | Order signature |
Request Example
{
"payment_id": "PM00000102",
"payment_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
{ "error_code": "0000" }
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Returning "0000" indicates the platform has processed successfully |
Remarks
- This API is implemented by the merchant. The system will call this API when an order succeeds.
- The first notification is sent immediately; the system then retries about every 5 minutes, up to 6 notifications in total (within roughly 30 minutes). Retries stop once the merchant returns a success response.
- It is recommended that merchants implement signature verification to ensure the content has not been tampered with.
- This API may receive duplicate notifications. Merchants should determine whether to execute business logic to avoid duplicate crediting.
- For order status reference, see: Order Status
- More fields may be supported in the future. During integration, please dynamically retrieve the returned fields and generate signature verification. Do not hardcode the fields.