Skip to content

查询订单状态(可选)

WARNING

注意:: 该协议可选, 如果游戏是依赖客户端依赖主动请求获取支付完成状态,可以在支付成功后,调用该接口去查询支付状态

签名规则

登录认证协议中的sign字段生成规则如下:

1)除了sign字段和值为空的字段, 将其余字段按照字段key值的升序排列, 然后按照key=value&key=value.....拼接成字符串。(注意接收到字段后,需要先进行url decode,再进行签名计算);

2) 将上述生成的字符串,最后附加&secretKey={SDK Key参数}格式生成待签名字符串。 {SDK Key参数}替换为分配的游戏【AppKey】参数;

3)对上面得到的待签名字符串,做md5(32位大写)计算,生成对应的sign。

协议内容

客户端SDK登录成功之后,会返回当前的uid和token等信息。 客户端需要将该参数告诉游戏服务器,游戏服务器拿着这些参数,来聚合SDK服务端进行一次登录认证。 认证成功的玩家,才能允许进入游戏。

1 请求协议

请求地址:http:///order/queryByCpOrder
请求方式:POST
请求参数格式:application/x-www-form-urlencoded
参数编码: UTF-8

请求参数:

参数名称参数类型参数说明
appIDString当前游戏的appID
timestampString时间戳,单位毫秒
uidString客户端SDK登陆成功后,SDK返回的uid参数
cpOrderIDString客户端调用SDK支付接口传入的cpOrderID
signString签名,签名算法规则见下方《签名规则》部分,这里使用的secretKey是分配的【AppKey】参数

2 响应内容

登录认证成功, SDK返回JSON格式的状态信息

json
{
    "code": 0,
    "msg": "SUCCESS",
    "data": {
        "orderID": "DK平台的订单唯一订单号",
        "platformOrderID": "第三方支付平台唯一订单号",
        "price": "商品下单金额(单位分)",
        "realPrice": "实际支付金额(单位分)",
        "status": "订单状态: 1——订单创建成功,等待支付;2——第三方平台下单成功;3——支付成功;-1: 支付失败"
    }    
}

状态码说明

状态码说明
0成功状态(成功时才有data字段)
1失败状态

版权所有© 2021-2030 上海丞诺网络科技有限公司