订单与商品关联
用 externalOrderId 关联商户订单,metadata 可携带商品 SKU。价格与商品权益由您的服务端确定。
从付款到业务处理
适合软件授权、模板、课程、API 点数和数字服务。
创建商品订单,关联商品 SKU 与买家。
展示收银台,买家按所选网络和完整金额付款。
在服务端验签,核对订单与付款状态。
仅执行一次交付,并保存授权或下载记录。
BoltUtil 核对付款并发送签名回调。您的服务端验签、核对订单状态并去重后,再交付商品、开通服务或入账。
接入要点
用 externalOrderId 关联商户订单,metadata 可携带商品 SKU。价格与商品权益由您的服务端确定。
返回店铺页面不代表已付款。您的系统验证回调与订单状态后,再解锁下载或发送授权码。
按商户订单号及处理状态去重。重复回调或重试,不应生成第二份授权或重复发货。
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": {
"sku": "license_pro",
"buyerId": "buyer_123"
}
}这是创建订单的请求体示例,不会发送请求。实际调用还需 API Key、时间戳与请求签名。metadata 由商户定义,不替代身份与价格校验。
查看开发文档收款场景
不会。BoltUtil 负责收款订单、链上付款核对与通知;授权码、文件、邮箱交付和访问权限由您的系统管理。
TRON 支持 USDT。Ethereum、BNB Smart Chain、Polygon、Solana 和 Base 支持对应版本的 USDT / USDC。实际可用选项取决于渠道启用状态与商户钱包;请以收银台和接口返回为准。
不要根据截图或浏览器返回页履约。按订单状态与付款记录核对,符合条件的差额付款可进入人工核对流程;接受关联和快捷处理需要有效会员。已处理订单应保持幂等,避免重复发放权益。