接入指南

为什么应付金额,多了几位小数

多个客户使用同一个钱包付款时,系统可能给新订单分配很小的小数偏移,用完整金额区分订单。商品标价与收银台应付金额因此可能略有不同。

操作步骤

小数区分订单,完整金额识别付款

适用于稳定币(USDT / USDC)收款。客户应按收银台显示的完整金额转账,商户系统也应保留 API 返回的小数位。

  1. 01

    商户提交商品金额,BoltUtil 为新订单分配可用的应付金额。

  2. 02

    收银台展示完整应付金额,客户原样转账,不截断、不四舍五入。

  3. 03

    系统按网络、币种、地址与精确金额核对转账,并检查订单有效期和确认进度。

  4. 04

    免费账户使用默认 3 位识别精度;有效会员可选择 2–6 位,只影响新订单,历史订单不重新计算。

BoltUtil 核对付款并发送签名回调。您的服务端验签、核对订单状态并去重后,再交付商品、开通服务或入账。

接入要点

把关键步骤,做准确

标价与应付金额

例如商品标价 10.00 USDT,某笔订单应付 10.001 USDT。实际以接口返回值为准,不是每笔订单固定增加 0.001。

识别精度与币种精度

2–6 位是订单金额识别设置,不等于链上 Token decimals。链上金额须按对应合约或 Mint 的实际精度读取。

差额付款另行核对

少付或多付不会直接按近似金额完成订单。手动转账符合核对规则时可形成待核对记录,由有效会员决定接受或拒绝关联。

金额区分示例
商品标价       10.00 USDT
订单 A 应付     10.001 USDT
订单 B 应付     10.002 USDT

仅用于说明小数如何区分订单。
实际应付金额以订单接口 / 收银台返回为准。

示例仅供接入和排查参考,不会发送请求。请结合您的订单数据、网络配置与当前接口文档使用。

查看开发文档

接入指南

常见问题

小数偏移是交易手续费吗?

不是。这是同一钱包下区分订单的应付金额安排,不应标记为 BoltUtil 交易手续费。请完整展示接口返回的应付金额。

会员可以选择哪些精度?

有效会员可以选择 2–6 位,免费账户使用默认 3 位。设置只影响后续新订单,不会重算已经创建的订单。

客户只按商品标价付款怎么办?

若少于该订单的完整应付金额,就不能作为精确匹配自动完成。请查看订单与待核对付款记录;符合条件的差额关联由有效会员审核处理。

为您的业务,接上稳定币收款

创建订单、核对付款,确认后通知您的系统。