某银行快捷支付接口规范

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

2、敦迪删除快捷捷支付业业务概述述；调整整错误代代码；重重定义身身份鉴权权报文头头；删除除单笔提提现接口口；删除除批量交交易明细细查询，新增单单笔交易易明细查查询黄敦迪20122-6-133.0黄敦迪增加批量量交易明明细查询询，修改改错误代代码黄敦迪20133-3-113.1黄敦迪修改身份份鉴权、网上支支付、单单笔退款款、批量量退款接接口，加加入了卡卡代号等等20133-3-123.2黄敦迪鉴权需中中账户姓姓名改为为必输20133-4-113.3黄敦迪接口实现现说明中中批量交交易查询询改为非非必须实实现的接接口。批批量交易易查询请请求报文文中加入入订单号号列表20133-4-193.4彭小波修改身

3、份份鉴权接接口，CCVV22、有效效期改为为可选字字段，增增加KooalBB64CCertt;修改网网上支付付接口CCVV22、有效效期改为为可选字字段，返返回报文文银行卡卡改为卡卡代号，黄敦迪20133-4-223.5.1彭小波批量交易易查询增增加爱业业务规则则：订单最多多支持110笔;查询的多多条订单单只返回回符合条条件的记记录。20133-4-283.5.2彭小波为单笔退退款增加加错误代代码：44045520133-5-23.5.3黄敦迪单笔交易易明细查查询应答答报文中中staatuss枚举值值调整及及定义eerroorCoode的的取值；批量交交易查询询应答报报文TrradeeInff

4、o清单单中的ssignnNo改改为caardNNo20133-5-113.5.4彭小波错误码不不再分类类别扩展鉴权权的证件件类别鉴权中增增加校验验规则，手机号号码必须须为111位明确单笔笔订单查查询中的的交易日日期和时时间20133-5-173.5.5彭小波调整错误误码描述述：30066 对应描描述改为为卡号不不存在或或不支持持的银行行卡30166 对对应描述述改为银银行账户户交易失失败批量交易易查询的的交易状状态进行行调整：00000 成功功；00001失失败20133-5-183.5.6彭小波30033的errrorrmesssagge从“身份证证号码不不匹配”改为“身份证证件号码码不匹配

5、配”20133-5-213.5.7彭小波针对信用用卡的CCVV22和有效效期，增增加对应应的错误误码：330500和3005120133-5-243.5.8彭小波身份鉴权权增加业业务逻辑辑：CVVV2和和有效期期需同时时输入或或同时都都不输入入20133-5-243.5.9彭小波网上支付付去除：CVVV2和有有效期20133-5-273.6黄敦迪删除二级级商户信信息同步步接口，增加单单笔撤消消接口20133-6-203.6.1彭小波批量交易易查询响响应报文文中交易易信息列列表trradeeInffoLiist 签名要要求由”Y”变更为为”N”20133-6-263.6.2彭小波新增错误误码：4

6、40466清算的的订单不不能做撤撤销处理理20133-6-273.6.3彭小波银行流水水号由ccharr(199)统一一更改为为chaar(220),修改点点：网上上支付、单笔退退款、单单笔撤消消20133-6-273.6.4彭小波清算对账账中文件件格式中中银行卡卡号修正正为银行行卡代号号20133-7-13.6.5彭小波单笔撤消消上送报报文增加加交易金金额，同同时增加加校验：交易金金额必须须和原订订单交易易金额一一致20133-7-23.6.6彭小波清算对账账增加业业务规则则：信用用卡撤消消及对应应原订单单不在清清算对账账文件内内。20133-7-5报文结构构上海银行行快捷支支付报文文规范规

7、规定了上上海银行行与商户户之间交交换报文文的处理理规范。报文结构构快捷支付付报文统统一采用用xmll格式。所有的的快捷支支付报文文均以BBankksh作作为根元元素，每每个Baankssh元素素中可以以包含多多个Meessaage元元素。Messsagee元素中中包含代代表具体体的业务务的元素素，比如如CSVVReqq、CSSVRees等。每个业业务元素素由一系系列属性性元素构构成，不不同的业业务元素素中包含含的属性性元素有有所不同同。对于涉及及到签约约状态修修改或者者资金变变动的业业务元素素，必须须要有与与之匹配配的Siignaaturre元素素进行数数字签名名。作为约定定，Baankssh

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

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

10、于请请求-应应答交互互模式，由服务务提供者者向服务务使用者者返回。服务应应答类报报文的命命令规范范是XXXRess，其中中XX是是报文代代表的业业务的首首字母缩缩略，RRes是是Ressponnse的的缩写。比如对对于支付付应答报报文，命命名为CCPRees，代代表Caard Payymennt RRespoonsee。通知类报报文通知类报报文用于于单向通通知交互互模式，由通知知发送者者向通知知接收者者发送。通知类类报文的的命令规规范是XXXNootiffy，其其中XXX是报文文代表的的业务的的首字母母缩略。通用报文文有两种通通用报文文，一种种是Errrorr报文，用于返返回处理理错误；另一种

11、种是NootiffyAccceppt，代代表单向向通知已已被接受受。通用报文文错误代码码银行返回回的错误误代码说说明：错误代码码错误描述述解释00000无效的根根元素根元素无无法识别别00011未定义的的消息域域消息不是是CSRReq、CSRRes等等；或者者消息发发送给了了一个错错误的组组件00022必填域缺缺失00033根据规范范，一个个或多个个域不符符合格式式要求例如，非非数字，或者不不是有效效的日期期格式等等等。00044商户标识识不正确确insttId域域中的商商户标识识不正确确00055签名无效效报文签名名校验不不通过00066验证证书书有效性性失败商户证书书过期或或失效10000

12、文件格式式不正确确商户批处处理业务务上传文文件不正正确10011文件不存存在下载文件件时，找找不到指指定的文文件10022文件已处处理对于不允允许重复复处理的的业务的的文件，如果已已处理过过，就发发生此错错误10033文件无法法解压缩缩上传的文文件无法法正确解解压缩10044文件摘要要不正确确文件上传传通知报报文中的的文件摘摘要不正正确20011支付流水水重复重复的网网上支付付流水20022原支付流流水不存存在申请退货货的原支支付流水水不存在在20033查询范围围太大查询时间间跨度太太大20044退款订单单日期错错误退款订单单日期小小于原订订单日期期20055当日撤销销必须为为全额退退款业务要

13、求求：当日日撤销必必须为全全额30011真实姓名名不正确确真实姓名名与商户户端登记记的不一一致30022证件类型型不正确确证件类型型与商户户端登记记的不一一致30033身份证件件号码不不匹配身份证件件号码与与商户端端登记的的身份证证件号码码不匹配配30044手机号不不匹配30055不支持的的银行卡卡类型30066卡号不存存在或不不支持的的银行卡卡30077未鉴权的的银行卡卡未做过鉴鉴权的银银行卡（卡代号号不存在在时）30088认证信息息不匹配配认证信息息与商户通过过认证的的信息不不匹配30099银行卡状状态不正正确银行卡状状态不正正确30111原支付申申请流水水不存在在支付申请请流水不不存在（

14、用于退退款）30133金额超限限支付金额额超过每每日限额额（退款款时超出出原订单单金额也也用这个个）30144余额不足足银行账户户中的余余额不足足以完成成支付30155银行交易易处理中中该笔交易易在银行行前置系系统中状状态未知知30166银行账户户交易失失败银行系统统的错误误返回。30500有效期错错误或卡卡已过期期对信用卡卡有效期期的校验验，信用用卡有效效期输错错，或信信用卡已已过有效效期30511CVV22错误信用卡CCVV22的校验验40455未清算的的订单不不能做退退款处理理不支持当当日退款款40011快捷支付付渠道关关闭没有开通通快捷支支付业务务40022服务没有有开通请求的业业务没

15、有有开通40466清算的订订单不能能做撤销销处理清算的订订单不允允许做撤撤销处理理90000暂时系统统异常通用性错错误NotiifyAAcceept报报文功能用来代表表单向通通知已被被接受。消息域下表列举举了消息息域的定定义中文域名名对应DTTD元素素类型出现要求求签名要求求说明版本号verssionncharr(7)RN目前版本本号：”1.0.1”商户标识识insttIdcharr(155)RY报文发送送方的商商户标识识流水号ordeerNuumcharr(300)RY原商户提提交的信信息流水水号交易日期期和时间间dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS结

16、果代码码erroorCoodecharr(4)RYSUCCC表示成成功其他均为为失败错误描述述erroorMeessaagecharr(2556)ON消息扩展展exteensiionON报文的解解析与传传输快捷支付付报文的的传输使使用HTTTP(S)方方式，在在HTTTP请求求/响应应体中包包含XMML形式式的报文文。报文解析析对XMLL解析的的基本要要求如下下：版本号检检查用于表示示组件支支持的协协议版本本号。消消息版本本号必须须表示为为：n+.n+.nn+ ，其中“nn” 表表示数字字，“+” 表示示一个或或多个。比如11.0或或1.00.1。在所有有的消息息中，各各组件都都必须填填写自身

17、身支持的的协议版版本号。消息版版本号不不能低于于1.00.1。xml解解析为了可以以支持后后续协议议版本，xmll解析的的实现不不要做严严格的验验证。特特别是需需要忽略略未被确确认的域域。所有有xmll消息必必须用“utff-8”编码。Messsagee域之iid属性性匹配请求和应应答报文文的Meessaage域域之idd属性必必须相同同，idd是请求求方生成成的唯一一序列号号。比如如：银行行在CSSReqq的Meessaage域域设置了了一个iid属性性值，则则商户在在CSRRes里里面的MMesssagee域的iid属性性必须和和CSRReq的的Messsagge域之之id值值相同。报文传

18、输输对HTTTPS传传输的基基本要求求如下：使用POOST发发送消息息消息请求求基于HHTTPP/HTTTPSS的POOST方方式。HTTPP消息头头要求HTTPP请求与与响应消消息中必必须按照照如下要要求设置置头部域域：Conntennt-LLenggth:必须设设置成消消息体的的长度Conntennt-TTypee:必必须设置置下面的的值：aappllicaatioon/xxml; chharsset=utff-8文件交换换规范文件命名名规范文件命名名规范对对文件名名称进行行统一的的规划，以达到到从文件件名称上上区分不不同业务务文件的的目的。文件命命名规范范：fiilettypee_yyy

19、yymmmddd_seequeencee.ziip，其其中：fileetyppe文件类类型，如如：BRRF 批量量退款文文件；BBRRFF-批量量退款结结果文件件；CCCF清算对对账文件件； IINFOO- 商商户信息息文件；yyyyymmddd文件业业务日sequuencce批次号号， 以以01，02，03递递增，与与商户一一般1天天交互一一次，故故批次号号固定为为“01”例如：CCF_2011002222_01.zipp （清算算对账文文件）文件压缩缩传输前需需要压缩缩成ziip格式式。文件加密密对压缩后后的文件件，需要要加密之之后再传传输。加加密时采采用三重重DESS对称加加密算法法3D

20、EES。加加密密钥钥按事先先约定方方式分发发。文件摘要要对加密后后的文件件进行摘摘要。摘摘要算法法使用标标准SHHA1算算法，结结果表示示成400位166进制大大写字母母数字串串。在商户往往银行发发送文件件下载请请求时需需对若干干域进行行摘要，具体可可参考文文件下载载章节描描述；在银行往往商户反反馈文件件时，需需对文件件进行摘摘要，文文件摘要要商户可从从 htttpss的reespoonsee的heead域域里面的的Bannkshha1域域的值获获取摘要要，从BBankksiggn域的的值获取取签名。文件下载载（银行行端URRL）文件采用用商户主主动请求求从银行行文件服服务下载载的方式式。例如

21、银行行文件服服务的UURL格格式如下下： htttp(ss):/m/booscaartooon/exppresss.ddo?iinsttId=1000011198 &acctioontyype=dowwnlooad&datte=22010002004&ffineenamme=SSCF_2011002222_01.zipp&KoaalB664Ceert=xxxxxxxx &ssignn=xxxxxxxx，其其中：httpp(s):/epaay.bbankkofsshannghaai.ccom/bosscarrtooon/eexprresss.doo银行行文件系系统的根根路径。actiiontty

22、pee操作作类型（如：uuplooad表表示上传传、doownlloadd表示下下载）。insttId商户户标识。 datee 交易日日期yyyyymmmddd。fileenamme遵循业业务文件件命名规规范的文文件名。KoallB644Cerrt商户公公钥Baase664位编编码signn使用用cerrtIdd指定的的证书对对“acttionntyppe|iinsttId|datte|ffileenamme”进行签名名，对签签名结果进进行Baase664编码码获得的的字符串串,详情情见签名名规范。文件下载载失败hhttpp状态码码1、4006：商商户标识识不匹配配2、4005：操操作类型型不

23、正确确3、4220：银银行端验验签失败败4、4004：请请求文件件名不存存在5、4009：请请求文件件格式不不正确接口实现现规范接口实现现说明序号接口类型型交易类型型描述必须1身份鉴权权实时商户发起起的实名名签约验验证Y2网上支付付实时Y3单笔退款款实时Y4批量退款款批量N5单笔交易易明细查查询实时Y6批量交易易查询实时N7清算对帐帐批量Y8单笔撤消消实时N4.2身身份鉴权权4.2.1业务务功能银行接收收商户要要求身份份鉴权的的交易请请求，必必须包含含客户卡卡号、客客户姓名名、客户户证件类类型、客客户证件件号码、手机号号码等信信息，银银行核对对卡号对对应的信信息与客客户提供供的信息息一致型型，

24、如一一致反馈馈匹配，否则反反馈不匹匹配。4.2.2业务务规则由于快捷捷支付的的签约是是在商户户端完成成的，银银行只是是提供身身份鉴权权，协助助商户验验证信息息的匹配配性。商商户必须须为客户户身份验验证承担担责任，确保是是持卡人人本人，银行不不承担责责任。快捷支付付签约用用户的必必须持有有手机，且手机机号为用用户在银银行端开开卡时所所登记的的手机号号。银行身份份鉴权，暂定为为核对卡卡对应的的客户姓姓名、证证件类型型、证件件号码、手机号号码，可可根据实实际情况况调整。建议商户户在快捷捷支付签签约成功功后发手手机短信信通知客客户。4.2.3交互互模式在身份鉴鉴权业务务中，商商户与上上海银行行通过请请

25、求-应应答模式式交互。商户作为为服务使使用者向向银行发发送 “身份鉴鉴权申请请”报文IIAReeq，银银行作为为服务提提供者向向商户返返回“签约应应答”报文IIARees。涉及到以以下交互互：商户将数数据发送送到银行行的身份份鉴权服服务接口口，商户户需调用用银行AAPI利利用数字字证书进进行加密密，签名名。（见 HYPERLINK l _证书存取规范 数字签签名）银行端校校验通过过核实客客户信息息，并在在同一个个连接中中返回IIARees报文文告诉银银行商户户验证情情况。银银行会对对返回数数据进行行加密，签名。商户端接接口银行行应答报报文后，验签、解析报报文后做做后续处处理。4.2.4报文文格

26、式鉴权请求求报文IIAReeq（IIdenntitty AAuthhentticaatioon RRequuestt）IAReeq是从从商户向向银行发发起的签签约请求求报文。中文域名名对应DTTD元素素类型出现要求求签名要求求说明版本号verssionncharr(7)RN目前版本本号：”1.0.1”商户标识识insttIdcharr(155)RY由银行分分配固定定值,请请求报文文中需填填写交易日期期和时间间dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS客户姓名名nameecharr(300)RY签约银行行卡号carddNocharr(200)RY签约银行行卡类型

27、型carddTyppecharr(1)RY1借记卡卡 2贷贷记卡 证件类型型certtTyppecharr(1)RY1：身份份证；2：护照照；3：军官官证；4：士兵兵证；5：户口口本；6：警官官证；7：台胞胞证证件号码码certtNocharr(300)RY手机号mobiilePPhonneCharr(200)RY持卡人在在银行留留的手机机号手机号必必须为111位CVV22cvv22Charr(3)ON卡背面签签名栏的的后三位位数字CVV22和有效效期需同同时输入入或同时时都不输输入有效期valiidittyCharr(4)ONMMYYYCVV22和有效效期需同同时输入入或同时时都不输输入经过

28、Baase664处理理的商户户证书代代码KoallB644Cerrt/RN商户端读读取本地地商户证证书文件件后，再再使用上上海银行行提供的的APII进行Baase664编码码后产生生的商户户证书数数据字串串。消息扩展展exteensiionON签约应答答报文IIARRess（Iddenttityy Auutheentiicattionn Reespoonsee）IARRRes银银行返回回给商户户的应答答。中文域名名对应DTTD元素素类型出现要求求签名要求求说明版本号verssionncharr(7)RN目前版本本号：”1.0.1”商户标识识insttIdcharr(155)RY报文发送送方的商

29、商户标识识银行卡号号carddNocharr(200)RY银行卡代代码carddCoddeCharr(200)RY唯一区分分银行卡卡代码交易日期期和时间间dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS结果代码码erroorCoodecharr(4)RY成功SUUCC，失败见见错误代代码错误描述述erroorMeessaagecharr(2556)ON消息扩展展exteensiionON4.3网网上支付付4.3.1业务务功能商户负责责验证客客户持卡卡人身份份与服务务权限，并请求求银行划划拨客户户的资金金用于互互联网交交易的支支付；银银行负责责验证由由商户发出出的支付

30、付指令是是否在快快捷支付付签约的的业务范范围与银银行控制制的快捷捷支付支支付限额额内，并并实时扣扣减签约约银行卡卡内的余余额。由于网上上支付引引起的银银行与商商户间的的资金清清算方法法由快捷捷支付清清算标准准规定。4.3.2业务务规则该交易在在执行中中需要满满足以下下约束条条件：支付必须须由客户户请求，从合作作商户发发起（可可以网上上、网点点等渠道道）。商户控制制支付的的资金只只能从快快捷支付付签约时时确定的的签约银银行卡账账户中支支出。银行端做做无磁无无密交易易。支付时客客户在签签约银行行卡账户户中的资资金只能能转移到到商户指指定的清清算账户户中。同一支付付订单号号的支付付交易，银行端端限定

31、只只能执行行一次，永不重重复。银行与商商户需要要保存支支付相关关报文的的日志作作为解决决资金清清算不一一致的依依据。4.3.3处理理流程4.3.4交互互模式在支付业业务中，商户与与银行通通过请求求-应答答模式交交互。商户作为为服务使使用者向向银行发发送 “支付”请求报报文CPPReqq，银行行作为服服务提供供者向商商户返回回“网上支支付”应答报报文CPPRess。4.3.5报文文格式“网上支支付”请求报报文CPPReqq(Caard Payymennt RRequuestt)网上支付付报文请请求CPPReqq(Caard Payymennt RRequuestt) 是是从商户户向银行行发起的的

32、支付请请求。中文域名名对应DTTD元素素类型出现要求求签名要求求说明版本号verssionncharr(7)RN目前版本本号：”1.0.1”商户标识识insttIdcharr(155)RY报文发送送方的商商户标识识二级商户户代码twoIIdcharr(155)CN二级商户户代码适用于有有些商户户需银行行在账单单或明细细查询中中显示其其平台的的二级商商户名称称订单号ordeerNuumcharr(300)RY商户支付付订单号号/流水水号,永永不重复复交易日期期和时间间dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS卡代号carddCoddecharr(200)RY鉴权

33、时返返回的卡卡代码手续费charrgeLongg(122)ON预留字段段，见 HYPERLINK l _金额格式 金额格格式说明明交易金额额amouuntLongg(122)RY见 HYPERLINK l _金额格式 金额格格式说明明交易货币币代码currrenccycharr(3)RY见 HYPERLINK l _卡通货币代码表 快捷支支付货币币代码表表经过Baase664处理理的商户户证书代代码KoallB644Cerrt/RN商户端读读取本地地商户证证书文件件后，再再使用上上海银行行提供的的APII进行Baase664编码码后产生生的商户户证书数数据字串串。消息扩展展exteensiio

34、nON“网上支支付”应答报报文CPPRess(Carrd PPaymmentt Reespoonsee)网上支付付应答报报文CPPRess是银行行返回给给商户CCPReeq的应应答。中文域名名对应DTTD元素素类型出现要求求签名要求求说明版本号verssionncharr(7)RN目前版本本号：”1.0.1”商户标识识insttIdcharr(155)RY报文发送送方的商商户标识识订单号ordeerNuumcharr(300)RY商户支付付订单号号/流水水号,永永不重复复卡代号carddCoddecharr(200)RY用于支付付的卡代代号（来来自CPPReqq）交易流水水号seriialNN

35、ocharr(200)RY银行交易易流水号号交易日期期和时间间dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS结果代码码erroorCoodecharr(4)RY成功SUUCC，失败见见错误代代码错误描述述erroorMeessaagecharr(2556)ON消息扩展展exteensiionON4.4单单笔退款款4.4.1业务务功能单笔退款款是在发发生在成成功充值值之后，将该笔笔交易充充值的款款项原路路退回到到快捷支支付签约约银行卡卡账户中中。充值值退回必必须在商商户核实实之后，由商户户发起。单笔退退款交易易为实时时交易，即实时时从商户户结算账账户扣取取，入个个人

36、账户户。4.4.2业务务规则充值退回回业务在在执行中中需要满满足以下下约束条条件：充值退回回业务从从商户发发起。充值退回回业务必必须有对对应成功功的支付付交易。原则上商商户可以以针对990天内内的支付付交易发发起充值值退回业业务。特特殊商户户可另约约定。充值退回回的金额额不能超超过对应应的成功功支付交交易的金金额。针对一笔笔成功的的支付充充值交易易，可以以进行多多次退回回，但退退回的总总金额不不能大于于对应该该笔成功功支付交交易的总总金额。退回的资资金只能能原路划划回签约约银行卡卡账户中中。商户结算算账户应应保留足足够的退退款资金金。同一退回回订单号号银行必必须保证证只能执执行一次次。银行与商

37、商户需要要保存单单笔退回回相关报报文的日日志，作作为解决决资金清清算不一一致的凭凭据。4.4.3处理理流程4.4.4交互互模式在单笔退退款业务务中，商商户与银银行通过过请求-应答模模式交互互。4.4.5报文文格式“单笔退退款”请求报报文SRRReqq(Siinglle RRefuund Reqquesst)中文域名名对应DTTD元素素类型出现要求求签名要求求说明版本号verssionncharr(7)RN目前版本本号：”1.0.1”商户标识识insttIdcharr(155)RY报文发送送方的商商户标识识订单号ordeerNuumcharr(300)RY该笔退款款交易的的商户订订单号,永不重重

38、复交易日期期和时间间dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS卡代号carddCoddecharr(200)RY鉴权时返返回的卡卡代码手续费charrgeLongg(122)ON预留字段段，见 HYPERLINK l _金额格式 金额格格式说明明交易金额额amouuntLongg(122)RY见 HYPERLINK l _金额格式 金额格格式说明明交易货币币代码currrenccycharr(3)RY见 HYPERLINK l _卡通货币代码表 快捷支支付货币币代码表表原订单号号oldoordeerNuumcharr(300)RY对应原支支付交易易的订单单号，

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

40、155)RY报文发送送方的商商户标识识订单号ordeerNuumcharr(300)RY商户退款款订单号号,永不不重复，同支付付时订单单号规制制交易流水水号seriialNNocharr(200)RY银行交易易流水号号交易日期期和时间间dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS卡代号carddCoddecharr(200)RY退款请求求中的卡卡代码结果代码码erroorCoodecharr(4)RY成功SUUCC，失败见见错误代代码错误描述述erroorMeessaagecharr(2556)ON消息扩展展exteensiionON4.5批批量退款款4.5.1

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

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

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

44、都记录到到批量退退货结果果文件中中。银行处理理完成后后发送通通知报文文告知，商户主主动发起起下载结结果文件件,或者者由商户户固定时时间下载载文件也也可；考虑安全全原因，建议哪哪方生成成的文件件存放于于哪方的的sevver，对方可可发起下下载。4.5.4交互互模式银行发送送通知报报文告知知，商户户主动发发起下载载结果文文件。注： 11、商户户生成的的批量退退款文件件必须按按约定的的格式及及压缩、加密方方式存放放。 并应定定义下载载的URRL。 例如33.5章章节文件件下载（银行方方URLL ）4.5.5报文文格式“批量退退货”通知报报文BRRNottifyy(Baatchh Reefunnd N

45、Notiify)批量退货货通知报报文BRRNottifyy是商户户向银行行发起的的通知批批量退货货文件下下载请求求。中文域名名对应DTTD元素素类型出现要求求签名要求求说明版本号verssionncharr(7)RN目前版本本号：”1.0.1”商户标识识insttIdcharr(155)RY报文发送送方的商商户标识识流水号ordeerNuumcharr(300)RY订单号/流水号号,永不不重复，定义该该批次的的退款文文件。交易日期期和时间间dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS文件下载载URLLdownnUrllCharr(1000)RY商户发布布的退款款

46、文件下下载URRL如，例如如 HYPERLINK :80/file/download/ httpp:/17:80/fille/ddownnloaad/上海银行行只能支支持IPP地址，不支持持域名；请商户在在测试和和生产前前公布，上海银银行会在在其防火火墙上做做网络绑绑定文件名称称fileeNammecharr(300)RYBRF_yyyyymmmdd_seqquennce.zipp（见 HYPERLINK l _文件命名规范 文文件命名名规范），其中中yyyyymmmdd是是本报文文的交易易日期。文件摘要要digeestcharr(400)RY见 HYPERLINK l _文件摘要 文件摘摘要

47、经过Baase664处理理的商户户证书代代码KoallB644Cerrt/RN商户端读读取本地地商户证证书文件件后，再再使用上上海银行行提供的的APII进行Baase664编码码后产生生的商户户证书数数据字串串。通知URRLnotiifyUUrlCharr(1000)RY接收银行行批量退退款处理理结果通通知的UURL消息扩展展ExteensiionO“批量退退货结果果”通知报报文BRRRNootiffy(BBatcch RRefuund Ressultt Nootiffy)批量退货货结果通通知报文文BRRRNottifyy是银行行向商户户发出的的批量退退货结果果文件通通知。中文域名名对应DTT

48、D元素素类型出现要求求签名要求求说明版本号verssionncharr(7)RN目前版本本号：”1.0.1”商户标识识insttIdcharr(155)RY报文发送送方的商商户标识识订单号ordeerNuumcharr(300)RY银行产生生的批次次流水号号交易日期期和时间间dateecharr(177)RY银行处理理的日期期和时间间YYYYYMMDDDHHH:MMM:SSS文件下载载URLLdownnUrllCharr(1000)RY银行发布布的退款款文件下下载URRL见4.55 文件件下载（银行端端URLL）文件名称称fileeNammecharr(300)RYBRRFF_yyyyymmm

49、ddd_seequeencee.ziip（见见 HYPERLINK l _文件命名规范 文件命命名规范范），其其中yyyyymmmddd是本报报文的交交易日期期。文件摘要要digeestcharr(400)RY见 HYPERLINK l _文件摘要 文件摘摘要原流水号号orgiinallSerriallNocharr(199)RY来自BRRNottifyy中批量量退货请请求流水水号原交易日日期origginaalDaatecharr(177)RYYYYYYMMDDDHHH:MMM:SSS (来来自BRRNottifyy中批量量退货请请求交易易日期和和时间)消息扩展展ExteensiionO4.

50、5.6文件件格式文件格式式文件格式式采用 HYPERLINK /html/rfc4180 CCSV（Commma-Sepparaatedd Vaariaablee）标准。批量退货货指令文文件格式式(商户户按标准准生成 ，文件件名约定定为BRRF_yyyyyymmddd_ssequuencce.zzip（见 HYPERLINK l _文件命名规范 文件件命名规规范）)批量退货货指令文文件由汇汇总项与与明细项项两部分分组成。汇总项为为文件第第一行，其中包包含以下下各项：中文名称称出现要求求备注总金额R格式见 HYPERLINK l _金额格式 金金额格式式说明总笔数R明细项从从文件第第二行开开始直

51、到到文件结结束，其其中每一一行包含含以下各各项：中文名称称出现要求求备注流水号（订单号号）R定义每笔笔交易的的退款交易日期期时间RYYYYYMMDDDHHH:MMM:SSS卡代号R手续费O见 HYPERLINK l _金额格式 金额格格式说明明(现在在是0)退货金额额R见 HYPERLINK l _金额格式 金额格格式说明明交易货币币代码R原流水号号R支付流水水号原交易日日期R支付日期期(YYYYYMMMDDD)批量退货货结果文文件格式式(银行行按标准准生成，文件名名约定为为BRRF_yyyyyymmddd_ssequuencce.zzip（见 HYPERLINK l _文件命名规范 文件件命

52、名规规范）)批量退货货结果文文件由汇汇总项与与明细项项两部分分组成。汇总项为为文件第第一行，其中包包含以下下各项：中文名称称出现要求求备注处理成功功总金额额R本批处理理成功的的总金额额，格式式见 HYPERLINK l _金额格式 金额额格式说说明处理成功功总笔数数R本批处理理成功的的总笔数数处理失败败总笔数数R本批处理理失败的的总笔数数明细项从从文件第第二行开开始直到到文件结结束，其其中每一一行包含含以下各各项：中文名称称出现要求求备注流水号（订单号号）R定义每笔笔交易的的退款交易日期期时间RYYYYYMMDDDHHH:MMM:SSS卡代码R手续费O见 HYPERLINK l _金额格式 金

53、额格格式说明明退货金额额R见 HYPERLINK l _金额格式 金额格格式说明明交易货币币代码R原流水号号R批量退货货文件中中原流水水号原交易日日期R批量退货货文件中中原交易易日期(YYYYYMMMDD)处理状态态RY 成功功；N 失败失败原因因R如果处理理状态为为失败，则描述述失败的的原因。4.6单单笔交易易明细查查询4.6.1业务务功能由商户发发起，向向银行查查询某一一订单号号的交易易状态。当由于网网络或系系统故障障产生掉掉单（商商户发出出了快捷捷支付请请求报文文，但没没有收到到银行的的应答报报文）时时，商户户可以使使用该交交易得到到银行的的交易状状态，继继而对商商户端的的指令进进行恢复

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

55、格式“查询”请求报报文SQReeq (SinngleeQueery Reqquesst)查询请求求报文SSQReeq是商商户向银银行发起起的交易易明细查查询请求求。中文域名名对应DTTD元素素类型出现要求求签名要求求说明版本号verssionncharr(7)RN目前版本本号：”1.0.1”商户标识识insttIdcharr(155)RY报文发送送方的商商户标识识流水号seriialNNocharr(199)RY该笔查询询交易的的流水号号交易日期期和时间间dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS交易性质质typeecharr(1)RY0全部; 1支支付; 2

56、退款款 3;提现订单号ordeerNuumcharr(300)RY需要查询询订单号号经过Baase664处理理的商户户证书代代码KoallB644CerrtRN商户端读读取本地地商户证证书文件件后，再再使用上上海银行行提供的的APII进行Baase664编码码后产生生的商户户证书数数据字串串。消息扩展展exteensiionON“查询”应答报报文SQRees (SinngleeQueery Ressponnse)中文域名名对应DTTD元素素类型出现要求求签名要求求说明版本号verssionncharr(7)RN目前版本本号：”1.0.1”商户标识识insttIdcharr(155)RY报文发送

57、送方的商商户标识识流水号seriialNNocharr(199)RY该笔查询询交易的的流水号号交易日期期和时间间dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS被查询订订单的交交易日期期和时间间交易性质质typeecharr(1)RY0全部; 1支支付; 2退款款 3;提现订单号ordeerNuumcharr(300)RY需要查询询订单号号交易状态态stattuscharr(4)RY交易状态态00000：成功功，00011：失败败，00022：银行行处理中中，00033：银行行查无此此订单。订单失败败原因ordeerReemakkcharr(1000)CN订单失败败

58、原因支付卡号号carddNocharr(455)CN交易卡号号交易金额额amouuntcharr (112)CN见 HYPERLINK l _金额格式 金额格格式说明明手续费charrgecharr (112)ON手续费见见 HYPERLINK l _金额格式 金额格格式说明明交易卡种种carddTyppeCharr(1)CN交易卡种种1借记记卡 22贷记卡卡 结果代码码erroorCoodecharr(4)RY成功SUUCC，其他表表示失败败，详见见 HYPERLINK l _错误代码 错误代代码此项为描描述请求求报文本本身的对对错错误描述述erroorMeessaagecharr(2556

59、)ON消息扩展展exteensiionON4.7批批量交易易查询4.7.1业务务功能由商户发发起，向向银行查查询某一一时间段段的所有有订单的的交易状状态。当由于网网络或系系统故障障产生掉掉单（商商户发出出了快捷捷支付请请求报文文，但没没有收到到银行的的应答报报文）时时，商户户可以使使用该交交易得到到银行的的交易状状态，继继而对商商户端的的指令进进行恢复复处理。4.7.2业务务规则该交易在在执行中中需要满满足以下下约束条条件：可查询银银行开通通的各类类交易状状态，如如支付、退款。银行端返返回的状状态包括括成功、失败、处理中中。其中中成功代代表账务务处理成成功、失失败代表表账务处处理失败败、处理理

60、中代表表账务未未明需晚晚间批量量对账后后产生结结果。查询条件件中订单单号为必必须字段段。查询时间间段需不不大于115分钟钟。4.7.3处理理流程4.7.4交互互模式在交易明明细查询询业务中中，商户户与银行行通过请请求-应应答模式式交互。商户作为为服务使使用者向向银行发发送 “查询”请求报报文TQQReqq，银行行作为服服务提供供者向商商户返回回查询应应答报文文TQRRes。4.7.5报文文格式“查询”请求报报文TQQReqq (TTradde QQuerry RRequuestt)查询请求求报文TTQReeq是商商户向银银行发起起的交易易明细查查询请求求。中文域名名对应DTTD元素素类型出现要