先验签,再解析
签名内容为时间戳、点号和原始请求体。重新序列化 JSON、调整空格或换行都会改变签名内容。
操作步骤
适用于 USDT / USDC 支付回调。回调重试是通知投递或处理问题,不应要求订单必须先到 COMPLETED 才能开始排查。
确认付款已达到确认条件,查询原订单与 Webhook 投递记录。
对比响应码、超时与错误信息,核查 HTTPS 接口、服务可用性和反向代理。
按时间戳与原始请求体校验签名,再解析 JSON 并核对订单及付款信息。
可靠保存有效通知并去重后返回 2xx。修复后重发,重复通知不重复开通、发货或入账。
BoltUtil 核对付款并发送签名回调。您的服务端验签、核对订单状态并去重后,再交付商品、开通服务或入账。
接入要点
签名内容为时间戳、点号和原始请求体。重新序列化 JSON、调整空格或换行都会改变签名内容。
成功响应应代表有效通知已可靠接收。耗时业务可在保存后异步处理,不要先返回成功再丢弃通知。
用商户订单号、交易关联和业务状态做幂等保护。重复有效通知应返回成功,不能再次增加余额或延长套餐。
signed_content = timestamp + "." + raw_request_body
signature = HMAC_SHA256(signed_content, webhook_secret)
1. 校验时间戳与签名(恒定时间比较)
2. 解析并核对订单、状态与付款信息
3. 可靠保存通知,幂等处理
4. 成功返回 2xx;重复有效通知也返回成功示例仅供接入和排查参考,不会发送请求。请结合您的订单数据、网络配置与当前接口文档使用。
查看开发文档接入指南
不一定。付款已确认时,重试通常属于商户接口投递或处理问题。请分别检查链上付款、BoltUtil 订单状态和回调日志。
不需要把 COMPLETED 当作排查前提。它通常是在回调成功响应后推进的状态;付款已确认且通知失败时,就应检查投递原因。
不会。是否重试及重试时间取决于响应类型与系统策略。签名或配置错误应先修复,再通过当前权限允许的重发入口验证。