话费、水电煤气费题库.docx

易淘客分销商平台接口协议 目录 易淘客分销商平台接口协议 1 目录 1 维护说明 1 报文说明 1 安全说明 2 接口内容 2 交易类 2 购买数字卡 2 手机话费直充 3 QQ游戏直充 3 水电煤代缴费 4 查询类 4 同步可销售产品 4 查询余额 5 订单查询 5 通知类 6 手机话费直充交易结果通知 6 交易类型说明 6 返回码说明 6 维护说明 版本号 日期 编写人 审核人 说明 1.0 2011-09-23 周涌 编写文档 1.1 2011-12-21 周涌 1. 新增交易类型 2. 新增交易返回码 3. 各响应添加易淘客订单号返回 4. 接口报文中,接口类型、分销商帐号为定长,其他字段的标示为最大长度 1.1.1 2012-07-25 汪学贫 5. 增加加密、解密示例数据 1.1.2 2012-08-01 汪学贫 6. 修改直充通知，并新增返回码：5005 报文说明 a) 协议：报文采用HTTP协议POST方式提交 b) 编码类型：UTF-8 c) 数据类型ANx表示最多x个ACSII字符 d) 报文内容：见接口报文内容 e) 报文格式说明：报文域key与value用“=”连接且报文域key均为小写字母，域之间用“” 连接，域value可为空字符串（特殊域value需要采用base64编码，详见接口内容备注）。 f) 分销商交易流水号：最大支持20位，数字型字符（不能以0开头）；由分销商提供，不能重复；格式：AN20=最大12位数字型字符+8位的分销商编号 g) 请求格式：mid=xxxverifystring=xxxsign=xxx i. mid为8位分销商编号 ii. verifystring为请求报文内容经过加密后内容 iii. sign为请求报文签名内容 原串：mid=${mid}verifystring=${verifystringRSA}key=${key} h) 响应格式：returncode=xxxverifystring=xxxsign=xxx i. returncode为服务端返回的业务码 ii. verifystring为响应报文内容经过加密后内容 iii. sign为响应报文签名内容 原串：returncode=${returncode}verifystring=${verifystringRSA}key=${key} i) 接口地址： i. 交易类：联系易淘客技术获取 ii. 查询类：联系易淘客技术获取 安全说明 j) 该报文采用RSA/ECB/PKCS1Padding密钥对的加解密方式 i. verifystring的生成方式 1. 明文格式：参数间采用“”连接，参数值可为空字符串 2. 采用RSA算法对接口内容字符串进行加密（彼此用对端的公钥进行加密，再由对端用对端的私钥解密，密钥采用pem标准格式：第三方用易淘客的公钥加密请求，用自己的私钥解密易淘客的响应；易淘客用自己的私钥解密第三方的请求，用第三方的公钥加密响应） 3. verifystring为16进制值的大写的字符串 ii. sign的生成方式 1. 对分销商ID和请求报文的加密结果串以及双方约定的md5key进行MD5摘要（32长度的小写的字符串），md5key请联系易淘客技术获取 k) 上线前，分销商能登录易淘客分销商平台（），修改平台登录密码及交易密码；交易密码的加密算法仅支持6位长度，您的新的交易密码长度不能超过6位。 接口内容 交易类 购买数字卡 购买数字卡之前，第三方先需要“同步可销售产品”，获取“产品编号”，并在本地维护可销售产品，一般每天02:00至04:00期间同步一次即可。 请求报文内容 中文说明 key 长度 备注 交易类型 transtype AN4 分销商编号 mid AN8 产品编码 pid AN8 通过”同步可销售产品”得到的产品编码 产品数量 pnum AN1 数字型字符，最大不超过5张 分销商交易流水号 mtransid AN20 参考说明 上送时间 mtime AN19 yyyy-MM-dd HH:mm:ss 响应报文内容 中文说明 key 长度 备注 返回码 returncode AN4 返回描述 returninfo 易淘客订单号 etransid AN10 产品编码 pid AN8 产品数量 pnum AN1 数字型字符 产品名称 pname AN64 （明文） 特殊字段，BASE64编码 产品信息 pinfo AN256 （明文） 特殊字段，BASE64编码 格式：卡号1#卡密1|卡号2#卡密2 单张卡号、卡密的长度上限均是64 手机话费直充 请求报文内容 中文说明 key 长度 备注 交易类型 transtype AN4 分销商编号 mid AN8 分销商交易流水号 mtransi