某銀行快捷支付接口規(guī)范

1、上海銀行-快捷支支付接口規(guī)范(版本號vv3.6.6)前言本文檔介紹紹上海銀銀行“快捷支支付”的技術術標準，此接口標準適應借記卡快捷支付及信用卡快捷支付。其中包括業(yè)務處理與系統(tǒng)交互方式、報文的語法與語義、網絡連接方式、安全規(guī)范等。文檔概述介紹概述本文檔闡述述的技術術標準，為為更加快快捷安全全的互聯(lián)聯(lián)網支付付結算提提供了解解決方案案。目標讀者本文檔的主主要目標標讀者是是銀行與與商戶的的技術實實施人員員，也可可供業(yè)務務人員參參考。最近修訂版本號作者內容提要核準人發(fā)布日期1.0黃敦迪定義上海銀銀行快捷捷支付接接口規(guī)范范蔡紅林2012-06-12.0黃敦迪刪除快捷支支付業(yè)務務概述；調整錯錯誤代碼碼；重定

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彭小波批量交易查查詢增加加愛業(yè)務務規(guī)則：訂單最多支支持100筆;查詢的多條條訂單只只返回符符合條件件的記錄錄。2013-4-2283.5.22彭小波為單筆退款款增加錯錯誤代碼碼：400452013-5-223.5.33黃敦迪單筆交易明明細查詢詢應答報報文中sstattus枚枚舉值調調整及定定義errrorrCodde的取取值；批量交交易查詢詢應答報報文TrradeeInffo清單單中的ssignnNo改改為caardNNo201

4、3-5-1113.5.44彭小波錯誤碼不再再分類別別擴展鑒權的的證件類類別鑒權中增加加校驗規(guī)規(guī)則，手手機號碼碼必須為為11位位明確單筆訂訂單查詢詢中的交交易日期期和時間間2013-5-1173.5.55彭小波調整錯誤碼碼描述：3006 對對應描述述改為 卡號號不存在在或不支支持的銀銀行卡3016 對應應描述改改為 銀行賬賬戶交易易失敗批量交易查查詢的交交易狀態(tài)態(tài)進行調調整：0000 成功；00001失敗敗2013-5-1183.5.66彭小波3003的的errrormmesssagee從“身份證證號碼不不匹配”改為“身份證證件號碼碼不匹配配”2013-5-2213.5.77彭小波針對信用卡卡的

5、CVVV2和和有效期期，增加加對應的的錯誤碼碼：30050和和305512013-5-2243.5.88彭小波身份鑒權增增加業(yè)務務邏輯：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)統(tǒng)一更改改為chhar(20),修改改點：網網上支付付、單筆筆退款、單單筆撤消消2013-6-2273.6.44彭小波清算對賬中中文件格格式中銀銀行卡號號修正為為銀行卡卡代號2013-7-113.6.55彭小波單筆撤消上上送報文文增加交交易金額額，同時時增加校校驗：交交易金額額必須和和原訂單單交易金金額一致致2013-7-223.6.66彭小波清算對賬增增加業(yè)務務規(guī)則：信用卡卡撤消及及對應原原訂單不不在清算算對賬文文件內。2013-7-55報文結構上海銀行快快捷支付付報文規(guī)規(guī)范規(guī)定定了上海海銀行與與商戶之之間交換換報文的的處理

7、規(guī)規(guī)范。報文結構快捷支付報報文統(tǒng)一一采用xxml格格式。所所有的快快捷支付付報文均均以Baankssh作為為根元素素，每個個Bannkshh元素中中可以包包含多個個Messsagge元素素。Messaage元元素中包包含代表表具體的的業(yè)務的的元素，比比如CSSVReeq、CCSVRRes等等。每個個業(yè)務元元素由一一系列屬屬性元素素構成，不不同的業(yè)業(yè)務元素素中包含含的屬性性元素有有所不同同。對于涉及到到簽約狀狀態(tài)修改改或者資資金變動動的業(yè)務務元素，必必須要有有與之匹匹配的SSignnatuure元元素進行行數字簽簽名。作為約定，BBankksh元元素、MMesssagee元素與與業(yè)務元元素均是是

8、首字母母大寫的的CammelCCasee形式，所所有的屬屬性元素素均是首首字母小小寫的CCameelCaase形形式。 以簽約請求求報文為為例，報報文的格格式如下下： Messaage id 定義為為不重復復的隨機機數，以以防止報報文重復復提交；在下文中出出現的具具體報文文格式描描述中，“出現要求”列包含的值的含義如下表所示：含義請求方約束束服務方約束束RRequiiredd必須包含該該域必須校驗該該域是否否存在和和內容的的合法性性CCondiitioonall如果條件符符合必須須包含該該域當條件滿足足時，必必須校驗驗該域是是否存在在當該域存在在時，必必須檢查查其內容容的合法法性OOptioo

9、nall該域可選當該域存在在時，必必須檢查查其內容容的合法法性報文分類快捷支付協(xié)協(xié)議中的的報文按按照交互互模式的的不同，分分為以下下幾類：服務請求類類報文服務請求類類報文用用于請求求-應答答交互模模式，由由服務使使用者向向服務提提供者發(fā)發(fā)送。服服務請求求類報文文的命令令規(guī)范是是XXRReq，其其中XXX是報文文代表的的業(yè)務的的首字母母縮略，RReq是是Reqquesst的縮縮寫。比比如對于于支付請請求報文文，命名名為CPPReqq，代表表Carrd PPaymmentt Reequeest。服務應答類類報文服務應答類類報文用用于請求求-應答答交互模模式，由由服務提提供者向向服務使使用者返返回。

10、服服務應答答類報文文的命令令規(guī)范是是XXRRes，其其中XXX是報文文代表的的業(yè)務的的首字母母縮略，RRes是是Ressponnse的的縮寫。比比如對于于支付應應答報文文，命名名為CPPRess，代表表Carrd PPaymmentt Ressponnse。通知類報文文通知類報文文用于單單向通知知交互模模式，由由通知發(fā)發(fā)送者向向通知接接收者發(fā)發(fā)送。通通知類報報文的命命令規(guī)范范是XXXNottifyy，其中中XX是是報文代代表的業(yè)業(yè)務的首首字母縮縮略。通用報文有兩種通用用報文，一一種是EErroor報文文，用于于返回處處理錯誤誤；另一一種是NNotiifyAAcceept，代代表單向向通知已已被

11、接受受。通用報文錯誤代碼銀行返回的的錯誤代代碼說明明：錯誤代碼錯誤描述解釋0000無效的根元元素根元素無法法識別0001未定義的消消息域消息不是CCSReeq、CCSRees等；或者消消息發(fā)送送給了一一個錯誤誤的組件件0002必填域缺失失0003根據規(guī)范，一一個或多多個域不不符合格格式要求求例如，非數數字，或或者不是是有效的的日期格格式等等等。0004商戶標識不不正確instIId域中中的商戶戶標識不不正確0005簽名無效報文簽名校校驗不通通過0006驗證證書有有效性失失敗商戶證書過過期或失失效1000文件格式不不正確商戶批處理理業(yè)務上上傳文件件不正確確1001文件不存在在下載文件時時，找不不

12、到指定定的文件件1002文件已處理理對于不允許許重復處處理的業(yè)業(yè)務的文文件，如如果已處處理過，就就發(fā)生此此錯誤1003文件無法解解壓縮上傳的文件件無法正正確解壓壓縮1004文件摘要不不正確文件上傳通通知報文文中的文文件摘要要不正確確2001支付流水重重復重復的網上上支付流流水2002原支付流水水不存在在申請退貨的的原支付付流水不不存在2003查詢范圍太太大查詢時間跨跨度太大大2004退款訂單日日期錯誤誤退款訂單日日期小于于原訂單單日期2005當日撤銷必必須為全全額退款款業(yè)務要求：當日撤撤銷必須須為全額額3001真實姓名不不正確真實姓名與與商戶端端登記的的不一致致3002證件類型不不正確證件類型

13、與與商戶端端登記的的不一致致3003身份證件號號碼不匹匹配身份證件號號碼與商商戶端登登記的身身份證件件號碼不不匹配3004手機號不匹匹配3005不支持的銀銀行卡類類型3006卡號不存在在或不支支持的銀銀行卡3007未鑒權的銀銀行卡未做過鑒權權的銀行行卡（卡卡代號不不存在時時）3008認證信息不不匹配認證信息與與商戶通過過認證的的信息不不匹配3009銀行卡狀態(tài)態(tài)不正確確銀行卡狀態(tài)態(tài)不正確確3011原支付申請請流水不不存在支付申請流流水不存存在（用用于退款款）3013金額超限支付金額超超過每日日限額（退退款時超超出原訂訂單金額額也用這這個）3014余額不足銀行賬戶中中的余額額不足以以完成支支付30

14、15銀行交易處處理中該筆交易在在銀行前前置系統(tǒng)統(tǒng)中狀態(tài)態(tài)未知3016銀行賬戶交交易失敗敗銀行系統(tǒng)的的錯誤返返回。3050有效期錯誤誤或卡已已過期對信用卡有有效期的的校驗，信信用卡有有效期輸輸錯，或或信用卡卡已過有有效期3051CVV2錯錯誤信用卡CVVV2的的校驗4045未清算的訂訂單不能能做退款款處理不支持當日日退款4001快捷支付渠渠道關閉閉沒有開通快快捷支付付業(yè)務4002服務沒有開開通請求的業(yè)務務沒有開開通4046清算的訂單單不能做做撤銷處處理清算的訂單單不允許許做撤銷銷處理9000暫時系統(tǒng)異異常通用性錯誤誤NotiffyAccceppt報文文功能用來代表單單向通知知已被接接受。消息域下

15、表列舉了了消息域域的定義義中文域名對應DTDD元素類型出現要求簽名要求說明版本號versiionchar(7)RN目前版本號號：”1.0.1”商戶標識instIIdchar(15)RY報文發(fā)送方方的商戶戶標識流水號orderrNummchar(30)RY原商戶提交交的信息息流水號號交易日期和和時間datechar(17)RYYYYYMMMDDD HH:MM:SSS 結果代碼errorrCoddechar(4)RYSUCC表表示成功功其他均為失失敗錯誤描述errorrMesssaggechar(2566)ON消息擴展extennsioonON報文的解析析與傳輸輸快捷支付報報文的傳傳輸使用用HTT

16、TP(SS)方式式，在HHTTPP請求/響應體體中包含含XMLL形式的的報文。報文解析對XML解解析的基基本要求求如下：版本號檢查查用于表示組組件支持持的協(xié)議議版本號號。消息息版本號號必須表表示為：n+.n+.n+ ，其中“n” 表示數數字，“+” 表示一一個或多多個。比比如1.0或11.0.1。在在所有的的消息中中，各組組件都必必須填寫寫自身支支持的協(xié)協(xié)議版本本號。消消息版本本號不能能低于11.0.1。xml解析析為了可以支支持后續(xù)續(xù)協(xié)議版版本，xxml解解析的實實現不要要做嚴格格的驗證證。特別別是需要要忽略未未被確認認的域。所有xml消息必須用“utf-8”編碼。Messaage域域之id

17、d屬性匹匹配請求和應答答報文的的Messsagge域之之id屬屬性必須須相同，iid是請請求方生生成的唯唯一序列列號。比比如：銀銀行在CCSReeq的MMesssagee域設置置了一個個id屬屬性值，則則商戶在在CSRRes里里面的MMesssagee域的iid屬性性必須和和CSRReq的的Messsagge域之之id值值相同。報文傳輸對HTTPPS傳輸輸的基本本要求如如下：使用POSST發(fā)送送消息消息請求基基于HTTTP/HTTTPS的的POSST方式式。HTTP消消息頭要要求HTTP請請求與響響應消息息中必須須按照如如下要求求設置頭頭部域：Conttentt-Leengtth:必須設設置成

18、消消息體的的長度Conttentt-Tyype:必須須設置下下面的值值：apppliicattionn/xmml; chaarseet=uutf-8文件交換規(guī)規(guī)范文件命名規(guī)規(guī)范文件命名規(guī)規(guī)范對文文件名稱稱進行統(tǒng)統(tǒng)一的規(guī)規(guī)劃，以以達到從從文件名名稱上區(qū)區(qū)分不同同業(yè)務文文件的目目的。文文件命名名規(guī)范：filletyype_yyyyymmmdd_seqquennce.zipp，其中中：filettypee文件件類型，如如：BRRF 批量量退款文文件；BBRRFF-批量量退款結結果文件件；CCCF清算對對賬文件件； IINFOO- 商商戶信息息文件；yyyymmmddd文件件業(yè)務日日sequeence

19、e批次次號， 以011，022，033遞增，與與商戶一一般1天天交互一一次，故故批次號號固定為為“01”例如：CCF_22010002222_001.zzip （清清算對賬賬文件）文件壓縮傳輸前需要要壓縮成zzip格格式。文件加密對壓縮后的的文件，需需要加密密之后再再傳輸。加加密時采采用三重重DESS對稱加加密算法法3DEES。加加密密鑰鑰按事先先約定方方式分發(fā)發(fā)。文件摘要對加密后的的文件進進行摘要要。摘要要算法使使用標準準SHAA1算法法，結果果表示成成40位位16進進制大寫寫字母數數字串。在商戶往銀銀行發(fā)送送文件下下載請求求時需對對若干域域進行摘摘要，具具體可參參考文件件下載章章節(jié)描述述；

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銀行行文件系系統(tǒng)的根根路徑。actioontyype操作作類型（如如：upploaad表示示上傳、ddownnloaad表示示下載）。instIId商戶標標識。 date 交易易日期yyyyyymmddd。filennamee 遵循循業(yè)務文文件命名名規(guī)范的的文件名名。K

22、oalBB64CCertt商戶戶公鑰BBasee64位位編碼sign 使用用cerrtIdd指定的的證書對對“acttionntyppe|iinsttId|datte|ffileenamme”進行簽名名，對簽簽名結果進行行Basse644編碼獲獲得的字字符串,詳情見見簽名規(guī)規(guī)范。文件下載失失敗htttp狀狀態(tài)碼1、4066：商戶戶標識不不匹配2、4055：操作作類型不不正確3、4200：銀行行端驗簽簽失敗4、4044：請求求文件名名不存在在5、4099：請求求文件格格式不正正確接口實現規(guī)規(guī)范接口實現說說明序號接口類型交易類型描述必須1身份鑒權實時商戶發(fā)起的的實名簽簽約驗證證Y2網上支付實時Y3

23、單筆退款實時Y4批量退款批量N5單筆交易明明細查詢詢實時Y6批量交易查查詢實時N7清算對帳批量Y8單筆撤消實時N4.2身份份鑒權4.2.11業(yè)務功功能銀行接收商商戶要求求身份鑒鑒權的交交易請求求，必須須包含客客戶卡號號、客戶戶姓名、客客戶證件件類型、客客戶證件件號碼、手手機號碼碼等信息息，銀行行核對卡卡號對應應的信息息與客戶戶提供的的信息一一致型，如如一致反反饋匹配配，否則則反饋不不匹配。4.2.22業(yè)務規(guī)規(guī)則由于快捷支支付的簽簽約是在在商戶端端完成的的，銀行行只是提提供身份份鑒權，協(xié)協(xié)助商戶戶驗證信信息的匹匹配性。商商戶必須須為客戶戶身份驗驗證承擔擔責任，確確保是持持卡人本本人，銀銀行不承承

24、擔責任任?？旖葜Ц逗灪灱s用戶戶的必須須持有手手機，且且手機號號為用戶戶在銀行行端開卡卡時所登登記的手手機號。銀行身份鑒鑒權，暫暫定為核核對卡對對應的客客戶姓名名、證件件類型、證證件號碼碼、手機機號碼，可可根據實實際情況況調整。建議商戶在在快捷支支付簽約約成功后后發(fā)手機機短信通通知客戶戶。4.2.33交互模模式在身份鑒權權業(yè)務中中，商戶戶與上海海銀行通通過請求求-應答答模式交交互。商戶作為服服務使用用者向銀銀行發(fā)送送 “身份鑒鑒權申請請”報文IIAReeq，銀銀行作為為服務提提供者向向商戶返返回“簽約應應答”報文IIARees。涉及到以下下交互：商戶將數據據發(fā)送到到銀行的的身份鑒鑒權服務務接口，

25、商商戶需調調用銀行行APII利用數數字證書書進行加加密，簽簽名。（見 HYPERLINK l _證書存取規(guī)范 數字簽簽名）銀行端校驗驗通過核核實客戶戶信息，并并在同一一個連接接中返回回IARRes報報文告訴訴銀行商商戶驗證證情況。銀銀行會對對返回數數據進行行加密，簽簽名。商戶端接口口銀行應應答報文文后，驗驗簽、解解析報文文后做后后續(xù)處理理。4.2.44報文格格式鑒權請求報報文IAAReqq（Iddenttityy Auutheentiicattionn Reequeest）IAReqq是從商商戶向銀銀行發(fā)起起的簽約約請求報報文。中文域名對應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報文發(fā)送方方的商戶戶標識銀行卡號cardNNochar(20)RY銀行卡代碼碼cardCCodeeChar(20)RY唯一區(qū)分銀銀行卡代代碼交易日期和和時間datechar(17)RYYYYYMMMDDD HH:MM:SSS結果代碼errorrCoddechar(4)RY成功SUCCC，失失敗見錯錯誤代碼碼錯誤描述errorrMesssaggecha

29、r(2566)ON消息擴展extennsioonON4.3網上上支付4.3.11業(yè)務功功能商戶負責驗驗證客戶戶持卡人人身份與與服務權權限，并并請求銀銀行劃撥撥客戶的的資金用用于互聯(lián)聯(lián)網交易易的支付付；銀行行負責驗驗證由商商戶發(fā)出出的支付付指令是是否在快快捷支付付簽約的的業(yè)務范范圍與銀銀行控制制的快捷捷支付支支付限額額內，并并實時扣扣減簽約約銀行卡卡內的余余額。由于網上支支付引起起的銀行行與商戶戶間的資資金清算算方法由由快捷支支付清算算標準規(guī)規(guī)定。4.3.22業(yè)務規(guī)規(guī)則該交易在執(zhí)執(zhí)行中需需要滿足足以下約約束條件件：支付必須由由客戶請請求，從從合作商商戶發(fā)起起（可以以網上、網網點等渠渠道）。商戶控

30、制支支付的資資金只能能從快捷捷支付簽簽約時確確定的簽簽約銀行行卡賬戶戶中支出出。銀行端做無無磁無密密交易。支付時客戶戶在簽約約銀行卡卡賬戶中中的資金金只能轉轉移到商商戶指定定的清算算賬戶中中。同一支付訂訂單號的的支付交交易，銀銀行端限限定只能能執(zhí)行一一次，永永不重復復。銀行與商戶戶需要保保存支付付相關報報文的日日志作為為解決資資金清算算不一致致的依據據。4.3.33處理流流程4.3.44交互模模式在支付業(yè)務務中，商商戶與銀銀行通過過請求-應答模模式交互互。商戶作為服服務使用用者向銀銀行發(fā)送送 “支付”請求報報文CPPReqq，銀行行作為服服務提供供者向商商戶返回回“網上支支付”應答報報文CPP

31、Ress。4.3.55報文格格式“網上支付付”請求報報文CPPReqq(Caard Payymennt RRequuestt)網上支付報報文請求求CPRReq(Carrd PPaymmentt Reequeest) 是從從商戶向向銀行發(fā)發(fā)起的支支付請求求。中文域名對應DTDD元素類型出現要求簽名要求說明版本號versiionchar(7)RN目前版本號號：”1.0.1”商戶標識instIIdchar(15)RY報文發(fā)送方方的商戶戶標識二級商戶代代碼twoIddchar(15)CN二級商戶代代碼適用于有些些商戶需需銀行在在賬單或或明細查查詢中顯顯示其平平臺的二二級商戶戶名稱訂單號orderrNu

32、mmchar(30)RY商戶支付訂訂單號/流水號號,永不不重復交易日期和和時間datechar(17)RYYYYYMMMDDD HH:MM:SS卡代號cardCCodeechar(20)RY鑒權時返回回的卡代代碼手續(xù)費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報文發(fā)送方方的商戶戶標識訂單號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業(yè)務功功能單筆退款是是在發(fā)生生在成功功充值之之后，將將該筆交交易充值值的款項項原路退退回到快快捷支付付簽約銀銀行卡賬賬戶中。充值退回

35、必須在商戶核實之后，由商戶發(fā)起。單筆退款交易為實時交易，即實時從商戶結算賬戶扣取，入個人賬戶。4.4.22業(yè)務規(guī)規(guī)則充值退回業(yè)業(yè)務在執(zhí)執(zhí)行中需需要滿足足以下約約束條件件：充值退回業(yè)業(yè)務從商商戶發(fā)起起。充值退回業(yè)業(yè)務必須須有對應應成功的的支付交交易。原則上商戶戶可以針針對900天內的的支付交交易發(fā)起起充值退退回業(yè)務務。特殊殊商戶可可另約定定。充值退回的的金額不不能超過過對應的的成功支支付交易易的金額額。針對一筆成成功的支支付充值值交易，可可以進行行多次退退回，但但退回的的總金額額不能大大于對應應該筆成成功支付付交易的的總金額額。退回的資金金只能原原路劃回回簽約銀銀行卡賬賬戶中。商戶結算賬賬戶應保

36、保留足夠夠的退款款資金。同一退回訂訂單號銀銀行必須須保證只只能執(zhí)行行一次。銀行與商戶戶需要保保存單筆筆退回相相關報文文的日志志，作為為解決資資金清算算不一致致的憑據據。4.4.33處理流流程4.4.44交互模模式在單筆退款款業(yè)務中中，商戶戶與銀行行通過請請求-應應答模式式交互。4.4.55報文格格式“單筆退款款”請求報報文SRRReqq(Siinglle RRefuund Reqquesst)中文域名對應DTDD元素類型出現要求簽名要求說明版本號versiionchar(7)RN目前版本號號：”1.0.1”商戶標識instIIdchar(15)RY報文發(fā)送方方的商戶戶標識訂單號orderrNu

37、mmchar(30)RY該筆退款交交易的商商戶訂單單號,永永不重復復交易日期和和時間datechar(17)RYYYYYMMMDDD HH:MM:SS卡代號cardCCodeechar(20)RY鑒權時返回回的卡代代碼手續(xù)費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報文發(fā)送方方的商戶戶標識訂單號orderrNummchar(30)RY商戶退款訂訂單號,永不重重復，同同支付時時訂單號號規(guī)制交易流水號號seriaalNoochar(20)RY銀行交易流流水號交易日期和和時間datechar(17)RYYYYYMMMDDD HH:MM:SSS 卡代號cardCCodeechar(20)RY退款請求中中的卡代代碼結果代碼errorrCoddechar(4)RY成功SUCCC，失失敗見錯錯誤代碼碼錯誤描述errorrMesssaggechar(2566)ON消息擴展extennsioonON4.5批量量退款4.5.11業(yè)務功功能批量退款業(yè)業(yè)務必須須在商戶戶

40、核實之之后，由由商戶發(fā)發(fā)起。商戶以提供供批量充充值退回回指令文文件的方方式，請請求銀行行執(zhí)行批批量的退退回處理理，銀行行以批量量退回處處理結果果文件的的形式，向向商戶返返回處理理結果。4.5.22業(yè)務規(guī)規(guī)則充值退回業(yè)業(yè)務在執(zhí)執(zhí)行中需需要滿足足以下約約束條件件：充值退回業(yè)業(yè)務從商商戶發(fā)起起。充值退回業(yè)業(yè)務必須須有對應應成功的的支付交交易。原則上商戶戶可以針針對900天內的的支付交交易發(fā)起起充值退退回業(yè)務務。特殊殊商戶可可另約定定。充值退回的的金額不不能超過過對應的的成功支支付交易易的金額額。針對一筆成成功的支支付充值值交易，可可以進行行多次退退回，但但退回的的總金額額不能大大于對應應該筆成成功支

41、付付交易的的總金額額。退回的資金金只能原原路劃回回簽約銀銀行卡賬賬戶中。同一退回訂訂單號銀銀行必須須保證只只能執(zhí)行行一次。銀行與商戶戶需要保保存單筆筆退回相相關報文文的日志志，作為為解決資資金清算算不一致致的憑據據。批量充值退退回文件件中，每每一筆都都是按照照獨立的的單筆指指令進行行處理。4.5.33處理流流程商戶將符合合條件的的等待處處理的快快捷支付付充值退退回申請請匯總成成批量退退回指令令文件。文件的格式見快捷支付批量退回指令文件格式說明。該文件保存在商戶文件服務器中。商戶以唯一一的批量量退回文文件批次次號、快快捷支付付批量退退回指令令文件的的下載UURL、快快捷支付付批量退退回文件件上傳

42、UURL等等要素為為參數，構構造“批量退退貨”通知BBRNootiffy，以以單向通通知方式式發(fā)送給給銀行。銀行收到“批量退退貨”通知BBRNootiffy之后后，從通通知中解解析出批批次號與與批量退退貨指令令文件下下載URRL，并并使用該該URLL下載批批量退貨貨文件。如如果文件件當時下下載不成成功，銀銀行會有有恰當的的重試策策略。銀行處理批批量退貨貨指令文文件。處處理的方方式是從從批量退退貨文件件中解析析出每一一筆退貨貨指令進進行分別別處理。針針對每一一筆退貨貨的銀行行內部處處理方式式與單筆筆退貨相相同。每每一筆退退貨的處處理結果果都記錄錄到批量量退貨結結果文件件中。銀行處理完完成后發(fā)發(fā)送

43、通知知報文告告知，商商戶主動動發(fā)起下下載結果果文件,或者由由商戶固固定時間間下載文文件也可可；考慮安全原原因，建建議哪方方生成的的文件存存放于哪哪方的sseveer，對對方可發(fā)發(fā)起下載載。4.5.44交互模模式銀行發(fā)送通通知報文文告知，商商戶主動動發(fā)起下下載結果果文件。注： 1、商商戶生成成的批量量退款文文件必須須按約定定的格式式及壓縮縮、加密密方式存存放。 并并應定義義下載的的URLL。 例例如3.5章章節(jié)文件件下載（銀銀行方UURL ） 4.5.55報文格格式“批量退貨貨”通知報報文BRRNottifyy(Baatchh Reefunnd NNotiify)批量退貨通通知報文文BRNNot

44、iify是是商戶向向銀行發(fā)發(fā)起的通通知批量量退貨文文件下載載請求。中文域名對應DTDD元素類型出現要求簽名要求說明版本號versiionchar(7)RN目前版本號號：”1.0.1”商戶標識instIIdchar(15)RY報文發(fā)送方方的商戶戶標識流水號orderrNummchar(30)RY訂單號/流流水號,永不重重復，定義該批批次的退退款文件件。交易日期和和時間datechar(17)RYYYYYMMMDDD HH:MM:SS文件下載UURLdownUUrlChar(1000)RY商戶發(fā)布的的退款文文件下載載URLL如，例如 HYPERLINK :80/file/download/ htt

45、p:/1:880/ffilee/doownlloadd/上海銀行只只能支持持IP地地址，不不支持域域名；請商戶在測測試和生生產前公公布，上上海銀行行會在其其防火墻墻上做網網絡綁定定文件名稱fileNNameechar(30)RYBRF_yyyyyymmddd_ssequuencce.zzip（見見 HYPERLINK l _文件命名規(guī)范 文件命命名規(guī)范范），其其中yyyyymmmddd是本報報文的交交易日期期。文件摘要digesstchar(40)RY見 HYPERLINK l _文件摘要 文件摘要要經過Basse644處理的的商戶證證書代碼碼KoalBB64CCertt

46、/RN商戶端讀取取本地商商戶證書書文件后后，再使使用上海海銀行提提供的AAPI進進行Baase664編碼碼后產生生的商戶戶證書數數據字串串。通知URLLnotiffyUrrlChar(1000)RY接收銀行批批量退款款處理結結果通知知的URRL消息擴展ExtennsioonO“批量退貨貨結果”通知報報文BRRRNootiffy(BBatcch RRefuund Ressultt Nootiffy)批量退貨結結果通知知報文BBRRNNotiify是是銀行向向商戶發(fā)發(fā)出的批批量退貨貨結果文文件通知知。中文域名對應DTDD元素類型出現要求簽名要求說明版本號versiionchar(7)RN目前版本號

47、號：”1.0.1”商戶標識instIIdchar(15)RY報文發(fā)送方方的商戶戶標識訂單號orderrNummchar(30)RY銀行產生的的批次流流水號交易日期和和時間datechar(17)RY銀行處理的的日期和和時間YYYYMMMDDD HH:MM:SS文件下載UURLdownUUrlChar(1000)RY銀行發(fā)布的的退款文文件下載載URLL見4.5 文件下下載（銀銀行端UURL）文件名稱fileNNameechar(30)RYBRRF_yyyyymmmdd_seqquennce.zipp（見 HYPERLINK l _文件命名規(guī)范 文文件命名名規(guī)范），其其中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 _文件命名規(guī)范 文文件命名名規(guī)范）)批量退貨指指令文件件由匯總總項與明明細項兩兩部分組組成。匯總項為文文件第一一行，其其中包含含以下各各項：中文名稱出現要求備注總金額R格式見 HYPERLINK l _金額格式 金額額格式說說明總筆數R明細項從文文件第二二行開始始直到文文件結束束，其中中每一行行包含以以下各項項： 中文名稱出現要求備注流水號（訂訂單號）R定義每筆交交易的退退款交易日期時時間RYYYYMMMDDD HH:MM:SS卡代

50、號R手續(xù)費O見 HYPERLINK l _金額格式 金額格式式說明(現在是是0)退貨金額R見 HYPERLINK l _金額格式 金額格式式說明交易貨幣代代碼R原流水號R支付流水號號原交易日期期R支付日期(YYYYYMMMDD)批量退貨結結果文件件格式(銀行按按標準生生成，文文件名約約定為BBRRF_yyyyyymmddd_ssequuencce.zzip（見見 HYPERLINK l _文件命名規(guī)范 文件命命名規(guī)范范）)批量退貨結結果文件件由匯總總項與明明細項兩兩部分組組成。匯總項為文文件第一一行，其其中包含含以下各各項：中文名稱出現要求備注處理成功總總金額R本批處理成成功的總總金額，格格式

51、見 HYPERLINK l _金額格式 金金額格式式說明處理成功總總筆數R本批處理成成功的總總筆數處理失敗總總筆數R本批處理失失敗的總總筆數明細項從文文件第二二行開始始直到文文件結束束，其中中每一行行包含以以下各項項：中文名稱出現要求備注流水號（訂訂單號）R定義每筆交交易的退退款交易日期時時間RYYYYMMMDDD HH:MM:SS卡代碼R手續(xù)費O見 HYPERLINK l _金額格式 金額格式式說明退貨金額R見 HYPERLINK l _金額格式 金額格式式說明交易貨幣代代碼R原流水號R批量退貨文文件中原原流水號號原交易日期期R批量退貨文文件中原原交易日日期(YYYYYYMMDDD)處理狀態(tài)

52、RY 成功；N 失失敗失敗原因R如果處理狀狀態(tài)為失失敗，則則描述失失敗的原原因。4.6單筆筆交易明明細查詢詢4.6.11業(yè)務功功能由商戶發(fā)起起，向銀銀行查詢詢某一訂單單號的交交易狀態(tài)態(tài)。當由于網絡絡或系統(tǒng)統(tǒng)故障產產生掉單單（商戶戶發(fā)出了了快捷支支付請求求報文，但但沒有收收到銀行行的應答答報文）時時，商戶戶可以使使用該交交易得到到銀行的的交易狀狀態(tài)，繼繼而對商商戶端的的指令進進行恢復復處理。4.6.22業(yè)務規(guī)規(guī)則該交易在執(zhí)執(zhí)行中需需要滿足足以下約約束條件件：可查詢銀行行開通的的各類交交易狀態(tài)態(tài)，如支支付、退退款。銀行端返回回的狀態(tài)態(tài)包括成成功、失失敗、處處理中。其其中成功功代表賬賬務處理理成功、

53、失失敗代表表賬務處處理失敗敗、處理理中代表表賬務未未明需晚晚間批量量對賬后后產生結結果。查詢條件中中訂單號號為必須須字段。4.6.33處理流流程4.6.44交互模模式在交易明細細查詢業(yè)業(yè)務中，商商戶與銀銀行通過過請求-應答模模式交互互。商戶作為服服務使用用者向銀銀行發(fā)送送 “查詢”請求報報文SQReeq，銀銀行作為為服務提提供者向向商戶返返回查詢詢應答報報文SQRees。4.6.55報文格格式“查詢”請請求報文文SQReeq (Sinnglee Queery Reqquesst)查詢請求報報文SQReeq是商商戶向銀銀行發(fā)起起的交易易明細查查詢請求求。中文域名對應DTDD元素類型出現要求簽名要

54、求說明版本號versiionchar(7)RN目前版本號號：”1.0.1”商戶標識instIIdchar(15)RY報文發(fā)送方方的商戶戶標識流水號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報文發(fā)送方方的商戶戶標識流水號seriaalNoochar(19)RY該筆查詢交交易的流流水號交易日期和和時間datechar(17)RYYYYYMMMDDD HH:MM:SS被查詢訂單單的交易易日期和和時間交易性質typechar(1)RY0全部; 1支付付; 22退款 3;

56、提提現訂單號orderrNummchar(30)RY需要查詢訂訂單號交易狀態(tài)statuuschar(4)RY交易狀態(tài)0000：成功，0001：失敗，0002：銀行處處理中，0003：銀行查查無此訂訂單。訂單失敗原原因orderrRemmakchar(1000)CN訂單失敗原原因支付卡號cardNNochar(45)CN交易卡號交易金額amounntchar (122)CN見 HYPERLINK l _金額格式 金額格式式說明手續(xù)費charggechar (122)ON手續(xù)費見 HYPERLINK l _金額格式 金金額格式式說明交易卡種cardTTypeeChar(1)CN交易卡種11借記卡卡

57、 2貸貸記卡 結果代碼errorrCoddechar(4)RY成功SUCCC，其其他表示示失敗，詳詳見 HYPERLINK l _錯誤代碼 錯誤誤代碼此項為描述述請求報報文本身身的對錯錯錯誤描述errorrMesssaggechar(2566)ON消息擴展extennsioonON4.7批量量交易查查詢4.7.11業(yè)務功功能由商戶發(fā)起起，向銀銀行查詢詢某一時時間段的的所有訂訂單的交交易狀態(tài)態(tài)。當由于網絡絡或系統(tǒng)統(tǒng)故障產產生掉單單（商戶戶發(fā)出了了快捷支支付請求求報文，但但沒有收收到銀行行的應答答報文）時時，商戶戶可以使使用該交交易得到到銀行的的交易狀狀態(tài)，繼繼而對商商戶端的的指令進進行恢復復處理

58、。4.7.22業(yè)務規(guī)規(guī)則該交易在執(zhí)執(zhí)行中需需要滿足足以下約約束條件件：可查詢銀行行開通的的各類交交易狀態(tài)態(tài)，如支支付、退退款。銀行端返回回的狀態(tài)態(tài)包括成成功、失失敗、處處理中。其其中成功功代表賬賬務處理理成功、失失敗代表表賬務處處理失敗敗、處理理中代表表賬務未未明需晚晚間批量量對賬后后產生結結果。查詢條件中中訂單號號為必須須字段。查詢時間段段需不大大于155分鐘。4.7.33處理流流程4.7.44交互模模式在交易明細細查詢業(yè)業(yè)務中，商商戶與銀銀行通過過請求-應答模模式交互互。商戶作為服服務使用用者向銀銀行發(fā)送送 “查詢”請求報報文TQQReqq，銀行行作為服服務提供供者向商商戶返回回查詢應應答

59、報文文TQRRes。4.7.55報文格格式“查詢”請請求報文文TQRReq (Trradee Quueryy Reequeest)查詢請求報報文TQQReqq是商戶戶向銀行行發(fā)起的的交易明明細查詢詢請求。中文域名對應DTDD元素類型出現要求簽名要求說明版本號versiionchar(7)RN目前版本號號：”1.0.1”商戶標識instIIdchar(15)RY報文發(fā)送方方的商戶戶標識流水號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編碼碼后產生生的商戶