USDT 代收 API 接口说明与参数规范
USDT 代收 API 的核心目标，是让商户把“收款下单”“链上确认”“状态查询”和“结果通知”封装为标准接口，让业务系统几乎不需要关心底层链上细节。对于想做充值、会员支付或数字资产场景的商户来说，接口设计越清晰，接入难度和后续维护成本就越低。
一个规范的代收接口通常至少包含四类信息：订单信息、资金信息、回调信息和签名信息。订单信息用于唯一标识一次交易；资金信息用于确认币种、金额和到账方式；回调信息用于把支付结果传递给商户；签名信息用于保证请求未被篡改。
常见请求参数
- merchantOrderNo：商户侧订单号，建议全局唯一。
- amount：订单金额，建议使用字符串类型避免精度问题。
- currency：币种，通常为 USDT。
- notifyUrl：支付完成后的回调地址。
- clientIp：发起请求的客户端 IP，便于风控与审计。
- userId：业务系统中的用户标识，用于归因和对账。
- timestamp：请求时间戳，用于防重放。
- sign：请求签名，用于鉴权与一致性校验。
响应结果建议
良好的接口响应应包含订单号、支付地址、金额、状态码和提示信息。若支付未生成成功，接口应该明确返回失败原因；若支付已生成，平台应返回可供用户跳转的收银台地址或支付地址。
状态管理
标准的订单状态建议至少包含：待支付、支付中、已支付、已确认、已回调、失败。状态迁移需要清晰且可追踪，便于商户在业务系统中判断当前订单是否已经完成。
参数规范建议
- 金额统一使用字符串，避免浮点误差。
- 回调地址统一使用 HTTPS，避免中间人攻击。
- 订单号不建议使用纯数字递增，要具备业务可识别性。
- 同一商户订单号不能重复提交，避免重复扣款或重复上分。
接口规范不是“写给平台看的”，而是写给商户开发团队和对接方看的。越清晰的字段定义，越能减少联调沟通成本，也越容易形成稳定的支付标准。