1. 登录状态查询
1.1 接口地址
| 地址类型 | 地址 | 访问方法 |
|---|---|---|
| 正式地址 | http://uni.notice.zqgame.com/app_id/platform_id/login_request | POST |
| 测试地址 | http://uni.zqbconnect.com/app_id/platform_id/login_request | POST |
**说明**：
地址中红色部分的名词解释如下：
- app_id是我方分配的游戏ID，游戏接入时需向我方申请。
- platform_id是渠道ID，游戏接入时我方会发放一份渠道ID excel表。
1.2 请求参数
| 参数名 | 是否必填 | 说明 |
|---|---|---|
| account | 是 | 玩家ID或者账号 |
| session | 是 | 登录返回得token |
| ext | 否 | 附加数据预留，预防特殊渠道 |
| sign | 是 | 参考“6签名算法” |
1.3 返回值
数据结构为为JSON 编码格式。
| 参数名 | 说明 |
|---|---|
| status |
|
| data | 参数名 |
Data结构说明：
| 参数名 | 是否必填 | 说明 |
|---|---|---|
| account | 是 | 渠道玩家ID或者账号 |
| session | 否 | 玩家session，部分平台创建需要 |
| accid | 否 | 玩家id,部分渠道验证后返回用户,如果没有，则返回account，该字段需要返回给客户端SDK更新 |
| ext | 否 | 预留数据 |
例如：
成功: {“status”:200,”data”:{“accid”:xxxx}}
失败: {“status”:403,”data”:{“msg”:”验证失败”}}
2. 创建订单
2.1 接口地址
| 地址类型 | 地址 | 访问方法 |
|---|---|---|
| 正式地址 | http://uni.notice.zqgame.com/app_id/platform_id/create_order | POST |
| 测试地址 | http://uni.zqbconnect.com/app_id/platform_id/create_order | POST |
2.2 请求参数
| 参数名 | 是否必填 | 说明 |
|---|---|---|
| account | 是 | 渠道玩家ID或者账号 |
| accid | 是 | 渠道玩家ID或者账号 |
| session | 是 | 渠道session或者access_token |
| game_order | 是 | 游戏订单号 |
| amount | 是 | 实际价格 |
| notice_url | 是 | 回调地址 |
| server_id | 是 | 充值的目标服务器 |
| role_id | 是 | 角色ID |
| role_name | 是 | 角色名称 |
| goods_id | 是 | 商品ID |
| goods_name | 是 | 商品名称 |
| goods_desc | 是 | 商品描述 |
| ext | 否 | 扩展数据（如没特殊说明，该字段在充值回调时原样回传） |
| sign | 是 | 参考“6签名算法” |
2.3 返回值
数据结构：JSON编码格式。
| 参数名 | 说明 |
|---|---|
| status |
|
| data | 参数名 |
Data结构说明：
| 参数名 | 是否必填 | 说明 |
|---|---|---|
| account | 是 | 登陆验证返回的account |
| accid | 是 | 登陆验证返回的accid |
| session | 是 | 玩家session，部分平台创建需要 |
| game_order | 是 | 游戏订单号 |
| plat_order | 否 | 渠道订单号（部分渠道有） |
| create_time | 否 | 订单创建时间，将该值传给客户端，部分渠道需要该值，比如魅族 |
| amount | 是 | 实际价格。 单位：分 |
| notice_url | 是 | 中青宝回调地址，必须回传给客户端 |
| server_id | 是 | 充值的目标服务器 |
| role_id | 是 | 角色ID |
| role_name | 是 | 角色名称 |
| goods_id | 是 | 商品ID |
| goods_name | 是 | 商品名称 |
| goods_desc | 是 | 商品描述 |
| sign | 否 | 部分渠道下单需要签名 |
| ext | 否 | 扩展数据
|
3. 订单查询
说明：适用于app store/google/应用宝。
3.1 接口地址
| 地址类型 | 地址 | 访问方法 |
|---|---|---|
| 正式地址 | http://uni.notice.zqgame.com/app_id/platform_id/query_order | POST |
| 测试地址 | http://uni.zqbconnect.com/app_id/platform_id/query_order | POST |
3.2 请求参数
| 参数名 | 是否必填 | 说明 |
|---|---|---|
| account | 是 | 登陆验证返回的account |
| accid | 是 | 登陆验证返回的accid |
| session | 是 | 渠道session或者access_token |
| game_order | 是 | 游戏订单号 |
| query_param | 是 | 查询凭证（长度很长） |
| ext | 否 | / |
| sign | 是 | 参考“6签名算法” |
3.3 返回值
成功验证订单后，将通过协议4通知给游戏方，游戏方需在创建订单时通过notice_url传来游戏的回调地址，本接口不返回数据。
4. 充值成功通知
4.1 接口地址
游戏服务器提供回调地址，用户充值成功后通过该地址返回相关信息。
4.2 请求参数
| 参数名 | 是否必填 | 说明 |
| plat_id | 是 | 平台ID |
| game_order | 是 | 游戏订单号 |
| plat_order | 是 | 渠道订单号（如果没有，则返回游戏订单号） |
| amount | 是 | 充值金额（分） |
| server_id | 是 | 服务器ID |
| role_id | 是 | 角色ID |
| ext | 否 | 回传数据 |
| sign | 是 | 参考“6签名算法” |
4.3 返回值
**说明**：游戏服务器必须返回参数。
发放游戏币成功，请返回“200”。
5. 签名算法
- 参数名按字母升序排序如：user_id,，session，ex;
- 以“&”符号将参数拼接签名字符串（注：值为空不参与签名）
如: “ex=22222&session=1c812bca02deab0cb0456af88af2519e&userid=1111”;
加上平台分配的appkey，进行MD5加密签名；
appkey是我方分配的游戏，游戏接入时需向我方申请。 例: Sign_str“account=22222&session=1c812bca02deab0cb0456af88af2519e&user_id=111” Key = “7833e7446004a9e0177b256f2f60004b” Sign = MD5(Sign_str + Key)