收款场景

游戏充值,确认后入账

用稳定币(USDT / USDC)接收点券、道具与充值包付款。BoltUtil 核对付款,您的服务端确认玩家和订单后,再发放点券或道具。

从付款到业务处理

游戏充值流程

适合游戏商城、点券商店和数字娱乐场景。

  1. 01

    服务端确认玩家、区服与充值包,创建订单。

  2. 02

    展示收银台,玩家按网络、币种与金额转账。

  3. 03

    验签并核对付款状态,匹配原始充值订单。

  4. 04

    在一次业务事务中记录入账,避免重复发放。

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

接入要点

付款之后,业务接上

找对玩家,再接付款

用订单关联 playerId、区服与充值包。不要仅凭前端传入的玩家编号或金额决定发放内容。

点券不是稳定币余额

您收取的是稳定币,发放的是游戏权益。充值金额与点券数量的换算由商户系统确定。

入账只做一次

支付确认后的点券发放应有订单唯一约束或事务保护。重复回调不能导致玩家重复获得余额。

充值订单 metadata 示例
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 会直接修改游戏余额吗?

不会。BoltUtil 发送付款结果,玩家余额、区服、道具和充值记录由您的游戏服务端处理。

哪些网络支持 USDT 和 USDC?

TRON 支持 USDT。Ethereum、BNB Smart Chain、Polygon、Solana 和 Base 支持对应版本的 USDT / USDC。实际可用选项取决于渠道启用状态与商户钱包;请以收银台和接口返回为准。

付款少了、多了或回调重复,怎么处理?

不要根据截图或浏览器返回页履约。按订单状态与付款记录核对,符合条件的差额付款可进入人工核对流程;接受关联和快捷处理需要有效会员。已处理订单应保持幂等,避免重复发放权益。

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

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