【文章內(nèi)容簡介】 har(7)RN目前版本號：””商戶標識instIdchar(15)RY報文發(fā)送方的商戶標識訂單號orderNumchar(30)RY商戶支付訂單號/流水號,永不重復卡代號cardCodechar(20)RY用于支付的卡代號（來自CPReq）交易流水號serialNochar(20)RY銀行交易流水號交易日期和時間datechar(17)RYYYYYMMDD HH:MM:SS 結(jié)果代碼errorCodechar(4)RY成功SUCC，失敗見錯誤代碼錯誤描述errorMessagechar(256)ON消息擴展extensionON單筆退款是在發(fā)生在成功充值之后，將該筆交易充值的款項原路退回到快捷支付簽約銀行卡賬戶中。充值退回必須在商戶核實之后，由商戶發(fā)起。單筆退款交易為實時交易，即實時從商戶結(jié)算賬戶扣取，入個人賬戶。充值退回業(yè)務在執(zhí)行中需要滿足以下約束條件：n 充值退回業(yè)務從商戶發(fā)起。n 充值退回業(yè)務必須有對應成功的支付交易。n 原則上商戶可以針對90天內(nèi)的支付交易發(fā)起充值退回業(yè)務。特殊商戶可另約定。n 充值退回的金額不能超過對應的成功支付交易的金額。n 針對一筆成功的支付充值交易，可以進行多次退回，但退回的總金額不能大于對應該筆成功支付交易的總金額。n 退回的資金只能原路劃回簽約銀行卡賬戶中。n 商戶結(jié)算賬戶應保留足夠的退款資金。n 同一退回訂單號銀行必須保證只能執(zhí)行一次。n 銀行與商戶需要保存單筆退回相關報文的日志，作為解決資金清算不一致的憑據(jù)。在單筆退款業(yè)務中，商戶與銀行通過請求應答模式交互。n “單筆退款”請求報文SRReq(Single Refund Request)中文域名對應DTD元素類型出現(xiàn)要求簽名要求說明版本號versionchar(7)RN目前版本號：””商戶標識instIdchar(15)RY報文發(fā)送方的商戶標識訂單號orderNumchar(30)RY該筆退款交易的商戶訂單號,永不重復交易日期和時間datechar(17)RYYYYYMMDD HH:MM:SS卡代號cardCodechar(20)RY鑒權(quán)時返回的卡代碼手續(xù)費chargeLong(12)ON預留字段，見金額格式說明交易金額amountLong(12)RY見金額格式說明交易貨幣代碼currencychar(3)RY見快捷支付貨幣代碼表原訂單號oldorderNumchar(30)RY對應原支付交易的訂單號，永不重復原交易日期和時間olddatechar(8)RYYYYYMMDD經(jīng)過Base64處理的商戶證書代碼KoalB64Cert/RN商戶端讀取本地商戶證書文件后，再使用上海銀行提供的API進行Base64編碼后產(chǎn)生的商戶證書數(shù)據(jù)字串。消息擴展extensionONn “單筆退款”應答報文SRRes(Single Refund Response)中文域名對應DTD元素類型出現(xiàn)要求簽名要求說明版本號versionchar(7)RN目前版本號：””商戶標識instIdchar(15)RY報文發(fā)送方的商戶標識訂單號orderNumchar(30)RY商戶退款訂單號,永不重復，同支付時訂單號規(guī)制交易流水號serialNochar(20)RY銀行交易流水號交易日期和時間datechar(17)RYYYYYMMDD HH:MM:SS 卡代號cardCodechar(20)RY退款請求中的卡代碼結(jié)果代碼errorCodechar(4)RY成功SUCC，失敗見錯誤代碼錯誤描述errorMessagechar(256)ON消息擴展extensionON批量退款業(yè)務必須在商戶核實之后，由商戶發(fā)起。商戶以提供批量充值退回指令文件的方式，請求銀行執(zhí)行批量的退回處理，銀行以批量退回處理結(jié)果文件的形式，向商戶返回處理結(jié)果。充值退回業(yè)務在執(zhí)行中需要滿足以下約束條件：n 充值退回業(yè)務從商戶發(fā)起。n 充值退回業(yè)務必須有對應成功的支付交易。n 原則上商戶可以針對90天內(nèi)的支付交易發(fā)起充值退回業(yè)務。特殊商戶可另約定。n 充值退回的金額不能超過對應的成功支付交易的金額。n 針對一筆成功的支付充值交易，可以進行多次退回，但退回的總金額不能大于對應該筆成功支付交易的總金額。n 退回的資金只能原路劃回簽約銀行卡賬戶中。n 同一退回訂單號銀行必須保證只能執(zhí)行一次。n 銀行與商戶需要保存單筆退回相關報文的日志，作為解決資金清算不一致的憑據(jù)。n 批量充值退回文件中，每一筆都是按照獨立的單筆指令進行處理。1. 商戶將符合條件的等待處理的快捷支付充值退回申請匯總成批量退回指令文件。文件的格式見快捷支付批量退回指令文件格式說明。該文件保存在商戶文件服務器中。2. 商戶以唯一的批量退回文件批次號、快捷支付批量退回指令文件的下載URL、快捷支付批量退回文件上傳URL等要素為參數(shù)，構(gòu)造“批量退貨”通知BRNotify，以單向通知方式發(fā)送給銀行。3. 銀行收到“批量退貨”通知BRNotify之后，從通知中解析出批次號與批量退貨指令文件下載URL，并使用該URL下載批量退貨文件。如果文件當時下載不成功，銀行會有恰當?shù)闹卦嚥呗浴?. 銀行處理批量退貨指令文件。處理的方式是從批量退貨文件中解析出每一筆退貨指令進行分別處理。針對每一筆退貨的銀行內(nèi)部處理方式與單筆退貨相同。每一筆退貨的處理結(jié)果都記錄到批量退貨結(jié)果文件中。5. 銀行處理完成后發(fā)送通知報文告知，商戶主動發(fā)起下載結(jié)果文件,或者由商戶固定時間下載文件也可；考慮安全原因，建議哪方生成的文件存放于哪方的sever，對方可發(fā)起下載。銀行發(fā)送通知報文告知，商戶主動發(fā)起下載結(jié)果文件。注： 商戶生成的批量退款文件必須按約定的格式及壓縮、加密方式存放。 并應定義下載的URL。 （銀行方URL ） n “批量退貨”通知報文BRNotify(Batch Refund Notify)批量退貨通知報文BRNotify是商戶向銀行發(fā)起的通知批量退貨文件下載請求。中文域名對應DTD元素類型出現(xiàn)要求簽名要求說明版本號versionchar(7)RN目前版本號：””商戶標識instIdchar(15)RY報文發(fā)送方的商戶標識流水號orderNumchar(30)RY訂單號/流水號,永不重復，定義該批次的退款文件。交易日期和時間datechar(17)RYYYYYMMDD HH:MM:SS文件下載URLdownUrlChar(100)RY商戶發(fā)布的退款文件下載URL如，例如:80/file/download/上海銀行只能支持IP地址，不支持域名；請商戶在測試和生產(chǎn)前公布，上海銀行會在其防火墻上做網(wǎng)絡綁定文件名稱fileNamechar(30)RY（見文件命名規(guī)范），其中yyyymmdd是本報文的交易日期。文件摘要digestchar(40)RY見文件摘要經(jīng)過Base64處理的商戶證書代碼KoalB64Cert/RN商戶端讀取本地商戶證書文件后，再使用上海銀行提供的API進行Base64編碼后產(chǎn)生的商戶證書數(shù)據(jù)字串。通知URLnotifyUrlChar(100)RY接收銀行批量退款處理結(jié)果通知的URL消息擴展ExtensionOn “批量退貨結(jié)果”通知報文BRRNotify(Batch Refund Result Notify)批量退貨結(jié)果通知報文BRRNotify是銀行向商戶發(fā)出的批量退貨結(jié)果文件通知。中文域名對應DTD元素類型出現(xiàn)要求簽名要求說明版本號versionchar(7)RN目前版本號：””商戶標識instIdchar(15)RY報文發(fā)送方的商戶標識訂單號orderNumchar(30)RY銀行產(chǎn)生的批次流水號交易日期和時間datechar(17)RY銀行處理的日期和時間YYYYMMDD HH:MM:SS文件下載URLdownUrlChar(100)RY銀行發(fā)布的退款文件下載URL 文件下載（銀行端URL）文件名稱fileNamechar(30)RY（見文件命名規(guī)范），其中yyyymmdd是本報文的交易日期。文件摘要digestchar(40)RY見文件摘要原流水號orginalSerialNochar(19)RY來自BRNotify中批量退貨請求流水號原交易日期originalDatechar(17)RYYYYYMMDD HH:MM:SS (來自BRNotify中批量退貨請求交易日期和時間)消息擴展ExtensionOn 文件格式文件格式采用CSV（CommaSeparated Variable）標準。n 批量退貨指令文件格式(商戶按標準生成 ，（見文件命名規(guī)范）)批量退貨指令文件由匯總項與明細項兩部分組成。匯總項為文件第一行，其中包含以下各項：中文名稱出現(xiàn)要求備注總金額R格式見金額格式說明總筆數(shù)R明細項從文件第二行開始直到文件結(jié)束，其中每一行包含以下各項： 中文名稱出現(xiàn)要求備注流水號（訂單號）R定義每筆交易的退款交易日期時間RYYYYMMDD HH:MM:SS卡代號R手續(xù)費O見金額格式說明(現(xiàn)在是0)退貨金額R見金額格式說明交易貨幣代碼R原流水號 R支付流水號原交易日期R支付日期(YYYYMMDD)n 批量退貨結(jié)果文件格式(銀行按標準生成，（見文件命名規(guī)范）)批量退貨結(jié)果文件由匯總項與明細項兩部分組成。匯總項為文件第一行，其中包含以下各項：中文名稱出現(xiàn)要求備注處理成功總金額R本批處理成功的總金額，格式見金額格式說明處理成功總筆數(shù)