支付接入

付款确认,通知您的系统

通过签名 Webhook 接收 USDT / USDC 付款结果。订单号、金额、币种、网络与交易信息同步到您的后端,方便核对和业务处理。

操作步骤

通知有签名,处理有记录

适合付款后开通套餐、发货或入账。此处是验签流程示意,不是可直接上线的完整接收端。

  1. 01

    配置 HTTPS 通知地址与 Webhook 密钥,后端保管密钥。

  2. 02

    付款满足确认条件后,BoltUtil 生成并投递签名通知。

  3. 03

    读取时间戳和签名,基于原始请求体验签后解析 JSON。

  4. 04

    核对本地订单与付款,可靠保存通知并去重;成功接收后返回 2xx。

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

接入要点

把关键步骤,做准确

原始请求体参与验签

重新序列化 JSON 会改变签名内容。先校验时间戳与签名,再解析请求体;签名用恒定时间比较。

重复通知,不重复交付

自动重试和手动重发可能重复到达。通过订单号、交易关联和处理状态,配合事务或唯一约束去重。

投递结果可排查

对比响应码、超时与错误记录。修复接收端后按当前权限重发;回调成功响应不等于您的商品已经交付。

HMAC-SHA256 · Signed payment notification
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 签名密钥替代。

查看开发文档

支付接入

常见问题

Webhook 失败时必须重新付款吗?

不需要。先核对原订单是否已确认,再修复通知接口与处理逻辑。回调失败属于投递或接收环节,不能要求客户因此重复付款。

资金会经过 BoltUtil 平台吗?

不会。客户直接转入您配置的收款钱包。BoltUtil 负责订单与链上付款核对,不托管资金,不需要私钥、助记词或提现权限。

所有网络都支持 USDT 和 USDC 吗?

TRON 仅支持 USDT。其他网络支持配置的 USDT / USDC 版本,实际可用组合取决于渠道启用状态与商户钱包。请以接口和收银台返回为准。

客户返回网站后可以发货吗?

returnUrl 只是页面跳转。请以已验证的签名回调或可信的服务端查询为依据,核对订单后幂等处理。

少付或多付如何处理?

免费商户可查看自己的待核对记录。手动转账的金额差异符合规则时可生成核对记录;多个候选须先核实归属。接受或拒绝关联需要有效会员,接受后确认付款并按配置发送回调。

客户可以连接钱包,自动填写金额吗?

可以。支持的网络与设备可使用钱包快捷支付,自动填写收款地址、代币和完整应付金额,客户在钱包中核对并确认。首次使用可能需要解锁、授权连接或切换网络;也可扫码或复制地址手动转账,付款后仍需链上确认。

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

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