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

1、上海銀行行-快捷捷支付接口規(guī)范范(版本號(hào)號(hào)v3.6.6)前言本文檔介介紹上海海銀行“快捷支支付”的技術(shù)術(shù)標(biāo)準(zhǔn)，此接口口標(biāo)準(zhǔn)適適應(yīng)借記記卡快捷捷支付及及信用卡卡快捷支支付。其其中包括括業(yè)務(wù)處處理與系系統(tǒng)交互互方式、報(bào)文的的語(yǔ)法與與語(yǔ)義、網(wǎng)絡(luò)連連接方式式、安全全規(guī)范等等。文檔概述述介紹概述本文檔闡闡述的技技術(shù)標(biāo)準(zhǔn)準(zhǔn)，為更更加快捷捷安全的的互聯(lián)網(wǎng)網(wǎng)支付結(jié)結(jié)算提供供了解決決方案。目標(biāo)讀者者本文檔的的主要目目標(biāo)讀者者是銀行行與商戶(hù)戶(hù)的技術(shù)術(shù)實(shí)施人人員，也也可供業(yè)業(yè)務(wù)人員員參考。最近修訂訂版本號(hào)作者內(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ún)，新增單單筆交易易明細(xì)查查詢(xún)黃敦迪20122-6-133.0黃敦迪增加批量量交易明明細(xì)查詢(xún)?cè)?，修改改錯(cuò)誤代代碼黃敦迪20133-3-113.1黃敦迪修改身份份鑒權(quán)、網(wǎng)上支支付、單單筆退款款、批量量退款接接口，加加入了卡卡代號(hào)等等20133-3-123.2黃敦迪鑒權(quán)需中中賬戶(hù)姓姓名改為為必輸20133-4-113.3黃敦迪接口實(shí)現(xiàn)現(xiàn)說(shuō)明中中批量交交易查詢(xún)?cè)兏臑榉欠潜仨殞?shí)實(shí)現(xiàn)的接接口。批批量交易易查詢(xún)請(qǐng)請(qǐng)求報(bào)文文中加入入訂單號(hào)號(hào)列表20133-4-193.4彭小波修改身

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

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

5、配”20133-5-213.5.7彭小波針對(duì)信用用卡的CCVV22和有效效期，增增加對(duì)應(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黃敦迪刪除二級(jí)級(jí)商戶(hù)信信息同步步接口，增加單單筆撤消消接口20133-6-203.6.1彭小波批量交易易查詢(xún)響響應(yīng)報(bào)文文中交易易信息列列表trradeeInffoLiist 簽名要要求由”Y”變更為為”N”20133-6-263.6.2彭小波新增錯(cuò)誤誤碼：4

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

7、規(guī)定了上上海銀行行與商戶(hù)戶(hù)之間交交換報(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ù)元素素中包含含的屬性性元素有有所不同同。對(duì)于涉及及到簽約約狀態(tài)修修改或者者資金變變動(dòng)的業(yè)業(yè)務(wù)元素素，必須須要有與與之匹配配的Siignaaturre元素素進(jìn)行數(shù)數(shù)字簽名名。作為約定定，Baankssh

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

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

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

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

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

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

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

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

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

17、身支持的的協(xié)議版版本號(hào)。消息版版本號(hào)不不能低于于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屬性性匹配請(qǐng)求和應(yīng)應(yīng)答報(bào)文文的Meessaage域域之idd屬性必必須相同同，idd是請(qǐng)求求方生成成的唯一一序列號(hào)號(hào)。比如如：銀行行在CSSReqq的Meessaage域域設(shè)置了了一個(gè)iid屬性性值，則則商戶(hù)在在CSRRes里里面的MMesssagee域的iid屬性性必須和和CSRReq的的Messsagge域之之id值值相同。報(bào)文傳

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

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

20、EES。加加密密鑰鑰按事先先約定方方式分發(fā)發(fā)。文件摘要要對(duì)加密后后的文件件進(jìn)行摘摘要。摘摘要算法法使用標(biāo)標(biāo)準(zhǔn)SHHA1算算法，結(jié)結(jié)果表示示成400位166進(jìn)制大大寫(xiě)字母母數(shù)字串串。在商戶(hù)往往銀行發(fā)發(fā)送文件件下載請(qǐng)請(qǐng)求時(shí)需需對(duì)若干干域進(jìn)行行摘要，具體可可參考文文件下載載章節(jié)描描述；在銀行往往商戶(hù)反反饋文件件時(shí)，需需對(duì)文件件進(jìn)行摘摘要，文文件摘要要商戶(hù)可從從 htttpss的reespoonsee的heead域域里面的的Bannkshha1域域的值獲獲取摘要要，從BBankksiggn域的的值獲取取簽名。文件下載載（銀行行端URRL）文件采用用商戶(hù)主主動(dòng)請(qǐ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操作作類(lèi)型（如：uuplooad表表示上傳傳、doownlloadd表示下下載）。insttId商戶(hù)戶(hù)標(biāo)識(shí)。 datee 交易日日期yyyyymmmddd。fileenamme遵循業(yè)業(yè)務(wù)文件件命名規(guī)規(guī)范的文文件名。KoallB644Cerrt商戶(hù)公公鑰Baase664位編編碼signn使用用cerrtIdd指定的的證書(shū)對(duì)對(duì)“acttionntyppe|iinsttId|datte|ffileenamme”進(jìn)行簽名名，對(duì)簽簽名結(jié)果進(jìn)進(jìn)行Baase664編碼碼獲得的的字符串串,詳情情見(jiàn)簽名名規(guī)范。文件下載載失敗hhttpp狀態(tài)碼碼1、4006：商商戶(hù)標(biāo)識(shí)識(shí)不匹配配2、4005：操操作類(lèi)型型不

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

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

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

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

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

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

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

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

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

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

33、時(shí)返返回的卡卡代碼手續(xù)費(fèi)charrgeLongg(122)ON預(yù)留字段段，見(jiàn) HYPERLINK l _金額格式 金額格格式說(shuō)明明交易金額額amouuntLongg(122)RY見(jiàn) HYPERLINK l _金額格式 金額格格式說(shuō)明明交易貨幣幣代碼currrenccycharr(3)RY見(jiàn) HYPERLINK l _卡通貨幣代碼表 快捷支支付貨幣幣代碼表表經(jīng)過(guò)Baase664處理理的商戶(hù)戶(hù)證書(shū)代代碼KoallB644Cerrt/RN商戶(hù)端讀讀取本地地商戶(hù)證證書(shū)文件件后，再再使用上上海銀行行提供的的APII進(jìn)行Baase664編碼碼后產(chǎn)生生的商戶(hù)戶(hù)證書(shū)數(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是銀行行返回給給商戶(hù)CCPReeq的應(yīng)應(yīng)答。中文域名名對(duì)應(yīng)DTTD元素素類(lèi)型出現(xiàn)要求求簽名要求求說(shuō)明版本號(hào)verssionncharr(7)RN目前版本本號(hào)：”1.0.1”商戶(hù)標(biāo)識(shí)識(shí)insttIdcharr(155)RY報(bào)文發(fā)送送方的商商戶(hù)標(biāo)識(shí)識(shí)訂單號(hào)ordeerNuumcharr(300)RY商戶(hù)支付付訂單號(hào)號(hào)/流水水號(hào),永永不重復(fù)復(fù)卡代號(hào)carddCoddecharr(200)RY用于支付付的卡代代號(hào)（來(lái)來(lái)自CPPReqq）交易流水水號(hào)seriialNN

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

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

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

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

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

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

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

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

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

44、都記錄到到批量退退貨結(jié)果果文件中中。銀行處理理完成后后發(fā)送通通知報(bào)文文告知，商戶(hù)主主動(dòng)發(fā)起起下載結(jié)結(jié)果文件件,或者者由商戶(hù)戶(hù)固定時(shí)時(shí)間下載載文件也也可；考慮安全全原因，建議哪哪方生成成的文件件存放于于哪方的的sevver，對(duì)方可可發(fā)起下下載。4.5.4交互互模式銀行發(fā)送送通知報(bào)報(bào)文告知知，商戶(hù)戶(hù)主動(dòng)發(fā)發(fā)起下載載結(jié)果文文件。注： 11、商戶(hù)戶(hù)生成的的批量退退款文件件必須按按約定的的格式及及壓縮、加密方方式存放放。 并應(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是商戶(hù)戶(hù)向銀行行發(fā)起的的通知批批量退貨貨文件下下載請(qǐng)求求。中文域名名對(duì)應(yīng)DTTD元素素類(lèi)型出現(xiàn)要求求簽名要求求說(shuō)明版本號(hào)verssionncharr(7)RN目前版本本號(hào)：”1.0.1”商戶(hù)標(biāo)識(shí)識(shí)insttIdcharr(155)RY報(bào)文發(fā)送送方的商商戶(hù)標(biāo)識(shí)識(shí)流水號(hào)ordeerNuumcharr(300)RY訂單號(hào)/流水號(hào)號(hào),永不不重復(fù)，定義該該批次的的退款文文件。交易日期期和時(shí)間間dateecharr(177)RYYYYYYMMDDDHHH:MMM:SSS文件下載載URLLdownnUrllCharr(1000)RY商戶(hù)發(fā)布布的退款款

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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