DB14-T 2543-2022 政府非稅網(wǎng)上支付平臺第三方接入接口規(guī)范

ICS35.080CCSL7714IDB14/T2543—2022前言 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 5基本要求 26接口組成 3參考文獻(xiàn) DB14/T2543—2022本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。本文件由山西省財(cái)政廳提出、組織實(shí)施和監(jiān)督檢查。本文件由山西省市場監(jiān)督管理局對標(biāo)準(zhǔn)的組織實(shí)施情況進(jìn)行監(jiān)督檢查。本文件由山西省財(cái)政標(biāo)準(zhǔn)化技術(shù)委員會(SXS/TC48)歸口。本文件起草單位：山西省財(cái)政科學(xué)研究院、山西寶佳質(zhì)量基礎(chǔ)研究院。本文件主要起草人：韓慧彥、李林駿、張寶林、任巍英、王永、魏笑甜。1DB14/T2543—2022政府非稅網(wǎng)上支付平臺第三方接入接口規(guī)范本文件規(guī)定了政府非稅網(wǎng)上支付平臺第三方接入接口的術(shù)語和定義、縮略語、基本要求和接口組成。本文件適用于政府非稅網(wǎng)上支付平臺第三方接入接口的設(shè)計(jì)、開發(fā)和應(yīng)用。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。IETFRFC3629UTF-8,ISO10646轉(zhuǎn)換格式（UTF-8,atransformationformatofISO10646）3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1Base64Base64是一種基于64個可打印ASCII字符對任意字節(jié)數(shù)據(jù)進(jìn)行編碼的算法。3.2siteCode政府非稅收入網(wǎng)上支付平臺分配給第三方的接入編碼。3.33DES三重?cái)?shù)據(jù)加密算法，對每個數(shù)據(jù)塊應(yīng)用三次加密算法。3.4注冊中心存儲第三方IP地址和認(rèn)證信息的服務(wù)。4縮略語下列縮略語適用于本文件。HTTP:超文本傳輸協(xié)議（HyperTextTransferProtocol）URL:統(tǒng)一資源定位符（UniformResourceLocator）2DB14/T2543—20225基本要求5.1接口協(xié)議接口協(xié)議統(tǒng)一采用HTTP協(xié)議。5.2數(shù)據(jù)結(jié)構(gòu)5.2.1基本數(shù)據(jù)類型接口基本數(shù)據(jù)類型見表1。表1基本數(shù)據(jù)類型每一項(xiàng)均為一個子數(shù)據(jù)項(xiàng)，子數(shù)據(jù)項(xiàng)編碼方式與父5.2.2數(shù)據(jù)編碼方式應(yīng)符合IETFRFC3629的規(guī)定。5.2.3數(shù)據(jù)交換格式應(yīng)采用JSON傳輸數(shù)據(jù)。5.3接口調(diào)用地址應(yīng)向政府非稅網(wǎng)上支付平臺獲取接口調(diào)用地址及端口號。5.4安全策略5.4.1在政府非稅網(wǎng)上支付平臺與第三方互聯(lián)過程中，應(yīng)采取必要的通信安全措施，采用TLS.IP驗(yàn)證、數(shù)字簽名、用戶身份驗(yàn)證等方法。5.4.2應(yīng)采用Base64加密解密保證數(shù)據(jù)在傳輸過程中的機(jī)密性。5.4.3宜使用3DES、MD5及以上算法，保證數(shù)據(jù)在傳輸過程中的完整性。5.4.4驗(yàn)證和授權(quán)通過以下兩種方式進(jìn)行：——確保相互訪問的地址是可信任的，相關(guān)證書通過數(shù)字簽名進(jìn)行驗(yàn)證；3DB14/T2543—2022——IP驗(yàn)證僅為初步驗(yàn)證請求來源的合法性方法。應(yīng)將第三方的IP及相關(guān)認(rèn)證信息存儲至注冊中心，政府非稅網(wǎng)上支付平臺在收到請求時，將請求的IP和系統(tǒng)認(rèn)證信息及注冊中心進(jìn)行對比，確認(rèn)請求源的合法性。5.4.5政府非稅網(wǎng)上支付平臺應(yīng)通過請求頻率和請求配額對單一請求方進(jìn)行限制。5.4.6應(yīng)通過數(shù)字簽名校驗(yàn)保證數(shù)據(jù)不被篡改。6接口組成6.1接口列表政府非稅網(wǎng)上支付平臺第三方接入應(yīng)支持的接口見表2。表2接口列表本接口用于生成非稅收入繳款書，同時生成統(tǒng)一繳款本接口用于對已經(jīng)開具的繳款書進(jìn)行作廢（繳款書本接口用于對已繳款的繳款書進(jìn)行退付申請（繳款書本接口用于對已提交繳款書退付申請進(jìn)行終止（繳款書必須是已繳款狀態(tài)并且已提6.2繳款書開具接口繳款書開具接口見表3。表3繳款書開具接口http://ip:port/api/issuePa4DB14/T2543—2022表3繳款書開具接口（續(xù)）是是否是否是是是是是是否是是否否是是是是是是5DB14/T2543—20226.3繳款書狀態(tài)查詢接口繳款書狀態(tài)查詢接口見表4。表4繳款書狀態(tài)查詢接口http://ip:port/api/queryPaymentS是是是是否是否否是否是是6.4繳款書作廢接口繳款書作廢接口見表5。6DB14/T2543—2022表5繳款書作廢接口http://ip:port/api/invalidPa是是是是是是是是6.5退付申請接口退付申請接口見表6。表6退付申請接口http://ip:port/api/applyR是是是是是7DB14/T2543—2022表6退付申請接口（續(xù)）是否否否否是是是是6.6退付申請終止接口退付申請終止接口見表7。表7退付申請終止接口http://ip:port/api/stopR是是是是是8DB14/T2543—2022表7退付申請終止接口（續(xù)）是是是是6.7繳款書明細(xì)查詢接口繳款書明細(xì)查詢接口見表8。表8繳款書明細(xì)查詢接口http://ip:port/api/queryPaymen是是是是是是是是否否否9DB14/T2543—20226.8電子票據(jù)信息接口電子票據(jù)信息接口見表9。表9電子票據(jù)信息接口http://ip:port/api/getElectroni是是否是是6.9單位可用收費(fèi)項(xiàng)目接口單位可用收費(fèi)項(xiàng)目接口見表10。表10單位可用收費(fèi)項(xiàng)目接口http://ip:port/api/queryCharge是是是否否否DB14/T2543—20226.10跳轉(zhuǎn)支付頁面接口跳轉(zhuǎn)支付頁面接口見表11。表11跳轉(zhuǎn)支付頁面接口http://ip:port/api/go是是否是是是6.11生成支付二維碼接口生成支付二維碼接口見表12。表12生成支付二維碼接口http://ip:port/api/getPayQ是是是是DB14/T2543—2022表12生成支付二維碼接口（續(xù)）是是6.12繳款書支付結(jié)果異步通知接口繳款書支付結(jié)果異步通知接口見表13。表13