快速集成指南
遵循以下四个步骤,将 BoltUtil 加密支付网关无缝接入您的现有业务逻辑。
1
后端发起:同步创建订单
Backend通过服务器端调用 /api/v1/order/create。系统将根据配置,自动锁定目标金额并分配您的专属收款地址。
安全提示:请务必在 Header 中携带 X-Bolt-Key 并完成签名。
2
前端引导:展示支付界面
Frontend引导用户跳转至 checkoutUrl 或展示原生二维码。用户使用私有钱包直接向您转账,资金不经平台托管,点对点直达。
支持波场 (TRON) 等主流钱包,可一键唤起 App 完成支付。
3
系统推送:监听异步回调
Webhook节点集群将实时监控区块链账本。一旦检测到交易确认,系统将立即向您的 notifyUrl 发送 POST 请求,推送包含交易哈希(txHash)在内的完整支付详情。
为应对网络抖动,请务必实现接口幂等性逻辑,以安全处理可能的重复通知。
4
业务交付:校验签名并自动发货
Backend后端接收 Webhook 后,请务必通过签名算法核实数据来源。确认回调金额与订单金额匹配后,即可自动更新系统状态并为用户完成交付。
🚨 安全金律:在未通过签名校验、或回调金额不符的情况下,严禁执行业务交付逻辑。