接入指南

核实付款,先核对这几项

客户说已付款,先收集交易哈希。把网络、币种合约、收款地址、应付金额和确认进度逐项对上,再核对 BoltUtil 的订单记录。

操作步骤

链上记录与订单,逐项对照

适合客服与开发者核实稳定币(USDT / USDC)转账。截图是排查线索,不能替代链上记录与订单校验。

  1. 01

    确认订单网络与客户实际转账网络一致,打开对应区块浏览器。

  2. 02

    核对配置的币种合约或 Mint、转账结果与收款地址,避免把同名 Token 当作付款。

  3. 03

    比较收银台的完整应付金额,并检查转账时间、订单有效期及确认进度。

  4. 04

    查询 BoltUtil 订单状态与交易关联记录;回调已投递时,再核对商户系统的处理结果。

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

接入要点

把关键步骤,做准确

核对正确币种

同一币种在不同网络可能使用不同合约和精度。TRON 仅支持 USDT,其他网络的可用组合以启用配置为准。

核对收银台应付金额

比较 API 返回的应付金额,而不是商品标价或截图中的近似金额。使用十进制定点数或最小单位整数。

核对业务交付记录

链上成功、订单确认与商户交付是不同环节。验签、状态核对和去重完成后,再执行交付。

付款核实清单
网络与订单一致
币种合约 / Mint 与配置一致
收款地址与订单一致
金额等于收银台完整应付金额
转账时间和订单有效期符合规则
确认进度达到要求
交易关联与履约记录无重复

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

查看开发文档

遇到这几种情况,下一步怎么查

先保留原订单号与交易哈希。链上转账成功、订单付款确认和回调投递成功,需要分别核对。

例如订单 A 应付 1.000、B 应付 1.010、C 应付 1.020;收到 1.020 时,其他条件也满足才归属 C。收到 1.030 则不存在精确匹配。

此处仅作示意。没有精确匹配不等于自动接受差额,还需核对规则、原订单时间窗口和付款归属。免费商户可查看自己的核对记录,接受或拒绝关联需要有效 Pro 会员。

金额完全一致
比较完整应付金额、网络、币种、钱包与付款时间窗口。满足条件的精确匹配优先于差额核对候选,不按最早创建的订单分配。
少付或多付
手动转账符合条件时可形成核对记录,仍须满足差额规则并核实归属。存在多个候选时,不能直接分配给金额最接近的订单。
付款仍在确认中
PAID 表示已记录付款,链上确认仍在继续。核对网络确认与扫描进度,不要因此要求客户再次付款。
付款已确认,店铺却没更新
检查回调投递记录、HTTP 响应、原始请求体验签及订单持久化处理。修复接收端后按权限重发,并确保只交付一次。
网络或币种不一致
核对实际网络及合约或 Mint。同名币种、相同地址格式,都不能让另一条通道的转账直接完成当前订单。

接入指南

常见问题

TRC20 付款可以完成 ERC20 订单吗?

不可以。USDT / USDC 存在于多条网络,但每个订单只应该匹配 Checkout 选择的网络。

为什么区块浏览器显示成功,但订单仍然 pending?

交易可能发生在错误网络、使用了错误 token 合约、金额不一致、超过订单有效期,或确认数尚未达到要求。

客服可以依赖客户截图吗?

截图可以帮助定位交易,但最终履约应该基于区块浏览器事实和支付系统自身检查。

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

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