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

《收购接口对接技术文档v1.2版》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、收购接口对接直通车技术文档商户接入指南版本号1.2扬州畅联网络科技有限公司2009年9月1日1、摘要1.1目的此文档,只仅用于本公司商户使用.使用70card收购接口对接直通车（以下简称70card直通车）可方便、快捷的处理售卡业务与服务，减少人工操作.文档描述了商户如何通过直通车接口对接直通车方式进和行售卡业务,以及相关信息1.2版本声明此文档版权归属于扬州畅联网络科技有限公司拥有。作为本公司的最终商户，可以拥有该份文档的使用权，不得向第三方借阅、出让、出版该文档。1.3售卡接口说明商户系统作为请求的终端，按照本文档的约定向70card直通车接口发起请求，70card收到商户请求

2、并给予验证、处理,处理完成后将结果发送给商户系统。1.4参考资料暂无2、提交售卡请求2.1说明商户系统向70card直通车请求，商户系统作为请求的终端，按照本文档的约定发起请求，70card收到商户请求并给予验证并返回提交请求结果商户与70card请求与返回的参数均为小写2.2订单销售类型说明l产品类型列表登陆商户后台-》用户中心-》接口对接供卡设置-》对接卡种类编码及产品ID查询l产品列表登陆商户后台-》用户中心-》接口对接供卡设置-》对接卡种类编码及产品ID查询2.3提交售卡请求提交流程说明l商户向70card直通车接口提交请求l70card验证商户提交请求数据正确性，对请求i

3、p（详见ip验证说明）、md5组合验证（详见MD5组合验证）、商户号、产品类型编码与产品编码、卡号与卡密做验证l请求通过70card直通车接口验证，返回确认请求信息（详见请求确认），此时商户售卡请求完成。l请求数据及格式http://tongs.yzch.net/sale.aspx?userid={}&orderid={}&typeid={}&productid={}&cardno={}&cardpwd={}&money={}&url={}&sign={}&ext={}参数说明参数名称参数含义长度是否必填备注userid商户IDMAX(10)是商户在70card中的唯一标识，在直通

4、车中获得orderid商户订单号MAX(30)是提交的订单号在商户系统中必须唯一typeid产品类型IDMAX(10)是当前提交的产品类型代码productid产品IDMAX(10)是当前提交的产品代码cardno卡号MAX(30)是卡号cardpwd卡密MAX(30)是卡密money订单金额Max(10)是订单金额(卡面值)url商户接收售卡结果数据的地址MAX(200)是售卡成功后，70card向该地址址发送两次通知，该地址可以带参数，如:“www.xxxxx.com/callback.aspx?para=para”sign签名数据MAX(50)是32位小写的组合加密验证串ex

5、tMax(50)否商户扩展信息，返回时原样返回，此参数如用到中文，请注意转码lIp验证说明商户提交售卡请求到70card接口时，70card会根据商户在直通车中设置的ip地址来验证请求的合法性,，验证失败将不予处理。lMD5组合验证接口采用做md5加密对请求数据验证，验证失败将不予处理。MD5组合源串如下：userid={}&orderid={}&typeid={}&productid={}&cardno={}&cardpwd={}&money={}&url={}&keyvalue={}商户用具体的参数数值代替{}，注意要保证参数循序的正确性其中keyvalue在直通车中获取。l请

6、求举例2.4请求确认信息参数名称参数含义长度是否必填备注returncode确认代码MAX(20)是确认代码，“1”代表提交成功，列表中非“1”的其它代码表示提交失败，非列表代码为异常情况(不处理本地单据)5：ip验证错误6：数字签名错误7：无效的商户号8：无效单据号9：无效的产品类型ID10：无效的产品ID11：无效的卡12：系统错误returnorderid商户订单号MAX(30)是提交的订单号在商户系统中必须唯一sign签名数据MAX(50)是32位小写的组合加密验证串sign为组合验证串，采用md5加密，MD5组合源串如下returncode={}&returnorderi

7、d={}&keyvalue={}商户用具体的参数数值代替{}，注意要保证参数循序的正确性其中keyvalue在直通车中获取。商户接受到确认信息后向页面写入”ok”3、服务器端通知售卡结果3.1说明70card售卡服务器将在第一时间将商户请求的结果以Httppost方式发送到商户提交的url参数中，商户在接收到售卡结果后向页面写入“ok”（请去除不必要的html标记），表明已经接收到数据,如果70card售卡服务器接收不到商户的返回信息”ok”,，将间隔一段时间再此向商