ICS03.060;35.240.40CCSA11團 體 標 準T/CBA213.1—20231Bankingconfirmationserviceplatform-ApplicationProgrammingInterface-Part1:Connectingdirectlytothebankingconfirmationserviceplatform2023-12-26發(fā)布 2024-01-01實施中國銀行業(yè)協會 發(fā)布TT/CBA213.1—2023PAGE\*ROMANPAGE\*ROMANIII目??次前??言 III引??言 V范圍 6規(guī)范性引用文件 6術語和定義 6縮略語 7應用編程接口 8概述 8基本要求 8接口方式 8系統(tǒng)測試 8等級測評 8應用投產 8接口概述 8函證請求方 8交互概述 9函證申請（函證請求方主填） 9函證申請（函證提供方主填） 11函證申請（驗資） 14函證撤銷 17函證實時狀態(tài)查詢 19函證實時狀態(tài)批量查詢 20函證狀態(tài)流轉記錄查詢 22函證文件下載 24函證申請秘鑰獲取 26函證提供方詳細信息查詢 28函證提供方 29交互概述 29函證狀態(tài)更新 29回函文件上傳 31回函密鑰獲取 33函證實時狀態(tài)查詢 35函證實時狀態(tài)批量查詢 37函證狀態(tài)流轉記錄查詢 39請求方匯聚轉發(fā)平臺 41交互概述 41函證申請（函證請求方主填） 41函證申請（函證提供方主填） 44函證申請（驗資） 46函證撤銷 49函證實時狀態(tài)查詢 51函證實時狀態(tài)批量查詢 52函證狀態(tài)流轉記錄查詢 55函證文件下載 56函證申請秘鑰獲取 58函證提供方詳細信息查詢 60函證提供方匯聚轉發(fā)平臺 61交互概述 62函證提供方匯聚轉發(fā)平臺接口 62附錄A （資料性）銀行函證服務平臺應用編程接口返回碼匯總 63返回碼編碼規(guī)則 63函證請求方返回碼及返回信息 63函證提供方返回碼及返回信息 65附錄B （規(guī)范性）函證狀態(tài)碼、狀態(tài)信息及交易狀態(tài)響應碼 67附錄C （資料性）銀行函證服務平臺應用編程接口定義及參數示例 69概述 69函證申請（函證請求方主填） 69函證申請（函證提供方主填） 69函證申請（驗資） 70函證撤銷 70函證實時狀態(tài)查詢 71函證實時狀態(tài)批量查詢 71函證狀態(tài)流轉記錄查詢 72函證文件下載 72函證申請秘鑰獲取 73函證提供方詳細信息查詢 73函證狀態(tài)更新 74回函文件上傳 74回函密鑰獲取 75參?考?文?獻 76前??言中國銀行業(yè)協會(ChinaBankingAssociation，CBA)成立于2000年5月，是經中國人民銀行和民政2003年中國銀監(jiān)會成立后，中國銀行業(yè)協會主管單位由中國人民銀行變更為中國銀監(jiān)會。2018年3月，原中國銀行保險監(jiān)督管理委員會成立后，中國銀行業(yè)協會主管單位由中國銀監(jiān)會變更為中國銀行保險監(jiān)督管理委員會。中國銀行業(yè)協會日常辦事機構為秘書處。秘書處設秘書長1名，副秘書長若干名。根據工作需要，中國銀行業(yè)協會設立32本文件按照T/CBA1—2021《中國銀行業(yè)協會團體標準化文件的結構和起草規(guī)則》的規(guī)定起草。本文件是T/CBA2131部分。T/CBA213已經發(fā)布了以下部分：——第1部分：直連函證服務平臺。請注意本文件的某些內容可能涉及專利。本文件的發(fā)布機構不承擔識別專利的責任。T/CBA函證服務平臺的工作技術依據系列文件之一，本系列文件結構如下：——T/CBA210——T/CBA211——T/CBA212《銀行函證服務平臺基礎數據元》；——T/CBA213（多部分）《銀行函證服務平臺應用編程接口》；——T/CBA214《銀行函證服務平臺運營規(guī)則》；——T/CBA215《銀行函證服務平臺候選分布式賬本技術節(jié)點接入要求》；——T/CBA216《銀行函證服務平臺分布式賬本應用編程接口》；——T/CBA217《銀行函證服務平臺分布式賬本智能合約》；——T/CBA218《銀行函證服務平臺匯聚轉發(fā)平臺建設要求》。本文件由中國銀行業(yè)協會銀行函證服務平臺服務中心提出。本文件由中國銀行業(yè)協會銀行業(yè)產品和服務標準化專業(yè)委員會歸口。本文件為中國銀行業(yè)協會制定，其著作權為中國銀行業(yè)協會所有。本文件為中國銀行業(yè)協會制定，其著作權為中國銀行業(yè)協會所有。1512、15層電話：010-66553368010-66291132郵編：100033郵箱：cba.china@傳真??言為全面規(guī)范銀行函證系統(tǒng)各組件間的信息傳輸，T/CBA213擬由3個部分組成：12——第3部分：連接相關機構。目的在于規(guī)范函證服務平臺與相關機構之間的聯機信息交換。TT/CBA213.1—2023PAGEPAGE10銀行函證服務平臺應用編程接口第1部分：直連函證服務平臺范圍本文件界定了銀行函證服務平臺與直接連入處理銀行函證業(yè)務的相關方聯機交換信息涉及到的術注：在大多數情況下，函證請求方是會計師事務所，函證提供方是銀行業(yè)金融機構。規(guī)范性引用文件（包括所有的修改單適用于本文件。GB/T22239—2019信息安全技術網絡安全等級保護基本要求JR/T0101銀行業(yè)軟件測試文檔規(guī)范T/CBA211—2021銀行函證服務平臺加密體系T/CBA212—2022銀行函證服務平臺基本數據元ISO/IEC21778:2017信息技術JSON數據交換語法(Informationtechnology—TheJSONdatainterchangesyntax)術語和定義下列術語和定義適用于本文件。銀行函證業(yè)務?bankingconfirmationbusiness函證請求方在獲取被審計單位授權后，直接向函證提供方發(fā)出詢證函，函證提供方針對所收到的詢證函，查詢、核對相關信息并直接提供回函的過程。術語條目注1：函證請求方大多是會計師事務所，函證提供方大多是銀行業(yè)金融機構。術語條目注2：詢證函可能是能夠進行數據元解析的，也可能僅是一個圖像或不可更改格式的文件。[來源：T/CBA210—2021，3.1，有修改]積極式函證positiveconfirmation要求函證提供方直接向函證請求方回復，表明是否同意詢證函所列示的信息，或填列所要求的信息的一種詢證方式。1：1312直接向注冊會計師回復，表明是否同意詢證函所列示的信息，或填列所要求的信息的一種詢證方T/CBA1—2021[來源：中國注冊會計師審計準則第1312號，第六條，有修改——見術語條目注1]銀行詢證函（格式一）bankingconfirmationrequest(format1)適用于函證請求方執(zhí)行財務報表審計業(yè)務時積極性函證（3.2）的一種格式要求，主要用于函證提供方對函證請求方掌握信息的確認和補充。1：在《銀行函證及回函工作操作指引》中，二、（一）、2核對后回復相符或不符，如不符，銀行業(yè)金融機構應當提供詳細信息?！便y行詢證函（格式二）bankingconfirmationrequest(format2)適用于函證請求方執(zhí)行財務報表審計業(yè)務時積極性函證（3.2）的一種格式要求，主要用于函證提供方對函證請求方詢證賬號相關情況的回復。術語條目注1：在《銀行函證及回函工作操作指引》中，二、（一）、2項對格式二的描述為“由注冊會計師填寫需要詢證的銀行賬號等相關信息，由銀行業(yè)金融機構填寫具體信息后回函?！便y行詢證函（格式三）bankingconfirmationrequest(format3)適用于驗資業(yè)務的銀行詢證函格式。函證請求方?bankingconfirmationacquirer向函證提供方發(fā)出詢證函的銀行函證業(yè)務參與方。（202012的其他機構。函證提供方?bankingconfirmationprovider響應函證請求方的請求，提供詢證回函的銀行函證業(yè)務參與方。（202012行業(yè)金融機構；在本文件中，也包括法律法規(guī)所允許的其他機構。公鑰publickey非對稱密碼算法中可公開的密鑰。[來源：GB/T25056—2018，3.11]私鑰privatekey非對稱密碼算法中只能由擁有者使用的不公開密鑰。[來源：GB/T25056—2018，3.10]數字簽名digitalsignature[來源：GB/T25069—2010，76]縮略語下列縮略語適用于本文件。JSON Java腳本對象表示法（JavaScriptObjectNotation）UTF-8 8位Unicode轉換格式（8-bitUnicodeTransformationFormat）URL 統(tǒng)一資源定位符（UniformResourceLocator）注1：JSON定義于ISO/IEC21778:2017。注2：UTF-8定義于ISO/IEC10646:2020。應用編程接口概述基本要求應用系統(tǒng)自行開發(fā)的，應符合GB/T22239—2019中的要求；應用系統(tǒng)外包開發(fā)的，應符合GB/T22239—2019中的要求。接口方式函證請求方、函證提供方和匯聚轉發(fā)平臺應用編程接口支持如下方式之一：協議方式。通過HTTPSISO/IEC21778:2017JSONSDKSDK，需支持Java、C#等主流編程語言。系統(tǒng)測試測試的策劃和設計應根據系統(tǒng)實際功能確定。不論采用何種方式開發(fā)，測試應符合GB/T22239—2019中的要求。軟件測試文檔的編制，應符合JR/T0101的規(guī)定。注：在必要時，由銀行函證服務平臺的管理方提供典型測試用例和測試規(guī)程。等級測評應按照GB/T22239—2019中的要求進行等級測評，并獲得測評報告。應用投產應按照GB/T22239—2019中的要求組織投產。接口概述本文件按如下方式對應用編程接口進行描述：AURLhttpsJSON（key-value）容器使用，參數安排不區(qū)分順序；每個鍵值對均有必要性屬性，其中“M”為必要鍵值對、“O”為可選鍵值對、“C”為條件必要鍵值對；B；C函證請求方交互概述函證請求方應用場景可分為多個視角，其中：從業(yè)務上看，函證請求方是銀行函證業(yè)務的發(fā)起方和接收方。函證申請（函證請求方主填）表1 函證申請（函證請求方主填）基本屬性名稱屬性接口名稱JSONapplyOnFirstTemplate(JSONparams)接口功能函證請求方提交函證申請URL/bpbcapi/v1/confirmation/application/format1URL參數無請求類型POST請求內容類型application/json字符集UTF-8表2 函證申請（函證請求方主填）輸入參數章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.1函證請求方IDtenantIdstring11M5.1.2函證請求方名稱tenantNamestring50M5.5.1消息IDmsgIdstring32M5.5.2消息發(fā)送時間timeStampstring19M5.5.3發(fā)起方地址ipAddressstring128M5.5.4提交人submitterstring19M5.5.5消息簽名signstring300MStartb業(yè)務參數體bizContentobject/M5.1.5函證編號upstreamEventSerialnostring16M5.1.4函證提供方名稱bankNamestring50M5.1.6授權企業(yè)網銀賬戶開戶行支付系統(tǒng)行號cnapsstring12M5.1.7授權企業(yè)網銀賬戶authPayAccountstring34M5.1.8被函證企業(yè)名稱organizationNamestring60M5.1.9起始日期confirmBeginDatestring10M5.1.10截止日期confirmEndDatestring10M5.2.1發(fā)函文件密鑰sCodestring/M5.2.2發(fā)函文件名confirmationFileNamestring/M5.2.3發(fā)函文件正文confirmationTextstring/M表2 函證申請（函證請求方主填）輸入參數（續(xù)）章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.11經辦人transactorstring60O5.1.12經辦人職務transactorTitlestring30O5.1.13經辦人電話transactorPhonestring20O5.1.14回函地址replyAddressstring100M5.1.15回函聯系人replyContactstring50M5.1.16回函電話replyPhonestring20M5.1.17回函傳真replyFaxstring20O5.1.18回函郵編replyPostalCodestring10O5.1.19回函電子郵箱replyEmailstring50OEndb業(yè)務參數體bizContentobject/M加密與簽名要求：confirmationText”進行加密；函證請求方應使用函證提供方的公鑰對鍵值對“sCode”進行加密；函證請求方應使用私鑰對業(yè)務參數體“bizContent”全文進行簽名；T/CBA211—20216.3a章節(jié)號指的是T/CBA212—2021中的章節(jié)號。b“start”和“End”之間的信息是JSON報文中的一個對象，即一組信息的集合。表3 函證申請（函證請求方主填）輸出參數章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.6返回代碼retCodestring7M5.5.7返回信息retMsgstring100O5.5.5返回消息簽名signstring/OStart返回業(yè)務參數體responseBizContentobject/M5.5.1消息IDmsgIdstring32M5.1.5函證編號upstreamEventSerialnostring27MEnd返回業(yè)務參數體responseBizContentobject/M銀行函證服務平臺使用平臺私鑰對返回業(yè)務參數體“responseBizContent”內所有鍵值對進行簽名。表4 函證申請（函證請求方主填）返回碼信息及解決方案返回碼返回信息解決方案0請求成功1000001函證請求方ID不存在請確認是否輸入正確函證請求方ID1000002函證請求方ID未啟用請聯系平臺工作人員確定函證請求方啟停用情況1000003函證請求方公鑰不存在請確認是否輸入正確公鑰2000001函證編號已存在請重新輸入函證編號2000002銀行名稱重復請重新輸入銀行名稱2000003銀行不存在請輸入正確的銀行名稱表4 函證申請（函證請求方主填）返回碼信息及解決方案（續(xù)）返回碼返回信息解決方案2000004缺少必填參數請確認必填參數是否已輸入2000005bizContent缺少必填參數請輸入bizContent中的必填參數2000007詢證項起止時間格式錯誤起止日期格式為：yyyy-MM-dd2000008詢證項起始時間大于截止時間請輸入正確的起止日期2000010事務所名稱為空或與在平臺注冊的名稱不一致請檢查函證請求方名稱是否正確2000012bizContent字段超長請重新輸入bizContent2000015聯行號格式錯誤請輸入正確的聯行號2000016聯行號不存在請輸入正確的聯行號2000017聯行號對應機構非收函機構請輸入正確的聯行號2000018聯行號與函證發(fā)往的銀行不匹配請確認聯行號對應得機構是否正確3000005銀行不支持當前格式的函證申請請與銀行確認支持的函證格式3000011ipAddress校驗不通過請確認當前ipAddress是否正確3000012函證開始時間格式不正確，請重新填寫日期格式為：yyyy-MM-dd3000013函證結束時間格式不正確，請重新填寫日期格式為：yyyy-MM-dd7000001請求失敗，獲取響應體異常請確定報文加密是否使用了平臺公鑰7000002請求失敗，返回的responseBizContent為空請確定平臺是否收到請求7000003返回消息格式異常請確定平臺是否收到請求7000004響應消息驗簽失敗請確認數字簽名信息是否正確8000001請傳入請求參數請傳入請求參數8000002請傳入參數：bizContent請傳入參數：bizContent8000005請傳入參數：applyFile請傳入參數：applyFile8000006申請文件大小不超過平臺限制請傳入符合平臺大小限制的申請文件8000008請傳入正確的地址參數請傳入正確的地址參數8000010文件名不合法請輸入正確的文件名9000001請求區(qū)塊鏈失敗，區(qū)塊鏈響應體為空請確認區(qū)塊鏈地址及網絡是否正常9000002bokhiRsose請確定平臺是否收到請求9000003請求區(qū)塊鏈失敗，返回狀態(tài)異常請確認區(qū)塊鏈網絡及區(qū)塊鏈接口參數是否正確9000004請求區(qū)塊鏈超時，請稍候再試請稍候再試注：完整的返回碼列表參見附錄A。函證申請（函證提供方主填）表5 函證申請（函證提供方主填）基本屬性名稱接口名稱屬性JSONapplyOnSecondTemplate(JSONparams)接口功能函證請求方提交函證申請URL/bpbcapi/v1/confirmation/application/format2表5 函證申請（函證提供方主填）基本屬性（續(xù)）名稱屬性URL參數無請求類型POST請求內容類型application/json字符集UTF-8表6 函證申請（函證提供方主填）輸入參數章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.1函證請求方IDtenantIdstring11M5.1.2函證請求方名稱tenantNamestring50M5.5.1消息IDmsgIdstring32M5.5.2消息發(fā)送時間timeStampstring19M5.5.3發(fā)起方地址ipAddressstring128M5.5.4提交人submitterstring19M5.5.5消息簽名signstring300MStartb業(yè)務參數體bizContentobject/M5.1.5函證編號upstreamEventSerialnostring16M5.1.4銀行名稱bankNamestring50M5.1.6授權企業(yè)網銀賬戶開戶聯行號cnapsstring12M5.1.7授權企業(yè)網銀賬戶authPayAccountstring34M5.1.8被函證企業(yè)名稱organizationNamestring60M5.1.11經辦人transactorstring60O5.1.12經辦人職務transactorTitlestring30O5.1.13經辦人電話transactorPhonestring20O5.1.14回函地址replyAddressstring100Cc5.1.15回函聯系人replyContactstring50Cc5.1.16回函電話replyPhonestring20Cc5.1.17回函傳真replyFaxstring20O5.1.18回函郵編replyPostalCodestring10O5.1.19回函電子郵箱replyEmailstring50Cc5.1.20列表項->函證項編號conList->confirmationTypestring3M5.1.21列表項->函證項賬戶conList->conditionNOstring34M5.1.22列表項->函證項賬戶名稱conList->accountNamestring140O5.1.9列表項->函證項起始日期conList->confirmBeginDatestring10M5.1.10列表項->函證項截止日期conList->confirmEndDatestring10MEndb業(yè)務參數體bizContentobject/M表6 函證申請（函證提供方主填）輸入參數（續(xù)）章節(jié)號a中文名稱鍵名字段類型字段長度必要性校驗、加密與簽名要求：函證提供方可根據實際需要選擇是否校驗列表項中的字段；bizContent”全文進行加密；bizContent”全文進行簽名；T/CBA211—20216.3a章節(jié)號指的是T/CBA212—2021中的章節(jié)號。b“start”和“End”之間的信息是JSON報文中的一個對象，即一組信息的集合。c若事務所未提供其它有效聯系方式，則回函地址（replyAddress）、回函聯系人（replyContact）、回函電話（replyPhone）、回函電子郵箱（replyEmail）為必填項。表7 函證申請（函證提供方主填）輸出參數章節(jié)號中文名稱鍵名字段類型字段長度存在性5.5.6返回代碼retCodestring7M5.5.7返回信息retMsgstring100O5.5.5返回消息簽名signstring/OStart返回業(yè)務參數體responseBizContentobject/M5.5.1消息IDmsgIdstring32M5.1.5函證編號upstreamEventSerialnostring27MEnd返回業(yè)務參數體responseBizContentobject/M銀行函證服務平臺使用平臺私鑰對返回業(yè)務參數體“responseBizContent”內所有鍵值對進行簽名。表8 函證申請（函證提供方主填）返回碼信息及解決方案返回碼返回信息解決方案0請求成功1000001函證請求方ID不存在請確認是否輸入正確函證請求方ID1000002函證請求方ID未啟用請聯系平臺工作人員確定函證請求方啟停用情況1000003函證請求方公鑰不存在請確認是否輸入正確公鑰2000001函證編號已存在請重新輸入函證編號2000002銀行名稱重復請重新輸入銀行名稱2000003銀行不存在請輸入正確的銀行名稱2000004缺少必填參數請確認必填參數是否已輸入2000005bizContent缺少必填參數請輸入bizContent中的必填參數2000006conList缺少必填參數請輸入conList中的必填參數2000007詢證項起止時間格式錯誤起止日期格式為：yyyy-MM-dd2000008詢證項起始時間大于截止時間請輸入正確的起止日期2000009詢證項列表為空請?zhí)钊朐冏C項2000010事務所名稱為空或與在平臺注冊的名稱不一致請檢查函證請求方名稱是否正確2000012bizContent字段超長請重新輸入bizContent表8 函證申請（函證提供方主填）返回碼信息及解決方案（續(xù)）返回碼返回信息解決方案2000013conList字段超長請重新輸入conList2000014詢證項列表超過最大條數限制請重新填入詢證項2000015聯行號格式錯誤請輸入正確的聯行號2000016聯行號不存在請輸入正確的聯行號2000017聯行號對應機構非收函機構請輸入正確的聯行號2000018聯行號與函證發(fā)往的銀行不匹配請確認聯行號對應得機構是否正確3000005銀行不支持當前格式的函證申請請與銀行確認支持的函證格式3000011ipAddress校驗不通過請確認當前ipAddress是否正確3000012函證開始時間格式不正確，請重新填寫日期格式為：yyyy-MM-dd3000013函證結束時間格式不正確，請重新填寫日期格式為：yyyy-MM-dd7000001請求失敗，獲取響應體異常請確定報文加密是否使用了平臺公鑰7000002請求失敗，返回的responseBizContent為空請確定平臺是否收到請求7000003返回消息格式異常請確定平臺是否收到請求7000004響應消息驗簽失敗請確認數字簽名信息是否正確8000000請創(chuàng)建帶有blockChainConnBean參數的連接請創(chuàng)建帶有blockChainConnBean參數的連接8000001請傳入請求參數請傳入請求參數8000002請傳入參數：bizContent請傳入參數：bizContent8000003請傳入參數：詢證項conList請傳入參數：詢證項conList8000005請傳入參數：applyFile請傳入參數：applyFile8000006申請文件大小不超過平臺限制請傳入符合平臺大小限制的申請文件8000010文件名不合法請輸入正確的文件名9000001請求區(qū)塊鏈失敗，區(qū)塊鏈響應體為空請確認區(qū)塊鏈地址及網絡是否正常9000002bokhiRsose請確定平臺是否收到請求9000003請求區(qū)塊鏈失敗，返回狀態(tài)異常請確認區(qū)塊鏈網絡及區(qū)塊鏈接口參數是否正確9000004請求區(qū)塊鏈超時，請稍候再試請稍候再試注：完整的返回碼列表參見附錄A。函證申請（驗資）在函證請求方驗資時，函證請求方采用銀行詢證函格式三，應用編程接口信息描述于表9～表12。表9 函證申請（驗資）基本屬性名稱屬性接口名稱JSONapplyOnThirdTemplate(JSONparams)接口功能函證請求方提交函證申請URL/bpbcapi/v1/confirmation/application/format3URL參數無請求類型POST請求內容類型application/json字符集UTF-8表10 函證申請（驗資）輸入參數章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.1函證請求方IDtenantIdstring11M5.1.2函證請求方名稱tenantNamestring50M5.5.1消息IDmsgIdstring32M5.5.2消息發(fā)送時間timeStampstring19M5.5.3發(fā)起方地址ipAddressstring128M5.5.4提交人submitterstring19M5.5.5消息簽名signstring300MStartb業(yè)務參數體bizContentobject/M5.1.5函證編號upstreamEventSerialnostring16M5.1.4銀行名稱bankNamestring50M5.1.6授權企業(yè)網銀賬戶開戶聯行號cnapsstring12M5.1.7授權企業(yè)網銀賬戶authPayAccountstring34M5.1.8被函證企業(yè)名稱organizationNamestring60M5.1.9起始日期confirmBeginDatestring10M5.1.10截止日期confirmEndDatestring10M5.2.1發(fā)函文件密鑰sCodestring/M5.2.2發(fā)函文件名confirmationFileNamestring/M5.2.3發(fā)函文件正文confirmationTextstring/M5.1.11經辦人transactorstring60O5.1.12經辦人職務transactorTitlestring30O5.1.13經辦人電話transactorPhonestring20O5.1.14回函地址replyAddressstring100O5.1.15回函聯系人replyContactstring50O5.1.16回函電話replyPhonestring20O5.1.17回函傳真replyFaxstring20O5.1.18回函郵編replyPostalCodestring10O5.1.19回函電子郵箱replyEmailstring50OEndb業(yè)務參數體bizContentobject/M加密與簽名要求：confirmationText”進行加密；函證請求方應使用詢證銀行的公鑰對鍵值對“sCode”進行加密；函證請求方應使用私鑰對業(yè)務參數體“bizContent”全文進行簽名；T/CBA211—20216.3a章節(jié)號指的是T/CBA212—2021中的章節(jié)號。b“start”和“End”之間的信息是JSON報文中的一個對象，即一組信息的集合。表11 函證申請（驗資）輸出參數章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.6返回代碼retCodestring7M5.5.7返回信息retMsgstring100O5.5.5返回消息簽名signstring/OStart返回業(yè)務參數體responseBizContentobject/M5.5.1消息IDmsgIdstring32M5.1.5函證編號upstreamEventSerialnostring27MEnd返回業(yè)務參數體responseBizContentobject/M銀行函證服務平臺使用平臺私鑰對返回業(yè)務參數體“responseBizContent”內所有鍵值對進行簽名。表12 函證申請（驗資）返回碼信息及解決方案返回碼返回信息解決方案0請求成功1000001函證請求方ID不存在請確認是否輸入正確函證請求方ID1000002函證請求方ID未啟用請聯系平臺工作人員確定函證請求方啟停用情況1000003函證請求方公鑰不存在請確認是否輸入正確公鑰2000001函證編號已存在請重新輸入函證編號2000002銀行名稱重復請重新輸入銀行名稱2000003銀行不存在請輸入正確的銀行名稱2000004缺少必填參數請確認必填參數是否已輸入2000005bizContent缺少必填參數請輸入bizContent中的必填參數2000007詢證項起止時間格式錯誤起止日期格式為：yyyy-MM-dd2000008詢證項起始時間大于截止時間請輸入正確的起止日期2000010事務所名稱為空或與在平臺注冊的名稱不一致請檢查函證請求方名稱是否正確2000012bizContent字段超長請重新輸入bizContent2000015聯行號格式錯誤請輸入正確的聯行號2000016聯行號不存在請輸入正確的聯行號2000017聯行號對應機構非收函機構請輸入正確的聯行號2000018聯行號與函證發(fā)往的銀行不匹配請確認聯行號對應得機構是否正確3000005銀行不支持當前格式的函證申請請與銀行確認支持的函證格式3000011ipAddress校驗不通過請確認當前ipAddress是否正確3000012函證開始時間格式不正確，請重新填寫日期格式為：yyyy-MM-dd3000013函證結束時間格式不正確，請重新填寫日期格式為：yyyy-MM-dd7000001請求失敗，獲取響應體異常請確定報文加密是否使用了平臺公鑰7000002請求失敗，返回的responseBizContent為空請確定平臺是否收到請求7000003返回消息格式異常請確定平臺是否收到請求7000004響應消息驗簽失敗請確認數字簽名信息是否正確8000001請傳入請求參數請傳入請求參數8000002請傳入參數：bizContent請傳入參數：bizContent表12 函證申請（驗資）返回碼信息及解決方案（續(xù)）返回碼返回信息解決方案8000005請傳入參數：applyFile請傳入參數：applyFile8000006申請文件大小不超過平臺限制請傳入符合平臺大小限制的申請文件8000008請傳入正確的地址參數請傳入正確的地址參數8000010文件名不合法請輸入正確的文件名9000001請求區(qū)塊鏈失敗，區(qū)塊鏈響應體為空請確認區(qū)塊鏈地址及網絡是否正常9000002bokhiRsose請確定平臺是否收到請求9000003請求區(qū)塊鏈失敗，返回狀態(tài)異常請確認區(qū)塊鏈網絡及區(qū)塊鏈接口參數是否正確9000004請求區(qū)塊鏈超時，請稍候再試請稍候再試注：完整的返回碼列表參見附錄A。函證撤銷表13 函證撤銷基本屬性名稱屬性接口名稱JSONrevocation(JSONparams)接口功能函證請求方提交函證撤銷URL/bpbcapi/v1/confirmation/revocationURL參數無請求類型POST請求內容類型application/json字符集UTF-8表14 函證撤銷輸入參數章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.1函證請求方IDtenantIdstring11M5.1.2函證請求方名稱tenantNamestring50M5.5.1消息IDmsgIdstring32M5.5.2消息發(fā)送時間timeStampstring19M5.5.3發(fā)起方地址ipAddressstring128M5.5.4提交人submitterstring19M5.5.5消息簽名signstring300MStartb業(yè)務參數體bizContentobject/M5.1.5函證編號upstreamEventSerialnostring16MEndb業(yè)務參數體bizContentobject/M表14 函證撤銷輸入參數（續(xù)）章節(jié)號a中文名稱鍵名字段類型字段長度必要性加密與簽名要求：函證請求方應使用私鑰對業(yè)務參數體“bizContent”全文進行簽名；T/CBA211—20216.3a章節(jié)號指的是T/CBA212—2021中的章節(jié)號。b“start”和“End”之間的信息是JSON報文中的一個對象，即一組信息的集合。表15 函證撤銷輸出參數章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.6返回代碼retCodestring7M5.5.7返回信息retMsgstring100O5.5.5返回消息簽名signstring/OStart返回業(yè)務參數體responseBizContentobject/M5.5.1消息IDmsgIdstring32M5.1.5函證編號upstreamEventSerialnostring27MEnd返回業(yè)務參數體responseBizContentobject/M銀行函證服務平臺使用平臺私鑰對返回業(yè)務參數體“responseBizContent”內所有鍵值對進行簽名。表16 函證撤銷返回碼信息及解決方案返回碼返回信息解決方案0請求成功1000001函證請求方ID不存在請確認是否輸入正確函證請求方ID1000002函證請求方ID未啟用請聯系平臺工作人員確定函證請求方啟停用情況1000003函證請求方公鑰不存在請確認是否輸入正確公鑰2000004缺少必填參數請確認必填參數是否已輸入2000005bizContent缺少必填參數請輸入bizContent中的必填參數2000010事務所名稱為空或與在平臺注冊的名稱不一致請檢查函證請求方名稱是否正確2000012bizContent字段超長請重新輸入bizContent3000001函證編號不存在請輸入正確的函證編號3000002該函證狀態(tài)不可撤銷請重新發(fā)起函證3000011ipAddress校驗不通過請確認當前ipAddress是否正確7000001請求失敗，獲取響應體異常請確定報文加密是否使用了平臺公鑰7000002請求失敗，返回的responseBizContent為空請確定平臺是否收到請求7000003返回消息格式異常請確定平臺是否收到請求7000004響應消息驗簽失敗請確認數字簽名信息是否正確8000000請創(chuàng)建帶有blockChainConnBean參數的連接請創(chuàng)建帶有blockChainConnBean參數的連接8000001請傳入請求參數請傳入請求參數8000002請傳入參數：bizContent請傳入參數：bizContent9000001請求區(qū)塊鏈失敗，區(qū)塊鏈響應體為空請確認區(qū)塊鏈地址及網絡是否正常9000002bokhiRsose請確定平臺是否收到請求表16 函證撤銷返回碼信息及解決方案（續(xù)）返回碼返回信息解決方案9000003請求區(qū)塊鏈失敗，返回狀態(tài)異常請確認區(qū)塊鏈網絡及區(qū)塊鏈接口參數是否正確9000004請求區(qū)塊鏈超時，請稍候再試請稍候再試注：完整的返回碼列表參見附錄A。函證實時狀態(tài)查詢函證請求方可調用此接口查詢單條函證當前所處的狀態(tài)，應用編程接口信息描述于表17～表20。表17 函證實時狀態(tài)查詢基本屬性名稱屬性接口名稱JSONactuality(JSONparams)接口功能函證請求方查詢函證實時狀態(tài)URL/bpbcapi/v1/confirmation/status/actualityURL參數無請求類型POST請求內容類型application/json字符集UTF-8表18 函證實時狀態(tài)查詢輸入參數章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.1函證請求方IDtenantIdstring11M5.1.2函證請求方名稱tenantNamestring50M5.5.1消息IDmsgIdstring32M5.5.2消息發(fā)送時間timeStampstring19M5.5.3發(fā)起方地址ipAddressstring128M5.5.4提交人submitterstring19M5.5.5消息簽名signstring300MStartb業(yè)務參數體bizContentobject/M5.1.5函證編號upstreamEventSerialnostring16MEndb業(yè)務參數體bizContentobject/M加密與簽名要求：函證請求方應使用私鑰對業(yè)務參數體“bizContent”全文進行簽名；T/CBA211—20216.3a章節(jié)號指的是T/CBA212—2021中的章節(jié)號。b“start”和“End”之間的信息是JSON報文中的一個對象，即一組信息的集合。表19 函證實時狀態(tài)查詢輸出參數章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.6返回代碼retCodestring7M5.5.7返回信息retMsgstring100O表19 函證實時狀態(tài)查詢輸出參數（續(xù)）章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.5返回消息簽名signstring/OStart返回業(yè)務參數體responseBizContentobject/M5.5.1消息IDmsgIdstring32M5.1.5函證編號upstreamEventSerialnostring27M5.3.1a函證狀態(tài)statusstring6MEnd返回業(yè)務參數體responseBizContentobject/M銀行函證服務平臺使用平臺私鑰對返回業(yè)務參數體“responseBizContent”內所有鍵值對進行簽名。a銀行函證狀態(tài)編碼規(guī)定于表B.1。表20 函證實時狀態(tài)查詢返回碼信息及解決方案返回碼返回信息解決方案0請求成功1000001函證請求方ID不存在請確認是否輸入正確函證請求方ID1000002函證請求方ID未啟用請聯系平臺工作人員確定函證請求方啟停用情況1000003函證請求方公鑰不存在請確認是否輸入正確公鑰2000004缺少必填參數請確認必填參數是否已輸入2000005bizContent缺少必填參數請輸入bizContent中的必填參數2000010事務所名稱為空或與在平臺注冊的名稱不一致請檢查函證請求方名稱是否正確3000001函證編號不存在請輸入正確的函證編號3000011ipAddress校驗不通過請確認當前ipAddress是否正確7000001請求失敗，獲取響應體異常請確定報文加密是否使用了平臺公鑰7000002請求失敗，返回的responseBizContent為空請確定平臺是否收到請求7000003返回消息格式異常請確定平臺是否收到請求7000004響應消息驗簽失敗請確認數字簽名信息是否正確8000001請傳入請求參數請傳入請求參數8000002請傳入參數：bizContent請傳入參數：bizContent注：完整的返回碼列表參見附錄A。函證實時狀態(tài)批量查詢函證請求方可調用此接口查詢多條函證當前所處的狀態(tài)，應用編程接口信息描述于表21～表24。表21 函證實時狀態(tài)批量查詢基本屬性名稱屬性接口名稱JSONactualityBatch(JSONparams)接口功能函證請求方查詢函證實時狀態(tài)URL/bpbcapi/v1/confirmation/status/actualityBatchURL參數無請求類型POST請求內容類型application/json表21 函證實時狀態(tài)批量查詢基本屬性（續(xù)）名稱屬性字符集UTF-8表22 函證實時狀態(tài)批量查詢輸入參數章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.1函證請求方IDtenantIdstring11M5.1.2函證請求方名稱tenantNamestring50M5.5.1消息IDmsgIdstring32M5.5.2消息發(fā)送時間timeStampstring19M5.5.3發(fā)起方地址ipAddressstring128M5.5.4提交人submitterstring19M5.5.5消息簽名signstring300MStartb業(yè)務參數體bizContentobject/M5.1.5函證編號列表upstreamEventSerialNoListstring16C5.1.8函證申請開始日期applicationDateStartstring10C5.1.9函證申請結束日期applicationDateEndstring10C無頁碼currentPageint10O無每頁顯示條數limitint10OEndb業(yè)務參數體bizContentobject/M加密與簽名要求：函證請求方應使用私鑰對業(yè)務參數體“bizContent”全文進行簽名；T/CBA211—20216.3注：（upstreamEventSerialNoList）applicationDateStarta章節(jié)號指的是T/CBA212—2021中的章節(jié)號。b“start”和“End”之間的信息是JSON報文中的一個對象，即一組信息的集合。表23 函證實時狀態(tài)批量查詢輸出參數章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.6返回代碼retCodestring7M5.5.7返回信息retMsgstring100O5.5.5返回消息簽名signstring/OStart返回業(yè)務參數體responseBizContentobject/M5.5.1消息IDmsgIdstring32M無總條數totalNumberint10O無每頁顯示條數limitint10O無頁碼currentPageint10O5.1.5函證編號applicationList->upstreamEventSerialnostring27M表23 函證實時狀態(tài)批量查詢輸出參數（續(xù)）章節(jié)號中文名稱鍵名字段類型字段長度必要性5.3.1a函證狀態(tài)applicationList->statusstring6MEnd返回業(yè)務參數體responseBizContentobject/M銀行函證服務平臺使用平臺私鑰對返回業(yè)務參數體“responseBizContent”內所有鍵值對進行簽名。a銀行函證狀態(tài)編碼規(guī)定于表B.1。表24 函證實時狀態(tài)批量返回碼信息及解決方案返回碼返回信息解決方案0請求成功1000001函證請求方ID不存在請確認是否輸入正確函證請求方ID1000002函證請求方ID未啟用請聯系平臺工作人員確定函證請求方啟停用情況1000003函證請求方公鑰不存在請確認是否輸入正確公鑰2000004缺少必填參數請確認必填參數是否已輸入2000005bizContent缺少必填參數請輸入bizContent中的必填參數2000010事務所名稱為空或與在平臺注冊的名稱不一致請檢查函證請求方名稱是否正確2000031函證編號數組長度最大為20請重新輸入函證編號2000032申請日期開始與申請日期結束，必須成對傳入請同時輸入起止申請日期2000033函證編號數組參數錯誤，參數中有不存在的函證編號請檢查列表內的函證編號是否正確2000035函證分頁參數不能小于0且每頁顯示數量要求在10-50之間請輸入正確的limit參數2000036函證開始時間不能大于函證結束時間請輸入正確的起止申請日期3000011ipAddress校驗不通過請確認當前ipAddress是否正確3000012函證開始時間格式不正確，請重新填寫日期格式為：yyyy-MM-dd3000013函證結束時間格式不正確，請重新填寫日期格式為：yyyy-MM-dd7000001請求失敗，獲取響應體異常請確定報文加密是否使用了平臺公鑰7000002請求失敗，返回的responseBizContent為空請確定平臺是否收到請求7000003返回消息格式異常請確定平臺是否收到請求7000004響應消息驗簽失敗請確認數字簽名信息是否正確8000001請傳入請求參數請傳入請求參數8000002請傳入參數：bizContent請傳入參數：bizContent注：完整的返回碼列表參見附錄A。函證狀態(tài)流轉記錄查詢表25 函證狀態(tài)流轉記錄查詢基本屬性名稱屬性接口名稱JSONhistory(JSONparams)接口功能函證請求方查詢函證狀態(tài)流轉記錄URL/bpbcapi/v1/confirmation/status/historyURL參數無請求類型POST請求內容類型application/json字符集UTF-8表26 函證狀態(tài)流轉記錄查詢輸入參數章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.1函證請求方IDtenantIdstring11M5.1.2函證請求方名稱tenantNamestring50M5.5.1消息IDmsgIdstring32M5.5.2消息發(fā)送時間timeStampstring19M5.5.3發(fā)起方地址ipAddressstring128M5.5.4提交人submitterstring19M5.5.5消息簽名signstring300MStartb業(yè)務參數體bizContentobject/M5.1.5函證編號upstreamEventSerialnostring16MEndb業(yè)務參數體bizContentobject/M加密與簽名要求：函證請求方應使用私鑰對業(yè)務參數體“bizContent”全文進行簽名；T/CBA211—20216.3a章節(jié)號指的是T/CBA212—2021中的章節(jié)號。b“start”和“End”之間的信息是JSON報文中的一個對象，即一組信息的集合。表27 函證狀態(tài)流轉記錄查詢輸出參數章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.6返回代碼retCodestring7M5.5.7返回信息retMsgstring100O5.5.5返回消息簽名signstring/OStart返回業(yè)務參數體responseBizContentobject/M5.5.1消息IDmsgIdstring32M5.1.5函證編號upstreamEventSerialnostring27M5.3.1a狀態(tài)列表->狀態(tài)statusList->statusstring6M5.3.2狀態(tài)列表->備注說明statusList->commentsstring500O5.3.3狀態(tài)列表->更新時間statusList->timeStampstring19M5.3.4狀態(tài)列表->操作人statusList->operatorstring50O表27 函證狀態(tài)流轉記錄查詢輸出參數（續(xù)）章節(jié)號中文名稱鍵名字段類型字段長度必要性5.3.5狀態(tài)列表->操作IPstatusList->ipAddressstring45MEnd返回業(yè)務參數體responseBizContentobject/M銀行函證服務平臺使用平臺私鑰對返回業(yè)務參數體“responseBizContent”內所有鍵值對進行簽名。a銀行函證狀態(tài)編碼規(guī)定于表B.1。表28 函證狀態(tài)流轉記錄查詢返回碼信息及解決方案返回碼返回信息解決方案0請求成功1000001函證請求方ID不存在請確認是否輸入正確函證請求方ID1000002函證請求方ID未啟用請聯系平臺工作人員確定函證請求方啟停用情況1000003函證請求方公鑰不存在請確認是否輸入正確公鑰2000004缺少必填參數請確認必填參數是否已輸入2000005bizContent缺少必填參數請輸入bizContent中的必填參數2000010事務所名稱為空或與在平臺注冊的名稱不一致請檢查函證請求方名稱是否正確3000001函證編號不存在請輸入正確的函證編號3000011ipAddress校驗不通過請確認當前ipAddress是否正確7000001請求失敗，獲取響應體異常請確定報文加密是否使用了平臺公鑰7000002請求失敗，返回的responseBizContent為空請確定平臺是否收到請求7000003返回消息格式異常請確定平臺是否收到請求7000004響應消息驗簽失敗請確認數字簽名信息是否正確8000001請傳入請求參數請傳入請求參數8000002請傳入參數：bizContent請傳入參數：bizContent注：完整的返回碼列表參見附錄A。函證文件下載表29 函證文件下載基本屬性名稱屬性接口名稱JSONdownload(JSONparams)接口功能函證請求方下載回函文件URL/bpbcapi/v1/confirmation/downloadURL參數無請求類型請求內容類型POSTapplication/json字符集UTF-8表30 函證文件下載輸入參數章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.1函證請求方IDtenantIdstring11M5.1.2函證請求方名稱tenantNamestring50M5.5.1消息IDmsgIdstring32M5.5.2消息發(fā)送時間timeStampstring19M5.5.3發(fā)起方地址ipAddressstring128M5.5.4提交人submitterstring19M5.5.5消息簽名signstring300MStartb業(yè)務參數體bizContentobject/M5.1.5函證編號upstreamEventSerialnostring16MEndb業(yè)務參數體bizContentobject/M加密與簽名要求：函證請求方應使用私鑰對業(yè)務參數體“bizContent”全文進行簽名；T/CBA211—20216.3a章節(jié)號指的是T/CBA212—2021中的章節(jié)號。b“start”和“End”之間的信息是JSON報文中的一個對象，即一組信息的集合。表31 函證文件下載輸出參數章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.6返回代碼retCodestring7M5.5.7返回信息retMsgstring100O5.5.5返回消息簽名signstring/OStart返回業(yè)務參數體responseBizContentobject/M5.5.1消息IDmsgIdstring32M5.1.5函證編號upstreamEventSerialnostring27M5.2.4回函密鑰sCodestring/M5.2.5回函文件名confirmationFileNamestring/M5.2.6回函正文confirmationTextstring/MEnd返回業(yè)務參數體responseBizContentobject/M銀行函證服務平臺使用平臺私鑰對返回業(yè)務參數體“responseBizContent”內所有鍵值對進行簽名。表32 函證文件下載返回碼信息及解決方案返回碼返回信息解決方案0請求成功1000001函證請求方ID不存在請確認是否輸入正確函證請求方ID1000002函證請求方ID未啟用請聯系平臺工作人員確定函證請求方啟停用情況1000003函證請求方公鑰不存在請確認是否輸入正確公鑰2000004缺少必填參數請確認必填參數是否已輸入2000005bizContent缺少必填參數請輸入bizContent中的必填參數表32 函證文件下載返回碼信息及解決方案（續(xù)）返回碼返回信息解決方案2000010事務所名稱為空或與在平臺注冊的名稱不一致請檢查函證請求方名稱是否正確3000001函證編號不存在請輸入正確的函證編號3000003回函文件不存在請與銀行確認是否已上傳回函文件3000006回函文件準備中，請稍候再試請稍后再試3000008回函文件已銷毀，請重新申請請重新發(fā)起函證3000010函證當前狀態(tài)非已回函狀態(tài)，不可下載回函文件請確認當前函證狀態(tài)3000011ipAddress校驗不通過請確認當前ipAddress是否正確7000001請求失敗，獲取響應體異常請確定報文加密是否使用了平臺公鑰7000002請求失敗，返回的responseBizContent為空請確定平臺是否收到請求7000003返回消息格式異常請確定平臺是否收到請求7000004響應消息驗簽失敗請確認數字簽名信息是否正確8000001請傳入請求參數請傳入請求參數8000002請傳入參數：bizContent請傳入參數：bizContent注：完整的返回碼列表參見附錄A。函證申請秘鑰獲取表33 函證申請秘鑰獲取基本屬性名稱屬性接口名稱JSONqueryBankPublicKey(JSONparams)接口功能函證請求方獲取銀行公鑰用于加密對稱密鑰URL/bpbcapi/v1/confirmation/query/bankpublickeyURL參數無請求類型POST請求內容類型application/json字符集UTF-8表34 函證申請秘鑰獲取輸入參數章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.1函證請求方IDtenantIdstring11M5.1.2函證請求方名稱tenantNamestring50M5.5.1消息IDmsgIdstring32M5.5.2消息發(fā)送時間timeStampstring19M5.5.3發(fā)起方地址ipAddressstring128M5.5.4提交人submitterstring19M5.5.5消息簽名signstring300MStartb業(yè)務參數體bizContentobject/M表34 函證申請秘鑰獲取輸入參數（續(xù)）章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.4銀行名稱bankNamestring16MEndb業(yè)務參數體bizContentobject/M加密與簽名要求：函證請求方應使用私鑰對業(yè)務參數體“bizContent”全文進行簽名；T/CBA211—20216.3a章節(jié)號指的是T/CBA212—2021中的章節(jié)號。b“start”和“End”之間的信息是JSON報文中的一個對象，即一組信息的集合。表35 函證申請秘鑰獲取輸出參數章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.6返回代碼retCodestring7M5.5.7返回信息retMsgstring100O5.5.5返回消息簽名signstring/OStart返回業(yè)務參數體responseBizContentobject/M5.5.1消息IDmsgIdstring32M5.1.4銀行名稱bankNamestring50M5.2.7銀行公鑰sCodestring/MEnd返回業(yè)務參數體responseBizContentobject/M銀行函證服務平臺使用平臺私鑰對返回業(yè)務參數體“responseBizContent”內所有鍵值對進行簽名。表36 函證申請秘鑰獲取返回碼信息及解決方案返回碼返回信息解決方案0請求成功1000001函證請求方ID不存在請確認是否輸入正確函證請求方ID1000002函證請求方ID未啟用請聯系平臺工作人員確定函證請求方啟停用情況1000003函證請求方公鑰不存在請確認是否輸入正確公鑰2000003銀行不存在請輸入正確的銀行名稱2000004缺少必填參數請確認必填參數是否已輸入2000005bizContent缺少必填參數請輸入bizContent中的必填參數2000010事務所名稱為空或與在平臺注冊的名稱不一致請檢查函證請求方名稱是否正確3000004查詢的銀行公鑰不存在請確認銀行是否上傳公鑰3000011ipAddress校驗不通過請確認當前ipAddress是否正確7000001請求失敗，獲取響應體異常請確定報文加密是否使用了平臺公鑰7000002請求失敗，返回的responseBizContent為空請確定平臺是否收到請求7000003返回消息格式異常請確定平臺是否收到請求7000004響應消息驗簽失敗請確認數字簽名信息是否正確8000001請傳入請求參數請傳入請求參數8000002請傳入參數：bizContent請傳入參數：bizContent表36 函證申請秘鑰獲取返回碼信息及解決方案（續(xù)）返回碼返回信息解決方案注：完整的返回碼列表參見附錄A。函證提供方詳細信息查詢表37 函證提供方詳細信息查詢基本屬性名稱屬性接口名稱JSONqueryBankDetail(JSONparams)接口功能函證請求方查詢已接入函證平臺的銀行詳細信息(支持的模板類型、接入渠道類型、機構列表、聯行號等等)URL/bpbcapi/v1/confirmation/bank/detailURL參數無請求類型POST請求內容類型application/json字符集UTF-8表38 函證提供方詳細信息查詢輸入參數章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.1函證請求方IDtenantIdstring11M5.1.2函證請求方名稱tenantNamestring50M5.5.1消息IDmsgIdstring32M5.5.2消息發(fā)送時間timeStampstring19M5.5.3發(fā)起方地址ipAddressstring128M5.5.4提交人submitterstring19M5.5.5消息簽名signstring300MStartb業(yè)務參數體bizContentobject/M5.1.4函證提供方名稱bankNamestring50MEndb業(yè)務參數體bizContentobject/M加密與簽名要求：函證請求方應使用私鑰對業(yè)務參數體“bizContent”全文進行簽名；T/CBA211—20216.3a章節(jié)號指的是T/CBA212—2021中的章節(jié)號。b“start”和“End”之間的信息是JSON報文中的一個對象，即一組信息的集合。表39 函證提供方詳細信息查詢輸出參數章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.6返回代碼retCodestring7M5.5.7返回信息retMsgstring100O表39 函證提供方詳細信息查詢輸出參數（續(xù)）章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.5返回消息簽名signstring/OStart返回業(yè)務參數體responseBizContentobject/M5.1.4函證提供方名稱bankList->bankNamestring50M5.4.1銀行金融許可證機構編碼abankList->financialCodestring15M5.4.2函證提供方接入渠道bankList->bankChannelstring3M5.4.3函證提供方支持模板類型bankList->templatestring20M5.4.4銀行函證業(yè)務說明bankList->instructionsstring65535OEnd返回業(yè)務參數體responseBizContentobject/M銀行函證服務平臺使用平臺私鑰對返回業(yè)務參數體“responseBizContent”內所有鍵值對進行簽名。a銀行金融許可證機構編碼是由中國銀行保險監(jiān)督委員會依法頒發(fā)的特許銀行機構經營金融業(yè)務的法律文件數字編碼。表40 函證提供方詳細信息查詢返回碼信息及解決方案返回碼返回信息解決方案0請求成功1000001函證請求方ID不存在請確認是否輸入正確函證請求方ID1000002函證請求方ID未啟用請聯系平臺工作人員確定函證請求方啟停用情況1000003函證請求方公鑰不存在請確認是否輸入正確公鑰2000004缺少必填參數請確認必填參數是否已輸入2000010事務所名稱為空或與在平臺注冊的名稱不一致請檢查函證請求方名稱是否正確2000012bizContent字段超長請重新輸入bizContent3000009查詢的銀行信息不存在請與銀行確認是否已上傳銀行信息3000011ipAddress校驗不通過請確認當前ipAddress是否正確7000001請求失敗，獲取響應體異常請確定報文加密是否使用了平臺公鑰7000002請求失敗，返回的responseBizContent為空請確定平臺是否收到請求7000003返回消息格式異常請確定平臺是否收到請求7000004響應消息驗簽失敗請確認數字簽名信息是否正確8000001請傳入請求參數請傳入請求參數注：完整的返回碼列表參見附錄A。函證提供方交互概述函證提供方應用場景可分為多個視角，其中：從技術上看，銀行函證服務平臺是服務提供方，函證提供方是銀行函證平臺服務的調用方；從業(yè)務上看，函證提供方是銀行函證業(yè)務的服務提供方。函證狀態(tài)更新表41 函證狀態(tài)更新基本屬性名稱屬性接口名稱JSONcondirmationStatusUpdate(JSONparams)接口功能銀行更新函證狀態(tài)URL/bpbcapi/v1/confirmation/status/updateURL參數無請求類型POST請求內容類型application/json字符集UTF-8表42 函證狀態(tài)更新輸入參數章節(jié)號a中文名稱鍵名字段類型字段長度必要性5.1.3函證提供方IDtenantIdstring11M5.1.4函證提供方名稱tenantNamestring50M5.5.1消息IDmsgIdstring32M5.5.2消息發(fā)送時間timeStampstring19M5.5.3發(fā)起方地址ipAddressstring128M5.5.4提交人submitterstring19M5.5.5消息簽名signstring300MStartb業(yè)務參數體bizContentobject/M5.1.5函證編號upstreamEventSerialnostring27M5.3.1c函證狀態(tài)statusstring6M5.3.6扣費金額paymentstring10O5.3.2函證狀態(tài)更新說明commentsstring500OEndb業(yè)務參數體bizContentobject/M加密與簽名要求：函證提供方應使用私鑰對業(yè)務參數體“bizContent”全文進行簽名；T/CBA211—20216.3a章節(jié)號指的是T/CBA212—2021中的章節(jié)號。b“start”和“End”之間的信息是JSON報文中的一個對象，即一組信息的集合。c函證提供方函證狀態(tài)編碼規(guī)定于表B.1。表43 函證狀態(tài)更新輸出參數章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.6返回代碼retCodestring7M5.5.7返回信息retMsgstring100O5.5.5返回消息簽名signstring/OStart返回業(yè)務參數體responseBizContentstring/M表43 函證狀態(tài)更新輸出參數（續(xù)）章節(jié)號中文名稱鍵名字段類型字段長度必要性5.5.1消息IDmsgIdobject32M5.1.5函證編號upstreamEventSerialnostring27MEnd返回業(yè)務參數體responseBizContentobject/M銀行函證服務平臺使用平臺私鑰對返回業(yè)務參數體“responseBizContent”內所有鍵值對進行簽名。表44 函證狀態(tài)更新返回碼信息及解決方案返回碼返回信息解決方案0請求成功400009請求數據不存在請確認函證編號是否正確400010銀行函證狀態(tài)無法更新，請確認該數據是否可更新為當前狀態(tài)請確認函證當前狀態(tài)400011comments長度校驗不通過請確認comments是否超過500字符400016當前狀態(tài)不可更新為目標狀態(tài)請確認函證當前狀態(tài)400017函證提供方ID不存在請確認是否輸入正確銀行ID400018函證提供方ID與函證提供方名稱必須匹配請確認銀行ID是否正確400019函證提供方ID未啟用請確定銀行啟停用情況3000011ipAddress字段超長請確認當前ipAddress是否正確7000001請求失敗，獲取響應體異常請確定報文加密是否使用了平臺公鑰7000002請求失敗，返回的responseBizContent為空請確定平臺是否收到請求7000003返回消息格式異常請確定平臺是否收到請求7000004響應消息驗簽失敗請確認數字簽名信息是否正確8000000請創(chuàng)建帶有blockChainConnBean參數的連接請創(chuàng)建帶有blockChainConnBean參數的連接8000001請傳入