Transaction Result Notification (TRC20)

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

Request Information

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

Request Parameters (sent by the system to the merchant)

Parameter	Required	Type	Description
txn_id	Yes	String(11)	System order number
txn_cl_id	Yes	String(32)	Merchant order number
amount	Yes	Integer(10)	Order amount (unit: 0.01 USDT)
fee	Yes	int	Merchant fee (unit: 0.01 USDT)
status	Yes	int	Order status (see table below)
from_address	Yes	string	Sending address
target_address	Yes	string	Receiving address
create_time	Yes	String(7)	Create time (unix timestamp, unit: seconds)
update_time	Yes	int	Update time (unix timestamp, unit: seconds)
sign	Yes	String(32)	Transaction signature

Request Example

{
    "txn_id": "CTX00000007",
    "txn_cl_id": "test_payout_txn_1634396394",
    "amount": 50000000,
    "fee": 0,
    "status": 1,
    "from_address": "TR1KMKNJAJRsPWuMVYnEkj1H3GaUdUe4wG",
    "target_address": "TAkr13ZMWyPSpo7jvQ4ajgmm8X9EG4dEZK",
    "create_time": 1634396394,
    "update_time": 0,
    "sign": "d373360cd44e420863b1ced04bc9efe0"
}

Merchant Response Example

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

{
  "error_code": "0000"
}

TRC-20 Order Transaction Status

Status	Value
Initial	0
Pending	1
Processing	2
Success	3
Cancelled	4
Failed	5

Notes

• This interface is implemented by the merchant, and this system will consume this interface when the order is successful
• It is recommended that merchants implement a signature verification process to ensure the content has not been tampered with
• 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