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

70Card平台接口对接直通车技术文档商户接入指南版本号2.5扬州畅联网络科技有限公司2012年4月27日1、摘要1.1目的此文档,只仅用于本平台商户使用.使用70card平台接口对接直通车（以下简称70card直通车）可方便、快捷的处理支付业务与服务，减少人工操作.文档描述了平台商户如何通过平台接口对接直通车方式接入平台售卡业务,以及相关信息1.2版本声明此文档版权归属于扬州畅联网络科技有限公司拥有。作为本平台的最终商户，可以拥有该份文档的使用权，不得向第三方借阅、出让、出版该文档。1.3 售卡接口说明商户系统作为请求的终端，按照本文档的约定向70card直通车接口发起POST请求，70card收到商户请求并给予验证、处理,处理完成后将结果发送给商户系统。1.4参考资料暂无2、提交售卡请求2.1说明商户系统向70card直通车平台POST请求，商户系统作为请求的终端，按照本文档的约定发起请求，70card收到商户请求并给予验证并返回提交请求结果商户与70card请求与返回的参数均为小写2.2订单销售类型说明l 产品类型列表登陆-接口设置-对接卡种类编码及产品ID查询l 产品列表登陆-接口设置-对接卡种类编码及产品ID查询2.3提交售卡请求提交流程说明l 商户向70card直通车接口提交请求l 70card验证商户提交请求数据正确性，对md5组合验证（详见MD5组合验证）、商户号、产品类型编码与产品编码、卡号与卡密做验证l 请求通过70card直通车接口验证，返回确认请求信息（详见请求确认），此时商户售卡请求完成。l 请求数据及格式/sale.ashx?userid=&orderno=&typeid=&cardno=&encpwd=&cardpwd=&cardpwdenc&money=&url=&sign=&ext=&appname=&ip=参数说明参数名称参数含义长度是否必填备注userid商户IDMAX(10)是商户在70card中的唯一标识，在直通车中获得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向该网址发送两次成功通知，该地址可以带参数，如:“/callback.aspx?para=para”sign签名数据MAX(50)是32位小写的组合加密验证串ext商户自定义数据Max(50)否商户扩展信息，返回时原样返回，此参数如用到中文，请注意转码appname程序名称MAX(50)否提供程序名ip用户IPMax(50)否用户提卡的真实IPl 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为加对称加密前的。l 请求举例2.4请求确认信息参数名称参数含义长度是否必填备注returncode确认代码MAX(20)是确认代码，1代表提交成功，0提交失败message中文提示MAX(100)是卡处理失败的中文提示，成功为oksign 为组合验证串，采用md5加密，MD5组合源串如下returncode=&message=商户用具体的参数数值代替，注意要保证参数循序的正确性其中keyvalue在直通车中获取。加密后转为小写。Cardpwdenc 的 加密联系 70Card 技术返回error 表示系统错误 请通过查询接口确定订单有没有提交上订单号已存在8产品被用户关闭9产品维护中9该产品被用户关闭9该产品不存在或者被关闭9该卡无此面值9(省)神州行维护11不支持的卡号11该卡为赠送卡不能充值11卡号或卡密不符合格式11卡号或卡密长度错误11提交金额不正确11该卡已超过系统规定的失败次数14该卡已成功或正在处理中15该卡已失败163、服务器端通知售卡结果3.1说明70card售卡服务器将在第一时间将商户请求的结果以Http post方式发送到商户提交的url参数中，中文请注意转码，商户在接收到支付结果后向页面写入“ok”（请去除不必要的html标记），表明已经接收到数据,如果70card售卡服务器接收不到商户的返回信息”ok”,，将间隔一段时间再此向商户系统发送售卡结果服务器端通知信息，直到发送超过一定次数，70card将停止发送结果通知.l 返回数据及格式Callback?returncode=&yzchorderno=&userid=&orderno=&money=&realmoney=&sign=&ext=&message=3.2参数参数名称参数含义长度备注returncode售卡结果MAX(20)返回代码：“1”代表售卡成功， “0”代表售卡失败yzchorderno我方订单号MAX(50)70卡世界订单号userid商户IDMAX(10)商户在70card中的唯一标识，在直通车中获得orderno商户订单号Max (30)提交的订单号在商户系统中必须唯一money订单金额Max(10)订单金额realmoney支付金额Max(10)订单实际支付金额sign签名数据Max (50)32位小写的组合加密验证串extMax(50)商户扩展信息，返回时原样返回，此参数如用到中文，请注意转码message错误说明Max(100)returncode=0时才有值l MD5组合验证采用做md5加密对请求数据验证。MD5组合源串如下：returncode=&yzchorderno=&userid=&orderno=&money=&realmoney=&keyvalue=商户用具体的参数数值代替，注意要保证参数循序的正确性其中keyvalue在直通车中获取。l 注意事项商户接收到售卡结果后，首先通过sign验证各个参数正确性，然后通过returncode来处理本地单据：当returncode=1时按照实际支付金额realmoney来处理本地资金。其它情况都为失败。用户处理完成后请向本地接收页面写入“ok”。4查询单据4.1说明商户可以登陆70card在代销售单据查询中查询单据信息，也可以通过70card查询借口查询单据信息调用查询接口说明l 商户向70card直通车查询接口提交请求l 70card验证商户提交请求数据正确性，对请求ip（详见ip验证说明）、md5组合验证（详见MD5组合验证）、商户号做验证l 请求通过70card直通车接口验证，返回商户单据信息。4.2提交查询请求/query.ashx?userid=&orderno=&sign=商户参数说明参数名称参数含义长度是否必填备注userid商户IDMAX(10)是商户在70card中的唯一标识，在直通车中获得orderno商户订单号MAX(30)是sign签名数据MAX(50)是32位小写的组合加密验证串sign 为组合验证串，采用md5加密，MD5组合源串如下userid =& orderno=&keyvalue=4.2获取查询结果returncode=&realmoney=&message=返回参数说明参数名称参数含义长度备注returncode售卡结果MAX(20)“-1”代表售卡无记录“0”代表售卡失败，“1”代表售卡成功