Payment Notify API
Tips
- All requests are
Postrequests, and the data format isjson
Asynchronous Notification for Transaction Results
This document describes the asynchronous notification sent to the merchant when there are results for transactions (payout, payin). The platform will post the results to the merchant's reported URL. Upon receiving the transaction results, the merchant must respond with OK to indicate the completion of processing. In case of a failed request from the platform, the merchant will be notified 8 times within 24 hours according to the following schedule: 2s/5s/10s/30s/1h/3h/3h/3h. If the merchant still does not succeed, they can query the results through the API.
- If the merchant's request acceptance has IP restrictions, please inform us.
Request Method
- POST
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| status | Yes | string | Request result. "0000" indicates success, "0015" indicates processing, and other values indicate error codes for failure handling. |
| message | Yes | string | Error description. |
| platFormTradeNo | Yes | string | Unique platform transaction number. |
| tradeNo | Yes | string | Merchant transaction number returned. |
| amount | Yes | string | Actual payment amount. |
| successTime | No | string | Transaction success time (local time) when the transaction is successful. |
| timestamp | Yes | string | Timestamp. |
| sign | Yes | string | Encrypted signature. |
Asynchronous Notification Example
{
"platFormTradeNo": "5286e98841194687a95d25b5f3be346d",
"tradeNo": "00000020",
"amount": "30000",
"status": "0000",
"message": "SUCCESS",
"successTime": "2024-07-01 18:34:31",
"timestamp": "1724740395968",
"sign": "12222222222"
}
Response Parameters
OK