骏网直连充值接口文档新版Word文档下载推荐.docx
- 文档编号:22394635
- 上传时间:2023-02-03
- 格式:DOCX
- 页数:24
- 大小:38.70KB
骏网直连充值接口文档新版Word文档下载推荐.docx
《骏网直连充值接口文档新版Word文档下载推荐.docx》由会员分享,可在线阅读,更多相关《骏网直连充值接口文档新版Word文档下载推荐.docx(24页珍藏版)》请在冰豆网上搜索。
6.特殊参数说明13
7.附录14
1.引言
1.1.编写目的
本系统采用公开标准Web方式由合作商家调用充值接口地址,实现官方充值产品的充值和查询目的。
2.协议概述
2.1.协议列表
协议名称
说明
销售协议
销售等开通服务的协议
协议的交互逻辑
直充接口流程图
3.销售协议
3.1.直充接口商户准备文档
3.1.1.商户准备工作
1、登陆在线平台()并注册到kakuzhilian帐号下面成为直销商,然后联系我公司商务合作人员。
此申请将作为协议附加文件备档。
接口如有更新请重新提交审核。
2、商户请登入800j系统查看您的数字卡ID并记录下来,在左上角有显示。
3、请检查自己服务器的IP地址(一或多个),我公司技术人员将会对IP访问进行限制。
4、准备好您的12位MD5钥匙码,任意组合,请牢记。
5、请联系我公司平台技术中心相关技术人员进行调试。
6、商户若需要调试及查看正式使用的产品卡编号,在进入在线平台系统后,选择价格管理在产品价格设置中可以看到。
7、商户调试完成后,该帐号即可转为正式使用帐号,修改密码即可,建议进行网卡绑定,以保证安全。
对特殊合作的商户由双方协商对敏感信息数据3DES加密。
8、请向我公司商务提交电子文档时文件名要统一原则上是公司名+xx产品接口申请+年月日.doc格式.如北京xxx公司卡密产品接口申请20071029.doc
9、开通业务请注明卡密或直充。
3.1.2.商户需要提交的信息
协议情况:
(必须填写)公司名、协议时间、商户协议负责人、协议状态(测试或正式签署)
开通业务:
商户名称:
地址:
商务联系人:
商务联系方式:
技术联系人:
技术联系手机:
技术QQ:
800j平台注册中文名称:
800j平台注册账户:
800j平台账户ID号:
商户访问接口的服务器IP地址:
商户MD5码(自己编写12位字母加数字的组合):
3.1.3.以下为我公司内部审核使用(商家无需填写)
法务审核人:
审核时间:
商务审核人:
技术审核人:
3.2.充值调用说明
此接口,需要合作方收集用户的充值信息,再将信息按接口参数说明的规则组织好,请求到指定的直连接口,根据解析接口页面上打印的信息来判断充值的状态。
对于没有收到返回信息或者返回信息状态是未知状态的单据,请使用查询接口查询单据状态后在进行单据的最终处理。
调用方式:
post/get方式请求url接口地址。
调用要求:
1.商家提交的订单号不能重复,充值成功后不要再次提交。
2.合作方在条件允许的情况下,定期协商更换加密key,确保数据传输的安全性。
3.查询接口要与直充接口同时上线使用。
4.要求合作方能够保存明细帐,以便出错时进行对帐。
5.直充和查询接口的提交和返回的参数名均小写。
6.由合作方对充值区域和服务器、产品信息的XML文件进行解析。
并及时更新同步。
7.md5Key为双方约定的密匙,可以在平台设置。
Md5测试结果对比
支持中文字符
测试数据:
test123测试
加密结果:
fb60bcaf22d4f61f2efbffd8af047b76
不带中文字符
test123
cc03e747a6afbbcbf8be7668acfebee5
3.2.1.充值接口的调用说明
http:
//S
接口参数说明:
名称
类型
agent_id
int
商家ID(必填)800j账户数字ID(请登陆m平台查看)
bill_id
string
商家提交的唯一订单号(必填)必须唯一6到50位
bill_time
商户订单时间(必填)(格式为yyyMMddHHmmss4位年+2位月+2位日+2位时+2位分+2位秒)
supply_type
供货类型(必填)0=自动找供货商,1=骏网供货,2=自己供货,3=上级供货,4=指定供货id(指定的id必须是骏网或自己或上级或对接的sup)
supply_id
指定的供货商ID只有当supply_type=4的时候才有效
product_code
充值产品编号(必填)
product_num
充值数量默认为1(人工代充1元产品才可以多张)(必填)
region_id
充值区域值ID,无区域值为-1(必填)
server_id
充值服务ID,无服务ID值为-1(必填)
charge_account
用户的游戏充值帐号(必填)请求数据前请UrlEncode编码
charge_ext1
扩展参数1(用于特殊充值产品)(可选)详见特殊参数说明
charge_ext2
扩展参数2(用于特殊充值产品)(可选)
charge_ext3
扩展参数3(用于特殊充值产品)(可选)
charge_amt
商户平台收玩家的充值金额(必填)
client_ip
用户来源IP(可选)
notify_url
通知地址,充值中的单据,处理后通知,为空不通知(可选)
desc
备注说明(可选)
time_stamp
提交时间戳(必填格式为yyyMMddHHmmss4位年+2位月+2位日+2位时+2位分+2位秒)(必填)
sign
数字签名(32位的md5加密,加密后转换成小写)
需要加密的串:
agent_id=***&
bill_id=***&
bill_time=***&
supply_type=***&
supply_id=***&
product_code=***&
product_num=***&
region_id=***&
server_id=***&
charge_account=***&
time_stamp=***|||md5Key
3.2.2.查询接口调用说明
接口参数说明:
商家ID(必填)800j注册的账户数字ID
3.2.3.接口输出参数说明
ret_code=***&
ret_msg=***&
jnet_bill_no=***&
par_price=***&
purchase_amt=***&
bill_charge_time=***&
bill_status=***&
sign=*****
ret_code
返回结果代码0=成功,其他值参考3.2.4
ret_msg
返回消息
商户ID号
商户订单号
jnet_bill_no
成功后在骏网产生的单据号
par_price
money
面值单价(格式0.00)
purchase_amt
实际充值总金额(格式0.00)
bill_charge_time
充值时间
bill_status
充值状态:
失败、处理中、成功
数字签名的组成
bill_status=***|||md5Key
3.2.4.返回代码值ret_code说明
ret_code的值代表的意义:
充值成功
1
传入参数有误
2
代理商ID错误或未开通该服务
3
IP验证错误
4
签名验证错误
5
重复的订单号
6
产品不存在,上级没此卡的库存
7
创建记录失败
8
此单据不存在
9
产品未开通
11
无效的订单号
12
无效的版本号
13
无效的单据时间
14
无效的产品编码
15
无效的充值数量
16
此产品充值账号格式错误
17
无效的产品区服
18
通知的url无效
-1
失败
997
998
接口维中
999
系统错误,未知(需要查询后在处理单据状态)
3.3.充值区域和服务器链接地址
说明:
都是以XML文件形式输出
请求参数:
查某一个产品的区域值信息
CategoryCode
产品的分类编码(必填)
xml输出参数说明:
产品的分类ID
CategoryName
产品的分类名称
RegionID
充值区域ID
RegionName
充值区域名称
RegionValue
充值区域值
List_Order
排序号
如下:
<
?
xmlversion="
1.0"
encoding="
GB2312"
?
>
GameRegion>
GameRegionInfoCategoryCode="
AAFZWLTYSK"
CategoryName="
《机战》太阳石卡"
GameRegionItemRegionID="
790"
RegionName="
第一大区(福建电信)"
RegionValue="
1"
List_Order="
/>
791"
第二大区(山东网通)"
2"
792"
第三大区(广东电信)"
3"
793"
第四大区(浙江电信)"
4"
794"
第五大区(江苏电信)"
5"
/GameRegionInfo>
/GameRegion>
要查询的区域id值(必填)
ServerID
服务器ID
ServerName
服务器名称
ServerValue
服务器值
如下:
<
-<
GameServer>
GameServerInfoRegionID="
90"
GameServerItemServerID="
58"
ServerName="
雷霆"
ServerValue="
0"
59"
光芒"
60"
烈焰"
61"
疾风"
62"
新浪"
8"
63"
流云"
6"
64"
联通"
65"
蜀山"
7"
/GameServerInfo>
/GameServer>
3.4可充值的产品信息列表
注意:
由此接口的查询到的产品才可以通过接口购买。
这里显示了产品的面值和产品的进货价,也就是购买成功后骏网扣除商户账号的金额。
3.4.1查询接口说明
接口参数说明
use_type
产品类型(必填)直冲产品=3默认(use_type=3)
category_code
产品类别编号(可选)
use_type=***&
3.4.2接口输出参数说明
查询出错时的输出说明:
ret_code=***|||md5Key
查询成功后的输出说明:
ProductLists>
ProductList>
<
ProductItemCategoryCode="
AABBKJJHOL"
ProductCode="
AABBKJJHOL015AV"
ProductFullName="
新江湖_1500八八贝-15元卡密"
UseType="
SupplierID="
ParPrice="
15.0000"
PurchasePrice="
12.3000"
27652"
13.0000"
AABBKJJHOL030AV"
新江湖_3000八八贝-30元卡密"
30.0000"
25.2001"
AABBKJJHOL100AV"
新江湖_10000八八贝-100元卡密"
100.0000"
/ProductList>
AAJWVVCSVV"
AAJWVVCSVV01FAV"
测试产品(请不要购买,购买概不负责)_卡密测试-1分"
0.0100"
AAJWVVCSVV000AV"
测试产品(请不要购买,购买概不负责)_卡密测试-1角"
0.1000"
<
AAJWVVJWYK"
AAJWVVJWYKA06AV"
骏网一卡通_6元卡密"
6.0000"
/ProductLists>
产品大类编码,字符串长度10位固定不变
ProductCode
产品的编码,字符串长度15位固定不变
ProductFullName
产品的名称
UseType
产品的使用类型,数字类型
SupplierID
供货商id,数字类型
ParPrice
产品面值
PurchasePrice
产品成本价(成功后骏网扣除商户账号的金额)
3.4.3产品编码简要说明
例如:
大类编码:
CategoryCode=AAJWVVCSVV
产品编码:
ProductCode=AAJWVVCSVV001AV
产品名称:
测试产品-1元
产品编码是由15位字母及数字组成,分为A、B、C、D四部分组成。
A表示产品大类,由2位字母组成(AA);
B表示产品公司名称,由四位字母组成(JWVV);
C表示产品名称,由四位字母组成;
(CSVV)
D表示产品编号,由五位数字字母组成,其中前3位为数字面值,第4位为字母使用类型,第5位为字母卡类型
ProductCode编码的前10位也就是CategoryCode
3.5单据对账接口说明
此接口可以查询当前日的前两天的数据,主要用于获取骏网平台的接口单据信息来核对商户自己平台的单据。
3.5.1接口参数说明
产品类型(必填)默认use_type=3,直冲产品
begin_time
string(14)
订单开始时间(必填)形式如20100327011015表示2010-3-2701:
10:
end_time
stri
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 骏网直连充值 接口 文档 新版
![提示](https://static.bdocx.com/images/bang_tan.gif)