第三方充值平台接口开发文档..

API接口说明书

目录

1、API介绍 (3)

1.1通讯协议 (3)

1.2充值流程 (3)

1.3权限版本（power） (3)

1.4版本号（ver） (4)

1.5时间戳（timestamp） (4)

1.6订单号（orderid） (4)

1.7数字签名（sign和signkey） (4)

2、API调用说明 (5)

2.1在线充值 (5)

2.2订单回调 (7)

2.3商品进价表 (7)

2.4渠道商信息 (9)

2.5游戏区服表 (11)

2.6用户余额 (12)

2.7手机号码归属地 (12)

2.8系统时间戳 (13)

2.9销售软件 (13)

2.10激活码开通软件 (14)

2.11下级用户列表 (15)

2.12财务记录 (16)

2.13订单记录 (17)

2.14转账 (19)

3、注意事项 (19)

4、通用状态码 (20)

5、附录 (20)

5.1全国省份直辖市ID对照表 (20)

1、API介绍

1.1通讯协议

1. 联系速度达技术（QQ：1551369420）获取密钥KEY，及接口地址。

2. 接口采用GET/POST方式提交请求

3. 返回XML或JSON，传入参数增加format=xml或者format=json 1.2充值流程

一次请求保存在本地

1 请求时间戳

系统启动，获取服务器时间戳 [api/sys_now]

2请求产品表、渠道表、区服表

获取充值产品表 [api/product]、渠道表

[api/product_channel]、区服表 [api/product_area](该步骤执行一次存储在本地即可)

多次请求3选择产品

根据所要充值的业务需要先调用本地数据(游戏充值需调用区服表、手机充值需调用渠道表并请求归属地 [api/sys_phone])，然后选择产品。

4提交订单

将充值订单提交到充值接口 [api/recharge]。其中productid 就是api/product的 i ；area的值就是手机号码归属地对应的值（见附录）如果是游戏则是api/product_area的i。

5回调订单状态

回调订单状态 [api/status]。

1.3权限版本（power）

13代表普及版

15代表专业版

16 代表豪华版

17 代表旗舰版

1.4版本号（ver）

固定值等于3，每个api接口必须要传的参数。

1.5时间戳（timestamp）

时间戳是自1970 年 1 月 1 日（00:00:00 GMT）至当前时间的总秒数。时间戳的有效期为10分钟。如果您的本机时间为准确的“北京时间”，可使用本机时间戳，否则可通过接口获取当前服务器的时间戳，以它为基本，开始自动计时。时间戳是很多接口必须要传的一个参数。时间戳的目的是为了使一个接口产生的URL在10分钟后失效，提高安全性。

1.6订单号（orderid）

为防止重复提交，很多接口都必须传入订单号。

建议按如下方法生成：

取系统当前时间按年月日小时分钟秒毫秒，再与用户编号用字母“v”相连。生成如：20131112170125156v123456

1.7数字签名（sign和signkey）

sign 以时间戳作为秘钥

signkey 以KEY值和时间戳作为秘钥

如下请求为例，来说明signkey生成步骤

http://***/api/recharge?count=1&orderid=1384243215449v9631&productid=1139×tamp=13 84243215&to=138********&username=test4@&ver=3&signkey=d38d6a9180d9d7791fb11f187813 c105

将除“signkey”外的所有参数按key进行字典升序排列，将接口名和排序后的参数(key=value)用&拼接起来。例如：

/api/recharge?count=1&orderid=1384243215449v9631&productid=1139×tamp=1384243215&to=138**** ****&username=test4@&ver=3&

将上面生成的字符串连上用户设置的秘钥进行URLencode转码，把转码后的字符串进行MD5加密，即是s ignkey。

signkey=md5(URLencode(/api/recharge?count=1&orderid=1384243215449v9631&productid=1139×tamp= 1384243215&to=138********&username=test4@&ver=3&用户秘钥))

sign则是以/api/recharge?count=1&orderid=1384243215449v9631&productid=1139×tamp=1384243215&t

o=138********&username=test4@&ver=3进行进行URLencode转码，把转码后的字符串进行M D5加密。

sign=md5(URLencode(/api/recharge?count=1&orderid=1384243215449v9631&productid=1139×tamp=138 4243215&to=138********&username=test4@&ver=3))

2、API调用说明

2.1在线充值http://***/api/recharge