Appearance
查询订单状态(可选)
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
请求参数:
参数名称 | 参数类型 | 参数说明 |
---|---|---|
appID | String | 当前游戏的appID |
timestamp | String | 时间戳,单位毫秒 |
uid | String | 客户端SDK登陆成功后,SDK返回的uid参数 |
cpOrderID | String | 客户端调用SDK支付接口传入的cpOrderID |
sign | String | 签名,签名算法规则见下方《签名规则》部分,这里使用的secretKey是分配的【AppKey】参数 |
2 响应内容
登录认证成功, SDK返回JSON格式的状态信息
json
{
"code": 0,
"msg": "SUCCESS",
"data": {
"orderID": "DK平台的订单唯一订单号",
"platformOrderID": "第三方支付平台唯一订单号",
"price": "商品下单金额(单位分)",
"realPrice": "实际支付金额(单位分)",
"status": "订单状态: 1——订单创建成功,等待支付;2——第三方平台下单成功;3——支付成功;-1: 支付失败"
}
}
状态码说明
状态码 | 说明 |
---|---|
0 | 成功状态(成功时才有data字段) |
1 | 失败状态 |