每次付款,各自有订单
套餐购买与续费分别创建订单。稳定币转账由客户发起,本服务不从客户钱包自动扣款。
从付款到业务处理
适合服务国际用户、并希望提供稳定币付款方式的 SaaS 产品。
为套餐或续费创建订单,关联客户账户。
客户进入收银台,自行完成本次转账。
服务端验签并核对订单的付款状态。
幂等开通套餐或延长到期时间,保留账单记录。
BoltUtil 核对付款并发送签名回调。您的服务端验签、核对订单状态并去重后,再交付商品、开通服务或入账。
接入要点
套餐购买与续费分别创建订单。稳定币转账由客户发起,本服务不从客户钱包自动扣款。
套餐类型、有效期、升级差价由您的系统决定。metadata 可关联 plan 与 userId,不替代权限校验。
回调重试或主动查询可能重复触发处理。记录已处理订单,避免同一笔付款重复增加订阅时长。
POST /api/v1/order/create
Content-Type: application/json
{
"externalOrderId": "ORDER_DEMO_001",
"amount": 199,
"currency": "USDC",
"network": "BASE",
"notifyUrl": "https://merchant.example.com/webhooks/boltutil",
"returnUrl": "https://merchant.example.com/orders/001",
"metadata": {
"plan": "pro",
"userId": "user_123"
}
}这是创建订单的请求体示例,不会发送请求。实际调用还需 API Key、时间戳与请求签名。metadata 由商户定义,不替代身份与价格校验。
查看开发文档收款场景
这里的稳定币付款需要客户主动转账。您可以为续费创建新订单并提醒客户,但不能将此流程理解为钱包自动扣款。
TRON 支持 USDT。Ethereum、BNB Smart Chain、Polygon、Solana 和 Base 支持对应版本的 USDT / USDC。实际可用选项取决于渠道启用状态与商户钱包;请以收银台和接口返回为准。
不要根据截图或浏览器返回页履约。按订单状态与付款记录核对,符合条件的差额付款可进入人工核对流程;接受关联和快捷处理需要有效会员。已处理订单应保持幂等,避免重复发放权益。