抖音开放平台Logo
控制台

接入流程
收藏
我的收藏

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

    1.
    2.
    3.
    4.审核通过后即可使用支付 SDK 能力进行小游戏支付​

小游戏支付时序图​

功能一:小游戏支付​

1. 前端调用小游戏支付​

小游戏前端调用 tt.requestGamePayment(Android) / tt.openAwemeCustomerService(ios) 接口,生成订单调起小程序收银台,发起支付流程,参考tt.requestGamePayment / tt.openAwemeCustomerService。​

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

支付结果会发送给小游戏前端和字节服务端,为减少掉单情况发生,建议开发者同时接入小游戏前端回调和服务端回调,同时把支付结果传递给小游戏服务端进行后续业务处理。
    前端回调:Android 小游戏前端可使用 tt.requestGamePayment 调用结果进行后续业务处理,参考tt.requestGamePayment;ios支付接口 tt.openAwemeCustomerService 暂不支持,请从服务端回调获取支付结果。​
    服务端回调:需要提前设置服务端回调地址,参考服务端回调接口,设置成功后,字节服务端会将用户支付成功的订单发送给小游戏服务端,回调由于网络异常等原因无法 100%触达,开发者可以使用queryPayState手动查询订单状态。​

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

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

功能二:游戏币赠送​

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

功能三:游戏币查询​

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

支付签名​

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