接入指南

Webhook 重试,先找到失败原因

付款已确认,您的系统却没有更新?先查看回调响应码与投递记录,再核对签名、超时和业务去重。修复接收端后,再按权限重发通知。

操作步骤

从投递记录,定位接收端问题

适用于 USDT / USDC 支付回调。回调重试是通知投递或处理问题,不应要求订单必须先到 COMPLETED 才能开始排查。

  1. 01

    确认付款已达到确认条件,查询原订单与 Webhook 投递记录。

  2. 02

    对比响应码、超时与错误信息,核查 HTTPS 接口、服务可用性和反向代理。

  3. 03

    按时间戳与原始请求体校验签名,再解析 JSON 并核对订单及付款信息。

  4. 04

    可靠保存有效通知并去重后返回 2xx。修复后重发,重复通知不重复开通、发货或入账。

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

接入要点

把关键步骤,做准确

先验签,再解析

签名内容为时间戳、点号和原始请求体。重新序列化 JSON、调整空格或换行都会改变签名内容。

保存成功,再返回 2xx

成功响应应代表有效通知已可靠接收。耗时业务可在保存后异步处理,不要先返回成功再丢弃通知。

重试仍是同一笔付款

用商户订单号、交易关联和业务状态做幂等保护。重复有效通知应返回成功,不能再次增加余额或延长套餐。

签名校验与响应原则
signed_content = timestamp + "." + raw_request_body
signature = HMAC_SHA256(signed_content, webhook_secret)

1. 校验时间戳与签名(恒定时间比较)
2. 解析并核对订单、状态与付款信息
3. 可靠保存通知,幂等处理
4. 成功返回 2xx;重复有效通知也返回成功

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

查看开发文档

接入指南

常见问题

Webhook 重试说明链上识别失败了吗?

不一定。付款已确认时,重试通常属于商户接口投递或处理问题。请分别检查链上付款、BoltUtil 订单状态和回调日志。

必须等 COMPLETED 后才能重发吗?

不需要把 COMPLETED 当作排查前提。它通常是在回调成功响应后推进的状态;付款已确认且通知失败时,就应检查投递原因。

自动重试会处理所有错误吗?

不会。是否重试及重试时间取决于响应类型与系统策略。签名或配置错误应先修复,再通过当前权限允许的重发入口验证。

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

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