70卡世界平台接口对接技术文档v2.5版

《70卡世界平台接口对接技术文档v2.5版》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

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

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

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

4、标识，在直通车中获得orderno商户订单号MAX(30)是提交的订单号在商户系统中必须唯一typeid产品类型IDMAX(10)是当前提交的产品类型代码cardno卡号MAX(30)是卡号encpwd卡密是否加密MAX(1)是值为0或者1，1表示加密cardpwd卡密MAX(30)是encpwd为1时可为空，否则为未加密的密码cardpwdenc加密后卡密MAX(100)是encpwd为0时可为空，否则为加密后的密码money卡面值MAX(30)是整型url商户接收售卡结果数据的地址MAX(200)是售卡成功后，70card向该网址发送两次成功通知，该地址可以带参数，如:“www.yzc

5、h.net/callback.aspx?para=para”sign签名数据MAX(50)是32位小写的组合加密验证串ext商户自定义数据Max(50)否商户扩展信息，返回时原样返回，此参数如用到中文，请注意转码appname程序名称MAX(50)否提供程序名ip用户IPMax(50)否用户提卡的真实IPlMD5组合验证接口采用做md5加密对请求数据验证，验证失败将不予处理。MD5组合源串如下：userid={0}&orderno={1}&typeid={2}&cardno={3}&encpwd={4}&cardpwd={5}&cardpwdenc={6}&money={7}&url={8

6、}&keyvalue={9}商户用具体的参数数值代替{}，注意要保证参数循序的正确性，其中keyvalue在直通车中获取。加密后结果转为小写,cardpwd为加对称加密前的。l请求举例2.4请求确认信息参数名称参数含义长度是否必填备注returncode确认代码MAX(20)是确认代码，1代表提交成功，0提交失败message中文提示MAX(100)是卡处理失败的中文提示，成功为oksign为组合验证串，采用md5加密，MD5组合源串如下returncode={}&message={}商户用具体的参数数值代替{}，注意要保证参数循序的正确性其中keyvalue在直通车中获取。加密后转为小写

7、。Cardpwdenc的加密联系70Card技术返回error表示系统错误请通过查询接口确定订单有没有提交上 订单号已存在8产品被用户关闭9产品维护中9该产品被用户关闭9该产品不存在或者被关闭9该卡无此面值9(省)神州行维护11不支持的卡号11该卡为赠送卡不能充值11卡号或卡密不符合格式11卡号或卡密长度错误11提交金额不正确11该卡已超过系统规定的失败次数14该卡已成功或正在处理中15该卡已失败163、服务器端通知售卡