客户付款后，为什么 USDT 订单仍然 pending

区块链交易看起来成功，并不一定代表商户订单应该完成。USDT 订单 pending 通常来自转账和订单规则不匹配，或者订单已完成但 Webhook 没有被商户系统正确处理。

适用于: Pending 排查
适用于: 匹配问题诊断
适用于: Webhook 恢复

Pending 付款排查清单

Pending USDT order triage

Network mismatch?        TRC20 vs ERC20 vs BEP20
Token contract mismatch? USDT Transfer vs native coin or other token
Amount mismatch?         Exact normalized USDT amount
Address mismatch?        Transfer.to vs order destination
Confirmation delay?      Current confirmations vs required threshold
Order window issue?      Payment time vs order expiration
Webhook issue?           Paid order but merchant app not updated

USDT pending 订单排查流程

适合客服、运营和开发者排查 TRC20、ERC20、BEP20 上“客户已付款但订单未完成”的问题。

01
先判断是支付未匹配，还是支付已完成但商户应用未更新。
02
如果支付未匹配，依次检查网络、USDT 合约、收款地址、金额、过期时间和确认数。
03
如果 BoltUtil 已完成订单，请检查 Webhook 日志、商户响应码和签名验证。
04
修复原因后，使用订单状态 API 或 Webhook 重发流程，避免重复人工履约。

非托管结算

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

三条 USDT 网络

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

Webhook 自动化

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

接入要点

上线前真正重要的细节

Wrong network is the most common customer mistake

USDT exists on several chains. A customer may send TRC20 while the order expects ERC20, or choose BEP20 from an exchange withdrawal screen by mistake.

A successful tx hash can still be the wrong asset

Native ETH, BNB, or TRX transfers are not USDT token transfers. Other stablecoin contracts should also be rejected by a production gateway.

Webhook failures look like payment failures to the customer

If BoltUtil completed the order but the merchant app returned an error, the next step is webhook log review and resend, not chain scanning.

上线前商户常问的问题

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

为什么链上交易成功了，订单还是 pending？ +

常见原因是网络、USDT 合约、收款地址、精确金额、确认数或订单有效期没有和订单规则完全匹配。

如果 BoltUtil 已经 completed，但我的系统没更新怎么办？ +

这通常是 Webhook 投递、签名验证或商户端履约逻辑问题。先检查 Webhook 日志和响应码，再使用重发流程。

可以直接手动把 pending 订单改成已支付吗？ +

只建议在确认链上事实和内部订单规则都正确后操作，并记录 tx hash，避免重复入账或重复发货。

上线更清晰的 USDT 收款流程

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

创建免费账户