原始请求体参与验签
重新序列化 JSON 会改变签名内容。先校验时间戳与签名,再解析请求体;签名用恒定时间比较。
操作步骤
适合付款后开通套餐、发货或入账。此处是验签流程示意,不是可直接上线的完整接收端。
配置 HTTPS 通知地址与 Webhook 密钥,后端保管密钥。
付款满足确认条件后,BoltUtil 生成并投递签名通知。
读取时间戳和签名,基于原始请求体验签后解析 JSON。
核对本地订单与付款,可靠保存通知并去重;成功接收后返回 2xx。
BoltUtil 核对付款并发送签名回调。您的服务端验签、核对订单状态并去重后,再交付商品、开通服务或入账。
接入要点
重新序列化 JSON 会改变签名内容。先校验时间戳与签名,再解析请求体;签名用恒定时间比较。
自动重试和手动重发可能重复到达。通过订单号、交易关联和处理状态,配合事务或唯一约束去重。
对比响应码、超时与错误记录。修复接收端后按当前权限重发;回调成功响应不等于您的商品已经交付。
X-Bolt-Webhook-Timestamp: <timestamp>
X-Bolt-Webhook-Signature: <hex signature>
signed_content = timestamp + "." + raw_body
expected = HMAC_SHA256(signed_content, webhook_secret)
Verify timestamp + constant-time signature comparison
→ Parse JSON and validate local order / payment
→ Persist notification and process once
→ Return 2xx after durable acceptance通知验签流程示意,不是完整接收端。Webhooks 使用 Webhook 密钥,不能用创建订单的 API 签名密钥替代。
查看开发文档支付接入
不需要。先核对原订单是否已确认,再修复通知接口与处理逻辑。回调失败属于投递或接收环节,不能要求客户因此重复付款。
不会。客户直接转入您配置的收款钱包。BoltUtil 负责订单与链上付款核对,不托管资金,不需要私钥、助记词或提现权限。
TRON 仅支持 USDT。其他网络支持配置的 USDT / USDC 版本,实际可用组合取决于渠道启用状态与商户钱包。请以接口和收银台返回为准。
returnUrl 只是页面跳转。请以已验证的签名回调或可信的服务端查询为依据,核对订单后幂等处理。
免费商户可查看自己的待核对记录。手动转账的金额差异符合规则时可生成核对记录;多个候选须先核实归属。接受或拒绝关联需要有效会员,接受后确认付款并按配置发送回调。
可以。支持的网络与设备可使用钱包快捷支付,自动填写收款地址、代币和完整应付金额,客户在钱包中核对并确认。首次使用可能需要解锁、授权连接或切换网络;也可扫码或复制地址手动转账,付款后仍需链上确认。