創建出款單(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 | 是 | String(32) | 訂單簽名 |
請求示例
{
"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,
"display_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