普通小游戏开发
API
开放能力
数据分析
视频拍摄器
多端支持

接入流程

小游戏支付接入前提 - 申请支付功能

  1. 需要在小程序开发者后台 对应小游戏申请开通支付功能,请仔细阅读协议。
  2. 勾选同意协议后,确认提现账户信息并填写银行账号等相关信息。
  3. 设置游戏币兑换汇率(注意填写后提交通过后将无法更改),设置服务端回调地址等,完成后提交申请,等待审核。
  4. 审核通过后即可使用支付 SDK 能力进行小游戏支付

小游戏支付时序图

功能一:小游戏支付

1. 前端调用小游戏支付

小游戏前端调用 tt.requestGamePayment 接口,生成订单调起小程序收银台,发起支付流程,参考tt.requestGamePayment

2. 获取支付结果并将结果发给小游戏服务端

支付结果会发送给小游戏前端和字节服务端,为减少掉单情况发生,建议开发者同时接入小游戏前端回调和服务端回调,同时把支付结果传递给小游戏服务端进行后续业务处理

  • 前端回调:小游戏前端使用 tt.requestGamePayment 调用结果进行后续业务处理,参考tt.requestGamePayment
  • 服务端回调:需要提前设置服务端回调地址,参考服务端回调接口,设置成功后,字节服务端会将用户支付成功的订单发送给小游戏服务端,回调由于网络异常等原因无法 100%触达,开发者可以使用queryPayState手动查询订单状态。

3. 小游戏服务端发起请求扣除游戏币并下发对应游戏道具给用户

当小游戏后端收到用户支付成功的通知后,可使用游戏币扣除接口进行游戏币扣除并发放游戏道具等。

功能二:游戏币赠送

小游戏可设置一些场景任务给予玩家一定的游戏币奖励,如观看广告或者完成某些任务,此时可以通过调用游戏币赠送接口给玩家赠送游戏币。

功能三:游戏币查询

开通小游戏支付后,如果需要查询某个用户的游戏币余额,此时可以通过调用获取游戏币余额接口获取用户余额。

支付签名

为确保支付安全性,游戏币赠送接口,游戏币查询接口,扣除游戏币接口都需要传递支付签名字段,具体生成方式参考支付签名生成算法

点击纠错
评价此篇文档