上海银行-快捷支付接口规范(版本号v3.6.6)前言本文档介绍上海银行“快捷支付”的技术标准，此接口标准适应借记卡快捷支付及信用卡快捷支付。其中包括业务处理与系统交互方式、报文的语法与语义、网络连接方式、安全规范等。第1章文档概述1.1介绍1.1.1概述本文档阐述的技术标准，为更加快捷安全的互联网支付结算提供了解决方案。1.1.2目标读者本文档的主要目标读者是银行与商户的技术实施人员，也可供业务人员参考。1.1.3最近修订版本号作者内容提要核准人发布日期1.0黄敦迪定义上海银行快捷支付接口规范蔡红林2012-06-12.0黄敦迪删除快捷支付业务概述；调整错误代码；重定义身份鉴权报文头；删除单笔提现接口；删除批量交易明细查询，新增单笔交易明细查询黄敦迪2012-6-133.0黄敦迪增加批量交易明细查询，修改错误代码黄敦迪2013-3-113.1黄敦迪修改身份鉴权、网上支付、单笔退款、批量退款接口，加入了卡代号等2013-3-123.2黄敦迪鉴权需中账户姓名改为必输2013-4-113.3黄敦迪接口实现说明中批量交易查询改为非必须实现的接口。批量交易查询请求报文中加入订单号列表2013-4-193.4彭小波修改身份鉴权接口，CVV2、有效期改为可选字段，增加KoalB64Cert;修改网上支付接口CVV2、有效期改为可选字段，返回报文银行卡改为卡代号，黄敦迪2013-4-223.5.1彭小波批量交易查询增加爱业务规则：订单最多支持10笔;查询的多条订单只返回符合条件的记录。2013-4-283.5.2彭小波为单笔退款增加错误代码：40452013-5-23.5.3黄敦迪单笔交易明细查询应答报文中status枚举值调整及定义errorCode的取值；批量交易查询应答报文TradeInfo清单中的signNo改为cardNo2013-5-113.5.4彭小波错误码不再分类别扩展鉴权的证件类别鉴权中增加校验规则，手机号码必须为11位明确单笔订单查询中的交易日期和时间2013-5-173.5.5彭小波调整错误码描述：3006对应描述改为卡号不存在或不支持的银行卡3016对应描述改为银行账户交易失败批量交易查询的交易状态进行调整：0000成功；0001失败2013-5-183.5.6彭小波3003的errormessage从“身份证号码不匹配”改为“身份证件号码不匹配”2013-5-213.5.7彭小波针对信用卡的CVV2和有效期，增加对应的错误码：3050和30512013-5-243.5.8彭小波身份鉴权增加业务逻辑：CVV2和有效期需同时输入或同时都不输入2013-5-243.5.9彭小波网上支付去除：CVV2和有效期2013-5-273.6黄敦迪删除二级商户信息同步接口，增加单笔撤消接口2013-6-203.6.1彭小波批量交易查询响应报文中交易信息列表tradeInfoList签名要求由”Y”变更为”N”2013-6-263.6.2彭小波新增错误码：4046清算的订单不能做撤销处理2013-6-273.6.3彭小波银行流水号由char(19)统一更改为char(20),修改点：网上支付、单笔退款、单笔撤消2013-6-273.6.4彭小波清算对账中文件格式中银行卡号修正为银行卡代号2013-7-13.6.5彭小波单笔撤消上送报文增加交易金额，同时增加校验：交易金额必须和原订单交易金额一致2013-7-23.6.6彭小波清算对账增加业务规则：信用卡撤消及对应2013-7-5原订单不在清算对账文件内。第2章报文结构上海银行快捷支付报文规范规定了上海银行与商户之间交换报文的处理规范。2.1报文结构快捷支付报文统一采用xml格式。所有的快捷支付报文均以Banksh作为根元素，每个Banksh元素中可以包含多个Message元素。Message元素中包含代表具体的业务的元素，比如CSVReq、CSVRes等。每个业务元素由一系列属性元素构成，不同的业务元素中包含的属性元素有所不同。对于涉及到签约状态修改或者资金变动的业务元素，必须要有与之匹配的Signature元素进行数字签名。作为约定，Banksh元素、Message元素与业务元素均是首字母大写的CamelCase形式，所有的属性元素均是首字母小写的CamelCase形式。以签约请求报文为例，报文的格式如下：<Banksh><Messageid=“2008070913123456"><CSReqid="CSVReq"><version>…</version><date>…</date><instId></instId><certId></certId><signNo>…</signNo><cardNo>…</cardNo><cardType>…</cardType><name>…</name><gender>…</gender><certType>…</certType><certNo>…</certNo><email>…</email><ce...