Payment Notify API
Tips
- All requests are
Postrequests, and the data format isjson
API Documentation for Asynchronous Notifications to Merchants
Brief Description
This document describes the asynchronous notifications sent to merchants. When a transaction (payout or payin) has a result, the system will POST the result to the URL reported by the merchant. When the merchant receives the transaction result, they must respond with OK to indicate that processing is complete. If the platform's request fails, it will notify the merchant up to 8 times within 24 hours, following the pattern of 2s/5s/10s/30s/1h/3h/3h/3h. If the merchant still does not receive a successful notification, they can actively query the result using the query interface.
If the merchant has IP restrictions for accepting requests, please inform us.
Request Method
- POST
Request Parameters
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| status | Yes | string | Request result. Merchants can use this for logical processing. "0000" indicates transaction success, "0015" indicates processing, and other codes are error codes that can be treated as failures. |
| message | Yes | string | Error description |
| platFormTradeNo | Yes | string | PayPro transaction number |
| tradeNo | Yes | string | Merchant's transaction number returned |
| amount | Yes | string | Transaction amount |
| successTime | No | string | Transaction success time (local time); returned when the transaction is successful |
| timestamp | Yes | string | Timestamp |
| sign | Yes | string | Encrypted signature string |
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 Parameter
OK