价格与权益由服务端确定
不直接信任浏览器提交的金额、套餐或用户 ID。metadata 是关联信息,不能替代身份与价格校验。
操作步骤
适合会员、席位、点数与续费场景。每次续费由客户主动转账,BoltUtil 不自动从客户钱包扣款。
用户选择套餐,服务端验证账户、套餐价格与购买周期。
保存唯一商户订单号,metadata 可关联用户与套餐,创建已启用币种及网络的付款订单。
客户按收银台完整金额付款,等待链上匹配和确认。
验证回调与订单状态后,在事务中幂等开通权益;续费规则和到期时间由商户系统决定。
BoltUtil 核对付款并发送签名回调。您的服务端验签、核对订单状态并去重后,再交付商品、开通服务或入账。
接入要点
不直接信任浏览器提交的金额、套餐或用户 ID。metadata 是关联信息,不能替代身份与价格校验。
需要续费时创建新账单,引导客户再次主动付款。这不是银行卡式自动订阅扣费,也不会授权 BoltUtil 扣钱包。
保存商户订单号及业务处理状态,以事务或唯一约束防止重复回调再次延长权益。
商户订单 ORDER_SAAS_001
账户 user_123
套餐 pro_monthly
付款币种 USDC
网络 BASE
付款确认 → 验签 / 核对订单 → 幂等开通
续费到期时间与套餐权益由商户系统计算。示例仅供接入和排查参考,不会发送请求。请结合您的订单数据、网络配置与当前接口文档使用。
查看开发文档接入指南
不可以。当前流程是客户主动转账付款;商户可创建续费账单,但不能把它描述为自动钱包扣款。
returnUrl 不代表付款成功。应以验证通过的付款回调或可信的服务端订单状态查询为依据,再核对业务订单。
商户系统需要通过事务和唯一约束记录已处理订单。重复有效通知返回成功,但不再延长权益。