《某银行快捷支付接口规范.docx》由会员分享，可在线阅读，更多相关《某银行快捷支付接口规范.docx（38页珍藏版）》请在三一办公上搜索。
1、上海银行-快捷支付接口规范(版本号v3.6.6)前言本文档介绍上海银行“快捷支付”的技术标准，此接口标准适应借记卡快捷支付及信用卡快捷支付。其中包括业务处理与系统交互方式、报文的语法与语义、网络连接方式、安全规范等。第1章 文档概述1.1 介绍1.1.1 概述本文档阐述的技术标准，为更加快捷安全的互联网支付结算提供了解决方案。1.1.2 目标读者本文档的主要目标读者是银行与商户的技术实施人员，也可供业务人员参考。1.1.3 最近修订版本号作者内容提要核准人发布日期1.0黄敦迪定义上海银行快捷支付接口规范蔡红林2012-06-12.0黄敦迪删除快捷支付业务概述；调整错误代码；重定义身份鉴权报文头
2、；删除单笔提现接口；删除批量交易明细查询，新增单笔交易明细查询黄敦迪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-2
3、23.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 对应描述改为 卡号不存在或不支持的银行卡30
4、16 对应描述改为 银行账户交易失败批量交易查询的交易状态进行调整：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彭小波批量交易查询响应报文中
5、交易信息列表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章 报文结构上海银行快捷
6、支付报文规范规定了上海银行与商户之间交换报文的处理规范。2.1 报文结构快捷支付报文统一采用xml格式。所有的快捷支付报文均以Banksh作为根元素，每个Banksh元素中可以包含多个Message元素。Message元素中包含代表具体的业务的元素，比如CSVReq、CSVRes等。每个业务元素由一系列属性元素构成，不同的业务元素中包含的属性元素有所不同。对于涉及到签约状态修改或者资金变动的业务元素，必须要有与之匹配的Signature元素进行数字签名。作为约定，Banksh元素、Message元素与业务元素均是首字母大写的CamelCase形式，所有的属性元素均是首字母小写的CamelCas
7、e形式。 以签约请求报文为例，报文的格式如下： Message id 定义为不重复的随机数，以防止报文重复提交；在下文中出现的具体报文格式描述中，“出现要求”列包含的值的含义如下表所示：含义请求方约束服务方约束RRequired必须包含该域必须校验该域是否存在和内容的合法性CConditional如果条件符合必须包含该域l 当条件满足时，必须校验该域是否存在l 当该域存在时，必须检查其内容的合法性OOptional该域可选当该域存在时，必须检查其内容的合法性2.2 报文分类快捷支付协议中的报文按照交互模式的不同，分为以下几类：n 服务请求类报文服务请求类报文用于请求-应答交互模式，由服务使用者
8、向服务提供者发送。服务请求类报文的命令规范是XXReq，其中XX是报文代表的业务的首字母缩略，Req是Request的缩写。比如对于支付请求报文，命名为CPReq，代表Card Payment Request。n 服务应答类报文服务应答类报文用于请求-应答交互模式，由服务提供者向服务使用者返回。服务应答类报文的命令规范是XXRes，其中XX是报文代表的业务的首字母缩略，Res是Response的缩写。比如对于支付应答报文，命名为CPRes，代表Card Payment Response。n 通知类报文通知类报文用于单向通知交互模式，由通知发送者向通知接收者发送。通知类报文的命令规范是XXNot
9、ify，其中XX是报文代表的业务的首字母缩略。n 通用报文有两种通用报文，一种是Error报文，用于返回处理错误；另一种是NotifyAccept，代表单向通知已被接受。2.3 通用报文2.3.1 错误代码n 银行返回的错误代码说明：错误代码错误描述解释0000无效的根元素根元素无法识别0001未定义的消息域消息不是CSReq、CSRes等；或者消息发送给了一个错误的组件0002必填域缺失0003根据规范，一个或多个域不符合格式要求例如，非数字，或者不是有效的日期格式等等。0004商户标识不正确instId域中的商户标识不正确0005签名无效报文签名校验不通过0006验证证书有效性失败商户证书
10、过期或失效1000文件格式不正确商户批处理业务上传文件不正确1001文件不存在下载文件时，找不到指定的文件1002文件已处理对于不允许重复处理的业务的文件，如果已处理过，就发生此错误1003文件无法解压缩上传的文件无法正确解压缩1004文件摘要不正确文件上传通知报文中的文件摘要不正确2001支付流水重复重复的网上支付流水2002原支付流水不存在申请退货的原支付流水不存在2003查询范围太大查询时间跨度太大2004退款订单日期错误退款订单日期小于原订单日期2005当日撤销必须为全额退款业务要求：当日撤销必须为全额3001真实姓名不正确真实姓名与商户端登记的不一致3002证件类型不正确证件类型与商
11、户端登记的不一致3003身份证件号码不匹配身份证件号码与商户端登记的身份证件号码不匹配3004手机号不匹配3005不支持的银行卡类型3006卡号不存在或不支持的银行卡3007未鉴权的银行卡未做过鉴权的银行卡（卡代号不存在时）3008认证信息不匹配认证信息与商户通过认证的信息不匹配3009银行卡状态不正确银行卡状态不正确3011原支付申请流水不存在支付申请流水不存在（用于退款）3013金额超限支付金额超过每日限额（退款时超出原订单金额也用这个）3014余额不足银行账户中的余额不足以完成支付3015银行交易处理中该笔交易在银行前置系统中状态未知3016银行账户交易失败银行系统的错误返回。3050有
12、效期错误或卡已过期对信用卡有效期的校验，信用卡有效期输错，或信用卡已过有效期3051CVV2错误信用卡CVV2的校验4045未清算的订单不能做退款处理不支持当日退款4001快捷支付渠道关闭没有开通快捷支付业务4002服务没有开通请求的业务没有开通4046清算的订单不能做撤销处理清算的订单不允许做撤销处理9000暂时系统异常通用性错误2.3.2 NotifyAccept报文n 功能用来代表单向通知已被接受。n 消息域下表列举了消息域的定义中文域名对应DTD元素类型出现要求签名要求说明版本号versionchar(7)RN目前版本号：”1.0.1”商户标识instIdchar(15)RY报文发送方
13、的商户标识流水号orderNumchar(30)RY原商户提交的信息流水号交易日期和时间datechar(17)RYYYYYMMDD HH:MM:SS 结果代码errorCodechar(4)RYSUCC表示成功其他均为失败错误描述errorMessagechar(256)ON消息扩展extensionON2.4 报文的解析与传输快捷支付报文的传输使用HTTP(S)方式，在HTTP请求/响应体中包含XML形式的报文。2.4.1 报文解析对XML解析的基本要求如下：n 版本号检查用于表示组件支持的协议版本号。消息版本号必须表示为：n+.n+.n+ ，其中“n” 表示数字， “+” 表示一个或多个
14、。比如1.0或1.0.1。在所有的消息中，各组件都必须填写自身支持的协议版本号。消息版本号不能低于1.0.1。n xml解析为了可以支持后续协议版本，xml解析的实现不要做严格的验证。特别是需要忽略未被确认的域。所有xml消息必须用“utf-8”编码。n Message域之id属性匹配请求和应答报文的Message域之id属性必须相同，id是请求方生成的唯一序列号。比如：银行在CSReq的Message域设置了一个id属性值，则商户在CSRes里面的Message域的id属性必须和CSReq的Message域之id值相同。2.4.2 报文传输对HTTPS传输的基本要求如下：n 使用POST发送
15、消息消息请求基于HTTP/HTTPS的POST方式。n HTTP消息头要求HTTP请求与响应消息中必须按照如下要求设置头部域：Content-Length:必须设置成消息体的长度Content-Type:必须设置下面的值：application/xml; charset=utf-8第3章 文件交换规范3.1 文件命名规范文件命名规范对文件名称进行统一的规划，以达到从文件名称上区分不同业务文件的目的。文件命名规范：filetype_yyyymmdd_sequence.zip，其中：filetype文件类型，如：BRF 批量退款文件；BRRF-批量退款结果文件；CCF清算对账文件； INFO- 商
16、户信息文件；yyyymmdd文件业务日sequence批次号， 以01，02，03递增，与商户一般1天交互一次，故批次号固定为“01”例如：CCF_20100222_01.zip （清算对账文件）3.2 文件压缩传输前需要压缩成zip格式。3.3 文件加密对压缩后的文件，需要加密之后再传输。加密时采用三重DES对称加密算法3DES。加密密钥按事先约定方式分发。3.4 文件摘要对加密后的文件进行摘要。摘要算法使用标准SHA1算法，结果表示成40位16进制大写字母数字串。在商户往银行发送文件下载请求时需对若干域进行摘要，具体可参考文件下载章节描述；在银行往商户反馈文件时，需对文件进行摘要，文件摘要
17、商户可从 https的response的head域里面的Banksha1域的值获取摘要，从Banksign域的值获取签名。3.5 文件下载（银行端URL）文件采用商户主动请求从银行文件服务下载的方式。例如银行文件服务的URL格式如下： http(s):/ &actiontype=download&date=20100204&finename=SCF_20100222_01.zip&KoalB64Cert=xxxxxx &sign=xxxxxx，其中：http(s):/actiontype操作类型（如：upload表示上传、download表示下载）。instId商户标识。 date 交易日期y
18、yyymmdd。filename 遵循业务文件命名规范的文件名。KoalB64Cert商户公钥Base64位编码sign 使用certId指定的证书对“actiontype|instId|date|filename”进行签名，对签名结果进行Base64编码获得的字符串,详情见签名规范。3.6 文件下载失败http状态码1、406：商户标识不匹配2、405：操作类型不正确3、420：银行端验签失败4、404：请求文件名不存在5、409：请求文件格式不正确第4章 接口实现规范4.1 接口实现说明序号接口类型交易类型描述必须1身份鉴权实时商户发起的实名签约验证Y2网上支付实时Y3单笔退款实时Y4批量
19、退款批量N5单笔交易明细查询实时Y6批量交易查询实时N7清算对帐批量Y8单笔撤消实时N4.2身份鉴权4.2.1业务功能银行接收商户要求身份鉴权的交易请求，必须包含客户卡号、客户姓名、客户证件类型、客户证件号码、手机号码等信息，银行核对卡号对应的信息与客户提供的信息一致型，如一致反馈匹配，否则反馈不匹配。4.2.2业务规则n 由于快捷支付的签约是在商户端完成的，银行只是提供身份鉴权，协助商户验证信息的匹配性。商户必须为客户身份验证承担责任，确保是持卡人本人，银行不承担责任。n 快捷支付签约用户的必须持有手机，且手机号为用户在银行端开卡时所登记的手机号。n 银行身份鉴权，暂定为核对卡对应的客户姓名
20、、证件类型、证件号码、手机号码，可根据实际情况调整。n 建议商户在快捷支付签约成功后发手机短信通知客户。4.2.3交互模式在身份鉴权业务中，商户与上海银行通过请求-应答模式交互。商户作为服务使用者向银行发送 “身份鉴权申请”报文IAReq，银行作为服务提供者向商户返回“签约应答”报文IARes。涉及到以下交互：1、 商户将数据发送到银行的身份鉴权服务接口，商户需调用银行API利用数字证书进行加密，签名。（见数字签名）2、 银行端校验通过核实客户信息，并在同一个连接中返回IARes报文告诉银行商户验证情况。银行会对返回数据进行加密，签名。3、 商户端接口银行应答报文后，验签、解析报文后做后续处理
21、。4.2.4报文格式n 鉴权请求报文IAReq（Identity Authentication Request）IAReq是从商户向银行发起的签约请求报文。中文域名对应DTD元素类型出现要求签名要求说明版本号versionchar(7)RN目前版本号：”1.0.1”商户标识instIdchar(15)RY由银行分配固定值,请求报文中需填写交易日期和时间datechar(17)RYYYYYMMDD HH:MM:SS客户姓名namechar(30)RY签约银行卡号cardNochar(20)RY签约银行卡类型cardTypechar(1)RY1借记卡 2贷记卡 证件类型certTypechar(1
22、)RY1：身份证；2：护照；3：军官证；4：士兵证；5：户口本；6：警官证；7：台胞证证件号码certNochar(30)RY手机号mobilePhoneChar(20)RY持卡人在银行留的手机号手机号必须为11位CVV2cvv2Char(3)ON卡背面签名栏的后三位数字CVV2和有效期需同时输入或同时都不输入有效期validityChar(4)ONMMYYCVV2和有效期需同时输入或同时都不输入经过Base64处理的商户证书代码KoalB64Cert/RN商户端读取本地商户证书文件后，再使用上海银行提供的API进行Base64编码后产生的商户证书数据字串。消息扩展extensionONn 签
23、约应答报文IARRes（Identity Authentication Response）IARRes银行返回给商户的应答。中文域名对应DTD元素类型出现要求签名要求说明版本号versionchar(7)RN目前版本号：”1.0.1”商户标识instIdchar(15)RY报文发送方的商户标识银行卡号cardNochar(20)RY银行卡代码cardCodeChar(20)RY唯一区分银行卡代码交易日期和时间datechar(17)RYYYYYMMDD HH:MM:SS结果代码errorCodechar(4)RY成功SUCC，失败见错误代码错误描述errorMessagechar(256)ON
24、消息扩展extensionON4.3网上支付4.3.1业务功能商户负责验证客户持卡人身份与服务权限，并请求银行划拨客户的资金用于互联网交易的支付；银行负责验证由商户发出的支付指令是否在快捷支付签约的业务范围与银行控制的快捷支付支付限额内，并实时扣减签约银行卡内的余额。由于网上支付引起的银行与商户间的资金清算方法由快捷支付清算标准规定。4.3.2业务规则该交易在执行中需要满足以下约束条件：n 支付必须由客户请求，从合作商户发起（可以网上、网点等渠道）。n 商户控制支付的资金只能从快捷支付签约时确定的签约银行卡账户中支出。银行端做无磁无密交易。n 支付时客户在签约银行卡账户中的资金只能转移到商户指
25、定的清算账户中。n 同一支付订单号的支付交易，银行端限定只能执行一次，永不重复。n 银行与商户需要保存支付相关报文的日志作为解决资金清算不一致的依据。4.3.3处理流程4.3.4交互模式在支付业务中，商户与银行通过请求-应答模式交互。商户作为服务使用者向银行发送 “支付”请求报文CPReq，银行作为服务提供者向商户返回“网上支付”应答报文CPRes。4.3.5报文格式n “网上支付”请求报文CPReq(Card Payment Request)网上支付报文请求CPReq(Card Payment Request) 是从商户向银行发起的支付请求。中文域名对应DTD元素类型出现要求签名要求说明版本
26、号versionchar(7)RN目前版本号：”1.0.1”商户标识instIdchar(15)RY报文发送方的商户标识二级商户代码twoIdchar(15)CN二级商户代码适用于有些商户需银行在账单或明细查询中显示其平台的二级商户名称订单号orderNumchar(30)RY商户支付订单号/流水号,永不重复交易日期和时间datechar(17)RYYYYYMMDD HH:MM:SS卡代号cardCodechar(20)RY鉴权时返回的卡代码手续费chargeLong(12)ON预留字段，见金额格式说明交易金额amountLong(12)RY见金额格式说明交易货币代码currencychar(
27、3)RY见快捷支付货币代码表经过Base64处理的商户证书代码KoalB64Cert/RN商户端读取本地商户证书文件后，再使用上海银行提供的API进行Base64编码后产生的商户证书数据字串。消息扩展extensionONn “网上支付”应答报文CPRes(Card Payment Response)网上支付应答报文CPRes是银行返回给商户CPReq的应答。中文域名对应DTD元素类型出现要求签名要求说明版本号versionchar(7)RN目前版本号：”1.0.1”商户标识instIdchar(15)RY报文发送方的商户标识订单号orderNumchar(30)RY商户支付订单号/流水号,永
28、不重复卡代号cardCodechar(20)RY用于支付的卡代号（来自CPReq）交易流水号serialNochar(20)RY银行交易流水号交易日期和时间datechar(17)RYYYYYMMDD HH:MM:SS 结果代码errorCodechar(4)RY成功SUCC，失败见错误代码错误描述errorMessagechar(256)ON消息扩展extensionON4.4单笔退款4.4.1业务功能单笔退款是在发生在成功充值之后，将该笔交易充值的款项原路退回到快捷支付签约银行卡账户中。充值退回必须在商户核实之后，由商户发起。单笔退款交易为实时交易，即实时从商户结算账户扣取，入个人账户。4
29、.4.2业务规则充值退回业务在执行中需要满足以下约束条件：n 充值退回业务从商户发起。n 充值退回业务必须有对应成功的支付交易。n 原则上商户可以针对90天内的支付交易发起充值退回业务。特殊商户可另约定。n 充值退回的金额不能超过对应的成功支付交易的金额。n 针对一笔成功的支付充值交易，可以进行多次退回，但退回的总金额不能大于对应该笔成功支付交易的总金额。n 退回的资金只能原路划回签约银行卡账户中。n 商户结算账户应保留足够的退款资金。n 同一退回订单号银行必须保证只能执行一次。n 银行与商户需要保存单笔退回相关报文的日志，作为解决资金清算不一致的凭据。4.4.3处理流程4.4.4交互模式在单
30、笔退款业务中，商户与银行通过请求-应答模式交互。4.4.5报文格式n “单笔退款”请求报文SRReq(Single Refund Request)中文域名对应DTD元素类型出现要求签名要求说明版本号versionchar(7)RN目前版本号：”1.0.1”商户标识instIdchar(15)RY报文发送方的商户标识订单号orderNumchar(30)RY该笔退款交易的商户订单号,永不重复交易日期和时间datechar(17)RYYYYYMMDD HH:MM:SS卡代号cardCodechar(20)RY鉴权时返回的卡代码手续费chargeLong(12)ON预留字段，见金额格式说明交易金额a
31、mountLong(12)RY见金额格式说明交易货币代码currencychar(3)RY见快捷支付货币代码表原订单号oldorderNumchar(30)RY对应原支付交易的订单号，永不重复原交易日期和时间olddatechar(8)RYYYYYMMDD经过Base64处理的商户证书代码KoalB64Cert/RN商户端读取本地商户证书文件后，再使用上海银行提供的API进行Base64编码后产生的商户证书数据字串。消息扩展extensionONn “单笔退款”应答报文SRRes(Single Refund Response)中文域名对应DTD元素类型出现要求签名要求说明版本号versionc
32、har(7)RN目前版本号：”1.0.1”商户标识instIdchar(15)RY报文发送方的商户标识订单号orderNumchar(30)RY商户退款订单号,永不重复，同支付时订单号规制交易流水号serialNochar(20)RY银行交易流水号交易日期和时间datechar(17)RYYYYYMMDD HH:MM:SS 卡代号cardCodechar(20)RY退款请求中的卡代码结果代码errorCodechar(4)RY成功SUCC，失败见错误代码错误描述errorMessagechar(256)ON消息扩展extensionON4.5批量退款4.5.1业务功能批量退款业务必须在商户核实
33、之后，由商户发起。商户以提供批量充值退回指令文件的方式，请求银行执行批量的退回处理，银行以批量退回处理结果文件的形式，向商户返回处理结果。4.5.2业务规则充值退回业务在执行中需要满足以下约束条件：n 充值退回业务从商户发起。n 充值退回业务必须有对应成功的支付交易。n 原则上商户可以针对90天内的支付交易发起充值退回业务。特殊商户可另约定。n 充值退回的金额不能超过对应的成功支付交易的金额。n 针对一笔成功的支付充值交易，可以进行多次退回，但退回的总金额不能大于对应该笔成功支付交易的总金额。n 退回的资金只能原路划回签约银行卡账户中。n 同一退回订单号银行必须保证只能执行一次。n 银行与商户
34、需要保存单笔退回相关报文的日志，作为解决资金清算不一致的凭据。n 批量充值退回文件中，每一笔都是按照独立的单笔指令进行处理。4.5.3处理流程1. 商户将符合条件的等待处理的快捷支付充值退回申请汇总成批量退回指令文件。文件的格式见快捷支付批量退回指令文件格式说明。该文件保存在商户文件服务器中。2. 商户以唯一的批量退回文件批次号、快捷支付批量退回指令文件的下载URL、快捷支付批量退回文件上传URL等要素为参数，构造“批量退货”通知BRNotify，以单向通知方式发送给银行。3. 银行收到“批量退货”通知BRNotify之后，从通知中解析出批次号与批量退货指令文件下载URL，并使用该URL下载批
35、量退货文件。如果文件当时下载不成功，银行会有恰当的重试策略。4. 银行处理批量退货指令文件。处理的方式是从批量退货文件中解析出每一笔退货指令进行分别处理。针对每一笔退货的银行内部处理方式与单笔退货相同。每一笔退货的处理结果都记录到批量退货结果文件中。5. 银行处理完成后发送通知报文告知，商户主动发起下载结果文件,或者由商户固定时间下载文件也可；考虑安全原因，建议哪方生成的文件存放于哪方的sever，对方可发起下载。4.5.4交互模式银行发送通知报文告知，商户主动发起下载结果文件。注： 1、商户生成的批量退款文件必须按约定的格式及压缩、加密方式存放。 并应定义下载的URL。 例如3.5章节文件下
36、载（银行方URL ） 4.5.5报文格式n “批量退货”通知报文BRNotify(Batch Refund Notify)批量退货通知报文BRNotify是商户向银行发起的通知批量退货文件下载请求。中文域名对应DTD元素类型出现要求签名要求说明版本号versionchar(7)RN目前版本号：”1.0.1”商户标识instIdchar(15)RY报文发送方的商户标识流水号orderNumchar(30)RY订单号/流水号,永不重复，定义该批次的退款文件。交易日期和时间datechar(17)RYYYYYMMDD HH:MM:SS文件下载URLdownUrlChar(100)RY商户发布的退款文
37、件下载URL如，例如http:/172.17.11.2:80/file/download/上海银行只能支持IP地址，不支持域名；请商户在测试和生产前公布，上海银行会在其防火墙上做网络绑定文件名称fileNamechar(30)RYBRF_yyyymmdd_sequence.zip（见文件命名规范），其中yyyymmdd是本报文的交易日期。文件摘要digestchar(40)RY见文件摘要经过Base64处理的商户证书代码KoalB64Cert/RN商户端读取本地商户证书文件后，再使用上海银行提供的API进行Base64编码后产生的商户证书数据字串。通知URLnotifyUrlChar(100)
38、RY接收银行批量退款处理结果通知的URL消息扩展ExtensionOn “批量退货结果”通知报文BRRNotify(Batch Refund Result Notify)批量退货结果通知报文BRRNotify是银行向商户发出的批量退货结果文件通知。中文域名对应DTD元素类型出现要求签名要求说明版本号versionchar(7)RN目前版本号：”1.0.1”商户标识instIdchar(15)RY报文发送方的商户标识订单号orderNumchar(30)RY银行产生的批次流水号交易日期和时间datechar(17)RY银行处理的日期和时间YYYYMMDD HH:MM:SS文件下载URLdownU
39、rlChar(100)RY银行发布的退款文件下载URL见4.5 文件下载（银行端URL）文件名称fileNamechar(30)RYBRRF_yyyymmdd_sequence.zip（见文件命名规范），其中yyyymmdd是本报文的交易日期。文件摘要digestchar(40)RY见文件摘要原流水号orginalSerialNochar(19)RY来自BRNotify中批量退货请求流水号原交易日期originalDatechar(17)RYYYYYMMDD HH:MM:SS (来自BRNotify中批量退货请求交易日期和时间)消息扩展ExtensionO4.5.6文件格式n 文件格式文件格式采用CSV（Comma-Separated Variable）标准。n 批量退货指令文件格式(商户按标准生成 ，文件名约定为BRF_yyyymmdd_sequence.zip（见文件命名规范）)批量退货指令文件由汇总项与明细项两部分组成。汇总项为文件第一行，其中包含以下各项：中文名称出现要求备注总金额R格式见金额格式说明总笔数R明细项从文件第二行开始直到文件结束，其中每一行包含以下各项： 中文名称出现要求备注流水号（订单号）R定义每笔交易的退款交易日期时间RYYYYMMDD HH:MM:SS卡代号R手续
