手游游戏币充值接口.pdfVIP

10、手游游戏币充值接口规范（对外）

版本：

文档版本创建时间作者备注

1.0.02015-01-28新建

2.0.02015-06-09SDK2.0

1简介

1.1目的

手游接入顺网游戏充值统一规范

1.2适用范围

此规范适用于手游游戏充值

1.3与缩写解释

说明

signKeyMD5加密时所用的密钥(由我方统一分配)

2系统安全性

2.1服务器ip限制

游戏方可以将顺网IP纳入其白内

2.2数据签名

合作方和顺网游戏约定一个共同的签名密钥即signKey，在数据传递时参数信息都应经过MD5加密。在接收到加密信息后必须进行验证。

任何不合法的签名信息均被视为

2.3签名方式

HTTP请求中传递的所有参数(包括游戏方自定义参数，但sign除外)按照参数名称字符升序(区分大小写)的顺序串联起来，中间用英文|分隔，

最后一个参数为signKey(由顺网)，构成待签名数据(只对参数值进行MD5)。例如：调用某接口需要以下参数：

gameId=1001

region=s1

guid=5a60cc3718ba43a994caa2507d673dac

那么待签名数据就是(按参数名的次序)：顺序是ga--gur

Sign=MD5(1001|5a60cc3718ba43a994caa2507d673dac|s1|接入方的sign_key).toUpperCase

注：签名数据是没进行urlencode之前的原始数据。参数值为NULL或空时，该参数不参与签名计算，也不需要传递该参数。

3接口

3.3接口类型

HTTP协议POST请求

3.4接口请求地址

由游戏方，地址可以包含请求参数

3.5接口参数说明

参数名称参数类型长度是否非空参数说明

orderNoString是顺网订单号

gameIdInteger是游戏ID(由顺网分配)

guidString是用户GUID

moneyInteger是游戏币金额，单位元

coinsInteger是游戏币数量

coinMesString是游戏商品描述

timeString是时间戳，格式：yyyyMMddHHmmss

其他游戏方参数游戏方自定义

signString32位是MD5签名串

注意：【其他游戏方参数】通过在充值接口地址URL附加请求参数形式传入（如需编码，请采用UTF-8的URL编码），我方只解析这些参数，并在请求

游戏方自定义参数不能和我方

【coins】参数可能为0，如果非游戏币类商品

3.6接口返回值说明

游戏方充值接口返回一个数字表示充值是否成功

响应说明

0游戏币成功

1游戏币失败

其他游戏币异常

4注意事项

1.签名时将参数的字符集应统一为UTF-8。

2.游戏方应保证接口实现支持重复调用，但完成（成功或失败）的订单不能再次给用户充值游戏币，可直接返回订单结果。