USDT 结算说明¶
客户在收银台选择 Pay with USDT 时,系统会走链上收款。对开放 API 调用方而言:
| 项 | 对外行为 |
|---|---|
查询 / Webhook 的 order.id |
始终为建单返回的原单 UUID |
merchant_order_id |
建单时的业务单号 |
顶层 amount / currency |
保持建单时的法币 |
支付成功后的 status |
对外为 PAID |
settled_via |
默认 ONLINE;USDT 付清后为 CRYPTO |
crypto_payment |
USDT 实付详情;未走 USDT 结算时为 null |
物流 shipping |
合并到原单 ID 的查询/回调响应中 |
return_url 参数 |
pay_order_id / merchant_order_id 仍指向建单原单 |
crypto_payment 字段(settled_via=CRYPTO 且 status=PAID 时)¶
| 字段 | 说明 |
|---|---|
amount |
USDT 金额(字符串) |
currency |
固定 USDT |
network |
链/网络(如 TRC20) |
tx_id |
链上交易 ID(可能为 null) |
paid_at |
确认时间 |
source_amount |
原法币金额 |
source_currency |
原法币币种 |
fx_rate |
转 USDT 时锁定的汇率 |
对接时请始终用建单返回的 order.id 做轮询与幂等关联,无需关心内部子单。