某银行快捷支付接口规范

1、上海银行-快捷支支付接口规范(版本号vv3.6.6)前言本文档介绍绍上海银银行“快捷支支付”的技术术标准，此接口标准适应借记卡快捷支付及信用卡快捷支付。其中包括业务处理与系统交互方式、报文的语法与语义、网络连接方式、安全规范等。文档概述介绍概述本文档阐述述的技术术标准，为为更加快快捷安全全的互联联网支付付结算提提供了解解决方案案。目标读者本文档的主主要目标标读者是是银行与与商户的的技术实实施人员员，也可可供业务务人员参参考。最近修订版本号作者内容提要核准人发布日期1.0黄敦迪定义上海银银行快捷捷支付接接口规范范蔡红林2012-06-12.0黄敦迪删除快捷支支付业务务概述；调整错错误代码码；重定

2、定义身份份鉴权报报文头；删除单单笔提现现接口；删除批批量交易易明细查查询，新新增单笔笔交易明明细查询询黄敦迪2012-6-1133.0黄敦迪增加批量交交易明细细查询，修修改错误误代码黄敦迪2013-3-1113.1黄敦迪修改身份鉴鉴权、网网上支付付、单笔笔退款、批批量退款款接口，加加入了卡卡代号等等2013-3-1123.2黄敦迪鉴权需中账账户姓名名改为必必输2013-4-1113.3黄敦迪接口实现说说明中批批量交易易查询改改为非必必须实现现的接口口。批量量交易查查询请求求报文中中加入订订单号列列表2013-4-1193.4彭小波修改身份鉴鉴权接口口，CVVV2、有有效期改改为可选选字段，增增

3、加KooalBB64CCertt;修改网网上支付付接口CCVV22、有效效期改为为可选字字段，返返回报文文银行卡卡改为卡卡代号， 黄敦迪2013-4-2223.5.11彭小波批量交易查查询增加加爱业务务规则：订单最多支支持100笔;查询的多条条订单只只返回符符合条件件的记录录。2013-4-2283.5.22彭小波为单笔退款款增加错错误代码码：400452013-5-223.5.33黄敦迪单笔交易明明细查询询应答报报文中sstattus枚枚举值调调整及定定义errrorrCodde的取取值；批量交交易查询询应答报报文TrradeeInffo清单单中的ssignnNo改改为caardNNo201

4、3-5-1113.5.44彭小波错误码不再再分类别别扩展鉴权的的证件类类别鉴权中增加加校验规规则，手手机号码码必须为为11位位明确单笔订订单查询询中的交交易日期期和时间间2013-5-1173.5.55彭小波调整错误码码描述：3006 对对应描述述改为 卡号号不存在在或不支支持的银银行卡3016 对应应描述改改为 银行账账户交易易失败批量交易查查询的交交易状态态进行调调整：0000 成功；00001失败败2013-5-1183.5.66彭小波3003的的errrormmesssagee从“身份证证号码不不匹配”改为“身份证证件号码码不匹配配”2013-5-2213.5.77彭小波针对信用卡卡的

5、CVVV2和和有效期期，增加加对应的的错误码码：30050和和305512013-5-2243.5.88彭小波身份鉴权增增加业务务逻辑：CVVV2和有有效期需需同时输输入或同同时都不不输入2013-5-2243.5.99彭小波网上支付去去除：CCVV22和有效效期2013-5-2273.6黄敦迪删除二级商商户信息息同步接接口，增增加单笔笔撤消接接口2013-6-2203.6.11彭小波批量交易查查询响应应报文中中交易信信息列表表traadeIInfooLisst 签签名要求求由”Y”变更为为”N”2013-6-2263.6.22彭小波新增错误码码：40046 清算的的订单不不能做撤撤销处理理2

6、013-6-2273.6.33彭小波银行流水号号由chhar(19)统一更改改为chhar(20),修改改点：网网上支付付、单笔笔退款、单单笔撤消消2013-6-2273.6.44彭小波清算对账中中文件格格式中银银行卡号号修正为为银行卡卡代号2013-7-113.6.55彭小波单笔撤消上上送报文文增加交交易金额额，同时时增加校校验：交交易金额额必须和和原订单单交易金金额一致致2013-7-223.6.66彭小波清算对账增增加业务务规则：信用卡卡撤消及及对应原原订单不不在清算算对账文文件内。2013-7-55报文结构上海银行快快捷支付付报文规规范规定定了上海海银行与与商户之之间交换换报文的的处理

7、规规范。报文结构快捷支付报报文统一一采用xxml格格式。所所有的快快捷支付付报文均均以Baankssh作为为根元素素，每个个Bannkshh元素中中可以包包含多个个Messsagge元素素。Messaage元元素中包包含代表表具体的的业务的的元素，比比如CSSVReeq、CCSVRRes等等。每个个业务元元素由一一系列属属性元素素构成，不不同的业业务元素素中包含含的属性性元素有有所不同同。对于涉及到到签约状状态修改改或者资资金变动动的业务务元素，必必须要有有与之匹匹配的SSignnatuure元元素进行行数字签签名。作为约定，BBankksh元元素、MMesssagee元素与与业务元元素均是是

8、首字母母大写的的CammelCCasee形式，所所有的属属性元素素均是首首字母小小写的CCameelCaase形形式。 以签约请求求报文为为例，报报文的格格式如下下： Messaage id 定义为为不重复复的随机机数，以以防止报报文重复复提交；在下文中出出现的具具体报文文格式描描述中，“出现要求”列包含的值的含义如下表所示：含义请求方约束束服务方约束束RRequiiredd必须包含该该域必须校验该该域是否否存在和和内容的的合法性性CCondiitioonall如果条件符符合必须须包含该该域当条件满足足时，必必须校验验该域是是否存在在当该域存在在时，必必须检查查其内容容的合法法性OOptioo

9、nall该域可选当该域存在在时，必必须检查查其内容容的合法法性报文分类快捷支付协协议中的的报文按按照交互互模式的的不同，分分为以下下几类：服务请求类类报文服务请求类类报文用用于请求求-应答答交互模模式，由由服务使使用者向向服务提提供者发发送。服服务请求求类报文文的命令令规范是是XXRReq，其其中XXX是报文文代表的的业务的的首字母母缩略，RReq是是Reqquesst的缩缩写。比比如对于于支付请请求报文文，命名名为CPPReqq，代表表Carrd PPaymmentt Reequeest。服务应答类类报文服务应答类类报文用用于请求求-应答答交互模模式，由由服务提提供者向向服务使使用者返返回。

10、服服务应答答类报文文的命令令规范是是XXRRes，其其中XXX是报文文代表的的业务的的首字母母缩略，RRes是是Ressponnse的的缩写。比比如对于于支付应应答报文文，命名名为CPPRess，代表表Carrd PPaymmentt Ressponnse。通知类报文文通知类报文文用于单单向通知知交互模模式，由由通知发发送者向向通知接接收者发发送。通通知类报报文的命命令规范范是XXXNottifyy，其中中XX是是报文代代表的业业务的首首字母缩缩略。通用报文有两种通用用报文，一一种是EErroor报文文，用于于返回处处理错误误；另一一种是NNotiifyAAcceept，代代表单向向通知已已被

11、接受受。通用报文错误代码银行返回的的错误代代码说明明：错误代码错误描述解释0000无效的根元元素根元素无法法识别0001未定义的消消息域消息不是CCSReeq、CCSRees等；或者消消息发送送给了一一个错误误的组件件0002必填域缺失失0003根据规范，一一个或多多个域不不符合格格式要求求例如，非数数字，或或者不是是有效的的日期格格式等等等。0004商户标识不不正确instIId域中中的商户户标识不不正确0005签名无效报文签名校校验不通通过0006验证证书有有效性失失败商户证书过过期或失失效1000文件格式不不正确商户批处理理业务上上传文件件不正确确1001文件不存在在下载文件时时，找不不

12、到指定定的文件件1002文件已处理理对于不允许许重复处处理的业业务的文文件，如如果已处处理过，就就发生此此错误1003文件无法解解压缩上传的文件件无法正正确解压压缩1004文件摘要不不正确文件上传通通知报文文中的文文件摘要要不正确确2001支付流水重重复重复的网上上支付流流水2002原支付流水水不存在在申请退货的的原支付付流水不不存在2003查询范围太太大查询时间跨跨度太大大2004退款订单日日期错误误退款订单日日期小于于原订单单日期2005当日撤销必必须为全全额退款款业务要求：当日撤撤销必须须为全额额3001真实姓名不不正确真实姓名与与商户端端登记的的不一致致3002证件类型不不正确证件类型

13、与与商户端端登记的的不一致致3003身份证件号号码不匹匹配身份证件号号码与商商户端登登记的身身份证件件号码不不匹配3004手机号不匹匹配3005不支持的银银行卡类类型3006卡号不存在在或不支支持的银银行卡3007未鉴权的银银行卡未做过鉴权权的银行行卡（卡卡代号不不存在时时）3008认证信息不不匹配认证信息与与商户通过过认证的的信息不不匹配3009银行卡状态态不正确确银行卡状态态不正确确3011原支付申请请流水不不存在支付申请流流水不存存在（用用于退款款）3013金额超限支付金额超超过每日日限额（退退款时超超出原订订单金额额也用这这个）3014余额不足银行账户中中的余额额不足以以完成支支付30

14、15银行交易处处理中该笔交易在在银行前前置系统统中状态态未知3016银行账户交交易失败败银行系统的的错误返返回。3050有效期错误误或卡已已过期对信用卡有有效期的的校验，信信用卡有有效期输输错，或或信用卡卡已过有有效期3051CVV2错错误信用卡CVVV2的的校验4045未清算的订订单不能能做退款款处理不支持当日日退款4001快捷支付渠渠道关闭闭没有开通快快捷支付付业务4002服务没有开开通请求的业务务没有开开通4046清算的订单单不能做做撤销处处理清算的订单单不允许许做撤销销处理9000暂时系统异异常通用性错误误NotiffyAccceppt报文文功能用来代表单单向通知知已被接接受。消息域下

15、表列举了了消息域域的定义义中文域名对应DTDD元素类型出现要求签名要求说明版本号versiionchar(7)RN目前版本号号：”1.0.1”商户标识instIIdchar(15)RY报文发送方方的商户户标识流水号orderrNummchar(30)RY原商户提交交的信息息流水号号交易日期和和时间datechar(17)RYYYYYMMMDDD HH:MM:SSS 结果代码errorrCoddechar(4)RYSUCC表表示成功功其他均为失失败错误描述errorrMesssaggechar(2566)ON消息扩展extennsioonON报文的解析析与传输输快捷支付报报文的传传输使用用HTT

16、TP(SS)方式式，在HHTTPP请求/响应体体中包含含XMLL形式的的报文。报文解析对XML解解析的基基本要求求如下：版本号检查查用于表示组组件支持持的协议议版本号号。消息息版本号号必须表表示为：n+.n+.n+ ，其中“n” 表示数数字，“+” 表示一一个或多多个。比比如1.0或11.0.1。在在所有的的消息中中，各组组件都必必须填写写自身支支持的协协议版本本号。消消息版本本号不能能低于11.0.1。xml解析析为了可以支支持后续续协议版版本，xxml解解析的实实现不要要做严格格的验证证。特别别是需要要忽略未未被确认认的域。所有xml消息必须用“utf-8”编码。Messaage域域之id

17、d属性匹匹配请求和应答答报文的的Messsagge域之之id属属性必须须相同，iid是请请求方生生成的唯唯一序列列号。比比如：银银行在CCSReeq的MMesssagee域设置置了一个个id属属性值，则则商户在在CSRRes里里面的MMesssagee域的iid属性性必须和和CSRReq的的Messsagge域之之id值值相同。报文传输对HTTPPS传输输的基本本要求如如下：使用POSST发送送消息消息请求基基于HTTTP/HTTTPS的的POSST方式式。HTTP消消息头要要求HTTP请请求与响响应消息息中必须须按照如如下要求求设置头头部域：Conttentt-Leengtth:必须设设置成

18、消消息体的的长度Conttentt-Tyype:必须须设置下下面的值值：apppliicattionn/xmml; chaarseet=uutf-8文件交换规规范文件命名规规范文件命名规规范对文文件名称称进行统统一的规规划，以以达到从从文件名名称上区区分不同同业务文文件的目目的。文文件命名名规范：filletyype_yyyyymmmdd_seqquennce.zipp，其中中：filettypee文件件类型，如如：BRRF 批量量退款文文件；BBRRFF-批量量退款结结果文件件；CCCF清算对对账文件件； IINFOO- 商商户信息息文件；yyyymmmddd文件件业务日日sequeence

19、e批次次号， 以011，022，033递增，与与商户一一般1天天交互一一次，故故批次号号固定为为“01”例如：CCF_22010002222_001.zzip （清清算对账账文件）文件压缩传输前需要要压缩成zzip格格式。文件加密对压缩后的的文件，需需要加密密之后再再传输。加加密时采采用三重重DESS对称加加密算法法3DEES。加加密密钥钥按事先先约定方方式分发发。文件摘要对加密后的的文件进进行摘要要。摘要要算法使使用标准准SHAA1算法法，结果果表示成成40位位16进进制大写写字母数数字串。在商户往银银行发送送文件下下载请求求时需对对若干域域进行摘摘要，具具体可参参考文件件下载章章节描述述；

20、在银行往商商户反馈馈文件时时，需对对文件进进行摘要要，文件件摘要商商户可从从 htttpss的reespoonsee的heead域域里面的的Bannkshha1域域的值获获取摘要要，从BBankksiggn域的的值获取取签名。文件下载（银银行端UURL）文件采用商商户主动动请求从从银行文文件服务务下载的的方式。例如银行文文件服务务的URRL格式式如下： httpp(s):/epaay.bbankkofsshannghaai.ccom/bosscarrtooon/eexprresss.doo?innstIId=11000011998 &acttionntyppe=ddownnloaad&ddat

21、ee=20010002044&fiinennamee=SCCF_22010002222_001.zzip&KoallB644Cerrt=xxxxxxxx &siign=xxxxxxxx，其中中：http(s):/eepayy.baankoofshhangghaii.coom/bbosccarttoonn/exxpreess.do银行行文件系系统的根根路径。actioontyype操作作类型（如如：upploaad表示示上传、ddownnloaad表示示下载）。instIId商户标标识。 date 交易易日期yyyyyymmddd。filennamee 遵循循业务文文件命名名规范的的文件名名。K

22、oalBB64CCertt商户户公钥BBasee64位位编码sign 使用用cerrtIdd指定的的证书对对“acttionntyppe|iinsttId|datte|ffileenamme”进行签名名，对签签名结果进行行Basse644编码获获得的字字符串,详情见见签名规规范。文件下载失失败htttp状状态码1、4066：商户户标识不不匹配2、4055：操作作类型不不正确3、4200：银行行端验签签失败4、4044：请求求文件名名不存在在5、4099：请求求文件格格式不正正确接口实现规规范接口实现说说明序号接口类型交易类型描述必须1身份鉴权实时商户发起的的实名签签约验证证Y2网上支付实时Y3

23、单笔退款实时Y4批量退款批量N5单笔交易明明细查询询实时Y6批量交易查查询实时N7清算对帐批量Y8单笔撤消实时N4.2身份份鉴权4.2.11业务功功能银行接收商商户要求求身份鉴鉴权的交交易请求求，必须须包含客客户卡号号、客户户姓名、客客户证件件类型、客客户证件件号码、手手机号码码等信息息，银行行核对卡卡号对应应的信息息与客户户提供的的信息一一致型，如如一致反反馈匹配配，否则则反馈不不匹配。4.2.22业务规规则由于快捷支支付的签签约是在在商户端端完成的的，银行行只是提提供身份份鉴权，协协助商户户验证信信息的匹匹配性。商商户必须须为客户户身份验验证承担担责任，确确保是持持卡人本本人，银银行不承承

24、担责任任。快捷支付签签约用户户的必须须持有手手机，且且手机号号为用户户在银行行端开卡卡时所登登记的手手机号。银行身份鉴鉴权，暂暂定为核核对卡对对应的客客户姓名名、证件件类型、证证件号码码、手机机号码，可可根据实实际情况况调整。建议商户在在快捷支支付签约约成功后后发手机机短信通通知客户户。4.2.33交互模模式在身份鉴权权业务中中，商户户与上海海银行通通过请求求-应答答模式交交互。商户作为服服务使用用者向银银行发送送 “身份鉴鉴权申请请”报文IIAReeq，银银行作为为服务提提供者向向商户返返回“签约应应答”报文IIARees。涉及到以下下交互：商户将数据据发送到到银行的的身份鉴鉴权服务务接口，

25、商商户需调调用银行行APII利用数数字证书书进行加加密，签签名。（见 HYPERLINK l _证书存取规范 数字签签名）银行端校验验通过核核实客户户信息，并并在同一一个连接接中返回回IARRes报报文告诉诉银行商商户验证证情况。银银行会对对返回数数据进行行加密，签签名。商户端接口口银行应应答报文文后，验验签、解解析报文文后做后后续处理理。4.2.44报文格格式鉴权请求报报文IAAReqq（Iddenttityy Auutheentiicattionn Reequeest）IAReqq是从商商户向银银行发起起的签约约请求报报文。中文域名对应DTDD元素类型出现要求签名要求说明版本号versii

26、onchar(7)RN目前版本号号：”1.0.1”商户标识instIIdchar(15)RY由银行分配配固定值值,请求求报文中中需填写写交易日期和和时间datechar(17)RYYYYYMMMDDD HH:MM:SSS客户姓名namechar(30)RY签约银行卡卡号cardNNochar(20)RY签约银行卡卡类型cardTTypeechar(1)RY1借记卡 2贷记记卡 证件类型certTTypeechar(1)RY1：身份证证；2：护照；3：军官证证；4：士兵证证；5：户口本本；6：警官证证；7：台胞证证证件号码certNNochar(30)RY手机号mobillePhhoneeCha

27、r(20)RY持卡人在银银行留的的手机号号手机号必须须为111位CVV2cvv2Char(3)ON卡背面签名名栏的后后三位数数字CVV2和和有效期期需同时时输入或或同时都都不输入入有效期validdityyChar(4)ONMMYYCVV2和和有效期期需同时时输入或或同时都不不输入经过Basse644处理的的商户证证书代码码KoalBB64CCertt/RN商户端读取取本地商商户证书书文件后后，再使使用上海海银行提提供的AAPI进进行Baase664编码码后产生生的商户户证书数数据字串串。消息扩展extennsioonON签约应答报报文IAARRess（Iddenttityy Auutheen

28、tiicattionn Reespoonsee）IARRees银行行返回给给商户的的应答。中文域名对应DTDD元素类型出现要求签名要求说明版本号versiionchar(7)RN目前版本号号：”1.0.1”商户标识instIIdchar(15)RY报文发送方方的商户户标识银行卡号cardNNochar(20)RY银行卡代码码cardCCodeeChar(20)RY唯一区分银银行卡代代码交易日期和和时间datechar(17)RYYYYYMMMDDD HH:MM:SSS结果代码errorrCoddechar(4)RY成功SUCCC，失失败见错错误代码码错误描述errorrMesssaggecha

29、r(2566)ON消息扩展extennsioonON4.3网上上支付4.3.11业务功功能商户负责验验证客户户持卡人人身份与与服务权权限，并并请求银银行划拨拨客户的的资金用用于互联联网交易易的支付付；银行行负责验验证由商商户发出出的支付付指令是是否在快快捷支付付签约的的业务范范围与银银行控制制的快捷捷支付支支付限额额内，并并实时扣扣减签约约银行卡卡内的余余额。由于网上支支付引起起的银行行与商户户间的资资金清算算方法由由快捷支支付清算算标准规规定。4.3.22业务规规则该交易在执执行中需需要满足足以下约约束条件件：支付必须由由客户请请求，从从合作商商户发起起（可以以网上、网网点等渠渠道）。商户控

30、制支支付的资资金只能能从快捷捷支付签签约时确确定的签签约银行行卡账户户中支出出。银行端做无无磁无密密交易。支付时客户户在签约约银行卡卡账户中中的资金金只能转转移到商商户指定定的清算算账户中中。同一支付订订单号的的支付交交易，银银行端限限定只能能执行一一次，永永不重复复。银行与商户户需要保保存支付付相关报报文的日日志作为为解决资资金清算算不一致致的依据据。4.3.33处理流流程4.3.44交互模模式在支付业务务中，商商户与银银行通过过请求-应答模模式交互互。商户作为服服务使用用者向银银行发送送 “支付”请求报报文CPPReqq，银行行作为服服务提供供者向商商户返回回“网上支支付”应答报报文CPP

31、Ress。4.3.55报文格格式“网上支付付”请求报报文CPPReqq(Caard Payymennt RRequuestt)网上支付报报文请求求CPRReq(Carrd PPaymmentt Reequeest) 是从从商户向向银行发发起的支支付请求求。中文域名对应DTDD元素类型出现要求签名要求说明版本号versiionchar(7)RN目前版本号号：”1.0.1”商户标识instIIdchar(15)RY报文发送方方的商户户标识二级商户代代码twoIddchar(15)CN二级商户代代码适用于有些些商户需需银行在在账单或或明细查查询中显显示其平平台的二二级商户户名称订单号orderrNu

32、mmchar(30)RY商户支付订订单号/流水号号,永不不重复交易日期和和时间datechar(17)RYYYYYMMMDDD HH:MM:SS卡代号cardCCodeechar(20)RY鉴权时返回回的卡代代码手续费charggeLong(12)ON预留字段，见 HYPERLINK l _金额格式 金额格式说明交易金额amounntLong(12)RY见 HYPERLINK l _金额格式 金额格式式说明交易货币代代码curreencyychar(3)RY见 HYPERLINK l _卡通货币代码表 快捷支付付货币代代码表经过Basse644处理的的商户证证书代码码KoalBB64CCert

33、t/RN商户端读取取本地商商户证书书文件后后，再使使用上海海银行提提供的AAPI进进行Baase664编码码后产生生的商户户证书数数据字串串。消息扩展extennsioonON“网上支付付”应答报报文CPPRess(Carrd PPaymmentt Reespoonsee)网上支付应应答报文文CPRRes是是银行返返回给商商户CPPReqq的应答答。中文域名对应DTDD元素类型出现要求签名要求说明版本号versiionchar(7)RN目前版本号号：”1.0.1”商户标识instIIdchar(15)RY报文发送方方的商户户标识订单号orderrNummchar(30)RY商户支付订订单号/流

34、水号号,永不不重复卡代号cardCCodeechar(20)RY用于支付的的卡代号号（来自自CPRReq）交易流水号号seriaalNoochar(20)RY银行交易流流水号交易日期和和时间datechar(17)RYYYYYMMMDDD HH:MM:SSS 结果代码errorrCoddechar(4)RY成功SUCCC，失失败见错错误代码码错误描述errorrMesssaggechar(2566)ON消息扩展extennsioonON4.4单笔笔退款4.4.11业务功功能单笔退款是是在发生生在成功功充值之之后，将将该笔交交易充值值的款项项原路退退回到快快捷支付付签约银银行卡账账户中。充值退回

35、必须在商户核实之后，由商户发起。单笔退款交易为实时交易，即实时从商户结算账户扣取，入个人账户。4.4.22业务规规则充值退回业业务在执执行中需需要满足足以下约约束条件件：充值退回业业务从商商户发起起。充值退回业业务必须须有对应应成功的的支付交交易。原则上商户户可以针针对900天内的的支付交交易发起起充值退退回业务务。特殊殊商户可可另约定定。充值退回的的金额不不能超过过对应的的成功支支付交易易的金额额。针对一笔成成功的支支付充值值交易，可可以进行行多次退退回，但但退回的的总金额额不能大大于对应应该笔成成功支付付交易的的总金额额。退回的资金金只能原原路划回回签约银银行卡账账户中。商户结算账账户应保

36、保留足够够的退款款资金。同一退回订订单号银银行必须须保证只只能执行行一次。银行与商户户需要保保存单笔笔退回相相关报文文的日志志，作为为解决资资金清算算不一致致的凭据据。4.4.33处理流流程4.4.44交互模模式在单笔退款款业务中中，商户户与银行行通过请请求-应应答模式式交互。4.4.55报文格格式“单笔退款款”请求报报文SRRReqq(Siinglle RRefuund Reqquesst)中文域名对应DTDD元素类型出现要求签名要求说明版本号versiionchar(7)RN目前版本号号：”1.0.1”商户标识instIIdchar(15)RY报文发送方方的商户户标识订单号orderrNu

37、mmchar(30)RY该笔退款交交易的商商户订单单号,永永不重复复交易日期和和时间datechar(17)RYYYYYMMMDDD HH:MM:SS卡代号cardCCodeechar(20)RY鉴权时返回回的卡代代码手续费charggeLong(12)ON预留字段，见 HYPERLINK l _金额格式 金额格式说明交易金额amounntLong(12)RY见 HYPERLINK l _金额格式 金额格式式说明交易货币代代码curreencyychar(3)RY见 HYPERLINK l _卡通货币代码表 快捷支付付货币代代码表原订单号oldorrderrNummchar(30)RY对应原支

38、付付交易的的订单号号，永不不重复原交易日期期和时间间olddaatechar(8)RYYYYYMMMDDD经过Basse644处理的的商户证证书代码码KoalBB64CCertt/RN商户端读取取本地商商户证书书文件后后，再使使用上海海银行提提供的AAPI进进行Baase664编码码后产生生的商户户证书数数据字串串。消息扩展extennsioonON“单笔退款款”应答报报文SRRRess(Siinglle RRefuund Ressponnse)中文域名对应DTDD元素类型出现要求签名要求说明版本号versiionchar(7)RN目前版本号号：”1.0.1”商户标识instIIdchar(1

39、5)RY报文发送方方的商户户标识订单号orderrNummchar(30)RY商户退款订订单号,永不重重复，同同支付时时订单号号规制交易流水号号seriaalNoochar(20)RY银行交易流流水号交易日期和和时间datechar(17)RYYYYYMMMDDD HH:MM:SSS 卡代号cardCCodeechar(20)RY退款请求中中的卡代代码结果代码errorrCoddechar(4)RY成功SUCCC，失失败见错错误代码码错误描述errorrMesssaggechar(2566)ON消息扩展extennsioonON4.5批量量退款4.5.11业务功功能批量退款业业务必须须在商户户

40、核实之之后，由由商户发发起。商户以提供供批量充充值退回回指令文文件的方方式，请请求银行行执行批批量的退退回处理理，银行行以批量量退回处处理结果果文件的的形式，向向商户返返回处理理结果。4.5.22业务规规则充值退回业业务在执执行中需需要满足足以下约约束条件件：充值退回业业务从商商户发起起。充值退回业业务必须须有对应应成功的的支付交交易。原则上商户户可以针针对900天内的的支付交交易发起起充值退退回业务务。特殊殊商户可可另约定定。充值退回的的金额不不能超过过对应的的成功支支付交易易的金额额。针对一笔成成功的支支付充值值交易，可可以进行行多次退退回，但但退回的的总金额额不能大大于对应应该笔成成功支

41、付付交易的的总金额额。退回的资金金只能原原路划回回签约银银行卡账账户中。同一退回订订单号银银行必须须保证只只能执行行一次。银行与商户户需要保保存单笔笔退回相相关报文文的日志志，作为为解决资资金清算算不一致致的凭据据。批量充值退退回文件件中，每每一笔都都是按照照独立的的单笔指指令进行行处理。4.5.33处理流流程商户将符合合条件的的等待处处理的快快捷支付付充值退退回申请请汇总成成批量退退回指令令文件。文件的格式见快捷支付批量退回指令文件格式说明。该文件保存在商户文件服务器中。商户以唯一一的批量量退回文文件批次次号、快快捷支付付批量退退回指令令文件的的下载UURL、快快捷支付付批量退退回文件件上传

42、UURL等等要素为为参数，构构造“批量退退货”通知BBRNootiffy，以以单向通通知方式式发送给给银行。银行收到“批量退退货”通知BBRNootiffy之后后，从通通知中解解析出批批次号与与批量退退货指令令文件下下载URRL，并并使用该该URLL下载批批量退货货文件。如如果文件件当时下下载不成成功，银银行会有有恰当的的重试策策略。银行处理批批量退货货指令文文件。处处理的方方式是从从批量退退货文件件中解析析出每一一笔退货货指令进进行分别别处理。针针对每一一笔退货货的银行行内部处处理方式式与单笔笔退货相相同。每每一笔退退货的处处理结果果都记录录到批量量退货结结果文件件中。银行处理完完成后发发送

43、通知知报文告告知，商商户主动动发起下下载结果果文件,或者由由商户固固定时间间下载文文件也可可；考虑安全原原因，建建议哪方方生成的的文件存存放于哪哪方的sseveer，对对方可发发起下载载。4.5.44交互模模式银行发送通通知报文文告知，商商户主动动发起下下载结果果文件。注： 1、商商户生成成的批量量退款文文件必须须按约定定的格式式及压缩缩、加密密方式存存放。 并并应定义义下载的的URLL。 例例如3.5章章节文件件下载（银银行方UURL ） 4.5.55报文格格式“批量退货货”通知报报文BRRNottifyy(Baatchh Reefunnd NNotiify)批量退货通通知报文文BRNNot

44、iify是是商户向向银行发发起的通通知批量量退货文文件下载载请求。中文域名对应DTDD元素类型出现要求签名要求说明版本号versiionchar(7)RN目前版本号号：”1.0.1”商户标识instIIdchar(15)RY报文发送方方的商户户标识流水号orderrNummchar(30)RY订单号/流流水号,永不重重复，定义该批批次的退退款文件件。交易日期和和时间datechar(17)RYYYYYMMMDDD HH:MM:SS文件下载UURLdownUUrlChar(1000)RY商户发布的的退款文文件下载载URLL如，例如 HYPERLINK :80/file/download/ htt

45、p:/1:880/ffilee/doownlloadd/上海银行只只能支持持IP地地址，不不支持域域名；请商户在测测试和生生产前公公布，上上海银行行会在其其防火墙墙上做网网络绑定定文件名称fileNNameechar(30)RYBRF_yyyyyymmddd_ssequuencce.zzip（见见 HYPERLINK l _文件命名规范 文件命命名规范范），其其中yyyyymmmddd是本报报文的交交易日期期。文件摘要digesstchar(40)RY见 HYPERLINK l _文件摘要 文件摘要要经过Basse644处理的的商户证证书代码码KoalBB64CCertt

46、/RN商户端读取取本地商商户证书书文件后后，再使使用上海海银行提提供的AAPI进进行Baase664编码码后产生生的商户户证书数数据字串串。通知URLLnotiffyUrrlChar(1000)RY接收银行批批量退款款处理结结果通知知的URRL消息扩展ExtennsioonO“批量退货货结果”通知报报文BRRRNootiffy(BBatcch RRefuund Ressultt Nootiffy)批量退货结结果通知知报文BBRRNNotiify是是银行向向商户发发出的批批量退货货结果文文件通知知。中文域名对应DTDD元素类型出现要求签名要求说明版本号versiionchar(7)RN目前版本号

47、号：”1.0.1”商户标识instIIdchar(15)RY报文发送方方的商户户标识订单号orderrNummchar(30)RY银行产生的的批次流流水号交易日期和和时间datechar(17)RY银行处理的的日期和和时间YYYYMMMDDD HH:MM:SS文件下载UURLdownUUrlChar(1000)RY银行发布的的退款文文件下载载URLL见4.5 文件下下载（银银行端UURL）文件名称fileNNameechar(30)RYBRRF_yyyyymmmdd_seqquennce.zipp（见 HYPERLINK l _文件命名规范 文文件命名名规范），其其中yyyyymmmddd是本

48、报报文的交交易日期期。文件摘要digesstchar(40)RY见 HYPERLINK l _文件摘要 文件摘要要原流水号orginnalSSeriialNNochar(19)RY来自BRNNotiify中中批量退退货请求求流水号号原交易日期期origiinallDattechar(17)RYYYYYMMMDDD HH:MM:SS (来自自BRNNotiify中中批量退退货请求求交易日日期和时时间)消息扩展ExtennsioonO4.5.66文件格格式文件格式文件格式采采用 HYPERLINK /html/rfc4180 CSSV（CCommma-SSepaaratted Varriabble

49、）标准。批量退货指指令文件件格式(商户按按标准生生成 ，文文件名约约定为BBRF_yyyyymmmdd_seqquennce.zipp（见 HYPERLINK l _文件命名规范 文文件命名名规范）)批量退货指指令文件件由汇总总项与明明细项两两部分组组成。汇总项为文文件第一一行，其其中包含含以下各各项：中文名称出现要求备注总金额R格式见 HYPERLINK l _金额格式 金额额格式说说明总笔数R明细项从文文件第二二行开始始直到文文件结束束，其中中每一行行包含以以下各项项： 中文名称出现要求备注流水号（订订单号）R定义每笔交交易的退退款交易日期时时间RYYYYMMMDDD HH:MM:SS卡代

50、号R手续费O见 HYPERLINK l _金额格式 金额格式式说明(现在是是0)退货金额R见 HYPERLINK l _金额格式 金额格式式说明交易货币代代码R原流水号R支付流水号号原交易日期期R支付日期(YYYYYMMMDD)批量退货结结果文件件格式(银行按按标准生生成，文文件名约约定为BBRRF_yyyyyymmddd_ssequuencce.zzip（见见 HYPERLINK l _文件命名规范 文件命命名规范范）)批量退货结结果文件件由汇总总项与明明细项两两部分组组成。汇总项为文文件第一一行，其其中包含含以下各各项：中文名称出现要求备注处理成功总总金额R本批处理成成功的总总金额，格格式

51、见 HYPERLINK l _金额格式 金金额格式式说明处理成功总总笔数R本批处理成成功的总总笔数处理失败总总笔数R本批处理失失败的总总笔数明细项从文文件第二二行开始始直到文文件结束束，其中中每一行行包含以以下各项项：中文名称出现要求备注流水号（订订单号）R定义每笔交交易的退退款交易日期时时间RYYYYMMMDDD HH:MM:SS卡代码R手续费O见 HYPERLINK l _金额格式 金额格式式说明退货金额R见 HYPERLINK l _金额格式 金额格式式说明交易货币代代码R原流水号R批量退货文文件中原原流水号号原交易日期期R批量退货文文件中原原交易日日期(YYYYYYMMDDD)处理状态

52、RY 成功；N 失失败失败原因R如果处理状状态为失失败，则则描述失失败的原原因。4.6单笔笔交易明明细查询询4.6.11业务功功能由商户发起起，向银银行查询询某一订单单号的交交易状态态。当由于网络络或系统统故障产产生掉单单（商户户发出了了快捷支支付请求求报文，但但没有收收到银行行的应答答报文）时时，商户户可以使使用该交交易得到到银行的的交易状状态，继继而对商商户端的的指令进进行恢复复处理。4.6.22业务规规则该交易在执执行中需需要满足足以下约约束条件件：可查询银行行开通的的各类交交易状态态，如支支付、退退款。银行端返回回的状态态包括成成功、失失败、处处理中。其其中成功功代表账账务处理理成功、

53、失失败代表表账务处处理失败败、处理理中代表表账务未未明需晚晚间批量量对账后后产生结结果。查询条件中中订单号号为必须须字段。4.6.33处理流流程4.6.44交互模模式在交易明细细查询业业务中，商商户与银银行通过过请求-应答模模式交互互。商户作为服服务使用用者向银银行发送送 “查询”请求报报文SQReeq，银银行作为为服务提提供者向向商户返返回查询询应答报报文SQRees。4.6.55报文格格式“查询”请请求报文文SQReeq (Sinnglee Queery Reqquesst)查询请求报报文SQReeq是商商户向银银行发起起的交易易明细查查询请求求。中文域名对应DTDD元素类型出现要求签名要

54、求说明版本号versiionchar(7)RN目前版本号号：”1.0.1”商户标识instIIdchar(15)RY报文发送方方的商户户标识流水号seriaalNoochar(19)RY该笔查询交交易的流流水号交易日期和和时间datechar(17)RYYYYYMMMDDD HH:MM:SS交易性质typechar(1)RY0全部; 1支付付; 22退款 3;提提现订单号orderrNummchar(30)RY需要查询订订单号经过Basse644处理的的商户证证书代码码KoalBB64CCerttRN商户端读取取本地商商户证书书文件后后，再使使用上海海银行提提供的AAPI进进行Baase664

55、编码码后产生生的商户户证书数数据字串串。消息扩展extennsioonON“查询”应应答报文文SQRees (Sinnglee Queery Ressponnse)中文域名对应DTDD元素类型出现要求签名要求说明版本号versiionchar(7)RN目前版本号号：”1.0.1”商户标识instIIdchar(15)RY报文发送方方的商户户标识流水号seriaalNoochar(19)RY该笔查询交交易的流流水号交易日期和和时间datechar(17)RYYYYYMMMDDD HH:MM:SS被查询订单单的交易易日期和和时间交易性质typechar(1)RY0全部; 1支付付; 22退款 3;

56、提提现订单号orderrNummchar(30)RY需要查询订订单号交易状态statuuschar(4)RY交易状态0000：成功，0001：失败，0002：银行处处理中，0003：银行查查无此订订单。订单失败原原因orderrRemmakchar(1000)CN订单失败原原因支付卡号cardNNochar(45)CN交易卡号交易金额amounntchar (122)CN见 HYPERLINK l _金额格式 金额格式式说明手续费charggechar (122)ON手续费见 HYPERLINK l _金额格式 金金额格式式说明交易卡种cardTTypeeChar(1)CN交易卡种11借记卡卡

57、 2贷贷记卡 结果代码errorrCoddechar(4)RY成功SUCCC，其其他表示示失败，详详见 HYPERLINK l _错误代码 错误误代码此项为描述述请求报报文本身身的对错错错误描述errorrMesssaggechar(2566)ON消息扩展extennsioonON4.7批量量交易查查询4.7.11业务功功能由商户发起起，向银银行查询询某一时时间段的的所有订订单的交交易状态态。当由于网络络或系统统故障产产生掉单单（商户户发出了了快捷支支付请求求报文，但但没有收收到银行行的应答答报文）时时，商户户可以使使用该交交易得到到银行的的交易状状态，继继而对商商户端的的指令进进行恢复复处理

58、。4.7.22业务规规则该交易在执执行中需需要满足足以下约约束条件件：可查询银行行开通的的各类交交易状态态，如支支付、退退款。银行端返回回的状态态包括成成功、失失败、处处理中。其其中成功功代表账账务处理理成功、失失败代表表账务处处理失败败、处理理中代表表账务未未明需晚晚间批量量对账后后产生结结果。查询条件中中订单号号为必须须字段。查询时间段段需不大大于155分钟。4.7.33处理流流程4.7.44交互模模式在交易明细细查询业业务中，商商户与银银行通过过请求-应答模模式交互互。商户作为服服务使用用者向银银行发送送 “查询”请求报报文TQQReqq，银行行作为服服务提供供者向商商户返回回查询应应答

59、报文文TQRRes。4.7.55报文格格式“查询”请请求报文文TQRReq (Trradee Quueryy Reequeest)查询请求报报文TQQReqq是商户户向银行行发起的的交易明明细查询询请求。中文域名对应DTDD元素类型出现要求签名要求说明版本号versiionchar(7)RN目前版本号号：”1.0.1”商户标识instIIdchar(15)RY报文发送方方的商户户标识流水号seriaalNoochar(19)RY该笔查询交交易的流流水号交易日期和和时间datechar(17)RYYYYYMMMDDD HH:MM:SS交易性质typechar(1)RY0全部; 1支付付; 22退

60、款 查询起始时时间beginnDattechar(17)RYYYYYMMMDDD HH:MM:SS查询截止时时间endDaatechar(17)RYYYYYMMMDDD HH:MM:SS订单号列表表checkkSerriallNoLListtRN需要查询的的订单号号列表，包包含多个个信息就指订单号号;多个个订单号号之间请请用“|”分隔；订单最多支支持100笔;查询的多条条订单只只返回符符合条件件的记录录。经过Basse644处理的的商户证证书代码码KoalBB64CCertt/RN商户端读取取本地商商户证书书文件后后，再使使用上海海银行提提供的AAPI进进行Baase664编码码后产生生的商户