快速接入指南
通过以下四步，将稳定币（USDT / USDC）收款接入您的业务。开始前，请配置 API Key、Webhook 密钥，以及已启用网络对应的收款钱包。右侧示例用于先检查 API Key。
1
创建支付订单
商户后端从后端调用 /api/v1/order/create，传入商品金额、币种、网络和商户订单号。系统返回已配置的收款地址与最终应付金额；同一地址可用于多个订单。
创建前可调用 GET /api/v1/ping 检查 API Key；创建订单还需时间戳和请求签名。
2
展示付款信息
商户前端引导客户打开响应中的 checkoutUrl，或根据 payment 字段展示金额、地址、网络和币种。付款直接进入您配置的收款钱包。
请使用 payment.amount 的完整金额；payment.qrData 是二维码内容，不是二维码图片。
3
等待付款确认
BoltUtilBoltUtil 按网络、币种、钱包与金额核对转账，达到确认条件后向订单关联的 notifyUrl 发送付款通知。符合规则的异常付款须由商户核对处理。
付款确认和通知送达受链上与网络状态影响；不要仅根据页面跳转认定付款成功。
4
验证通知并完成业务
商户后端使用请求体原文验证回调签名，检查时间戳、事件和业务订单关联。结合应付金额、实付金额与结算类型处理付款，可靠保存事件后返回 HTTP 2xx，并幂等完成交付。
按 eventId 去重，同时保证业务订单不会重复交付。人工接受少付时，实付金额可能低于应付金额。
网络与币种说明
查看各网络支持的币种、代币版本与付款确认规则。
查看支持列表 →