Create Deposit (TRC20)

Create USDT-TRC20 deposit order interface.

Request Information

• Request URL: /gateway/api/v1/tron/payment-txns
• Request Method: POST
• Content-Type: application/json;charset=utf-8

Request Parameters

Parameter	Required	Type	Description
platform_id	Yes	String(7)	Merchant ID
txn_cl_id	Yes	String(32)	Merchant order number (length 1~32)
user_id	No	String(32)	Sender platform ID
creator_address	Conditional	String(34)	Sender TRC20 wallet address (starts with T, 34-character Base58 format). Required in address matching mode; optional in amount fluctuating mode
amount	Yes	Integer(10)	Order amount (unit: 0.01 USDT) Example: 50000 represents 500 USDT
notify_url	Yes	String(256)	Transaction result notification URL
request_time	Yes	Integer(10)	Request time (seconds)
sign_type	No	String(16)	Signature type, fixed value HMAC-SHA256
sign	Yes	String(32|64)	Order Signature

Request Example

{
    "platform_id": "PF0001",
    "user_id": "b929c18b83bf47809e1595ff6b28916a",
    "txn_cl_id": "test_payment_txn_1755705625",
    "creator_address": "TAkr13ZMWyPSpo7jvQ4ajgmm8X9EG4dEZK",
    "amount": 12345,
    "notify_url": "https://notify.com/payments",
    "request_time": 1755705625,
    "sign": "660b1bb75801bedd796d7b33ae089ef5"
}

Response Example

Success Response

{
    "error_code": "0000",
    "data": {
        "txn_id": "CTX00000123",
        "txn_cl_id": "test_payment_txn_1755705625",
        "type": 0,
        "network": "TRC-20",
        "target_address": "TAkr13ZMWyPSpo7jvQ4ajgmm8X9EG4dEZK",
        "amount": 12345,
        "display_amount": 12345,
        "pay_link": "http://localhost:8889/payment/index.html?token=eyJhbG"
    }
}

Error Response Example

{
  "error_code": "0004",
  "error_msg": "Signature verification failed!"
}

Response Parameters

Parameter	Type	Description
error_code	String	Error code, see Global Error Codes
error_msg	String	Error message (returned when error_code is not "0000")
pay_link	String	Order cashier URL
amount	Int	Order amount
txn_id	String	Platform order number
txn_cl_id	String	Merchant order number
target_address	String	Receiving address
user_id	String	Sender platform username (ID)
display_amount	Number	Display payment amount (returned in amount fluctuating mode, the adjusted amount the user should pay)

Matching Modes

This API supports two matching modes, determined by platform configuration:

Mode	creator_address	Matching Method	Use Case
Address Matching (default)	Required	Sender address + amount	User pays from personal wallet
Amount Fluctuating	Omit	Fluctuated display amount	User pays from exchange (hot wallet address unpredictable)

In amount fluctuating mode, the system applies a micro-adjustment (±0.0001~0.9999 USDT) to ensure each order amount is unique within the matching window. The returned display_amount is the exact amount the user should pay.

caution

Amount fluctuating mode requires platform activation. Without activation, creator_address remains a required field.

Notes

• Amount unit is 0.01 USDT, for example, 500 USDT should be passed as 50000