快速集成指南

遵循以下四个步骤,将 BoltUtil 加密支付网关无缝接入您的现有业务逻辑。

1

后端发起:同步创建订单

Backend

通过服务器端调用 /api/v1/order/create。系统将根据配置,自动锁定目标金额并分配您的专属收款地址。

安全提示:请务必在 Header 中携带 X-Bolt-Key 并完成签名。
2

前端引导:展示支付界面

Frontend

引导用户跳转至 checkoutUrl 或展示原生二维码。用户使用私有钱包直接向您转账,资金不经平台托管,点对点直达。

支持波场 (TRON) 等主流钱包,可一键唤起 App 完成支付。
3

系统推送:监听异步回调

Webhook

节点集群将实时监控区块链账本。一旦检测到交易确认,系统将立即向您的 notifyUrl 发送 POST 请求,推送包含交易哈希(txHash)在内的完整支付详情。

为应对网络抖动,请务必实现接口幂等性逻辑,以安全处理可能的重复通知。
4

业务交付:校验签名并自动发货

Backend

后端接收 Webhook 后,请务必通过签名算法核实数据来源。确认回调金额与订单金额匹配后,即可自动更新系统状态并为用户完成交付。

🚨 安全金律:在未通过签名校验、或回调金额不符的情况下,严禁执行业务交付逻辑。