- API 概览
- 开放能力
- 基础
- 渲染
- 设备
- 文件
- 位置
- 媒体
- 网络
- 游戏转发分享
- 实时语音
- 数据缓存
- 系统
- 广告
- 界面
- 支付
- Worker
tt.requestGamePayment收藏我的收藏
收藏
我的收藏发起支付。
提示异常情况下,充值有可能存在游戏币延迟到账问题,建议游戏在收到支付结果回调后,向服务端轮询最新游戏币余额,间隔 3 秒,持续约 1 分钟,可以根据返回值的 save_amt 的变化来确定是否充值成功。 同时也存在一些异常情况,导致充值成功后结果回调失败,因此建议游戏在启用游戏时主动查询游戏币余额,并且提供给用户主动刷新余额的功能。(不要将查询余额作为进入游戏的必要条件,查询失败时,可在显示余额的界面显示异常,不要拒绝用户进入游戏,更不要直接显示 0) 强烈建议请求中填入 customId 和 extraInfo 字段(字段意义见下方表格),如果未填,支付结果回调将不包含游戏开发者的订单号,导致开发者无法确定回调是对应哪个订单,从而影响游戏道具发放。如果遇到此类问题,开发者可调用queryPayState 接口进行订单状态确认。以上三条均属建议,供游戏参考。
输入
扩展属性描述如下:
属性 | 类型 | 默认值 | 是否必填 | 说明 | 最低基础库版本 |
mode | string | | 是 | 支付的类型, 目前仅为"game" | |
env | number | 0 | 是 | 环境配置,目前合法值仅为"0" | |
currencyType | string | | 是 | 币种, 目前仅为"CNY" | |
platform | string | | 是 | 申请接入时的平台,目前仅为"android" | |
buyQuantity | number | | 是 | 金币购买数量,金币数量必须满足:金币数量*金币单价 = 限定价格等级(详见下方 buyQuantity 限制说明。开发者可以在字节小游戏平台的“支付”tab 设置游戏币单价) | |
zoneId | string | 1 | 否 | 游戏服务区 id,开发者自定义。游戏不分大区则默认填写"1"。如果应用支持多角色,则角色 ID 接在分区 ID 后,用"_"连接 | |
customId | string | | 是 | 必须具有唯一性,如果不传或重复传相同值,则会报错 | 1.55.0 |
extraInfo | string | | 否 | 1.55.0 |
mode 合法值
值 | 说明 |
game | 购买游戏币 |
env 合法值
值 | 说明 |
0 | 支付正式环境 |
currencyType 合法值
值 |