Skip to content

System Callback

Collection Callback

When a user successfully makes a payment, the system will notify the merchant via the callback URL in the order (please note that callbacks may be sent multiple times; if the order has already been processed in your system, please ignore these callback requests).

  • Method: POST JSON
  • Request Parameters:
NameTypeDescription
idstringPlatform unique order ID
mch_idnumberMerchant ID
trans_idstringMerchant order ID
channelstringChannel
order_amountnumberOrder amount
payed_amountnumberActual paid amount by user. If this amount is different from order_amount, do not credit the account
created_atstringOrder creation time
payed_atstringOrder payment time (only present when order is successful)
statusnumberOrder status: 60 for success, 20 for processing, others are failure
signstringParameter signature. See Signature Algorithm

Callback Notes:

  • For a successful callback, please return the string success
  • Timeout and retry: The current system callback timeout is 10 seconds. Please return within this period. If the first callback fails, the system will retry every 30 seconds. After five consecutive failures, it will stop retrying automatically.
  • Please pay attention to the payed_amount field, which is the actual amount paid by the user. This amount may not always match the order amount (e.g., if the user changes the payment amount). When receiving the callback, be sure to check if it matches the order amount before crediting the account.

Payout Callback

After a payout is successful, the system will notify the merchant via the callback URL in the order (please note that callbacks may be sent multiple times; if the order has already been processed in your system, please ignore these callback requests).

  • Method: POST JSON
  • Request Parameters:
NameTypeDescription
idstringPlatform unique order ID
mch_idnumberMerchant ID
trans_idstringMerchant order ID
order_amountnumberOrder amount
created_atstringOrder creation time
canceled_atstringOrder cancellation time (only present if canceled)
payed_atstringOrder payment time (only present when successful)
statusnumberOrder status: 60 for success, 20 for processing, others are failure
signstringParameter signature. See Signature Algorithm

Callback Notes:

  • For a successful callback, please return the string success
  • Timeout and retry: The current system callback timeout is 10 seconds. Please return within this period. If the first callback fails, the system will retry every 30 seconds. After five consecutive failures, it will stop retrying automatically.

Released under the MIT License.