70卡世界接口开发文档【荐】.docVIP

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