Create Withdraw (TRC20)

Create USDT-TRC20 withdrawal order interface.

Request Information

• Request URL: /gateway/api/v1/tron/payout-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)
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)
target_address	Yes	String	Receiving address (must be TRC-20 network)
sign	Yes	String(32)	Order Signature

Request Example

{
    "platform_id": "PF0001",
    "txn_cl_id": "test_payout_txn_1634395975",
    "amount": 500000,
    "notify_url": "https://notify.com/payments",
    "target_address": "TAkr13ZMWyPSpo7jvQ4ajgmm8X9EG4dEZK",
    "request_time": 1634395975,
    "sign": "d373360cd44e420863b1ced04bc9efe0"
}

Response Example

Success Response

{
    "error_code": "0000",
    "data": {
        "txn_id": "CTX00000007",
        "txn_cl_id": "test_payout_txn_1634396394",
        "type": 1,
        "network": "TRC-20",
        "from_address": "TR1KMKNJAJRsPWuMVYnEkj1H3GaUdUe4wG",
        "target_address": "TAkr13ZMWyPSpo7jvQ4ajgmm8X9EG4dEZK",
        "amount": 500000
    }
}

Error Response Example

{
    "error_code": "0018",
    "error_msg": "Insufficient merchant balance!"
}

Response Parameters

Parameter	Type	Description
error_code	String	Error code
error_msg	String	Error message (returned when error_code is not "0000")
txn_id	String	Platform order number
txn_cl_id	String	Merchant order number
from_address	String	Platform sending address
target_address	String	Target receiving address
amount	Int	Amount

Notes

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