创建出款单（TRC20）

创建 USDT-TRC20 出款订单接口。

请求资讯

• 请求 URL： /gateway/api/v1/tron/payout-txns
• 请求方式： POST
• Content-Type： application/json;charset=utf-8

请求参数

参数名	必选	类型	说明
platform_id	是	String(7)	商户 ID
txn_cl_id	是	String(32)	商户订单号（长度 1~32）
amount	是	Integer(10)	订单金额 （单位：0.01 USDT） 例如：50000 表示提单 500 USDT
notify_url	是	String(256)	交易结果通知地址
request_time	是	Integer(10)	请求时间（秒）
target_address	是	String	收款地址（需为 TRC-20 网络）
sign_type	否	String(16)	签名类型：HMAC-SHA256（推荐）或 MD5（默认）
sign	是	String(32	64)

请求示例

{
    "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"
}

返回示例

成功返回

{
    "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_code": "0018",
    "error_msg": "商户余额不足!"
}

返回参数说明

参数名	类型	说明
error_code	String	错误码
error_msg	String	错误讯息（error_code 不为 "0000" 时返回）
txn_id	String	平台订单号
txn_cl_id	String	商户订单号
from_address	String	平台发送地址
target_address	String	目标接收地址
amount	Int	金额

备注

• 金额单位为 0.01 USDT，例如 500 USDT 应传入 50000