为什么 USDT Checkout 应该匹配精确付款金额

精确金额匹配是非托管 USDT Checkout 稳定运行的关键。它能帮助系统在不托管资金、不依赖付款截图的情况下，把一笔链上转账准确关联到一个商户订单。

适用于: 精确金额匹配
适用于: Token 精度
适用于: 订单对账

精确金额匹配清单

Exact USDT amount matching

Order amount:       129.37 USDT
Expected decimals:  6
Normalized amount:  129.370000

Match only when:
- network matches the order
- token contract is USDT
- destination address matches
- normalized amount equals the order amount
- order is active and not already completed

精确金额匹配流程

适合使用同一个收款钱包接收多笔 USDT 订单的商户和开发者。

01
创建订单时保存精确 USDT 金额和网络。
02
Checkout 页面完整展示应付金额，避免四舍五入。
03
按 token decimals 归一化链上 Transfer 金额。
04
只有网络、USDT 合约、收款地址、金额、状态和有效期全部匹配时才完成订单。

非托管结算

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

三条 USDT 网络

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

Webhook 自动化

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

接入要点

上线前真正重要的细节

Rounding is a payment bug

Showing 129.37 while comparing against 129.370001, or formatting a token amount with floating-point math, can leave valid customers pending.

Exact amount is not the only rule

A matching amount is necessary but not enough. The system should also verify network, token contract, destination address, confirmation threshold, status, and expiration.

Unique amounts improve operational clarity

For some checkout flows, using precise payable amounts can reduce ambiguity when many customers send funds to the same merchant wallet.

上线前商户常问的问题

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

为什么不能接受近似金额？ +

近似匹配可能在多名客户支付相近金额时完成错误订单。精确匹配能让对账和履约更稳定。

USDT 金额可以用浮点数比较吗？ +

不建议。应使用 decimal-safe 类型或 token 最小单位整数，避免格式化和精度误差影响订单匹配。

两个客户支付同样金额怎么办？ +

系统还需要结合收款地址、订单有效期、订单状态、tx hash 唯一性和确认数来判断。

上线更清晰的 USDT 收款流程

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

创建免费账户