支付相关

WARNING

使用母包测试渠道测试支付时，是模拟支付， 客户端无需实际付钱， 点击支付成功后， 聚合服务端会回调通知游戏服务器，给玩家发道具。

支付

当玩家点击游戏内商品充值项时，调用支付接口:

let orderData = {
    price: 1,
    productId: '1',
    productName: 'H5测试商品',
    productDesc: '充值10元送50钻石',
    serverId: '1',
    serverName: 'H5演示服务器',
    roleId: '100',
    roleName: '角色_&#@!%^_+·~|{}[]',
    roleLevel: 1,
    vip: '1',
    extension: 'extra',
    cpOrderId: '123456',
    payNotifyUrl: 'http://www.game.com/pay/callback'
};

U8SDK.pay(orderData, function(suc){
    if (suc) {
        console.log('game pay suc')
    } else {
        console.log('game pay failed')
    }

});

orderData对象的结构说明如下：

参数名称	参数类型	参数说明
productId	String	充值商品ID，游戏内的商品ID， 不能为空
productName	String	商品名称，比如100元宝，500钻石等， 不能为空
productDesc	String	商品描述，比如 充值100元宝，赠送20元宝， 不能为空
price	int	充值金额(单位：元)， 不能为空
buyNum	int	购买数量，固定为1
coinNum	int	玩家当前身上剩余的游戏币，默认0
serverId	String	玩家所在服务器的ID， 不能为空
serverName	String	玩家所在服务器的名称， 不能为空
roleId	String	玩家角色ID， 不能为空
roleName	String	玩家角色名称， 不能为空
roleLevel	String	玩家角色等级， 不能为空
vip	String	玩家vip等级
payNotifyUrl	String	玩家支付成功，U8聚合SDK会优先通过该地址，通知游戏服务器，给玩家发货。 如果该地址没设置， 会使用后台配置的地址
cpOrderId	String	游戏自己的订单号，最大长度64字符；支付成功之后，U8聚合SDK原样返回给游戏服务器
extension	String	自定义数据，最大长度：64字符；支付成功之后，U8聚合SDK原样返回给游戏服务器

处理支付回调事件

当渠道SDK支付成功或失败时， 聚合SDK会通过pay接口传入的回调函数，通知给游戏层：

function(suc){
    //因为部分SDK支付成功回调触发的时机并不是真的支付成功，所以这里最好不要主动给用户提示， 以SDK充值界面中显示的状态为准。

    if (suc) {
        console.log('game pay suc')
    } else {
        console.log('game pay failed')
    }

}

处理服务端发货通知

玩家在客户端支付成功后， 各个渠道平台都会通知给U8聚合SDK服务端。 接着， U8聚合SDK服务端会按统一的协议通知给游戏服务器。

游戏服务器需要实现服务端->支付回调通知协议，用来接收U8聚合SDK的发货通知请求。

收到请求并验证通过后， 才能给玩家发放道具。