找对玩家,再接付款
用订单关联 playerId、区服与充值包。不要仅凭前端传入的玩家编号或金额决定发放内容。
从付款到业务处理
适合游戏商城、点券商店和数字娱乐场景。
服务端确认玩家、区服与充值包,创建订单。
展示收银台,玩家按网络、币种与金额转账。
验签并核对付款状态,匹配原始充值订单。
在一次业务事务中记录入账,避免重复发放。
BoltUtil 核对付款并发送签名回调。您的服务端验签、核对订单状态并去重后,再交付商品、开通服务或入账。
接入要点
用订单关联 playerId、区服与充值包。不要仅凭前端传入的玩家编号或金额决定发放内容。
您收取的是稳定币,发放的是游戏权益。充值金额与点券数量的换算由商户系统确定。
支付确认后的点券发放应有订单唯一约束或事务保护。重复回调不能导致玩家重复获得余额。
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": {
"playerId": "player_889",
"region": "region_1",
"package": "gold_500"
}
}这是创建订单的请求体示例,不会发送请求。实际调用还需 API Key、时间戳与请求签名。metadata 由商户定义,不替代身份与价格校验。
查看开发文档收款场景
不会。BoltUtil 发送付款结果,玩家余额、区服、道具和充值记录由您的游戏服务端处理。
TRON 支持 USDT。Ethereum、BNB Smart Chain、Polygon、Solana 和 Base 支持对应版本的 USDT / USDC。实际可用选项取决于渠道启用状态与商户钱包;请以收银台和接口返回为准。
不要根据截图或浏览器返回页履约。按订单状态与付款记录核对,符合条件的差额付款可进入人工核对流程;接受关联和快捷处理需要有效会员。已处理订单应保持幂等,避免重复发放权益。