接入指南

付款确认中,先看停在哪一步

客户转账后,链上确认、订单匹配和商户回调会分别推进。先区分待支付、已检测付款和已确认状态,再判断是否需要排查。

操作步骤

先判断环节,再处理原因

适合排查稳定币(USDT / USDC)订单进度。交易已广播或浏览器显示成功,不代表已满足订单确认条件。

  1. 01

    PENDING:订单尚未记录匹配付款,核对网络、币种、地址、金额、有效期和扫描进度。

  2. 02

    PAID:已记录付款,继续观察链上确认进度,不因等待而重复创建订单。

  3. 03

    CONFIRMED:付款已确认,检查签名回调投递日志与商户端响应。

  4. 04

    COMPLETED:BoltUtil 已收到成功响应;商户仍需检查自己的入账或交付记录。

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

接入要点

把关键步骤,做准确

确认进度不是固定倒计时

不同网络的确认方式和配置不同。展示实际进度,不承诺固定秒数到账。

订单与回调分别排查

付款已确认但应用未更新时,优先检查 Webhook 日志、签名校验与商户服务,避免误判为链上未付款。

避免重复付款

引导客户提供原交易哈希并查询原订单。等待确认期间不要要求再次付款,也不要直接新建订单代替排查。

付款状态与排查方向
PENDING     待支付 / 尚未匹配付款
PAID        已记录付款,等待确认
CONFIRMED   已确认,检查回调投递
COMPLETED   回调收到成功响应

商户系统的开通、发货或入账结果需另行核对。

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

查看开发文档

接入指南

常见问题

PAID 是已经完成订单了吗?

不是。PAID 表示系统已记录付款,还需要满足链上确认条件。CONFIRMED 与 COMPLETED 分别反映后续确认及回调进度。

COMPLETED 能保证商品已经发出吗?

不能。它表示 BoltUtil 的回调已收到成功响应。商户系统应在可靠保存通知后返回成功,再通过自己的业务记录核对交付结果。

确认中需要客户再付一次吗?

不需要。先用原订单号和原交易哈希排查;重复付款可能产生额外差额或无法关联的转账。

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

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