創建收款單（TRC20）

創建 USDT-TRC20 收款訂單接口。

請求資訊

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

請求參數

參數名	必選	類型	說明
platform_id	是	String(7)	商戶 ID
txn_cl_id	是	String(32)	商戶訂單號（長度 1~32）
user_id	是	String(32)	匯款人平台 ID
amount	是	Integer(10)	訂單金額 （單位：0.01 USDT） 例如：50000 表示提單 500 USDT
notify_url	是	String(256)	交易結果通知地址
request_time	是	Integer(10)	請求時間（秒）
sign	是	String(32)	訂單簽名

請求示例

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

返回示例

成功返回

{
    "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_code": "0004",
  "error_msg": "验签错误!"
}

返回參數說明

參數名	類型	說明
error_code	String	錯誤碼
error_msg	String	錯誤訊息（error_code 不為 "0000" 時返回）
pay_link	String	訂單收銀地址
amount	Int	提單金額
txn_id	String	平台訂單號
txn_cl_id	String	商戶訂單號
target_address	String	接收地址
user_id	String	匯款人平台用戶名 (ID)

備註

• 金額單位為 0.01 USDT，例如 500 USDT 應傳入 50000