tt.requestGamePayment
发起支付
提示
调用该方法时,需要保证用户已经登录。可以调用checkSession检测用户登录状态。
- 异常情况下,充值有可能存在延迟到账问题,建议游戏在收到支付成功的回调后,向服务端轮询最新游戏币余额,间隔 3 秒,持续约 1 分钟,可以根据返回值的 save_amt 的变化来确定是否充值成功。
- 同时也存在一些异常情况,导致充值成功后执行的失败回调,因此建议游戏在启用游戏时主动查询一次余额,并且提供给用户主动刷新余额的功能。(不要将查询余额作为进入游戏的必要条件,查询失败时,可在显示余额的界面显示异常,不要拒绝用户进入游戏,更不要直接显示 0)
以上两条均属建议,供游戏参考。
输入
继承标准对象输入,扩展属性描述:
属性 |
类型 |
默认值 |
是否必填 |
说明 |
mode |
string |
|
是 |
支付的类型 |
env |
number |
0 |
是 |
环境配置 |
currencyType |
string |
|
是 |
币种 |
platform |
string |
|
是 |
申请接入时的平台 |
buyQuantity |
number |
|
是 |
购买数量 |
zoneId |
string |
1 |
否 |
游戏服务器大区 id,游戏不分大区则默认填写"1"。如果应用支持多角色,则角色 ID 接在分区 ID 后,用"_"连接 |
mode 合法值
env 合法值
currencyType 合法值
plateform 合法值
输出
fail 回调函数接收的对象扩展属性
属性 |
类型 |
说明 |
errCode |
number |
错误码 |
errCode 的值类型
值 |
说明 |
-1 |
支付失败 |
-2 |
支付取消 |
-15001 |
缺少参数 |
-15002 |
请求参数不合法 |
-15006 |
app 没有支付权限 |
-15009 |
财经方失败 |
-16000 |
用户未登录 |
2 |
正在支付一起订单时,又发起了一笔支付请求 |
3 |
调起收银台失败 |
4 |
网络异常 |
6 |
其他错误 |
buyQuantity 限制说明
购买游戏币的数量,换算成 RMB 必须满足以下价格档位,即 buyQuantity * 游戏币单价 = 限定价格等级。如:游戏币单价为 0.1 元,一次购买最少数量为 10 个
价格等级(单位:元) |
1 |
3 |
6 |
8 |
12 |
18 |
25 |
30 |
40 |
45 |
50 |
60 |
68 |
73 |
78 |
88 |
98 |
108 |
118 |
128 |
148 |
168 |
188 |
198 |
328 |
648 |