跳转至

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=CRYPTOstatus=PAID 时)

字段 说明
amount USDT 金额(字符串)
currency 固定 USDT
network 链/网络(如 TRC20
tx_id 链上交易 ID(可能为 null
paid_at 确认时间
source_amount 原法币金额
source_currency 原法币币种
fx_rate 转 USDT 时锁定的汇率

对接时请始终用建单返回的 order.id 做轮询与幂等关联,无需关心内部子单。