话费、水电煤气费课件.docx

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