创建收款单（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 |
| creator_address | 条件 | String(34) | 打款人 TRC20 钱包地址（以 T 开头，34 位 Base58 格式）。地址匹配模式下必填；金额浮动模式下可不传 |
| amount | 是 | Integer(10) | 订单金额 （单位：0.01 USDT） 例如：50000 表示提单 500 USDT |
| notify_url | 是 | String(256) | 交易结果通知地址 |
| request_time | 是 | Integer(10) | 请求时间（秒） |
| sign_type | 否 | String(16) | 签名类型，固定值 HMAC-SHA256 |
| sign | 是 | String(32|64) | 订单签名 |
请求示例
{
"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"
}
返回示例
成功返回
{
"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) |
| display_amount | Number | 展示支付金额（金额浮动模式下返回，含浮动调整后的实际应付金额） |
匹配模式说明
本接口支持两种匹配模式，由平台配置决定：
| 模式 | creator_address | 匹配方式 | 适用场景 |
|---|---|---|---|
| 地址匹配（默认） | 必填 | 打款地址 + 金额 | 用户从个人钱包打款 |
| 金额浮动 | 不传 | 浮动后的展示金额 | 用户从交易所打款（热钱包地址不可控） |
金额浮动模式下，系统会对订单金额做微调（±0.0001~0.9999 USDT），确保同一时间窗口内每笔订单金额唯一。返回的 display_amount 即为用户应支付的精确金额。
警告
金额浮动模式需由平台方申请开通。未开通时，creator_address 仍为必填字段。
备注
- 金额单位为 0.01 USDT，例如 500 USDT 应传入 50000