統(tǒng)一支付對接平臺對接規(guī)范

DB36/T984—2017DB36/T984—2017IIPAGEI統(tǒng)一支付對接平臺對接規(guī)范范圍本標準規(guī)定了江西省政務服務統(tǒng)一支付對接平臺（以下簡稱統(tǒng)一支付平臺）建設技術標準編制的基本原則、標準體系、標準制（修）定、持續(xù)改進與推廣應用的要求。本標準適用于指導各級（市、縣區(qū)）政務服務系統(tǒng)建設工作的規(guī)劃、制定、修訂、應用與管理等工作。規(guī)范性引用文件下列文件對于本文件的應用是必不可少的。分時注明日期的引用文件，僅注明日期的版本適用于本文件。凡是不注明日期的引用文件，其最新版本適用于本文件?！丁盎ヂ?lián)網(wǎng)+政務服務”技術體系建設指南》(國辦函〔2016〕108號)術語下列術語和定義適用于本文件。

UTF-8UNICODE的一種變長字符編碼，又稱萬國碼，用在網(wǎng)頁上可以在同一頁面顯示中文簡體、繁體及其它語言(如日文、韓文)。

XMLSchema文件描述了XML文檔的結構，它的作用是定義一份XML文檔的合法組件群。

StructuralData即行數(shù)據(jù),存儲在數(shù)據(jù)庫里,可以用二維表結構來邏輯表達實現(xiàn)的數(shù)據(jù)。

UnstructuralData不方便用數(shù)據(jù)庫二維邏輯表來表現(xiàn)的數(shù)據(jù)稱為非結構化數(shù)據(jù),包括所有格式的辦公文檔、文本、圖片、XML、HTML、各類報表、圖像和音頻/視頻信息等等。

WebService又稱XMLWebService，WebService是一種可以接收從Internet或者Internet上的其它系統(tǒng)中傳遞過來的請求，輕量級的獨立的通訊技術。即通過SOAP在Web上提供的軟件服務，使用WSDL文件進行說明，并通過UDDI進行注冊。

XML擴展型可標記語言，面向短期的臨時數(shù)據(jù)處理、面向萬維網(wǎng)絡，是SOAP的基礎。

WSDL全稱WebServicesDescriptionLanguage，WSDL文件是一個XML文檔，用于說明一組SOAP消息以及如何交換這些消息，大多數(shù)情況下由軟件自動生成和使用。

RESTREST描述了一個架構樣式的互聯(lián)系統(tǒng)（如Web應用程序）。REST約束條件作為一個整體應用時，將生成一個簡單、可擴展、有效、安全、可靠的架構。由于它簡便、輕量級以及通過HTTP直接傳輸數(shù)據(jù)的特性，RESTFulWeb服務成為基于SOAP服務的一個最有前途的替代方案。用于Web服務和動態(tài)Web應用程序的多層架構可以實現(xiàn)可重用性、簡單性、可擴展性和組件可響應性的清晰分離。

統(tǒng)一支付對接平臺系統(tǒng)總體構架江西省政務服務統(tǒng)一支付對接平臺主要由設備接入層、前臺交互層、支付交易層、后臺管理層、輔助服務、客戶服務、短信服務、信息數(shù)據(jù)層、基礎設施層、統(tǒng)一安全保障體系和統(tǒng)一數(shù)據(jù)交換機制組成，全省集中式部署和存儲，其總體框架如下圖所示：圖1江西省政務服務統(tǒng)一支付對接平臺邏輯架構圖

服務組織結構江西省政務服務統(tǒng)一支付對接平臺主要用于支付交易、繳費配置管理、資金安全監(jiān)控、數(shù)據(jù)分析等，按照系統(tǒng)建設目標規(guī)劃，根據(jù)對江西省政務服務統(tǒng)一支付對接平臺的業(yè)務和功能需求進行梳理和分析，結合未來業(yè)務的拓展需要，業(yè)務功能包括電子繳費統(tǒng)一網(wǎng)關、繳費人服務子系統(tǒng)、收款單位服務子系統(tǒng)、后臺管理子系統(tǒng)、資金安全監(jiān)控子系統(tǒng)、數(shù)據(jù)分析子系統(tǒng)、客戶服務子系統(tǒng)等7大業(yè)務功能。本系統(tǒng)規(guī)劃功能結構如圖1所示：江西省政務江西省政務服務統(tǒng)一支付對接平臺江西省政務服務網(wǎng)江西省網(wǎng)上審批系統(tǒng)電子繳費統(tǒng)一網(wǎng)關統(tǒng)一資金安全監(jiān)控子系統(tǒng)數(shù)據(jù)分析子系統(tǒng)客服服務子系統(tǒng)后臺管理子系統(tǒng)繳費人繳款服務子系統(tǒng)收款單位服務子系統(tǒng)非稅收入收繳管理系統(tǒng)非稅收入收繳管理系統(tǒng)-清分子系統(tǒng)代收機構交易系統(tǒng)網(wǎng)銀支付系統(tǒng)第三方支付系統(tǒng)銀聯(lián)網(wǎng)上支付系統(tǒng)手機支付系統(tǒng)圖2江西省政務服務統(tǒng)一支付對接平臺系統(tǒng)架構服務交互圖繳費平臺和地方非稅系統(tǒng)間，在交互財政非稅收入收繳業(yè)務相關電子信息（電子憑證）時的服務交互流程如下，包括應用間的數(shù)據(jù)流、交互處理原則等圖3統(tǒng)一支付平臺系統(tǒng)交互圖建設方式本平臺系統(tǒng)采用省級平臺統(tǒng)一部署、地市級平臺各組成系統(tǒng)對接省級平臺的建設方式。業(yè)務流程商戶模式此模式中，商戶系統(tǒng)指代面向繳款人提供業(yè)務服務，并使用訂單作為數(shù)據(jù)基礎與統(tǒng)一支付平臺進行繳款數(shù)據(jù)交互的系統(tǒng)。商戶模式中，商戶系統(tǒng)無法獲取到每一筆訂單的繳款書信息，只能獲取到統(tǒng)一支付對接平臺封裝好的訂單信息。

網(wǎng)上繳費業(yè)務流程圖4網(wǎng)上繳費業(yè)務流程網(wǎng)上繳費流程步驟說明：1)繳款人登錄商戶系統(tǒng)，選擇要辦理的業(yè)務；2)繳款人填寫相關業(yè)務材料信息，商戶系統(tǒng)將自動生成繳款信息，繳款人確認繳款；3)商戶系統(tǒng)向支付平臺發(fā)送繳款請求申請，支付平臺對繳費信息進行驗證；4)支付平臺對繳費信息驗證通過后展示支付頁面給繳款人，若驗證不通過，返回錯誤信息頁面并結束本流程；5)繳款人選擇支付方式、支付銀行等，確認后；支付平臺將調用銀行網(wǎng)銀系統(tǒng)，由繳款人在銀行網(wǎng)銀端完成支付；6)繳款人支付完成后，支付平臺將展示支付成功網(wǎng)頁提示繳款人，繳款人可根據(jù)網(wǎng)頁上的提示信息繼續(xù)后續(xù)業(yè)務辦理；7)同時支付平臺將在繳款人支付完成后通知商戶系統(tǒng)交易結果；8)商戶系統(tǒng)在收到支付平臺的交易結果通知時，應將交易處理結果的回執(zhí)通知給支付平臺。日終對賬日終時，商戶系統(tǒng)與支付平臺必須進行流水核對，商戶系統(tǒng)從支付平臺下載繳費訂單結算明細逐筆進行核對。圖5日終對賬流程流程說明：（1）支付平臺向代收機構發(fā)起日終結算數(shù)據(jù)對賬查詢請求，代收機構驗證請求通過后，根據(jù)結算的情況返回相應的對賬單數(shù)據(jù)，支付平臺根據(jù)返回的對賬單數(shù)據(jù)對繳款訂單進行核對處理;（2）支付平臺與代收機構日終結算成功后，支付平臺向財政非稅票據(jù)系統(tǒng)發(fā)起日終繳款確認信息對賬，財政非稅票據(jù)根據(jù)收到的日終確認信息，對繳款書進行逐個核對與繳款確認處理，以保障數(shù)據(jù)的一致性；（3）在支付平臺日終結算數(shù)據(jù)對賬成功后，業(yè)務系統(tǒng)向支付平臺發(fā)起結算單查詢，支付平臺在收到請求時，根據(jù)結算的情況返回結算單數(shù)據(jù)，以實現(xiàn)業(yè)務系統(tǒng)能夠對每筆繳款書進行繳款確認，以保證雙方交易數(shù)據(jù)的一致性。（4）代收機構根據(jù)日終結算的結算資金劃轉至指定賬戶后，將所產生的資金入賬流水信息提供給支付平臺，支付平臺將根據(jù)該入賬流水信息進行資金到賬處理；（5）支付平臺在資金到賬處理成功后，支付平臺向財政非稅票據(jù)系統(tǒng)發(fā)起日終繳款資金到賬對賬，財政非稅票據(jù)根據(jù)收到的日終資金到賬對賬進行資金到賬處理，以保證資金流與數(shù)據(jù)流一致性，方可實現(xiàn)后續(xù)資金清分處理。（6）特別說明：資金到賬流水的流水號需與現(xiàn)有通知非稅系統(tǒng)的流水號保持一致。非稅業(yè)務模式非稅業(yè)務模式主要面向于江西省“互聯(lián)網(wǎng)+政務服務”平臺系統(tǒng)，提供符合江西省財政廳文件《財政業(yè)務基礎數(shù)據(jù)規(guī)范（2.0版）》的一整套流程化的支付交付服務。網(wǎng)上繳費業(yè)務流程圖6網(wǎng)上繳費業(yè)務流程網(wǎng)上繳費流程步驟說明:1)繳款用戶登錄業(yè)務系統(tǒng)，選擇要辦理的業(yè)務；2)在業(yè)務需繳款時，業(yè)務系統(tǒng)向支付平臺發(fā)送申請開具電子繳款書，支付平臺對繳費信息進行驗證，通過驗證后返回繳款書信息給業(yè)務系統(tǒng)；并由業(yè)務系統(tǒng)展現(xiàn)繳款信息供繳款用戶查看；3)繳款用戶根據(jù)繳款書信息登錄支付平臺查看繳款書信息，待核對信息無誤后，可申請網(wǎng)上繳款，繳款平臺將根據(jù)用戶的請求生成繳款訂單信息并申請代收機構進行網(wǎng)上支付請求，繳款用戶通過代收機構的交易系統(tǒng)操作完成支付交易處理；代收機構在收到交易成功結果后通知支付平臺交易結果，由支付平臺處理交易結果；4)支付平臺在處理交易結果成功后，支付平臺將返回相應繳費成功提示；5)同時支付平臺將在繳款人支付完成后通知業(yè)務系統(tǒng)繳款書繳款結果；業(yè)務系統(tǒng)對交易結果信息進行數(shù)據(jù)處理。日終對賬日終時，業(yè)務系統(tǒng)與支付平臺必須進行流水核對，業(yè)務系統(tǒng)從支付平臺下載繳費書結算明細逐筆進行核對。請參考本文“6.1.2日終對賬”。

系統(tǒng)接口說明統(tǒng)一支付對接平臺接口規(guī)范數(shù)據(jù)交互協(xié)議本接口規(guī)范中所有服務接口的數(shù)據(jù)交互方式，均采用HTTP協(xié)議，并以POST請求方式提交。接口服務地址請各單位向江西省信息中心申請接口服務的IP地址與端口。根據(jù)IP地址與端口與特定字符串拼接后，江西省統(tǒng)一支付對接平臺提供的接口服務地址如下：http://IP地址:端口/JNS/jns/entpaybusmgr/uniformResAllocation.do請求報文規(guī)范表1請求報文規(guī)范參數(shù)中文名參數(shù)名類型定義強制簽名參數(shù)說明接入標識符merappStr(MAX30)是是由支付平臺提供接口版本號versionStr(MAX10)是是由支付平臺提供終端類型deviceStr(MAX10)是是終端設備類型；1：桌面電腦2:手機3:自助機交易名稱tranNameStr(MAX100)是是由支付平臺提供請求數(shù)據(jù)reqDataStr不限定是是請求數(shù)據(jù)報文，json格式并采用base64編碼，詳見《附錄CJSON說明》簽名signStr不限定是否RSA簽名，詳見《附錄B簽名機制》字符集charsetStr(MAX10)否否默認：UTF-8;請求參數(shù)的編碼字符集，僅支持UTF-8/GBK返回格式規(guī)范請求返回采用Json格式;表2請求返回采用Json格式屬性中文名屬性名類型定義強制簽名參數(shù)說明響應碼respCodeStr(MAX10)是是000：響應成功999：響應失敗響應數(shù)據(jù)respDataStr(不限)是是響應數(shù)據(jù)報文，json格式并采用base64編碼，詳見《附錄CJSON說明》；其中，響應失敗數(shù)據(jù)請查閱《附錄D響應失敗數(shù)據(jù)》簽名signStr不限定是否RSA簽名，詳見《附錄B簽名機制》字符集charsetStr(MAX10)否否默認：UTF-8;請求參數(shù)的編碼字符集，僅支持UTF-8/GBK統(tǒng)一支付對接平臺接口說明-商戶模式繳款請求接口(商戶系統(tǒng)-->支付平臺)描述繳款人在商戶系統(tǒng)中填寫完相關業(yè)務資料，確認無誤后，商戶系統(tǒng)生成相應的繳款信息，調用繳款請求接口，支付平臺將返回支付頁面給繳款人。交易名稱繳款請求：payOrder請求數(shù)據(jù)(reqData)表3請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明應用名稱appNameStr(MAX30)是由支付平臺提供應用版本appVersionStr(MAX15)是由支付平臺提供訂單號ordNoStr(MAX30)是本商戶必須唯一訂單日期ordDateStr(8)是格式：yyyyMMdd訂單總金額amountNUMBER(16,2)是格式：0.00跳轉地址redirectUrlStr(MAX200)否頁面跳轉地址通知地址notifyUrlStr(MAX200)否服務通知地址子訂單數(shù)量quantityNUMBER(16,0)是通用參數(shù)commparaStr(MAX200)否支付平臺不做處理，當繳費成功后，在支付結果通知時，以通知參數(shù)轉發(fā)給商戶系統(tǒng)付款人payerNameStr(MAX80)是付款人手機號phoneStr(11)是備注1remark1Str(MAX200)否備注2remark2Str(MAX200)否備注3remark3Str(MAX200)否繳款信息feeDataStr(不限)是json格式請求時間reqTimeStr(MAX17)是格式：yyyyMMddHHmmss繳款信息（feeData）參數(shù)說明：(可具有多個繳款信息)表4繳款信息參數(shù)中文名參數(shù)名類型定義強制說明繳款識別碼payCodeStr(MAX32)是同一訂單業(yè)務繳款明細唯一電子票據(jù)類型eBillCodeStr(MAX30)是單位唯一碼orgUnicodeStr(MAX30)是金額合計sumNUMBER(16,2)是繳款人payManStr(MAX200)否未指定繳款人時，為付款人(payerName)備注1note1Str(MAX200)否備注2note2Str(MAX200)否收入明細項目chrgDetailStr(不限)是json格式收入明細項目（chrgDetail）參數(shù)說明：(可具有多個收入明細項)表5收入明細項目參數(shù)中文名參數(shù)名類型定義強制說明收入項目碼itemUnicodeStr(max15)是計量單位unitStr(max20)是執(zhí)收標準standardNUMBER(16,2)是執(zhí)收數(shù)量amountNUMBER(16,0)是執(zhí)收金額paymentNUMBER(16,2)是接口返回支付平臺接收到支付請求后，根據(jù)終端設備類型（5.3請求報文規(guī)范），返回對應的數(shù)據(jù)形式。共有“桌面電腦終端”，“手機終端”，“自助機終端”，“條碼付終端”四種設備類型。桌面電腦終端發(fā)送桌面電腦終端訂單請求數(shù)據(jù)后，跳轉到PC電腦的網(wǎng)頁版頁面，返回數(shù)據(jù)：表6桌面電腦終端屬性中文名屬性名類型定義強制說明處理碼codeStr(MAX10)是000:處理正常其他為處理失敗處理詳情信息messageStr(MAX200)是請求urlrequrlStr(MAX100)否code=000時，必有值，支付跳轉的html5的url

手機終端發(fā)送手機終端訂單請求數(shù)據(jù)后，跳轉到手機終端的頁面，手機終端返回數(shù)據(jù)(respData)：表7手機終端屬性中文名屬性名類型定義強制說明處理碼codeStr(MAX10)是000:處理正常其他為處理失敗處理詳情信息messageStr(MAX200)是請求urlrequrlStr(MAX100)否code=000時，必有值，支付跳轉的html5的url注：手機終端在請求支付時，在處理正常(code=000)的情況下，需根據(jù)返回的請求url(requrl)值，完成請求支付跳轉的操作。自助機終端自助機終端返回數(shù)據(jù)(respData)：表8自助機終端屬性中文名屬性名類型定義強制說明處理碼codeStr(MAX10)是000:處理正常其他為處理失敗處理詳情信息messageStr(MAX200)是返回訂單信息ordDataStr(不限)否code=000時，必有值，Json對象返回訂單信息(ordData)：表9返回訂單信息屬性中文名屬性名類型定義強制說明訂單號ordNoStr(MAX20)是訂單日期ordDateStr(8)是格式：yyyyMMdd訂單時間ordTimeStr(6)是格式：HHmmss平臺流水號platformNoStr(MAX30)是訂單總金額amountNUMBER(16,2)是繳款人payManList<String>是Json數(shù)組支付渠道列表payChannelStr(不限)否Json對象列表支付渠道(payChannel)：表10支付渠道屬性中文名屬性名類型定義強制說明渠道編碼channelCodeStr(MAX20)是渠道名稱channelNameStr(MAX80)是渠道描述descriptionStr(MAX300)否條碼付終端條碼付終端返回數(shù)據(jù)(respData)：表11條碼付終端返回數(shù)據(jù)屬性中文名屬性名類型定義強制說明處理碼codeStr(MAX10)是000:處理正常其他為處理失敗處理詳情信息messageStr(MAX200)是返回訂單信息ordDataStr(不限)否code=000時，必有值，Json對象返回訂單信息(ordData)：表12返回訂單信息屬性中文名屬性名類型定義強制說明訂單號ordNoStr(MAX20)是訂單日期ordDateStr(8)是格式：yyyyMMdd訂單時間ordTimeStr(6)是格式：HHmmss平臺流水號platformNoStr(MAX30)是訂單總金額amountNUMBER(16,2)是繳款人列表payManList<String>是Json對象列表支付渠道列表payChannelStr(不限)否Json對象列表支付渠道(payChannel)：表13支付渠道屬性中文名屬性名類型定義強制說明渠道編碼channelCodeStr(MAX20)是渠道名稱channelNameStr(MAX80)是渠道描述descriptionStr(MAX300)否條碼支付接口(商戶系統(tǒng)-->支付平臺)描述條碼支付為窗口工作人員使用掃碼設備（如:手持條碼掃描槍、平臺式掃描平臺、二維碼掃描器等）主動掃描繳款人的付款碼，或手動輸入繳款人付款碼的方式進行支付扣款請求。交易名稱條碼支付：reqCodePay。請求數(shù)據(jù)(reqData)表14請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明訂單號ordNoStr(MAX20)是訂單日期ordDateStr(8)是格式為：yyyyMMdd平臺流水號platformNoStr(MAX30)是渠道編碼channelCodeStr(MAX20)是付款碼payCodeStr(MAX128)是

返回數(shù)據(jù)(respData)表15返回數(shù)據(jù)屬性中文名屬性名類型定義強制說明訂單號ordNoStr(MAX20)是訂單日期ordDateStr(8)是格式為：yyyyMMdd訂單總金額amountNUMBER(16,2)是格式：0.00交易狀態(tài)tranStatusStr(1)是1:交易成功2:交易失敗3:待確認平臺流水號platformNoStr(MAX30)是交易流水號tranBankNoStr(MAX30)否交易日期tranDateStr(MAX8)否格式為：yyyyMMdd交易時間tranTimeStr(MAX6)否格式為：HHmmss通用參數(shù)commparaStr(MAX200)否交易結果頁面跳轉接口(支付平臺-->商戶系統(tǒng))描述支付成功后，支付平臺生成支付結果信息，以頁面跳轉的方式，將支付結果信息用URL參數(shù)，跳轉商戶系統(tǒng)的頁面（頁面url由繳款請求接口中跳轉地址(redirectUrl)參數(shù)指定，若未指定則從該商戶的基礎配置信息中獲取跳轉地址），以便于商戶系統(tǒng)可以做下一步處理。交易名稱交易結果跳轉服務：notifyOrder請求數(shù)據(jù)(reqData)表16請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明訂單號ordNoStr(MAX20)是訂單日期ordDateStr(8)是格式為：yyyyMMdd訂單總金額amountNUMBER(16,2)是格式：0.00交易狀態(tài)tranStatusStr(1)是1:交易成功平臺流水號platformNoStr(MAX30)是交易流水號tranBankNoStr(MAX30)是交易日期tranDateStr(MAX8)是格式為：yyyyMMdd交易時間tranTimeStr(MAX6)是格式為：HHmmss通用參數(shù)commparaStr(MAX200)否服務地址服務地址均采用繳款請求接口的參數(shù)地址優(yōu)先，商戶配置信息次之的處理方式；即，若繳款請求時，如果未填寫跳轉地址(redirectUrl)，則從該商戶的基礎配置信息中獲取跳轉地址，否則直接使用跳轉地址進行頁面跳轉。交易結果服務通知接口(支付平臺-->商戶系統(tǒng))描述支付成功后，支付平臺生成支付結果信息，以服務器通知的方式，將支付結果信息用URL參數(shù)，通知商戶系統(tǒng)（url由繳款請求接口中通知地址[notifyUrl]參數(shù)指定，若未指定則從該商戶的基礎配置信息中獲取通知地址），以便于商戶系統(tǒng)可以做下一步處理。交易名稱交易結果通知服務：notifyOrderPost請求數(shù)據(jù)(reqData)表17請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明訂單號ordNoStr(MAX20)是訂單日期ordDateStr(8)是格式為：yyyyMMdd訂單總金額amountNUMBER(16,2)是格式：0.00交易狀態(tài)tranStatusStr(1)是1:交易成功平臺流水號platformNoStr(MAX30)是交易流水號tranBankNoStr(MAX30)是交易日期tranDateStr(MAX8)是格式為：yyyyMMdd交易時間tranTimeStr(MAX6)是格式為：HHmmss通用參數(shù)commparaStr(MAX200)否返回數(shù)據(jù)(respData)表18返回數(shù)據(jù)屬性中文名屬性名類型定義強制說明訂單號ordNoStr(MAX20)是處理狀態(tài)oprStatusStr(1)是1:處理成功0:處理失敗服務地址服務地址采用繳款請求接口的參數(shù)地址優(yōu)先，商戶配置信息次之的處理方式；即，若繳款請求時，如果未填寫通知地址(notifyUrl)，則從該商戶的基礎配置信息中獲取通知地址，否則直接使用通知地址進行通知交易結果。業(yè)務約束交易結果通知可能會有多次同時通知商戶系統(tǒng)，商戶系統(tǒng)須加約束以避免重復處理；商戶系統(tǒng)應在收到通知時，須將處理結果反饋給支付平臺；如果支付平臺未收到商戶系統(tǒng)反饋信息，將在24小時內進行多次通知。約束：交易成功后，支付平臺使用相同的平臺流水號進行交易結果通知時，商戶系統(tǒng)須按冪等處理方式對交易結果進行處理與反饋。繳款訂單交易結果查詢接口(商戶系統(tǒng)-->支付平臺)描述查詢指定繳款訂單的當前實時交易結果情況交易名稱繳款訂單交易結果查詢：qryPayOrder請求數(shù)據(jù)(reqData)表19請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明訂單號ordNoStr(MAX20)是訂單日期ordDateStr(8)是格式為：yyyyMMdd返回數(shù)據(jù)(respData)表20返回數(shù)據(jù)屬性中文名屬性名類型定義強制說明訂單號ordNoStr(MAX20)是訂單日期ordDateStr(8)是格式為：yyyyMMdd訂單總金額amountNUMBER(16,2)是格式：0.00交易狀態(tài)tranStatusStr(1)是1:交易成功2:交易失敗3:待確認平臺流水號platformNoStr(MAX30)是交易流水號tranBankNoStr(MAX30)否交易日期tranDateStr(MAX8)否格式為：yyyyMMdd交易時間tranTimeStr(MAX6)否格式為：HHmmss通用參數(shù)commparaStr(MAX200)否繳款訂單結算單查詢接口(商戶系統(tǒng)-->支付平臺)描述查詢指定范圍內的所有繳款訂單結算數(shù)據(jù)的明細列表情況，基于商戶系統(tǒng)與支付平臺中的繳款訂單的交易結果數(shù)據(jù)須是一致的前提下，商戶系統(tǒng)須在日終后通過繳款訂單結算單查詢接口，從支付平臺批量下載繳款結算明細，以逐筆核對數(shù)據(jù)。交易名稱繳款訂單結算單查詢：listStlOrder請求數(shù)據(jù)(reqData)表21請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明結算日期stlDateStr(MAX8)是格式：yyyyMMdd頁碼pageNoNUMBER(4)是記錄的第幾頁數(shù)據(jù)，從1開始每頁記錄數(shù)pageSizeNUMBER(4)是每頁記錄數(shù)取值范圍[1000,5000]返回數(shù)據(jù)(respData)表22返回數(shù)據(jù)屬性中文名屬性名類型定義強制說明記錄總頁數(shù)pageCountNUMBER(4)是返回記錄總頁數(shù)當前頁碼pageNoNUMBER(4)是返回當前記錄頁碼結算日期stlDateStr(MAX8)是格式為：yyyyMMdd交易信息feeDataStr(無限制)是所有交易信息數(shù)據(jù)形成的JSON格式明文串，并做BASE64編碼；具體內容見下文；交易信息（feeData）屬性說明：表23交易信息屬性屬性中文名屬性名類型定義強制說明訂單號ordNoStr(MAX20)是訂單日期ordDateStr(8)是格式為：yyyyMMdd訂單總金額amountNUMBER(16,2)是格式：0.00交易狀態(tài)tranStatusStr(1)是1:交易成功平臺流水號platformNoStr(MAX30)是交易流水號tranBankNoStr(MAX30)是交易日期tranDateStr(MAX8)是格式為：yyyyMMdd交易時間tranTimeStr(MAX6)是格式為：HHmmss通用參數(shù)commparaStr(MAX200)否統(tǒng)一支付對接平臺接口說明–非稅業(yè)務模式開具繳款書(業(yè)務系統(tǒng)-->支付平臺)描述繳款人在業(yè)務系統(tǒng)中辦理相關業(yè)務，并根據(jù)業(yè)務相關的繳費內容，在確認無誤后，業(yè)務系統(tǒng)生成相應的繳款信息，調用開具繳款書接口服務申請電子繳款書，支付平臺將返回繳款書信息。交易名稱開具繳款書invoice請求數(shù)據(jù)(reqData)表24請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明業(yè)務流水號busNoStr(MAX30)是全局唯一開票單位標識deptCodeStr(MAX32)是唯一標識開票點編碼placeCodeStr(MAX30)否不填寫，則取默認值電子繳款書種類編碼eBillCodeStr(MAX30)否不填寫，則取默認值時間ivcDateTimeStr(MAX20)是格式:yyyy-MM-ddHH:mm:ss.SSS開票人ivcAuthorStr(MAX200)是繳款人payerNameStr(MAX200)是繳款人手機號payerTelStr(MAX11)是繳款人證件號payerCertificateStr(MAX30)否合計金額totalAmtNUMBER(18,2)是備注remarkStr(MAX200)否收費項目明細chargeDetailStr不限定是項目明細項（chargeDetail）參數(shù)說明：表25項目明細項參數(shù)參數(shù)中文名參數(shù)名類型定義強制說明收費項目編碼chargeCodeStr(max100)是收費項目名稱chargeNameStr(max200)是計量單位unitStr(max30)否收費標準standardNumber(16,2)是數(shù)量countNumber(16,2)是金額amtNumber(16,2)是備注remarkStr(max200)否返回數(shù)據(jù)（respData）respData為json數(shù)組格式表26返回數(shù)據(jù)屬性中文名屬性名類型定義強制說明業(yè)務流水號busNoStr(MAX30)是全局唯一開票單位標識deptCodeStr(MAX32)是唯一標識，平臺提供繳款碼epayCodeStr(MAX30)是創(chuàng)建時間createTimeStr(14)是作廢繳款書(業(yè)務系統(tǒng)-->支付平臺)描述對于錯開、誤開的繳款書，或者因業(yè)務需要停止繳款服務的繳款，使用本接口服務將繳款書作廢。S交易名稱作廢繳款書：invalidate請求數(shù)據(jù)(reqData)表27請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明開票單位標識deptCodeStr(MAX32)是唯一標識，平臺提供業(yè)務流水號busNoStr(MAX30)是全局唯一繳款碼epayCodeStr(MAX30)是返回數(shù)據(jù)（respData）表28返回數(shù)據(jù)屬性中文名屬性名類型定義強制說明操作狀態(tài)operateStatusStr(1)是0：作廢失敗1：作廢成功操作結果信息operateMsgStr(MAX200)否繳款書繳款確認(支付平臺-->業(yè)務系統(tǒng))描述繳款書繳款確認信息信息用URL做下一步處理。交易名稱繳款書繳款確認：confirm請求數(shù)據(jù)(reqData)表29請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明開票單位標識deptCodeStr(MAX32)是唯一標識，平臺提供業(yè)務流水號busNoStr(MAX30)是全局唯一繳款碼epayCodeStr(MAX30)是繳款狀態(tài)payStatusStr(1)是1已繳款繳款日期payDateStr(8)是yyyyMMdd繳款渠道payChannelStr(MAX30)是繳款銀行payBankStr(MAX32)是返回數(shù)據(jù)(respData)表30返回數(shù)據(jù)屬性中文名屬性名類型定義強制說明接收結果編碼receiveCodeStr(MAX5)是成功00000失敗99999接收結果信息receiveMsgStr(MAX200)否繳款書確認失敗的錯誤信息查看電子票據(jù)(業(yè)務系統(tǒng)-->支付平臺)描述業(yè)務系統(tǒng)在需要展現(xiàn)電子票據(jù)時，可通過該接口服務按繳款碼等參數(shù)查看電子票據(jù)交易名稱查看電子票據(jù)：getEBill請求數(shù)據(jù)(reqData)表31請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明開票單位標識deptCodeStr(MAX32)是唯一標識，平臺提供業(yè)務流水號busNoStr(MAX30)是全局唯一繳款碼epayCodeStr(MAX30)是返回數(shù)據(jù)(respData)表32返回數(shù)據(jù)屬性中文名屬性名類型定義強制說明電子票據(jù)圖片數(shù)據(jù)pictureDataStr不限定是該值為Base64編碼，解析時需要Base64解碼單張繳款書查詢(業(yè)務系統(tǒng)-->支付平臺)描述此系統(tǒng)接口，提供查詢單張繳款書的詳細信息與繳款狀態(tài)查詢服務。交易名稱單張繳款書查詢：getDetail請求數(shù)據(jù)(reqData)表33請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明開票單位標識deptCodeStr(MAX32)是唯一標識，平臺提供業(yè)務流水號busNoStr(MAX30)是全局唯一繳款碼epayCodeStr(MAX30)是返回數(shù)據(jù)（respData）respData為json數(shù)組格式表34返回數(shù)據(jù)屬性中文名屬性名類型定義強制說明開票單位標識deptCodeStr(MAX32)是唯一標識，平臺提供業(yè)務流水號busNoStr(MAX30)是全局唯一繳款碼epayCodeStr(MAX30)是繳款狀態(tài)payStatusStr(1)是0未繳款1已繳款 2已作廢繳款日期payDateStr(8)否yyyyMMdd繳款渠道payChannelStr(MAX30)否繳款銀行payBankStr(MAX32)否批量繳款書查詢(業(yè)務系統(tǒng)-->支付平臺)描述查詢指定日期的已交易成功的繳款書信息。交易失敗或者已作廢的繳款書將不予回饋。交易名稱批量繳款書查詢：listTran請求數(shù)據(jù)(reqData)表35請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明繳款日期payDateStr(MAX8)是格式：yyyyMMdd頁碼pageNoNUMBER(4)是記錄的第幾頁數(shù)據(jù)，從1開始每頁記錄數(shù)pageSizeNUMBER(4)是每頁記錄數(shù)取值范圍[1,5000]返回數(shù)據(jù)(respData)表36返回數(shù)據(jù)屬性中文名屬性名類型定義強制說明記錄總頁數(shù)pageCountNUMBER(4)是返回記錄總頁數(shù)頁碼pageNoNUMBER(4)是返回當前記錄頁碼交易信息payData無限制是所有交易信息數(shù)據(jù)形成的JSON格式明文串，并做BASE64編碼；交易信息（payData）屬性說明：表37交易信息屬性屬性中文名屬性名類型定義強制說明開票單位標識deptCodeStr(MAX32)是唯一標識，平臺提供業(yè)務流水號busNoStr(MAX30)是全局唯一繳款碼epayCodeStr(MAX30)是繳款狀態(tài)payStatusStr(1)是1已繳款繳款日期payDateStr(8)是yyyyMMdd繳款渠道payChannelStr(MAX30)是繳款銀行payBankStr(MAX32)是繳款書交易結算單批量查詢(業(yè)務系統(tǒng)-->支付平臺)描述查詢指定范圍內的繳款書的交易結算信息。交易名稱繳款書交易結算單批量查詢：listSettle請求數(shù)據(jù)(reqData)表38請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明結算日期stlDateStr(MAX8)是格式：yyyyMMdd頁碼pageNoNUMBER(4)是記錄的第幾頁數(shù)據(jù)，從1開始每頁記錄數(shù)pageSizeNUMBER(4)是每頁記錄數(shù)取值范圍[1,5000]返回數(shù)據(jù)(respData)表39返回數(shù)據(jù)屬性中文名屬性名類型定義強制說明記錄總頁數(shù)pageCountNUMBER(4)是返回記錄總頁數(shù)頁碼pageNoNUMBER(4)是返回當前記錄頁碼結算日期stlDateStr(MAX8)是格式：yyyyMMdd交易信息payData無限制是所有交易信息數(shù)據(jù)形成的JSON格式明文串，并做BASE64編碼；交易信息（payData）屬性說明：表40交易信息屬性屬性中文名屬性名類型定義強制說明開票單位標識deptCodeStr(MAX32)是唯一標識，平臺提供業(yè)務流水號busNoStr(MAX30)是全局唯一繳款碼epayCodeStr(MAX30)是繳款狀態(tài)payStatusStr(1)是1已繳款繳款日期payDateStr(8)是yyyyMMdd繳款渠道payChannelStr(MAX30)是繳款銀行payBankStr(MAX32)是繳款書繳款(業(yè)務系統(tǒng)-->支付平臺)描述當繳款人在業(yè)務系統(tǒng)發(fā)起網(wǎng)上繳款請求，使用本接口進行繳款的頁面跳轉，提供多種渠道的支付服務。交易名稱繳款書繳款：payLetterOrder請求數(shù)據(jù)(reqData)表41請求數(shù)據(jù)參數(shù)中文名參數(shù)名類型定義強制說明開票單位標識deptCodeStr(MAX32)是唯一標識，平臺提供業(yè)務流水號busNoStr(MAX30)是全局唯一繳款碼epayCodeStr(MAX30)是返回數(shù)據(jù)支付平臺返回繳款頁面，業(yè)務系統(tǒng)需要打開此http頁面，供繳款人進行后續(xù)操作。示例：圖7繳款頁面

簽名機制流程描述1、在請求生成簽名的參數(shù)列表中，除去SIGN參數(shù)；2、對參數(shù)數(shù)組的每一個參數(shù)以ASCIIa到z3、排序完成后，所有的參數(shù)以“&”字符進行拼接。注：無值的參數(shù)無需傳遞。示例參數(shù)列表：(以下簽名示例均使用些參數(shù)示例)表42參數(shù)列表參數(shù)名值ORDDATE20150825ORDNUMD15082500000002PARAM1remarkparamSTYLE01SERVICEcom.bs.payINIP拼接后的簽名串為：INIP=&ORDDATE=20150825&ORDNUM=D15082500000002&PARAM1=remarkparam&SERVICE=com.bs.pay&STYLE=01簽名MD5簽名在進行MD5簽名時，需要密鑰參與生成簽名。MD5的密鑰是以英文字母和數(shù)字組成的32位字符串。請求時生成簽名字符串，利用MD5的簽名函數(shù)對這個新的字符串進行簽名運算，從而得到32位簽名結果字符串（該字符串賦值于參數(shù)SIGN通知返回時驗證簽名面，形成新的字符串，利用MD5的簽名函數(shù)對這個新的字符串進行簽名運算，從而得到32位簽名結果字符串。此時這個新的字符串需要與通知返回參數(shù)中的參數(shù)SIGN的值進行驗證是否相等，來判斷簽名是否驗證通過。示例密鑰：d79f24b96ed68b2179455fd3b754ae3待簽名的字符串為：INIP=&ORDDATE=20150825&ORDNUM=D15082500000002&PARAM1=remarkparam&SERVICE=com.bs.pay&STYLE=01cd79f24b96ed68b2179455fd3b754ae3簽名：4ea73e8203e085400c45fa429e2a85c8RSA簽名在進行RSA簽名時，需要私鑰和公鑰一起參與簽名。私鑰與公鑰皆是客戶生成得出的(私鑰、公鑰均需進行BASE64編碼后而得到的字符串)?？蛻舭焉沙龅墓€與支付平臺配置好的公鑰做交換。因此，在簽名時，客戶要用到的是客戶的私鑰及支付平臺的公鑰。注：簽名的結果進行兩次的BASE64編碼。請求時生成簽名RSA的簽名函數(shù)中進行簽名運算，從而得到簽名結果字符串。通知返回時驗證簽名參數(shù)中的參數(shù)SIGN的值三者一同放入RSA名是否驗證通過。示例私鑰：MIICdQIBADANBgkqhkiG9w0BAQEFAASCAl8wggJbAgEAAoGBAKstf0WW7CXfXHbk137gKVolqeJLwNPMWYzpfvGXFt0PnfqNbVq0FFt3qZIXfeW9s1bBFLeV12vps99/1EfSj82vBVahEHPsPuLFh/oJ6pm1i4H2tvLVM34GWQpK7G6S/y9ldw8jAZHXXte/39+64XGUNngrQPrPPUGAMbiG6lHbAgMBAAECgYAvWgGX7XzbqSL53Knj9fxabIrHB6+Kpz+qZDjyeZoggp5v3cl/SstK1ho5SHhSIhzHBdhGRJP3zQkt7T16tLuEdQE0oR4h+RPXhtpFVXzApS6xnGP3K0IKfnIt5+48Lz0n5eEZ8CLlioJeSmIJxmD/LBeFGU/+ycQNuTho6+nfWQJBAORqUlGWx3K+df9+kPA75KS5xcSWFl+C3h9IKApjYCb6Pgyj4+VSKRpUmk1aRiU3FP5zA64hpr/9dHJzurluLTUCQQC/2Z7YqhRNs2vnAx/CV7vqUhHlJYNhlCHESl2RxYj4uwDPGkG34HEe3