第三方充值平台接口开发文档Word文档下载推荐.docx
- 文档编号:16489431
- 上传时间:2022-11-24
- 格式:DOCX
- 页数:30
- 大小:30.50KB
第三方充值平台接口开发文档Word文档下载推荐.docx
《第三方充值平台接口开发文档Word文档下载推荐.docx》由会员分享,可在线阅读,更多相关《第三方充值平台接口开发文档Word文档下载推荐.docx(30页珍藏版)》请在冰豆网上搜索。
回调订单状态
回调订单状态[api/status]。
1.3权限版本(power)
13代表普及版
15代表专业版
16代表豪华版
17代表旗舰版
1.4版本号(ver)
固定值等于3,每个api接口必须要传的参数。
1.5时间戳(timestamp)
时间戳是自1970年1月1日(00:
00:
00GMT)至当前时间的总秒数。
时间戳的有效期为10分钟。
如果您的本机时间为准确的“北京时间”,可使用本机时间戳,否则可通过接口获取当前服务器的时间戳,以它为基本,开始自动计时。
时间戳是很多接口必须要传的一个参数。
时间戳的目的是为了使一个接口产生的URL在10分钟后失效,提高安全性。
1.6订单号(orderid)
为防止重复提交,很多接口都必须传入订单号。
建议按如下方法生成:
取系统当前时间按年月日小时分钟秒毫秒,再与用户编号用字母“v”相连。
生成如:
20131112170125156v123456
1.7数字签名(sign和signkey)
sign以时间戳作为秘钥
signkey以KEY值和时间戳作为秘钥
如下请求为例,来说明signkey生成步骤
http:
//***
将除“signkey”外的所有参数按key进行字典升序排列,将接口名和排序后的参数(key=value)用&
拼接起来。
例如:
/api/recharge?
count=1&
orderid=1384243215449v9631&
productid=1139&
timestamp=1384243215&
to=13800138000&
username=****************&
ver=3&
将上面生成的字符串连上用户设置的秘钥进行URLencode转码,把转码后的字符串进行MD5加密,即是signkey。
signkey=md5(URLencode(/api/recharge?
用户秘钥))
sign则是以/api/recharge?
ver=3进行进行URLencode转码,把转码后的字符串进行MD5加密。
sign=md5(URLencode(/api/recharge?
ver=3))
2、API调用说明
2.1在线充值http:
参数名称
数据类型
说明
是否必填
username
Varchar(50)
速度达用户名
Y
orderid
订单号
productid
long
产品ID
to
充值对象
area
NVARCHAR2(25)
地区ID/区服ID(手机充值详见附录1)
N
shop
int
count
购买数量(件数)
ip
Varchar2(25)
用户的真实IP
timestamp
时间戳
ver
接口版本号
signkey
Varchar2(32)
签名串(不参与加密)
返回参数说明:
balance
float
用户余额
-1表示余额未变化
status
状态
详见“通用状态码”
tips
String
状态提示信息
请求示例
响应示例
<
<
sududa>
<
balance>
69.46<
/balance>
充值后用户所剩余额
status>
1<
/status>
状态码
tips>
:
0(状态已更新!
)<
/tips>
提示
/sududa>
使用下表商品ID充值话费,area值可传0(无需判断号码归属地)。
中国移动(全国)
商品ID
1元
18
2元
369
3元
370
4元
371
5元
24
6元
372
7元
373
8元
374
9元
375
中国联通(全国)
1089
1090
1091
1092
1093
1094
1095
1096
1097
中国电信(全国)
10元
1582
20元
1583
30元
1130
50元
1131
100元
1132
全国固话(全国)
1699
1698
1700
1701
1702
2.2订单回调(建议下单成功1分钟后调用)http:
sign
充值后用户所剩余额-1表示余额未变
2.3商品进价表http:
要获取的用户名
power
对应自己的版本
豪华版:
16
旗舰版:
17
gzip
Varchar2(10)
gzip=true时返回加密后的GZIP串
商品进价表版本号
i
产品ID充值时传给服务器
b
产品名称
f
面值
u
单位
t
小分类
移动是100,联通是101,电信是102,固话是103
QQ业务是200,Q币Q点是201
游戏是大等于300
c
渠道ID
v
省份ID
详见“全国省份直辖市ID对照表”
q
商品大类
话费业务是1,QQ业务是2,游戏业务是3
s
库存
大于0均表示库存充足
o
排序
m
限购数量
如:
1-1
目前话费业务不支持倍充
p16
豪华版进价
旗舰版是p17
ver>
30<
/ver>
版本号
list>
l>
i>
1349<
/i>
产品ID,充值时传给服务端
b>
浙江电信(手机)<
/b>
产品名称
f>
50<
/f>
面值
u>
元<
/u>
单位
t>
102<
/t>
小分类,移动是100,联通是101,电信是102,固话是103
c>
11<
/c>
渠道ID
v>
33<
/v>
省份
q>
/q>
1表示手机,2表示QQ业务,3是游戏。
s>
99<
/s>
库存
o>
2<
/o>
排序,值越小越靠前
m>
11<
/m>
提交件数限止
p10>
49.3<
/p10>
p13>
/p13>
普及版充值报价
p14>
/p14>
p15>
/p15>
专业版充值报价
p16>
/p16>
豪华版充值报价
p21>
/p21>
/l>
*……
(数据返回量大,为避免本文档冗余,有删节)
340<
湖北联通(手机)<
100<
101<
12<
42<
3<
98.6<
/list>
2.4渠道商信息http:
//***
渠道商ID
对应产品进价表的c
渠道名称
r
备注
s<
渠道ID。
对应product中的C
腾讯<
渠道名称
r/>
备注
……
203<
网易<
获取成功!
提示
2.5游戏区服表http:
Username
Varchar2(50)
用户名
对应产品进价表的i
游戏区服名称
游戏区服值
充值接口的area
<
渠
-<
1209<
产品ID。
对应product中的i
华夏电信7-8区<
名称
556<
areaID
……
1531<
网通一区-风雪之灵<
1995<
网通一区-黎明港湾<
1915<
2.6用户余额http:
NVARCHAR2(50)
blance
balance_lock
未确认余额
power_text
用户类型
50.0<
用户余额
balance_lock>
0.0<
/balance_lock>
未确认余额
power_text>
豪华版<
/power_text>
用户类型
2.7手机号码归属地http:
phone
要获取的手机号
type
号码运营商
city
归属地
areacode
区号
zipcode
邮编
<
type>
中国移动GSM<
/type>
号码运营商
city>
北京北京<
/city>
归属地
areacode>
010<
/areacode>
区号
zipcode>
100000<
/zipcode>
邮编
2.8系统时间戳http:
time>
1387437191<
/time>
系统时间戳
2.9销售软件http:
open
要开通用户名
权限版本号
income
此次扣费金额
in<
income>
-270<
/income>
此次扣费金额
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 第三 方充值 平台 接口 开发 文档