接入指南

转账成功,却没有匹配订单

链上成功只说明转账发生了。网络、币种、收款地址、金额与订单有效期,还需要与该笔订单一致。按交易哈希逐项排查,比凭截图判断更准确。

操作步骤

先找到差异,再决定处理方式

适合客服与开发者处理 USDT / USDC 未匹配付款。先保留交易证据,不直接修改订单或要求客户重复支付。

  1. 01

    收集交易哈希、客户实际使用的网络和商户订单号。

  2. 02

    核对成功的 Token 转账、配置合约或 Mint、收款地址和精确金额。

  3. 03

    检查订单有效期、确认进度、交易关联与扫描进度,排除重复使用同一付款。

  4. 04

    金额有差额时查看待核对记录;付款已确认但业务未更新时转到 Webhook 排查。

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

接入要点

把关键步骤,做准确

选错网络或币种

同名币种和相似地址不代表同一付款通道。另一条网络上的转账不能直接完成当前网络订单。

少付、多付与过期

不满足精确匹配条件的付款不能直接自动完成。手动转账符合规则时可形成核对记录;有多个候选订单时须先核实归属。

查看与处理权限

免费商户可查看自己的待核对记录;接受或拒绝关联需要有效会员;接受后确认付款并按配置发送回调,仍须先核对付款证据。

未匹配付款排查清单
订单网络 ≟ 转账网络
配置币种 ≟ 实际 Token / Mint
收款地址 ≟ 转账接收地址
应付金额 ≟ 实付金额
订单窗口 ≟ 转账时间
确认进度 / 扫描进度
交易关联 / 重复处理记录

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

查看开发文档

接入指南

常见问题

转账成功,为什么还不能直接完成订单?

还需要验证付款确实属于这笔订单,并满足网络、币种、地址、金额、时间和确认条件。区块浏览器成功状态不能替代这些校验。

免费账户能查看差额付款吗?

可以查看自己的核对记录。接受或拒绝关联需要有效会员;不是所有未匹配转账都会形成可处理记录。

付款已确认,但店铺订单没更新怎么办?

优先检查 Webhook 的响应码、验签与幂等处理记录。回调问题不需要重新匹配链上转账。

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

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