如何排查没有匹配订单的 USDT 付款

链上交易成功,并不代表一定能匹配到商户订单。最快的排查方式,是先把链上事实和订单规则逐项对比,再决定是否人工处理。

适用于
Tx hash 排查
适用于
订单匹配规则
适用于
客服流程
未匹配付款排查清单
USDT payment did not match an order

Start with the tx hash:
1. Open the correct explorer for TRC20, ERC20, or BEP20
2. Confirm the transfer is a successful USDT Transfer
3. Compare network, token contract, destination, and amount
4. Check order status, expiration time, and confirmations
5. Search whether the tx hash already completed another order
6. If chain facts match, inspect scanner lag and webhook logs

USDT 未匹配付款排查流程

适合客服和开发者处理“客户已付 USDT,但订单仍未支付或 pending”的问题。

  1. 01

    收集 tx hash,并确认客户实际使用的网络。

  2. 02

    确认交易是配置 USDT 合约发出的成功 Transfer。

  3. 03

    比较收款地址、归一化金额、确认数、订单状态和过期时间。

  4. 04

    人工完成前,先检查重复 tx hash、扫块进度和 Webhook 日志。

非托管结算

资金直接进入您配置的商户钱包。BoltUtil 只负责监听链上交易和发送通知,不接触也不托管用户资金。

三条 USDT 网络

通过同一套订单 API 和统一 Webhook,接入 TRC20、ERC20、BEP20 三条主流 USDT 网络。

Webhook 自动化

当链上交易被检测并确认后,您的系统会收到带签名的回调,可自动发货、开通会员或入账。

接入要点

上线前真正重要的细节

The wrong network is still a real payment

A customer may successfully send TRC20 USDT while the order expects ERC20. The chain transaction succeeded, but it should not complete that order.

Expired orders need policy, not guesswork

If a customer pays after expiration, the system should follow a consistent refund, manual review, or credit policy rather than silently completing old orders.

Scanner lag and webhook failure are different incidents

If no order is completed, inspect scanner progress. If the order is completed but the merchant app is stale, inspect webhook delivery.

上线前商户常问的问题

这些回答帮助开发者、创始人和客服团队在接收真实 USDT 付款前理解完整支付生命周期。

为什么 USDT 转账成功了却没有匹配订单? +

可能是网络错误、合约错误、收款地址不一致、金额不同、订单已过期、确认数不足,或该 tx hash 已经完成过其他订单。

客服可以直接手动完成订单吗? +

只建议在确认链上事实和内部订单规则都匹配后操作,并记录 tx hash,保证不会重复入账或发货。

如果 BoltUtil 已 completed,但商户系统没更新怎么办? +

这通常不是链上匹配问题,而是 Webhook 投递或商户端处理问题,应检查 Webhook 日志并重发。

相关资源

上线更清晰的 USDT 收款流程

创建订单、监听转账并通知您的后端,不再要求客户发送付款截图。

创建免费账户