Payment Notify API
Tips
- All requests are
Postrequests, and the data format isjson
Brief Description
This document describes the asynchronous notification sent to merchants. When a transaction (payout or payin) has a result, the result will be POSTed to the URL reported by the merchant. Upon receiving and processing the transaction result, the merchant must respond with "OK". If the platform's request fails, it will notify the merchant up to 8 times within 24 hours according to a specific schedule: 2s, 5s, 10s, 30s, 1h, 3h, 3h, 3h. If the merchant still does not succeed, they can query the result through an active query interface.
If the merchant has IP restrictions for receiving requests, please inform us.
Request Method
- POST
Request Parameters
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| status | Yes | string | The request result, which can be used by the merchant for logical processing. A value of "0000" indicates a successful transaction, "0015" indicates processing, and other values are error codes that can be treated as failures. |
| message | Yes | string | Error description |
| platFormTradeNo | Yes | string | Platform order number |
| tradeNo | Yes | string | Merchant order number |
| 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 |
| data.paymentType | No | string | TPayment methods (easypaisa,jazzcash) |
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