Skip to content

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 notifyUrl submitted 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

ParameterRequiredTypeDescription
merchantNoYesstringMerchant Number
signYesstringPlatform 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

ParameterRequiredTypeDescription
timestampYesstringTimestamp
merchantOrderNoYesstringMerchant Order Number
platOrderNoYesstringPlatform Order Number
amountYesstringTransaction Amount
feeYesstringService Fee
msgYesstringResponse Message
statusYesstringStatus: 0 Initialization, 1 Processing, 2 Failed, 3 Success
remarkYesstringCustom remarks passed by the merchant during order creation (echoed back unchanged)