[易收网直连充值接口文档新版.doc

商家直连接口 直充产品开发文档 版本（3.5） 修订历史记录 修改日期 修改者 版本号 备注 2009-8-4 王红伟 3.5 创建 目录 1. 引言 4 1.1. 编写目的 4 2. 协议概述 0 2.1. 协议列表 0 3. 销售协议 1 3.1. 直充接口商户准备文档 1 3.1.1. 商户准备工作 1 3.1.2. 商户需要提交的信息 1 3.1.3. 以下为我公司内部审核使用（商家无需填写） 1 3.2. 充值调用说明 2 3.2.1. 充值接口的调用说明 2 3.2.2. 查询接口调用说明 3 3.2.3. 接口输出参数说明 4 3.2.4. 返回代码值ret_code说明 5 3.3. 充值区域和服务器链接地址 5 3.3.1. 充值区域地址： 6 3.3.2. 充值服务地址： 6 3.4 可充值的产品信息列表 7 3.4.1 查询接口说明 7 3.4.2 接口输出参数说明 8 3.4.3 产品编码简要说明 9 3.5 单据对账接口说明 9 3.5.1 接口参数说明 9 3.5.2 接口输出参数说明 10 4. 常见问题 11 5. 注意问题 12 6. 特殊参数说明 13 7. 附录 14 引言 编写目的 本系统采用公开标准Web方式由合作商家调用充值接口地址，实现官方充值产品的充值和查询目的。 协议概述 协议列表 协议名称 说明 销售协议 销售等开通服务的协议 协议的交互逻辑 直充接口流程图 销售协议 直充接口商户准备文档 商户准备工作 登陆在线平台(http://www.239.la)并注册到kakuzhilian帐号下面成为直销商，然后联系我公司商务合作人员。此申请将作为协议附加文件备档。接口如有更新请重新提交审核。 商户请登入800j系统查看您的数字卡ID并记录下来，在左上角有显示。 请检查自己服务器的IP地址(一或多个)，我公司技术人员将会对IP访问进行限制。 准备好您的12位MD5钥匙码，任意组合，请牢记。 请联系我公司平台技术中心相关技术人员进行调试。 商户若需要调试及查看正式使用的产品卡编号，在进入在线平台系统后，选择价格管理在产品价格设置中可以看到。 商户调试完成后，该帐号即可转为正式使用帐号，修改密码即可，建议进行网卡绑定，以保证安全。对特殊合作的商户由双方协商对敏感信息数据3DES加密。 请向我公司商务提交电子文档时文件名要统一原则上是公司名+xx产品接口申请+年月日.doc格式.如北京xxx公司卡密产品接口申doc 开通业务请注明卡密或直充。 商户需要提交的信息 协议情况:（必须填写）公司名、协议时间、商户协议负责人、协议状态（测试或正式签署）技术联系人： 技术联系手机： 技术QQ： 800j平台注册中文名称： 800j平台注册账户： 800j平台账户ID号： 商户访问接口的服务器IP地址： 商户MD5码（自己编写12位字母加数字的组合）： 以下为我公司内部审核使用（商家无需填写） 法务审核人： 审核时间： 商务审核人： 审核时间： 技术审核人： 审核时间： 充值调用说明 此接口，需要合作方收集用户的充值信息，再将信息按接口参数说明的规则组织好，请求到指定的直连接口，根据解析接口页面上打印的信息来判断充值的状态。对于没有收到返回信息或者返回信息状态是未知状态的单据，请使用查询接口查询单据状态后在进行单据的最终处理。 调用方式：post/get方式请求url接口地址。 调用要求： 1． 商家提交的订单号不能重复，充值成功后不要再次提交。 2． 合作方在条件允许的情况下，定期协商更换加密key，确保数据传输的安全性。 3． 查询接口要与直充接口同时上线使用。 4． 要求合作方能够保存明细帐，以便出错时进行对帐。 5． 直充和查询接口的提交和返回的参数名均小写。 6． 由合作方对充值区域和服务器、产品信息的XML文件进行解析。并及时更新同步。 7． md5Key为双方约定的密匙，可以在平台设置。Md5测试结果对比 支持中文字符 测试数据:test123测试 加密结果: fb60bcaf22d4f61f2efbffd8af047b76 不带中文字符 测试数据:test123 加密结果: cc03e747a6afbbcbf8be7668acfebee5 充值接口的调用说明 http://www.239.la/Charge/Submit.aspx?agent