Pay-in Callback Notification
When a pay-in order is successfully completed or fails, the platform will actively send an asynchronous callback notification to the notifyUrl provided by the merchant during order creation.
Notification Protocol
- Endpoint: The
notifyUrlsubmitted by the merchant during order creation. - HTTP Method:
POST - Content-Type:
application/json; charset=utf-8 - Retry Strategy: Upon receiving the notification, the merchant system must respond with
SUCCESS(case-insensitive, or HTTP 200) to confirm successful reception. If the platform does not receive a successful response, it will retry every 20 minutes, up to 5 times.
Request Header Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| merchantNo | Yes | string | Merchant Number |
| sign | Yes | string | Platform Signature. The merchant must verify it using the Platform Public Key (Refer to Global Specification). |
Request Body Example
json
{
"timestamp": "1639466186292",
"merchantOrderNo": "ORDER_123456789",
"platOrderNo": "876324486452871168",
"amount": "100.00",
"fee": "1.00",
"status": "3",
"msg": "success",
"remark": "custom_data"
}Request Body Description
| Parameter | Required | Type | Description |
|---|---|---|---|
| timestamp | Yes | string | Timestamp |
| merchantOrderNo | Yes | string | Merchant Order Number |
| platOrderNo | Yes | string | Platform Order Number |
| amount | Yes | string | Transaction Amount |
| fee | Yes | string | Service Fee |
| msg | Yes | string | Response Message |
| status | Yes | string | Status: 0 Initialization, 1 Processing, 2 Failed, 3 Success |
| remark | Yes | string | Custom remarks passed by the merchant during order creation (echoed back unchanged) |
