商家直连接口.doc

商家直连接口 直充产品开发文档 版本（3.5） 修订历史记录 修改日期 版本号 备注 2009-8-4 3.5 创建 2011-6-10 修改关于充值接口中charge_amt参数的作用及说明：此参数传商户自己平台卖给用户的金额，以便购买时接口判断是否小于成本价，小于则购买失败；也可以不传或者默认为0，代表对价格不做检查判断（一般是商户自己平台搞活动低于成本价卖商品） 2012-3-26 增加字段bill_data_info描述单据情况（主要用户多张充值，拆分后每个单的状态）此参数不参加md5签名 2012-5-28 充值下单接口增加region_name,server_name两个字段，两个字段不参加签名 2013-6-18 充值区域和服务器的获取方式更改 2013-10-29 可充值产品信息列表获取方式修改（产品类别编号category_code第一次获取可为空，只能获取到所有可充值的产品列表，获取不到产品的进货价格信息，查询产品的价格信息时必须填写） 目录 1. 引言 5 1.1. 编写目的 5 2. 协议概述 0 2.1. 协议列表 0 3. 销售协议 1 3.1. 直充接口商户准备文档 1 3.1.1. 商户准备工作 1 3.1.2. 商户需要提交的信息 1 开通业务： 1 3.1.3. 以下为我公司内部审核使用（商家无需填写） 2 3.2. 充值调用说明 2 3.2.1. 充值接口的调用说明 2 3.2.2. 查询接口调用说明 4 3.2.3. 接口输出参数说明 4 3.2.4. 返回代码值ret_code说明 5 3.3. 异步通知接口请求说明 6 3.3.1. 发送请求的参数说明 6 3.3.2. 接收到异步通知后返回信息说明 7 3.4. 充值区域和服务器链接地址 7 3.4.1. 充值区域地址： 7 3.4.2. 充值服务地址： 8 3.5. 可充值的产品信息列表 8 3.5.1 查询接口说明 8 3.5.2 接口输出参数说明 9 3.5.3 产品编码简要说明 10 3.6. 商户帐号可用余额查询 11 3.6.1. 接口调用的说明 11 3.6.2. 接口输出参数说明 11 3.7. 单据对账接口说明 11 3.7.1. 接口参数说明 12 3.7.2. 接口输出参数说明 12 4. 常见问题 13 5. 注意问题 15 6. 特殊参数说明 15 7. 附录 18 引言 编写目的 本系统采用公开标准Web方式由合作商家调用充值接口地址，实现官方充值产品的充值和查询目的。 协议概述 协议列表 协议名称 说明 销售协议 销售等开通服务的协议 协议的交互逻辑 直充接口流程图 销售协议 直充接口商户准备文档 商户准备工作 登陆在线平台()并注册到kakuzhilian帐号下面成为直销商，然后联系我公司商务合作人员（如已有帐号则不需要重新注册）。此申请将作为协议附加文件备档。接口如有更新请重新提交审核。 商户请登入800j系统查看您的数字卡ID并记录下来，在左上角有显示。 请检查自己服务器的IP地址(一或多个)，我公司技术人员将会对IP访问进行限制。 准备好您的12位MD5钥匙码，任意组合，请牢记。 请联系我公司平台技术中心相关技术人员进行调试。 商户若需要调试及查看正式使用的产品卡编号，在进入在线平台系统后，选择价格管理在产品价格设置中可以看到。 商户调试完成后，该帐号即可转为正式使用帐号，修改密码即可，建议进行网卡绑定，以保证安全。对特殊合作的商户由双方协商对敏感信息数据3DES加密。 请向我公司商务提交电子文档时文件名要统一原则上是公司名+xx产品接口申请+年月日.doc格式.如北京xxx公司卡密产品接口申doc 开通业务请注明卡密或直充。 商户需要提交的信息 协议情况:（必须填写）公司名、协议时间、商户协议负责人、协议状态（测试或正式签署）技术联系人： 技术联系手机： 技术QQ： 800j平台注册中文名称： 800j平台注册账户： 800j平台账户ID号： 商户访问接口的服务器IP地址： 商户MD5码（自己编写12位字母加数字的组合）： 以下为我公司内部审核使用（商家无需填写） 法务审核人： 审核时间： 商务审核人： 审核时间： 技术审核人： 审核时间： 充值调用说明 此接口，需要合作方收集用户的充值信息，再将信息按接口参数说明的规则组织好，请求到指定的直连接口，根据解析接口页面上打印的信息来判断充值的状态。对于没有收到返回信息或者返回信息