收购接口对接技术文档V1.2版.docVIP

收购接口对接直通车技术文档 商户接入指南 版本号1.2 扬州畅联网络科技有限公司 2009年9月1日 1、摘要 1.1目的 此文档,只仅用于本公司商户使用.使用70card收购接口对接直通车（以下简称70card直通车）可方便、快捷的处理售卡业务与服务，减少人工操作.文档描述了商户如何通过直通车接口对接直通车方式进和行售卡业务,以及相关信息 1.2版本声明 此文档版权归属于扬州畅联网络科技有限公司拥有。作为本公司的最终商户，可以拥有该份文档的使用权，不得向第三方借阅、出让、出版该文档。 1.3 售卡接口说明 商户系统作为请求的终端，按照本文档的约定向70card直通车接口发起请求，70card收到商户请求并给予验证、处理,处理完成后将结果发送给商户系统。 1.4参考资料 暂无 2、提交售卡请求 2.1说明 商户系统向70card直通车请求，商户系统作为请求的终端，按照本文档的约定发起请求，70card收到商户请求并给予验证并返回提交请求结果 商户与70card请求与返回的参数均为小写 2.2订单销售类型说明 产品类型列表 登陆商户后台-》用户中心-》接口对接供卡设置-》对接卡种类编码及产品ID查询 产品列表 登陆商户后台-》用户中心-》接口对接供卡设置-》对接卡种类编码及产品ID查询 2.3提交售卡请求 提交流程说明 商户向70card直通车接口提交请求 70card验证商户提交请求数据正确性，对请求ip（详见ip验证说明）、md5组合验证（详见MD5组合验证）、商户号、产品类型编码与产品编码、卡号与卡密做验证 请求通过70card直通车接口验证，返回确认请求信息（详见请求确认），此时商户售卡请求完成。 请求数据及格式 /sale.aspx?userid={}orderid={}typeid={}productid={}cardno={}cardpwd={}money={}url={}sign={}ext={} 参数说明 参数名称 参数含义 长度 是否必填 备注 userid 商户ID MAX(10) 是 商户在70card中的唯一标识，在直通车中获得 orderid 商户订单号 MAX(30) 是 提交的订单号在商户系统中必须唯一 typeid 产品类型ID MAX(10) 是 当前提交的产品类型代码 productid 产品ID MAX(10) 是 当前提交的产品代码 cardno 卡号 MAX(30) 是 卡号 cardpwd 卡密 MAX(30) 是 卡密 money 订单金额 Max(10) 是 订单金额(卡面值) url 商户接收售卡结果数据的地址 MAX(200) 是 售卡成功后，70card向该地址址发送两次通知，该地址可以带参数，如: “/callback.aspx?para=para” sign 签名数据 MAX(50) 是 32位小写的组合加密验证串 ext Max(50) 否 商户扩展信息，返回时原样返回，此参数如用到中文，请注意转码 I 商户提交售卡请求到70card接口时，70card会根据商户在直通车中设置的ip地址来验证请求的合法性,，验证失败将不予处理。 MD5组合验证 接口采用做md5加密对请求数据验证，验证失败将不予处理。MD5组合源串如下： userid={}orderid={}typeid={}productid={}cardno={}cardpwd={}money={}url={}keyvalue={} 商户用具体的参数数值代替{}，注意要保证参数循序的正确性其中keyvalue在直通车中获取。 请求举例 2.4请求确认信息 参数名称 参数含义 长度 是否必填 备注 returncode 确认代码 MAX(20) 是 确认代码，“1”代表提交成功， 列表中非“1”的其它代码表示提交失败， 非列表代码为异常情况(不处理本地单据) 5：ip验证错误 6：数字签名错误 7：无效的商户号 8：无效单据号 9：无效的产品类型ID 10：无效的产品ID 11：无效的卡 12：系统错误 returnorderid 商户订单号 MAX(30) 是 提交的订单号在商户系统中必须唯一 sign 签名数据 MAX(50) 是 32位小写的组合加密验证串 sign 为组合验证串，采用md5加密，MD5组合源串如下 returncode={}returnorderid={}keyvalue={} 商户用具体的参数数值代替{}，注意要保证参数循序的正确性其中keyvalue在直通车中获取。 商户接受到确认信息后向页面写入”ok” 3、服务器端通知售卡结果 3.1说明 70card售卡服务器将在第一时间将商户