# 支付
# 1、接口调用
用于游戏内发起支付,仅在登录成功后可用。
sdk.pay(options, callback);
注意事项
- 并非所有支付渠道都有
callback
回调,请慎用,支付是否到账、发货等请以游戏服务端通知为准; - 游戏服务器需按照《服务端对接 > 登录支付 > 支付回调》文档要求,向相关运营人员提供支付回调接口,并由运营人员配置至SDK开放平台后台,用于在玩家支付成功后通知游戏发放相应购买物品!若有接口方面疑问,请咨询SDK服务端开发:陈肖军!
# 2、参数说明
参数说明如下表所示:
选项 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
areaId | number | 是 | - | 游戏区服ID,若游戏无大区概念,就填 1 表示初始大区编号 |
areaName | string | 是 | - | 游戏区服名称,若游戏无大区概念,就填 1 |
roleId | number | 是 | - | 角色ID |
roleName | string | 是 | - | 角色昵称 |
roleLevel | number | 是 | - | 角色等级,若游戏无角色等级概念,可传关卡或vip等级 |
itemId | string | 是 | - | 商品ID |
itemName | string | 是 | - | 商品名称 |
itemNum | number | 否 | 1 | 商品数量,默认值为 1 |
itemPrice | number | 是 | - | 商品单价,单位为分,请注意换算!!! |
currency | string | 否 | CNY | 货币类型,默认为 CNY |
orderId | string | 否 | - | 游戏开发者自定义的唯一订单号,预留参数,有就填写 |
memo | string | 否 | - | 透传参数 |
remark | string | 否 | - | 备用透传参数 |
# 3、示例代码
注:示例代码中的参数或选项均为演示数据,仅供参考,谢谢!
sdk.pay({
areaId: 1001, // 游戏区服ID,若游戏无大区概念,就传 1
areaName: "1区", // 游戏区服名称,若游戏无大区概念,可传 1
roleId: 1, // 角色ID
roleName: "小朋友", // 角色名字
roleLevel: 1, // 角色等级
itemId: "xxxxxxxxxx",
itemName: "xxxxxxxxxx",
itemNum: 1,
itemPrice: 600, // 注意:道具金额的单位为分,请注意换算!
currency: "CNY",
orderId: "",
memo: "",
remark: ""
}, (response) => {
// 注意,并非所有支付渠道都有该回调,请慎用,支付是否到账、发货等请以游戏服务端通知为准
// 支付成功
if (response.code === 0) {
}
// 其他,支付失败
else{
}
});