Deposit Transaction Notification

The system sends transaction results to the callback URL provided by the merchant.

Request Information

• Request URL: The notify_url provided by the merchant when creating the deposit order
• Request Method: POST
• Content-Type: application/json;charset=utf-8

Request Parameters (Sent by System to Merchant)

Parameter	Required	Type	Description
payment_id	Yes	String	System order ID
payment_cl_id	Yes	String	Merchant order ID
platform_id	Yes	String	Merchant ID
payment_cl_name	No	String	Depositor name
amount	Yes	Integer	Order amount (in cents)
real_amount	Yes	Integer	Actual received amount (in cents)
fee	Yes	Integer	Transaction fee
status	Yes	Integer	Transaction status
create_time	Yes	Integer	Creation time (Unix timestamp in seconds)
update_time	Yes	Integer	Update time (Unix timestamp in seconds)
sign	Yes	String	Order signature

Request Example

{
  "payment_id": "PM00000102",
  "payment_cl_id": "97a968b4a9db497c8c03198e395a38c6",
  "platform_id": "PF0014",
  "payment_cl_name": "testname",
  "amount": 400000,
  "real_amount": 400000,
  "fee": 3200,
  "status": 2,
  "create_time": 1567614049,
  "update_time": 1567614111,
  "sign": "d2e4534fce8c1d1053bbf59fd8ae4464"
}

Merchant Response Example

After receiving the notification, the merchant should return JSON format data to confirm receipt.

{
  "error_code": "0000"
}

Response Parameter Description

Parameter	Type	Description
error_code	String	Return "0000" to indicate the platform has processed successfully

Remarks

• This interface is implemented by the merchant. The system will call this interface when the order is completed.
• Within one hour after order completion, the system will retry notification up to 10 times. Notifications will stop once the merchant returns success.
• It is recommended that the merchant implements signature verification to ensure content has not been tampered with.
• This interface may receive duplicate notifications. The merchant should determine whether to execute business logic to avoid duplicate crediting.
• For order status, refer to: Order Status List