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

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

2、敦迪刪除快捷捷支付業(yè)業(yè)務(wù)概述述；調(diào)整整錯(cuò)誤代代碼；重重定義身身份鑒權(quán)權(quán)報(bào)文頭頭；刪除除單筆提提現(xiàn)接口口；刪除除批量交交易明細(xì)細(xì)查詢，新增單單筆交易易明細(xì)查查詢黃敦迪20122-6-133.0黃敦迪增加批量量交易明明細(xì)查詢詢，修改改錯(cuò)誤代代碼黃敦迪20133-3-113.1黃敦迪修改身份份鑒權(quán)、網(wǎng)上支支付、單單筆退款款、批量量退款接接口，加加入了卡卡代號等等20133-3-123.2黃敦迪鑒權(quán)需中中賬戶姓姓名改為為必輸20133-4-113.3黃敦迪接口實(shí)現(xiàn)現(xiàn)說明中中批量交交易查詢詢改為非非必須實(shí)實(shí)現(xiàn)的接接口。批批量交易易查詢請請求報(bào)文文中加入入訂單號號列表20133-4-193.4彭小波修改身

3、份份鑒權(quán)接接口，CCVV22、有效效期改為為可選字字段，增增加KooalBB64CCertt;修改網(wǎng)網(wǎng)上支付付接口CCVV22、有效效期改為為可選字字段，返返回報(bào)文文銀行卡卡改為卡卡代號，黃敦迪20133-4-223.5.1彭小波批量交易易查詢增增加愛業(yè)業(yè)務(wù)規(guī)則則：訂單最多多支持110筆;查詢的多多條訂單單只返回回符合條條件的記記錄。20133-4-283.5.2彭小波為單筆退退款增加加錯(cuò)誤代代碼：44045520133-5-23.5.3黃敦迪單筆交易易明細(xì)查查詢應(yīng)答答報(bào)文中中staatuss枚舉值值調(diào)整及及定義eerroorCoode的的取值；批量交交易查詢詢應(yīng)答報(bào)報(bào)文TrradeeInff

4、o清單單中的ssignnNo改改為caardNNo20133-5-113.5.4彭小波錯(cuò)誤碼不不再分類類別擴(kuò)展鑒權(quán)權(quán)的證件件類別鑒權(quán)中增增加校驗(yàn)驗(yàn)規(guī)則，手機(jī)號號碼必須須為111位明確單筆筆訂單查查詢中的的交易日日期和時(shí)時(shí)間20133-5-173.5.5彭小波調(diào)整錯(cuò)誤誤碼描述述：30066 對應(yīng)描描述改為為卡號不不存在或或不支持持的銀行行卡30166 對對應(yīng)描述述改為銀銀行賬戶戶交易失失敗批量交易易查詢的的交易狀狀態(tài)進(jìn)行行調(diào)整：00000 成功功；00001失失敗20133-5-183.5.6彭小波30033的errrorrmesssagge從“身份證證號碼不不匹配”改為“身份證證件號碼碼不匹配

5、配”20133-5-213.5.7彭小波針對信用用卡的CCVV22和有效效期，增增加對應(yīng)應(yīng)的錯(cuò)誤誤碼：330500和3005120133-5-243.5.8彭小波身份鑒權(quán)權(quán)增加業(yè)業(yè)務(wù)邏輯輯：CVVV2和和有效期期需同時(shí)時(shí)輸入或或同時(shí)都都不輸入入20133-5-243.5.9彭小波網(wǎng)上支付付去除：CVVV2和有有效期20133-5-273.6黃敦迪刪除二級級商戶信信息同步步接口，增加單單筆撤消消接口20133-6-203.6.1彭小波批量交易易查詢響響應(yīng)報(bào)文文中交易易信息列列表trradeeInffoLiist 簽名要要求由”Y”變更為為”N”20133-6-263.6.2彭小波新增錯(cuò)誤誤碼：4

6、40466清算的的訂單不不能做撤撤銷處理理20133-6-273.6.3彭小波銀行流水水號由ccharr(199)統(tǒng)一一更改為為chaar(220),修改點(diǎn)點(diǎn)：網(wǎng)上上支付、單筆退退款、單單筆撤消消20133-6-273.6.4彭小波清算對賬賬中文件件格式中中銀行卡卡號修正正為銀行行卡代號號20133-7-13.6.5彭小波單筆撤消消上送報(bào)報(bào)文增加加交易金金額，同同時(shí)增加加校驗(yàn)：交易金金額必須須和原訂訂單交易易金額一一致20133-7-23.6.6彭小波清算對賬賬增加業(yè)業(yè)務(wù)規(guī)則則：信用用卡撤消消及對應(yīng)應(yīng)原訂單單不在清清算對賬賬文件內(nèi)內(nèi)。20133-7-5報(bào)文結(jié)構(gòu)構(gòu)上海銀行行快捷支支付報(bào)文文規(guī)范規(guī)

7、規(guī)定了上上海銀行行與商戶戶之間交交換報(bào)文文的處理理規(guī)范。報(bào)文結(jié)構(gòu)構(gòu)快捷支付付報(bào)文統(tǒng)統(tǒng)一采用用xmll格式。所有的的快捷支支付報(bào)文文均以BBankksh作作為根元元素，每每個(gè)Baankssh元素素中可以以包含多多個(gè)Meessaage元元素。Messsagee元素中中包含代代表具體體的業(yè)務(wù)務(wù)的元素素，比如如CSVVReqq、CSSVRees等。每個(gè)業(yè)業(yè)務(wù)元素素由一系系列屬性性元素構(gòu)構(gòu)成，不不同的業(yè)業(yè)務(wù)元素素中包含含的屬性性元素有有所不同同。對于涉及及到簽約約狀態(tài)修修改或者者資金變變動(dòng)的業(yè)業(yè)務(wù)元素素，必須須要有與與之匹配配的Siignaaturre元素素進(jìn)行數(shù)數(shù)字簽名名。作為約定定，Baankssh

8、元素素、Meessaage元元素與業(yè)業(yè)務(wù)元素素均是首首字母大大寫的CCameelCaase形形式，所所有的屬屬性元素素均是首首字母小小寫的CCameelCaase形形式。 以簽約請請求報(bào)文文為例，報(bào)文的的格式如如下： Messsagee idd 定義義為不重重復(fù)的隨隨機(jī)數(shù)，以防止止報(bào)文重重復(fù)提交交；在下文中中出現(xiàn)的的具體報(bào)報(bào)文格式式描述中中，“出現(xiàn)要要求”列包含含的值的的含義如如下表所所示：含義請求方約約束服務(wù)方約約束RRequuireed必須包含含該域必須校驗(yàn)驗(yàn)該域是是否存在在和內(nèi)容容的合法法性CCondditiionaal如果條件件符合必必須包含含該域當(dāng)條件滿滿足時(shí)，必須校校驗(yàn)該域域是否存

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

10、于請請求-應(yīng)應(yīng)答交互互模式，由服務(wù)務(wù)提供者者向服務(wù)務(wù)使用者者返回。服務(wù)應(yīng)應(yīng)答類報(bào)報(bào)文的命命令規(guī)范范是XXXRess，其中中XX是是報(bào)文代代表的業(yè)業(yè)務(wù)的首首字母縮縮略，RRes是是Ressponnse的的縮寫。比如對對于支付付應(yīng)答報(bào)報(bào)文，命命名為CCPRees，代代表Caard Payymennt RRespoonsee。通知類報(bào)報(bào)文通知類報(bào)報(bào)文用于于單向通通知交互互模式，由通知知發(fā)送者者向通知知接收者者發(fā)送。通知類類報(bào)文的的命令規(guī)規(guī)范是XXXNootiffy，其其中XXX是報(bào)文文代表的的業(yè)務(wù)的的首字母母縮略。通用報(bào)文文有兩種通通用報(bào)文文，一種種是Errrorr報(bào)文，用于返返回處理理錯(cuò)誤；另一種

11、種是NootiffyAccceppt，代代表單向向通知已已被接受受。通用報(bào)文文錯(cuò)誤代碼碼銀行返回回的錯(cuò)誤誤代碼說說明：錯(cuò)誤代碼碼錯(cuò)誤描述述解釋00000無效的根根元素根元素?zé)o無法識別別00011未定義的的消息域域消息不是是CSRReq、CSRRes等等；或者者消息發(fā)發(fā)送給了了一個(gè)錯(cuò)錯(cuò)誤的組組件00022必填域缺缺失00033根據(jù)規(guī)范范，一個(gè)個(gè)或多個(gè)個(gè)域不符符合格式式要求例如，非非數(shù)字，或者不不是有效效的日期期格式等等等。00044商戶標(biāo)識識不正確確insttId域域中的商商戶標(biāo)識識不正確確00055簽名無效效報(bào)文簽名名校驗(yàn)不不通過00066驗(yàn)證證書書有效性性失敗商戶證書書過期或或失效10000

12、文件格式式不正確確商戶批處處理業(yè)務(wù)務(wù)上傳文文件不正正確10011文件不存存在下載文件件時(shí)，找找不到指指定的文文件10022文件已處處理對于不允允許重復(fù)復(fù)處理的的業(yè)務(wù)的的文件，如果已已處理過過，就發(fā)發(fā)生此錯(cuò)錯(cuò)誤10033文件無法法解壓縮縮上傳的文文件無法法正確解解壓縮10044文件摘要要不正確確文件上傳傳通知報(bào)報(bào)文中的的文件摘摘要不正正確20011支付流水水重復(fù)重復(fù)的網(wǎng)網(wǎng)上支付付流水20022原支付流流水不存存在申請退貨貨的原支支付流水水不存在在20033查詢范圍圍太大查詢時(shí)間間跨度太太大20044退款訂單單日期錯(cuò)錯(cuò)誤退款訂單單日期小小于原訂訂單日期期20055當(dāng)日撤銷銷必須為為全額退退款業(yè)務(wù)要

13、求求：當(dāng)日日撤銷必必須為全全額30011真實(shí)姓名名不正確確真實(shí)姓名名與商戶戶端登記記的不一一致30022證件類型型不正確確證件類型型與商戶戶端登記記的不一一致30033身份證件件號碼不不匹配身份證件件號碼與與商戶端端登記的的身份證證件號碼碼不匹配配30044手機(jī)號不不匹配30055不支持的的銀行卡卡類型30066卡號不存存在或不不支持的的銀行卡卡30077未鑒權(quán)的的銀行卡卡未做過鑒鑒權(quán)的銀銀行卡（卡代號號不存在在時(shí)）30088認(rèn)證信息息不匹配配認(rèn)證信息息與商戶通過過認(rèn)證的的信息不不匹配30099銀行卡狀狀態(tài)不正正確銀行卡狀狀態(tài)不正正確30111原支付申申請流水水不存在在支付申請請流水不不存在（

14、用于退退款）30133金額超限限支付金額額超過每每日限額額（退款款時(shí)超出出原訂單單金額也也用這個(gè)個(gè)）30144余額不足足銀行賬戶戶中的余余額不足足以完成成支付30155銀行交易易處理中中該筆交易易在銀行行前置系系統(tǒng)中狀狀態(tài)未知知30166銀行賬戶戶交易失失敗銀行系統(tǒng)統(tǒng)的錯(cuò)誤誤返回。30500有效期錯(cuò)錯(cuò)誤或卡卡已過期期對信用卡卡有效期期的校驗(yàn)驗(yàn)，信用用卡有效效期輸錯(cuò)錯(cuò)，或信信用卡已已過有效效期30511CVV22錯(cuò)誤信用卡CCVV22的校驗(yàn)驗(yàn)40455未清算的的訂單不不能做退退款處理理不支持當(dāng)當(dāng)日退款款40011快捷支付付渠道關(guān)關(guān)閉沒有開通通快捷支支付業(yè)務(wù)務(wù)40022服務(wù)沒有有開通請求的業(yè)業(yè)務(wù)沒

15、有有開通40466清算的訂訂單不能能做撤銷銷處理清算的訂訂單不允允許做撤撤銷處理理90000暫時(shí)系統(tǒng)統(tǒng)異常通用性錯(cuò)錯(cuò)誤NotiifyAAcceept報(bào)報(bào)文功能用來代表表單向通通知已被被接受。消息域下表列舉舉了消息息域的定定義中文域名名對應(yīng)DTTD元素素類型出現(xiàn)要求求簽名要求求說明版本號verssionncharr(7)RN目前版本本號：”1.0.1”商戶標(biāo)識識insttIdcharr(155)RY報(bào)文發(fā)送送方的商商戶標(biāo)識識流水號ordeerNuumcharr(300)RY原商戶提提交的信信息流水水號交易日期期和時(shí)間間dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS結(jié)

16、果代碼碼erroorCoodecharr(4)RYSUCCC表示成成功其他均為為失敗錯(cuò)誤描述述erroorMeessaagecharr(2556)ON消息擴(kuò)展展exteensiionON報(bào)文的解解析與傳傳輸快捷支付付報(bào)文的的傳輸使使用HTTTP(S)方方式，在在HTTTP請求求/響應(yīng)應(yīng)體中包包含XMML形式式的報(bào)文文。報(bào)文解析析對XMLL解析的的基本要要求如下下：版本號檢檢查用于表示示組件支支持的協(xié)協(xié)議版本本號。消消息版本本號必須須表示為為：n+.n+.nn+ ，其中“nn” 表表示數(shù)字字，“+” 表示示一個(gè)或或多個(gè)。比如11.0或或1.00.1。在所有有的消息息中，各各組件都都必須填填寫自身

17、身支持的的協(xié)議版版本號。消息版版本號不不能低于于1.00.1。xml解解析為了可以以支持后后續(xù)協(xié)議議版本，xmll解析的的實(shí)現(xiàn)不不要做嚴(yán)嚴(yán)格的驗(yàn)驗(yàn)證。特特別是需需要忽略略未被確確認(rèn)的域域。所有有xmll消息必必須用“utff-8”編碼。Messsagee域之iid屬性性匹配請求和應(yīng)應(yīng)答報(bào)文文的Meessaage域域之idd屬性必必須相同同，idd是請求求方生成成的唯一一序列號號。比如如：銀行行在CSSReqq的Meessaage域域設(shè)置了了一個(gè)iid屬性性值，則則商戶在在CSRRes里里面的MMesssagee域的iid屬性性必須和和CSRReq的的Messsagge域之之id值值相同。報(bào)文傳

18、輸輸對HTTTPS傳傳輸?shù)幕疽笄笕缦拢菏褂肞OOST發(fā)發(fā)送消息息消息請求求基于HHTTPP/HTTTPSS的POOST方方式。HTTPP消息頭頭要求HTTPP請求與與響應(yīng)消消息中必必須按照照如下要要求設(shè)置置頭部域域：Conntennt-LLenggth:必須設(shè)設(shè)置成消消息體的的長度Conntennt-TTypee:必必須設(shè)置置下面的的值：aappllicaatioon/xxml; chharsset=utff-8文件交換換規(guī)范文件命名名規(guī)范文件命名名規(guī)范對對文件名名稱進(jìn)行行統(tǒng)一的的規(guī)劃，以達(dá)到到從文件件名稱上上區(qū)分不不同業(yè)務(wù)務(wù)文件的的目的。文件命命名規(guī)范范：fiilettypee_yyy

19、yymmmddd_seequeencee.ziip，其其中：fileetyppe文件類類型，如如：BRRF 批量量退款文文件；BBRRFF-批量量退款結(jié)結(jié)果文件件；CCCF清算對對賬文件件； IINFOO- 商商戶信息息文件；yyyyymmddd文件業(yè)業(yè)務(wù)日sequuencce批次號號， 以以01，02，03遞遞增，與與商戶一一般1天天交互一一次，故故批次號號固定為為“01”例如：CCF_2011002222_01.zipp （清算算對賬文文件）文件壓縮縮傳輸前需需要壓縮縮成ziip格式式。文件加密密對壓縮后后的文件件，需要要加密之之后再傳傳輸。加加密時(shí)采采用三重重DESS對稱加加密算法法3D

20、EES。加加密密鑰鑰按事先先約定方方式分發(fā)發(fā)。文件摘要要對加密后后的文件件進(jìn)行摘摘要。摘摘要算法法使用標(biāo)標(biāo)準(zhǔn)SHHA1算算法，結(jié)結(jié)果表示示成400位166進(jìn)制大大寫字母母數(shù)字串串。在商戶往往銀行發(fā)發(fā)送文件件下載請請求時(shí)需需對若干干域進(jìn)行行摘要，具體可可參考文文件下載載章節(jié)描描述；在銀行往往商戶反反饋文件件時(shí)，需需對文件件進(jìn)行摘摘要，文文件摘要要商戶可從從 htttpss的reespoonsee的heead域域里面的的Bannkshha1域域的值獲獲取摘要要，從BBankksiggn域的的值獲取取簽名。文件下載載（銀行行端URRL）文件采用用商戶主主動(dòng)請求求從銀行行文件服服務(wù)下載載的方式式。例如

21、銀行行文件服服務(wù)的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銀行行文件系系統(tǒng)的根根路徑。actiiontty

22、pee操作作類型（如：uuplooad表表示上傳傳、doownlloadd表示下下載）。insttId商戶戶標(biāo)識。 datee 交易日日期yyyyymmmddd。fileenamme遵循業(yè)業(yè)務(wù)文件件命名規(guī)規(guī)范的文文件名。KoallB644Cerrt商戶公公鑰Baase664位編編碼signn使用用cerrtIdd指定的的證書對對“acttionntyppe|iinsttId|datte|ffileenamme”進(jìn)行簽名名，對簽簽名結(jié)果進(jìn)進(jìn)行Baase664編碼碼獲得的的字符串串,詳情情見簽名名規(guī)范。文件下載載失敗hhttpp狀態(tài)碼碼1、4006：商商戶標(biāo)識識不匹配配2、4005：操操作類型型不

23、正確確3、4220：銀銀行端驗(yàn)驗(yàn)簽失敗敗4、4004：請請求文件件名不存存在5、4009：請請求文件件格式不不正確接口實(shí)現(xiàn)現(xiàn)規(guī)范接口實(shí)現(xiàn)現(xiàn)說明序號接口類型型交易類型型描述必須1身份鑒權(quán)權(quán)實(shí)時(shí)商戶發(fā)起起的實(shí)名名簽約驗(yàn)驗(yàn)證Y2網(wǎng)上支付付實(shí)時(shí)Y3單筆退款款實(shí)時(shí)Y4批量退款款批量N5單筆交易易明細(xì)查查詢實(shí)時(shí)Y6批量交易易查詢實(shí)時(shí)N7清算對帳帳批量Y8單筆撤消消實(shí)時(shí)N4.2身身份鑒權(quán)權(quán)4.2.1業(yè)務(wù)務(wù)功能銀行接收收商戶要要求身份份鑒權(quán)的的交易請請求，必必須包含含客戶卡卡號、客客戶姓名名、客戶戶證件類類型、客客戶證件件號碼、手機(jī)號號碼等信信息，銀銀行核對對卡號對對應(yīng)的信信息與客客戶提供供的信息息一致型型，

24、如一一致反饋饋匹配，否則反反饋不匹匹配。4.2.2業(yè)務(wù)務(wù)規(guī)則由于快捷捷支付的的簽約是是在商戶戶端完成成的，銀銀行只是是提供身身份鑒權(quán)權(quán)，協(xié)助助商戶驗(yàn)驗(yàn)證信息息的匹配配性。商商戶必須須為客戶戶身份驗(yàn)驗(yàn)證承擔(dān)擔(dān)責(zé)任，確保是是持卡人人本人，銀行不不承擔(dān)責(zé)責(zé)任。快捷支付付簽約用用戶的必必須持有有手機(jī)，且手機(jī)機(jī)號為用用戶在銀銀行端開開卡時(shí)所所登記的的手機(jī)號號。銀行身份份鑒權(quán)，暫定為為核對卡卡對應(yīng)的的客戶姓姓名、證證件類型型、證件件號碼、手機(jī)號號碼，可可根據(jù)實(shí)實(shí)際情況況調(diào)整。建議商戶戶在快捷捷支付簽簽約成功功后發(fā)手手機(jī)短信信通知客客戶。4.2.3交互互模式在身份鑒鑒權(quán)業(yè)務(wù)務(wù)中，商商戶與上上海銀行行通過請請

25、求-應(yīng)應(yīng)答模式式交互。商戶作為為服務(wù)使使用者向向銀行發(fā)發(fā)送 “身份鑒鑒權(quán)申請請”報(bào)文IIAReeq，銀銀行作為為服務(wù)提提供者向向商戶返返回“簽約應(yīng)應(yīng)答”報(bào)文IIARees。涉及到以以下交互互：商戶將數(shù)數(shù)據(jù)發(fā)送送到銀行行的身份份鑒權(quán)服服務(wù)接口口，商戶戶需調(diào)用用銀行AAPI利利用數(shù)字字證書進(jìn)進(jìn)行加密密，簽名名。（見 HYPERLINK l _證書存取規(guī)范 數(shù)字簽簽名）銀行端校校驗(yàn)通過過核實(shí)客客戶信息息，并在在同一個(gè)個(gè)連接中中返回IIARees報(bào)文文告訴銀銀行商戶戶驗(yàn)證情情況。銀銀行會對對返回?cái)?shù)數(shù)據(jù)進(jìn)行行加密，簽名。商戶端接接口銀行行應(yīng)答報(bào)報(bào)文后，驗(yàn)簽、解析報(bào)報(bào)文后做做后續(xù)處處理。4.2.4報(bào)文文格

26、式鑒權(quán)請求求報(bào)文IIAReeq（IIdenntitty AAuthhentticaatioon RRequuestt）IAReeq是從從商戶向向銀行發(fā)發(fā)起的簽簽約請求求報(bào)文。中文域名名對應(yīng)DTTD元素素類型出現(xiàn)要求求簽名要求求說明版本號verssionncharr(7)RN目前版本本號：”1.0.1”商戶標(biāo)識識insttIdcharr(155)RY由銀行分分配固定定值,請請求報(bào)文文中需填填寫交易日期期和時(shí)間間dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS客戶姓名名nameecharr(300)RY簽約銀行行卡號carddNocharr(200)RY簽約銀行行卡類型

27、型carddTyppecharr(1)RY1借記卡卡 2貸貸記卡 證件類型型certtTyppecharr(1)RY1：身份份證；2：護(hù)照照；3：軍官官證；4：士兵兵證；5：戶口口本；6：警官官證；7：臺胞胞證證件號碼碼certtNocharr(300)RY手機(jī)號mobiilePPhonneCharr(200)RY持卡人在在銀行留留的手機(jī)機(jī)號手機(jī)號必必須為111位CVV22cvv22Charr(3)ON卡背面簽簽名欄的的后三位位數(shù)字CVV22和有效效期需同同時(shí)輸入入或同時(shí)時(shí)都不輸輸入有效期valiidittyCharr(4)ONMMYYYCVV22和有效效期需同同時(shí)輸入入或同時(shí)時(shí)都不輸輸入經(jīng)過

28、Baase664處理理的商戶戶證書代代碼KoallB644Cerrt/RN商戶端讀讀取本地地商戶證證書文件件后，再再使用上上海銀行行提供的的APII進(jìn)行Baase664編碼碼后產(chǎn)生生的商戶戶證書數(shù)數(shù)據(jù)字串串。消息擴(kuò)展展exteensiionON簽約應(yīng)答答報(bào)文IIARRess（Iddenttityy Auutheentiicattionn Reespoonsee）IARRRes銀銀行返回回給商戶戶的應(yīng)答答。中文域名名對應(yīng)DTTD元素素類型出現(xiàn)要求求簽名要求求說明版本號verssionncharr(7)RN目前版本本號：”1.0.1”商戶標(biāo)識識insttIdcharr(155)RY報(bào)文發(fā)送送方的商

29、商戶標(biāo)識識銀行卡號號carddNocharr(200)RY銀行卡代代碼carddCoddeCharr(200)RY唯一區(qū)分分銀行卡卡代碼交易日期期和時(shí)間間dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS結(jié)果代碼碼erroorCoodecharr(4)RY成功SUUCC，失敗見見錯(cuò)誤代代碼錯(cuò)誤描述述erroorMeessaagecharr(2556)ON消息擴(kuò)展展exteensiionON4.3網(wǎng)網(wǎng)上支付付4.3.1業(yè)務(wù)務(wù)功能商戶負(fù)責(zé)責(zé)驗(yàn)證客客戶持卡卡人身份份與服務(wù)務(wù)權(quán)限，并請求求銀行劃劃撥客戶戶的資金金用于互互聯(lián)網(wǎng)交交易的支支付；銀銀行負(fù)責(zé)責(zé)驗(yàn)證由由商戶發(fā)出出的支付

30、付指令是是否在快快捷支付付簽約的的業(yè)務(wù)范范圍與銀銀行控制制的快捷捷支付支支付限額額內(nèi)，并并實(shí)時(shí)扣扣減簽約約銀行卡卡內(nèi)的余余額。由于網(wǎng)上上支付引引起的銀銀行與商商戶間的的資金清清算方法法由快捷捷支付清清算標(biāo)準(zhǔn)準(zhǔn)規(guī)定。4.3.2業(yè)務(wù)務(wù)規(guī)則該交易在在執(zhí)行中中需要滿滿足以下下約束條條件：支付必須須由客戶戶請求，從合作作商戶發(fā)發(fā)起（可可以網(wǎng)上上、網(wǎng)點(diǎn)點(diǎn)等渠道道）。商戶控制制支付的的資金只只能從快快捷支付付簽約時(shí)時(shí)確定的的簽約銀銀行卡賬賬戶中支支出。銀行端做做無磁無無密交易易。支付時(shí)客客戶在簽簽約銀行行卡賬戶戶中的資資金只能能轉(zhuǎn)移到到商戶指指定的清清算賬戶戶中。同一支付付訂單號號的支付付交易，銀行端端限定

31、只只能執(zhí)行行一次，永不重重復(fù)。銀行與商商戶需要要保存支支付相關(guān)關(guān)報(bào)文的的日志作作為解決決資金清清算不一一致的依依據(jù)。4.3.3處理理流程4.3.4交互互模式在支付業(yè)業(yè)務(wù)中，商戶與與銀行通通過請求求-應(yīng)答答模式交交互。商戶作為為服務(wù)使使用者向向銀行發(fā)發(fā)送 “支付”請求報(bào)報(bào)文CPPReqq，銀行行作為服服務(wù)提供供者向商商戶返回回“網(wǎng)上支支付”應(yīng)答報(bào)報(bào)文CPPRess。4.3.5報(bào)文文格式“網(wǎng)上支支付”請求報(bào)報(bào)文CPPReqq(Caard Payymennt RRequuestt)網(wǎng)上支付付報(bào)文請請求CPPReqq(Caard Payymennt RRequuestt) 是是從商戶戶向銀行行發(fā)起的的

32、支付請請求。中文域名名對應(yīng)DTTD元素素類型出現(xiàn)要求求簽名要求求說明版本號verssionncharr(7)RN目前版本本號：”1.0.1”商戶標(biāo)識識insttIdcharr(155)RY報(bào)文發(fā)送送方的商商戶標(biāo)識識二級商戶戶代碼twoIIdcharr(155)CN二級商戶戶代碼適用于有有些商戶戶需銀行行在賬單單或明細(xì)細(xì)查詢中中顯示其其平臺的的二級商商戶名稱稱訂單號ordeerNuumcharr(300)RY商戶支付付訂單號號/流水水號,永永不重復(fù)復(fù)交易日期期和時(shí)間間dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS卡代號carddCoddecharr(200)RY鑒權(quán)

33、時(shí)返返回的卡卡代碼手續(xù)費(fèi)charrgeLongg(122)ON預(yù)留字段段，見 HYPERLINK l _金額格式 金額格格式說明明交易金額額amouuntLongg(122)RY見 HYPERLINK l _金額格式 金額格格式說明明交易貨幣幣代碼currrenccycharr(3)RY見 HYPERLINK l _卡通貨幣代碼表 快捷支支付貨幣幣代碼表表經(jīng)過Baase664處理理的商戶戶證書代代碼KoallB644Cerrt/RN商戶端讀讀取本地地商戶證證書文件件后，再再使用上上海銀行行提供的的APII進(jìn)行Baase664編碼碼后產(chǎn)生生的商戶戶證書數(shù)數(shù)據(jù)字串串。消息擴(kuò)展展exteensiio

34、nON“網(wǎng)上支支付”應(yīng)答報(bào)報(bào)文CPPRess(Carrd PPaymmentt Reespoonsee)網(wǎng)上支付付應(yīng)答報(bào)報(bào)文CPPRess是銀行行返回給給商戶CCPReeq的應(yīng)應(yīng)答。中文域名名對應(yīng)DTTD元素素類型出現(xiàn)要求求簽名要求求說明版本號verssionncharr(7)RN目前版本本號：”1.0.1”商戶標(biāo)識識insttIdcharr(155)RY報(bào)文發(fā)送送方的商商戶標(biāo)識識訂單號ordeerNuumcharr(300)RY商戶支付付訂單號號/流水水號,永永不重復(fù)復(fù)卡代號carddCoddecharr(200)RY用于支付付的卡代代號（來來自CPPReqq）交易流水水號seriialNN

35、ocharr(200)RY銀行交易易流水號號交易日期期和時(shí)間間dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS結(jié)果代碼碼erroorCoodecharr(4)RY成功SUUCC，失敗見見錯(cuò)誤代代碼錯(cuò)誤描述述erroorMeessaagecharr(2556)ON消息擴(kuò)展展exteensiionON4.4單單筆退款款4.4.1業(yè)務(wù)務(wù)功能單筆退款款是在發(fā)發(fā)生在成成功充值值之后，將該筆筆交易充充值的款款項(xiàng)原路路退回到到快捷支支付簽約約銀行卡卡賬戶中中。充值值退回必必須在商商戶核實(shí)實(shí)之后，由商戶戶發(fā)起。單筆退退款交易易為實(shí)時(shí)時(shí)交易，即實(shí)時(shí)時(shí)從商戶戶結(jié)算賬賬戶扣取取，入個(gè)個(gè)人

36、賬戶戶。4.4.2業(yè)務(wù)務(wù)規(guī)則充值退回回業(yè)務(wù)在在執(zhí)行中中需要滿滿足以下下約束條條件：充值退回回業(yè)務(wù)從從商戶發(fā)發(fā)起。充值退回回業(yè)務(wù)必必須有對對應(yīng)成功功的支付付交易。原則上商商戶可以以針對990天內(nèi)內(nèi)的支付付交易發(fā)發(fā)起充值值退回業(yè)業(yè)務(wù)。特特殊商戶戶可另約約定。充值退回回的金額額不能超超過對應(yīng)應(yīng)的成功功支付交交易的金金額。針對一筆筆成功的的支付充充值交易易，可以以進(jìn)行多多次退回回，但退退回的總總金額不不能大于于對應(yīng)該該筆成功功支付交交易的總總金額。退回的資資金只能能原路劃劃回簽約約銀行卡卡賬戶中中。商戶結(jié)算算賬戶應(yīng)應(yīng)保留足足夠的退退款資金金。同一退回回訂單號號銀行必必須保證證只能執(zhí)執(zhí)行一次次。銀行與商

37、商戶需要要保存單單筆退回回相關(guān)報(bào)報(bào)文的日日志，作作為解決決資金清清算不一一致的憑憑據(jù)。4.4.3處理理流程4.4.4交互互模式在單筆退退款業(yè)務(wù)務(wù)中，商商戶與銀銀行通過過請求-應(yīng)答模模式交互互。4.4.5報(bào)文文格式“單筆退退款”請求報(bào)報(bào)文SRRReqq(Siinglle RRefuund Reqquesst)中文域名名對應(yīng)DTTD元素素類型出現(xiàn)要求求簽名要求求說明版本號verssionncharr(7)RN目前版本本號：”1.0.1”商戶標(biāo)識識insttIdcharr(155)RY報(bào)文發(fā)送送方的商商戶標(biāo)識識訂單號ordeerNuumcharr(300)RY該筆退款款交易的的商戶訂訂單號,永不重重

38、復(fù)交易日期期和時(shí)間間dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS卡代號carddCoddecharr(200)RY鑒權(quán)時(shí)返返回的卡卡代碼手續(xù)費(fèi)charrgeLongg(122)ON預(yù)留字段段，見 HYPERLINK l _金額格式 金額格格式說明明交易金額額amouuntLongg(122)RY見 HYPERLINK l _金額格式 金額格格式說明明交易貨幣幣代碼currrenccycharr(3)RY見 HYPERLINK l _卡通貨幣代碼表 快捷支支付貨幣幣代碼表表原訂單號號oldoordeerNuumcharr(300)RY對應(yīng)原支支付交易易的訂單單號，

39、永永不重復(fù)復(fù)原交易日日期和時(shí)時(shí)間oldddateecharr(8)RYYYYYYMMDDD經(jīng)過Baase664處理理的商戶戶證書代代碼KoallB644Cerrt/RN商戶端讀讀取本地地商戶證證書文件件后，再再使用上上海銀行行提供的的APII進(jìn)行Baase664編碼碼后產(chǎn)生生的商戶戶證書數(shù)數(shù)據(jù)字串串。消息擴(kuò)展展exteensiionON“單筆退退款”應(yīng)答報(bào)報(bào)文SRRRess(Siinglle RRefuund Ressponnse)中文域名名對應(yīng)DTTD元素素類型出現(xiàn)要求求簽名要求求說明版本號verssionncharr(7)RN目前版本本號：”1.0.1”商戶標(biāo)識識insttIdcharr(

40、155)RY報(bào)文發(fā)送送方的商商戶標(biāo)識識訂單號ordeerNuumcharr(300)RY商戶退款款訂單號號,永不不重復(fù)，同支付付時(shí)訂單單號規(guī)制制交易流水水號seriialNNocharr(200)RY銀行交易易流水號號交易日期期和時(shí)間間dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS卡代號carddCoddecharr(200)RY退款請求求中的卡卡代碼結(jié)果代碼碼erroorCoodecharr(4)RY成功SUUCC，失敗見見錯(cuò)誤代代碼錯(cuò)誤描述述erroorMeessaagecharr(2556)ON消息擴(kuò)展展exteensiionON4.5批批量退款款4.5.1

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

42、總金額不不能大于于對應(yīng)該該筆成功功支付交交易的總總金額。退回的資資金只能能原路劃劃回簽約約銀行卡卡賬戶中中。同一退回回訂單號號銀行必必須保證證只能執(zhí)執(zhí)行一次次。銀行與商商戶需要要保存單單筆退回回相關(guān)報(bào)報(bào)文的日日志，作作為解決決資金清清算不一一致的憑憑據(jù)。批量充值值退回文文件中，每一筆筆都是按按照獨(dú)立立的單筆筆指令進(jìn)進(jìn)行處理理。4.5.3處理理流程商戶將符符合條件件的等待待處理的的快捷支支付充值值退回申申請匯總總成批量量退回指指令文件件。文件件的格式式見快捷捷支付批批量退回回指令文文件格式式說明。該文件件保存在在商戶文文件服務(wù)務(wù)器中。商戶以唯唯一的批批量退回回文件批批次號、快捷支支付批量量退回指

43、指令文件件的下載載URLL、快捷捷支付批批量退回回文件上上傳URRL等要要素為參參數(shù)，構(gòu)構(gòu)造“批量退退貨”通知BBRNootiffy，以以單向通通知方式式發(fā)送給給銀行。銀行收到到“批量退退貨”通知BBRNootiffy之后后，從通通知中解解析出批批次號與與批量退退貨指令令文件下下載URRL，并并使用該該URLL下載批批量退貨貨文件。如果文文件當(dāng)時(shí)時(shí)下載不不成功，銀行會會有恰當(dāng)當(dāng)?shù)闹卦囋嚥呗?。銀行處理理批量退退貨指令令文件。處理的的方式是是從批量量退貨文文件中解解析出每每一筆退退貨指令令進(jìn)行分分別處理理。針對對每一筆筆退貨的的銀行內(nèi)內(nèi)部處理理方式與與單筆退退貨相同同。每一一筆退貨貨的處理理結(jié)果都

44、都記錄到到批量退退貨結(jié)果果文件中中。銀行處理理完成后后發(fā)送通通知報(bào)文文告知，商戶主主動(dòng)發(fā)起起下載結(jié)結(jié)果文件件,或者者由商戶戶固定時(shí)時(shí)間下載載文件也也可；考慮安全全原因，建議哪哪方生成成的文件件存放于于哪方的的sevver，對方可可發(fā)起下下載。4.5.4交互互模式銀行發(fā)送送通知報(bào)報(bào)文告知知，商戶戶主動(dòng)發(fā)發(fā)起下載載結(jié)果文文件。注： 11、商戶戶生成的的批量退退款文件件必須按按約定的的格式及及壓縮、加密方方式存放放。 并應(yīng)定定義下載載的URRL。 例如33.5章章節(jié)文件件下載（銀行方方URLL ）4.5.5報(bào)文文格式“批量退退貨”通知報(bào)報(bào)文BRRNottifyy(Baatchh Reefunnd N

45、Notiify)批量退貨貨通知報(bào)報(bào)文BRRNottifyy是商戶戶向銀行行發(fā)起的的通知批批量退貨貨文件下下載請求求。中文域名名對應(yīng)DTTD元素素類型出現(xiàn)要求求簽名要求求說明版本號verssionncharr(7)RN目前版本本號：”1.0.1”商戶標(biāo)識識insttIdcharr(155)RY報(bào)文發(fā)送送方的商商戶標(biāo)識識流水號ordeerNuumcharr(300)RY訂單號/流水號號,永不不重復(fù)，定義該該批次的的退款文文件。交易日期期和時(shí)間間dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS文件下載載URLLdownnUrllCharr(1000)RY商戶發(fā)布布的退款款

46、文件下下載URRL如，例如如 HYPERLINK :80/file/download/ httpp:/17:80/fille/ddownnloaad/上海銀行行只能支支持IPP地址，不支持持域名；請商戶在在測試和和生產(chǎn)前前公布，上海銀銀行會在在其防火火墻上做做網(wǎng)絡(luò)綁綁定文件名稱稱fileeNammecharr(300)RYBRF_yyyyymmmdd_seqquennce.zipp（見 HYPERLINK l _文件命名規(guī)范 文文件命名名規(guī)范），其中中yyyyymmmdd是是本報(bào)文文的交易易日期。文件摘要要digeestcharr(400)RY見 HYPERLINK l _文件摘要 文件摘摘要

47、經(jīng)過Baase664處理理的商戶戶證書代代碼KoallB644Cerrt/RN商戶端讀讀取本地地商戶證證書文件件后，再再使用上上海銀行行提供的的APII進(jìn)行Baase664編碼碼后產(chǎn)生生的商戶戶證書數(shù)數(shù)據(jù)字串串。通知URRLnotiifyUUrlCharr(1000)RY接收銀行行批量退退款處理理結(jié)果通通知的UURL消息擴(kuò)展展ExteensiionO“批量退退貨結(jié)果果”通知報(bào)報(bào)文BRRRNootiffy(BBatcch RRefuund Ressultt Nootiffy)批量退貨貨結(jié)果通通知報(bào)文文BRRRNottifyy是銀行行向商戶戶發(fā)出的的批量退退貨結(jié)果果文件通通知。中文域名名對應(yīng)DTT

48、D元素素類型出現(xiàn)要求求簽名要求求說明版本號verssionncharr(7)RN目前版本本號：”1.0.1”商戶標(biāo)識識insttIdcharr(155)RY報(bào)文發(fā)送送方的商商戶標(biāo)識識訂單號ordeerNuumcharr(300)RY銀行產(chǎn)生生的批次次流水號號交易日期期和時(shí)間間dateecharr(177)RY銀行處理理的日期期和時(shí)間間YYYYYMMDDDHHH:MMM:SSS文件下載載URLLdownnUrllCharr(1000)RY銀行發(fā)布布的退款款文件下下載URRL見4.55 文件件下載（銀行端端URLL）文件名稱稱fileeNammecharr(300)RYBRRFF_yyyyymmm

49、ddd_seequeencee.ziip（見見 HYPERLINK l _文件命名規(guī)范 文件命命名規(guī)范范），其其中yyyyymmmddd是本報(bào)報(bào)文的交交易日期期。文件摘要要digeestcharr(400)RY見 HYPERLINK l _文件摘要 文件摘摘要原流水號號orgiinallSerriallNocharr(199)RY來自BRRNottifyy中批量量退貨請請求流水水號原交易日日期origginaalDaatecharr(177)RYYYYYYMMDDDHHH:MMM:SSS (來來自BRRNottifyy中批量量退貨請請求交易易日期和和時(shí)間)消息擴(kuò)展展ExteensiionO4.

50、5.6文件件格式文件格式式文件格式式采用 HYPERLINK /html/rfc4180 CCSV（Commma-Sepparaatedd Vaariaablee）標(biāo)準(zhǔn)。批量退貨貨指令文文件格式式(商戶戶按標(biāo)準(zhǔn)準(zhǔn)生成 ，文件件名約定定為BRRF_yyyyyymmddd_ssequuencce.zzip（見 HYPERLINK l _文件命名規(guī)范 文件件命名規(guī)規(guī)范）)批量退貨貨指令文文件由匯匯總項(xiàng)與與明細(xì)項(xiàng)項(xiàng)兩部分分組成。匯總項(xiàng)為為文件第第一行，其中包包含以下下各項(xiàng)：中文名稱稱出現(xiàn)要求求備注總金額R格式見 HYPERLINK l _金額格式 金金額格式式說明總筆數(shù)R明細(xì)項(xiàng)從從文件第第二行開開始直

51、到到文件結(jié)結(jié)束，其其中每一一行包含含以下各各項(xiàng)：中文名稱稱出現(xiàn)要求求備注流水號（訂單號號）R定義每筆筆交易的的退款交易日期期時(shí)間RYYYYYMMDDDHHH:MMM:SSS卡代號R手續(xù)費(fèi)O見 HYPERLINK l _金額格式 金額格格式說明明(現(xiàn)在在是0)退貨金額額R見 HYPERLINK l _金額格式 金額格格式說明明交易貨幣幣代碼R原流水號號R支付流水水號原交易日日期R支付日期期(YYYYYMMMDDD)批量退貨貨結(jié)果文文件格式式(銀行行按標(biāo)準(zhǔn)準(zhǔn)生成，文件名名約定為為BRRF_yyyyyymmddd_ssequuencce.zzip（見 HYPERLINK l _文件命名規(guī)范 文件件命

52、名規(guī)規(guī)范）)批量退貨貨結(jié)果文文件由匯匯總項(xiàng)與與明細(xì)項(xiàng)項(xiàng)兩部分分組成。匯總項(xiàng)為為文件第第一行，其中包包含以下下各項(xiàng)：中文名稱稱出現(xiàn)要求求備注處理成功功總金額額R本批處理理成功的的總金額額，格式式見 HYPERLINK l _金額格式 金額額格式說說明處理成功功總筆數(shù)數(shù)R本批處理理成功的的總筆數(shù)數(shù)處理失敗敗總筆數(shù)數(shù)R本批處理理失敗的的總筆數(shù)數(shù)明細(xì)項(xiàng)從從文件第第二行開開始直到到文件結(jié)結(jié)束，其其中每一一行包含含以下各各項(xiàng)：中文名稱稱出現(xiàn)要求求備注流水號（訂單號號）R定義每筆筆交易的的退款交易日期期時(shí)間RYYYYYMMDDDHHH:MMM:SSS卡代碼R手續(xù)費(fèi)O見 HYPERLINK l _金額格式 金

53、額格格式說明明退貨金額額R見 HYPERLINK l _金額格式 金額格格式說明明交易貨幣幣代碼R原流水號號R批量退貨貨文件中中原流水水號原交易日日期R批量退貨貨文件中中原交易易日期(YYYYYMMMDD)處理狀態(tài)態(tài)RY 成功功；N 失敗失敗原因因R如果處理理狀態(tài)為為失敗，則描述述失敗的的原因。4.6單單筆交易易明細(xì)查查詢4.6.1業(yè)務(wù)務(wù)功能由商戶發(fā)發(fā)起，向向銀行查查詢某一一訂單號號的交易易狀態(tài)。當(dāng)由于網(wǎng)網(wǎng)絡(luò)或系系統(tǒng)故障障產(chǎn)生掉掉單（商商戶發(fā)出出了快捷捷支付請請求報(bào)文文，但沒沒有收到到銀行的的應(yīng)答報(bào)報(bào)文）時(shí)時(shí)，商戶戶可以使使用該交交易得到到銀行的的交易狀狀態(tài)，繼繼而對商商戶端的的指令進(jìn)進(jìn)行恢復(fù)

54、復(fù)處理。4.6.2業(yè)務(wù)務(wù)規(guī)則該交易在在執(zhí)行中中需要滿滿足以下下約束條條件：可查詢銀銀行開通通的各類類交易狀狀態(tài)，如如支付、退款。銀行端返返回的狀狀態(tài)包括括成功、失敗、處理中中。其中中成功代代表賬務(wù)務(wù)處理成成功、失失敗代表表賬務(wù)處處理失敗敗、處理理中代表表賬務(wù)未未明需晚晚間批量量對賬后后產(chǎn)生結(jié)結(jié)果。查詢條件件中訂單單號為必必須字段段。4.6.3處理理流程4.6.4交互互模式在交易明明細(xì)查詢詢業(yè)務(wù)中中，商戶戶與銀行行通過請請求-應(yīng)應(yīng)答模式式交互。商戶作為為服務(wù)使使用者向向銀行發(fā)發(fā)送 “查詢”請求報(bào)報(bào)文SQReeq，銀銀行作為為服務(wù)提提供者向向商戶返返回查詢詢應(yīng)答報(bào)報(bào)文SQRees。4.6.5報(bào)文文

55、格式“查詢”請求報(bào)報(bào)文SQReeq (SinngleeQueery Reqquesst)查詢請求求報(bào)文SSQReeq是商商戶向銀銀行發(fā)起起的交易易明細(xì)查查詢請求求。中文域名名對應(yīng)DTTD元素素類型出現(xiàn)要求求簽名要求求說明版本號verssionncharr(7)RN目前版本本號：”1.0.1”商戶標(biāo)識識insttIdcharr(155)RY報(bào)文發(fā)送送方的商商戶標(biāo)識識流水號seriialNNocharr(199)RY該筆查詢詢交易的的流水號號交易日期期和時(shí)間間dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS交易性質(zhì)質(zhì)typeecharr(1)RY0全部; 1支支付; 2

56、退款款 3;提現(xiàn)訂單號ordeerNuumcharr(300)RY需要查詢詢訂單號號經(jīng)過Baase664處理理的商戶戶證書代代碼KoallB644CerrtRN商戶端讀讀取本地地商戶證證書文件件后，再再使用上上海銀行行提供的的APII進(jìn)行Baase664編碼碼后產(chǎn)生生的商戶戶證書數(shù)數(shù)據(jù)字串串。消息擴(kuò)展展exteensiionON“查詢”應(yīng)答報(bào)報(bào)文SQRees (SinngleeQueery Ressponnse)中文域名名對應(yīng)DTTD元素素類型出現(xiàn)要求求簽名要求求說明版本號verssionncharr(7)RN目前版本本號：”1.0.1”商戶標(biāo)識識insttIdcharr(155)RY報(bào)文發(fā)送

57、送方的商商戶標(biāo)識識流水號seriialNNocharr(199)RY該筆查詢詢交易的的流水號號交易日期期和時(shí)間間dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS被查詢訂訂單的交交易日期期和時(shí)間間交易性質(zhì)質(zhì)typeecharr(1)RY0全部; 1支支付; 2退款款 3;提現(xiàn)訂單號ordeerNuumcharr(300)RY需要查詢詢訂單號號交易狀態(tài)態(tài)stattuscharr(4)RY交易狀態(tài)態(tài)00000：成功功，00011：失敗敗，00022：銀行行處理中中，00033：銀行行查無此此訂單。訂單失敗敗原因ordeerReemakkcharr(1000)CN訂單失敗敗

58、原因支付卡號號carddNocharr(455)CN交易卡號號交易金額額amouuntcharr (112)CN見 HYPERLINK l _金額格式 金額格格式說明明手續(xù)費(fèi)charrgecharr (112)ON手續(xù)費(fèi)見見 HYPERLINK l _金額格式 金額格格式說明明交易卡種種carddTyppeCharr(1)CN交易卡種種1借記記卡 22貸記卡卡 結(jié)果代碼碼erroorCoodecharr(4)RY成功SUUCC，其他表表示失敗敗，詳見見 HYPERLINK l _錯(cuò)誤代碼 錯(cuò)誤代代碼此項(xiàng)為描描述請求求報(bào)文本本身的對對錯(cuò)錯(cuò)誤描述述erroorMeessaagecharr(2556

59、)ON消息擴(kuò)展展exteensiionON4.7批批量交易易查詢4.7.1業(yè)務(wù)務(wù)功能由商戶發(fā)發(fā)起，向向銀行查查詢某一一時(shí)間段段的所有有訂單的的交易狀狀態(tài)。當(dāng)由于網(wǎng)網(wǎng)絡(luò)或系系統(tǒng)故障障產(chǎn)生掉掉單（商商戶發(fā)出出了快捷捷支付請請求報(bào)文文，但沒沒有收到到銀行的的應(yīng)答報(bào)報(bào)文）時(shí)時(shí)，商戶戶可以使使用該交交易得到到銀行的的交易狀狀態(tài)，繼繼而對商商戶端的的指令進(jìn)進(jìn)行恢復(fù)復(fù)處理。4.7.2業(yè)務(wù)務(wù)規(guī)則該交易在在執(zhí)行中中需要滿滿足以下下約束條條件：可查詢銀銀行開通通的各類類交易狀狀態(tài)，如如支付、退款。銀行端返返回的狀狀態(tài)包括括成功、失敗、處理中中。其中中成功代代表賬務(wù)務(wù)處理成成功、失失敗代表表賬務(wù)處處理失敗敗、處理理

60、中代表表賬務(wù)未未明需晚晚間批量量對賬后后產(chǎn)生結(jié)結(jié)果。查詢條件件中訂單單號為必必須字段段。查詢時(shí)間間段需不不大于115分鐘鐘。4.7.3處理理流程4.7.4交互互模式在交易明明細(xì)查詢詢業(yè)務(wù)中中，商戶戶與銀行行通過請請求-應(yīng)應(yīng)答模式式交互。商戶作為為服務(wù)使使用者向向銀行發(fā)發(fā)送 “查詢”請求報(bào)報(bào)文TQQReqq，銀行行作為服服務(wù)提供供者向商商戶返回回查詢應(yīng)應(yīng)答報(bào)文文TQRRes。4.7.5報(bào)文文格式“查詢”請求報(bào)報(bào)文TQQReqq (TTradde QQuerry RRequuestt)查詢請求求報(bào)文TTQReeq是商商戶向銀銀行發(fā)起起的交易易明細(xì)查查詢請求求。中文域名名對應(yīng)DTTD元素素類型出現(xiàn)要