接入指南

SaaS 接入稳定币收款

客户用 USDT / USDC 付款,资金直达您的钱包。通过商户订单号关联账户与套餐,收到并验证付款通知后,再开通权益或延长有效期。

操作步骤

套餐订单,与付款结果关联

适合会员、席位、点数与续费场景。每次续费由客户主动转账,BoltUtil 不自动从客户钱包扣款。

  1. 01

    用户选择套餐,服务端验证账户、套餐价格与购买周期。

  2. 02

    保存唯一商户订单号,metadata 可关联用户与套餐,创建已启用币种及网络的付款订单。

  3. 03

    客户按收银台完整金额付款,等待链上匹配和确认。

  4. 04

    验证回调与订单状态后,在事务中幂等开通权益;续费规则和到期时间由商户系统决定。

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

接入要点

把关键步骤,做准确

价格与权益由服务端确定

不直接信任浏览器提交的金额、套餐或用户 ID。metadata 是关联信息,不能替代身份与价格校验。

主动付款式续费

需要续费时创建新账单,引导客户再次主动付款。这不是银行卡式自动订阅扣费,也不会授权 BoltUtil 扣钱包。

续费只延长一次

保存商户订单号及业务处理状态,以事务或唯一约束防止重复回调再次延长权益。

SaaS 订单关联示例
商户订单    ORDER_SAAS_001
账户        user_123
套餐        pro_monthly
付款币种    USDC
网络        BASE

付款确认 → 验签 / 核对订单 → 幂等开通
续费到期时间与套餐权益由商户系统计算。

示例仅供接入和排查参考,不会发送请求。请结合您的订单数据、网络配置与当前接口文档使用。

查看开发文档

接入指南

常见问题

可以自动从客户钱包续费扣款吗?

不可以。当前流程是客户主动转账付款;商户可创建续费账单,但不能把它描述为自动钱包扣款。

客户返回网站后,可以立即开通吗?

returnUrl 不代表付款成功。应以验证通过的付款回调或可信的服务端订单状态查询为依据,再核对业务订单。

重复回调会重复续费吗?

商户系统需要通过事务和唯一约束记录已处理订单。重复有效通知返回成功,但不再延长权益。

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

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