Deposit Transaction Result Notification

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

Request Information

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

Request Parameters (sent by the system to the merchant)

Parameter	Required	Type	Description
payment_id	Yes	String	System order number
payment_cl_id	Yes	String	Merchant order number
platform_id	Yes	String	Merchant ID
payment_cl_name	No	String	Depositor name
amount	Yes	Integer	Order amount (cents)
real_amount	Yes	Integer	Actual amount received (cents)
fee	Yes	Integer	Fee
status	Yes	Integer	Transaction status
create_time	Yes	Integer	Create time (seconds)
update_time	Yes	Integer	Update time (seconds)
sign_type	No	String	Signature type: HMAC-SHA256
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 needs to return JSON format data to confirm receipt of the notification.

{
  "error_code": "0000"
}

Response Parameters

Parameter	Type	Description
error_code	String	Returning "0000" indicates the platform has completed processing

Notes

• This interface is implemented by the merchant, and this system will consume this interface when the order is successful
• Within one hour of order completion, it will be notified ten times repeatedly. If the merchant returns success during this period, the notification will stop
• It is recommended that merchants implement a signature verification process to ensure the content has not been tampered with
• This interface may be notified repeatedly. Merchants need to determine whether to execute business logic themselves to avoid duplicate credits
• For order status, please refer to: Order Status List
• More fields may be supported in the future. When integrating, please dynamically obtain fields with return values and generate signature verification. Do not hardcode the fields