Payment Notify API
Tips
- All requests are
Postrequests, and the data format isjson
Brief Description
This article describes asynchronous notifications to merchants, and when a transaction (payout, payin) has a result, the result will be posted to the merchant according to the url reported by the merchant. When the merchant transaction receives the result and the processing is completed, it must respond with OK, when platform request fails, it will notify the merchant 8 times within 24 hours according to the rule, specific rules is 2s / 5s / 10s / 30s / 1h / 3h / 3h / 3h. If the merchant is still unsuccessful, the results can be queried through the active query interface.
If there are IP restrictions on merchant receiving requests, please inform Paypro.
Request Method
- post
Request Paramters
| Parameter name | Required | Type | Description |
|---|---|---|---|
| status | yes | string | Request result. Merchants can use it for logic processing. When the result is 0000, it means the transaction is successful. 0001 means that the transaction is partially successful and the actual successful amount is subject to the actual payment amount.(Only in Payin) 0015 means in processing. All other codes are error codes and can be treated as failures. |
| message | yes | string | Error description |
| platFormTradeNo | yes | string | Paypro Transaction Number |
| tradeNo | yes | string | Merchant order number |
| amount | yes | string | Actual amount of payment, could have partially payment situation |
| successTime | no | string | Transaction completed time (local time), return when the transaction is completed |
| channelCode | no | string | channelCode (this field only exists in PAYIN callback) |
| wayCode | no | string | wayCode(this field only exists in PAYIN callback) |
| timestamp | yes | string | Timestamp |
| sign | yes | string | Encrypted signature string |
Asynchronous Notification Example
{
"platFormTradeNo": "5286e98841194687a95d25b5f3be346d",
"tradeNo": "00000020",
"amount": "30000",
"status": "0000",
"message": "SUCCESS",
"utr": "111111111111",
"successTime": "2024-07-01 18:34:31",
"channelCode": "EWALLET",
"wayCode": "DANA",
"timestamp": "1724740395968",
"sign": "12222222222"
}
Response Parameter
OK