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	Yes	String(34)	Sender address (used for reconciliation)
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	Yes	String(32)	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,
        "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
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)

Notes

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