城市公共交通二維碼應(yīng)用技術(shù)規(guī)范

城市公共交通二維碼應(yīng)用技術(shù)規(guī)范范圍本文件規(guī)定了XX省城市公共交通領(lǐng)域二維碼應(yīng)用的數(shù)據(jù)格式、安全性、服務(wù)器數(shù)據(jù)交換協(xié)議、受理終端以及客戶端軟件的要求。本文件適用于XX省城市公共交通二維碼的服務(wù)系統(tǒng)、終端、客戶端軟件等的設(shè)計、研發(fā)與應(yīng)用。規(guī)范性引用文件下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T2312信息交換用漢字編碼字符集基本集GB/T18284—2000快速響應(yīng)矩陣碼GB/T32918（所有部分）信息安全技術(shù)SM2橢圓曲線公鑰密碼算法JT/T978.3城市公共交通IC卡技術(shù)規(guī)范第3部分：讀寫終端JT/T1179—2018交通一卡通二維碼支付技術(shù)規(guī)范術(shù)語和定義JT/T1179—2018界定的以及下列術(shù)語和定義適用于本文件。城市公共交通municipalpublictransportation運用公共汽電車、城市軌道交通、城市客運輪渡等運載工具和有關(guān)設(shè)施，按照核定的線路、站點、時間、票價運營，為公眾提供基本出行服務(wù)的城市客運方式。縮略語下列縮略語適用于本文件。3DES：三重數(shù)據(jù)加密算法（TripleDES）CA：電子商務(wù)認證授權(quán)機構(gòu)（CertificateAuthority）FTP：文件傳輸協(xié)議（FileTransferProtocol）S：超文本安全傳輸協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）MAC：消息認證碼（MessageAuthenticationCode）MAK：MAC密鑰（MACKey）MD5：信息—摘要算法（message—digestalgorithm5）MMK：成員主密鑰（MemberMasterKey）QRCODE：快速響應(yīng)矩陣碼（QuickResponseCode）RSA：一種非對稱加解密技術(shù)（RivestShamirAdleman）SM2：SM2橢圓曲線公鑰密碼算法（PublicKeyCryptographicAlgorithmSM2BasedonEllipticCurves）SM3：SM3密碼雜湊算法（SM3CryptographicHashAlgorithm）SM4：SM4分組密碼加密算法（SM4CryptographicAlgorithm）SSL/TLS：安全套接層/傳輸層安全（SecureSocketsLayer/TransportLayerSecurity）TLV：標簽、長度、值（TagLengthValue）TAC：交易認證碼（（TransactionAuthenticationCode）UID：用戶賬戶標識（UserAccountIdentifier）UIID：用戶賬戶發(fā)行方標識（UserAccountIssuerIdentity）UTC：協(xié)調(diào)世界時（CoordinatedUniversalTime）系統(tǒng)架構(gòu)XX省城市公共交通二維碼應(yīng)用系統(tǒng)由省級清算管理機構(gòu)、發(fā)碼機構(gòu)、收單機構(gòu)、受理終端、客戶端軟件組成。系統(tǒng)架構(gòu)見圖1。系統(tǒng)架構(gòu)示意圖省級清算管理機構(gòu)：省級二維碼清結(jié)算業(yè)務(wù)運營主體，負責全省二維碼交易數(shù)據(jù)的歸集，以及負責省內(nèi)跨城市、跨機構(gòu)之間的二維碼交易清分與結(jié)算，負責發(fā)碼機構(gòu)證書的統(tǒng)一申領(lǐng)和發(fā)放，負責各發(fā)碼機構(gòu)互聯(lián)互通的配置管理，發(fā)碼機構(gòu)、收單機構(gòu)、受理終端、客戶端軟件的時間均同步省級清算管理機構(gòu)服務(wù)器的時間。發(fā)碼機構(gòu)：城市公共交通二維碼運營主體或其它二維碼運營主體，負責用戶管理、資金渠道管理、二維碼密鑰服務(wù)、城市二維碼數(shù)據(jù)清結(jié)算及交易風險控制。發(fā)碼機構(gòu)申請二維碼流程、受理終端驗證二維碼流程、跨區(qū)域交易清分結(jié)算流程應(yīng)符合JT/T1179—2018的要求。收單機構(gòu)：城市公共交通二維碼交易終端運營主體或其它二維碼交易終端運營主體，負責受理終端安裝、系統(tǒng)維護、交易數(shù)據(jù)采集和上傳。受理終端：用于二維碼交易的終端設(shè)備。掃碼方式采用受理終端主掃模式?？蛻舳塑浖河糜谏啥S碼的應(yīng)用程序，包括用戶注冊、用戶登錄、密鑰申請以及二維碼生成等功能。二維碼數(shù)據(jù)格式編碼格式二維碼的編碼格式應(yīng)符合JT/T1179—2018的要求。數(shù)據(jù)結(jié)構(gòu)二維碼數(shù)據(jù)主要由17個字段組成，包括：二維碼版本、二維碼數(shù)據(jù)長度、城市發(fā)碼機構(gòu)公鑰證書、支付賬戶號、用戶賬戶號、城市發(fā)碼機構(gòu)代碼、發(fā)碼平臺代碼、用戶賬戶類型、單次消費金額上限、支付賬戶用戶公鑰、支付賬戶系統(tǒng)授權(quán)過期時間、二維碼有效時間、城市發(fā)碼機構(gòu)自定義域長度、城市發(fā)碼機構(gòu)自定域、城市發(fā)碼機構(gòu)授權(quán)簽名、二維碼生成時間和支付賬戶用戶私鑰簽名。二維碼數(shù)據(jù)結(jié)構(gòu)見表1，二維碼數(shù)據(jù)結(jié)構(gòu)說明見表2，二維碼數(shù)據(jù)結(jié)構(gòu)說明中出現(xiàn)的格式符號要求見附錄A。二維碼數(shù)據(jù)結(jié)構(gòu)二維碼結(jié)構(gòu)二維碼版本二維碼數(shù)據(jù)長度城市發(fā)碼機構(gòu)公鑰證書支付賬戶號用戶賬戶號城市發(fā)碼機構(gòu)代碼發(fā)碼平臺代碼用戶賬戶類型單次消費金額上限支付賬戶用戶公鑰支付賬戶系統(tǒng)授權(quán)過期時間二維碼有效時間城市發(fā)碼機構(gòu)自定義域長度城市發(fā)碼機構(gòu)自定域城市發(fā)碼機構(gòu)授權(quán)簽名二維碼生成時間支付賬戶用戶私鑰簽名1211716104413334213265465二維碼數(shù)據(jù)結(jié)構(gòu)說明序號字段名稱長度格式必填字段說明1二維碼版本1BM范圍為0x80—0xFF2二維碼數(shù)據(jù)長度2BM固定長度為0x016C3城市發(fā)碼機構(gòu)公鑰證書117BM應(yīng)符合JT/T1179—2018第9章的要求4支付賬戶號16ansM由支付賬戶系統(tǒng)自定義，長度不足前補“0”5用戶賬戶號10BM由城市發(fā)碼機構(gòu)賬戶管理平臺定義，長度不足前補“0”6城市發(fā)碼機構(gòu)代碼4BM由清算機構(gòu)統(tǒng)一分配7發(fā)碼平臺編碼4BM由清算機構(gòu)統(tǒng)一分配8用戶賬戶類型1BM用戶賬戶的類型（默認為0x01）0x01:普通卡0x02：學生卡0x03：老人卡0x04：測試卡0x05：軍人卡其他：城市發(fā)碼機構(gòu)自定義9單次消費金額上限3BM二維碼支付單次消費金額上限，由支付賬戶系統(tǒng)根據(jù)當前用戶消費狀態(tài)進行授權(quán)。此域在單次消費交易時可作為能否乘車的判斷依據(jù)10用戶公鑰33BM經(jīng)過壓縮的支付賬戶系統(tǒng)中用戶公鑰數(shù)據(jù)，壓縮方法應(yīng)符合GB/T32918的要求11系統(tǒng)授權(quán)過期時間4BM支付賬戶系統(tǒng)授權(quán)過期時間，使用UTC（0時區(qū)）時間1970年1月1日00：00：00到當前的秒數(shù)，高字節(jié)在前12二維碼有效時間2BM以秒為單位，此域在填寫時無須帶單位，高字節(jié)在前13城市發(fā)碼機構(gòu)自定義域長度1BM城市發(fā)碼機構(gòu)自定義域數(shù)據(jù)長度為3214城市發(fā)碼機構(gòu)自定義域32BM城市發(fā)碼機構(gòu)自定義，由城市發(fā)碼機構(gòu)自定義域，格式見6.315城市發(fā)碼機構(gòu)授權(quán)簽名65BM城市發(fā)碼機構(gòu)私鑰簽名，簽名數(shù)據(jù)包括本表中序號為3—14字段，應(yīng)符合JT/T1179—2018的要求16二維碼生成時間4BM二維碼生成的時間戳，使用UTC（0時區(qū)）時間1970年1月1日00：00：00到當前的秒數(shù)，高字節(jié)在前17支付賬戶用戶私鑰簽名65BM支付賬戶用戶私鑰簽名數(shù)據(jù)，簽名數(shù)據(jù)包括本表序號為1—16字段，應(yīng)符合JT/T1179—2018的要求發(fā)碼機構(gòu)自定義域定義和說明發(fā)碼機構(gòu)自定義數(shù)據(jù)結(jié)構(gòu)見表3。發(fā)碼機構(gòu)自定義數(shù)據(jù)結(jié)構(gòu)序號名稱長度格式標簽說明1發(fā)碼機構(gòu)保留區(qū)域11B由發(fā)碼機構(gòu)定義2交通行業(yè)類型標識1B01：公交02：城市軌道03：輪渡04：出租車05：城際軌道06：道路客運3交通行業(yè)自定義數(shù)據(jù)20B見6.4交通行業(yè)自定義說明發(fā)碼機構(gòu)自定義數(shù)據(jù)結(jié)構(gòu)見表4。發(fā)碼機構(gòu)自定義數(shù)據(jù)結(jié)構(gòu)序號交通行業(yè)類型標識標簽說明102第1字節(jié)為乘車碼驗證方式，0x1脫機驗證；0x2聯(lián)網(wǎng)驗證；0x3連防重系統(tǒng)驗證第2—3字節(jié)為流水號，每次交易里程使用一個流水號第4字節(jié)為車票狀態(tài)，0x1初始狀態(tài)；0x2已進站；0x3已出站；0x4進站更新狀態(tài)；0x5出站更新狀態(tài)第5—6字節(jié)為車站編碼，上一次處理車票的車站編碼，由線路和站點組成第7—10字節(jié)為車票處理時間，上一次處理車票的時間第11—14字節(jié)為行業(yè)數(shù)據(jù)過期時間第15—18字節(jié)為地鐵后臺賬戶ID第19—20字節(jié)為在線自助更新站點2其他保留信息接口說明通訊方式通訊方式應(yīng)使用S協(xié)議，POST請求數(shù)據(jù)方法。數(shù)據(jù)交換格式數(shù)據(jù)交換格式為JSON（JavaScriptObjectNotation）。接口數(shù)據(jù)簽名應(yīng)對數(shù)據(jù)進行數(shù)字簽名，在接收簽名數(shù)據(jù)之后進行簽名校驗。數(shù)字簽名有兩個步驟，先按7.1.4規(guī)則拼接簽名原始串，再選擇7.1.5的算法和密鑰計算出簽名結(jié)果。簽名原始串簽名原始串應(yīng)按以下方式組裝成字符串：——除簽名字段外，所有參數(shù)按照第一個字符的鍵值A(chǔ)SCII碼遞增排序，遇到相同字符則按照第二個字符的鍵值A(chǔ)SCII碼遞增排序，以此類推；——排序后的參數(shù)與其對應(yīng)值組合成“參數(shù)名=參數(shù)值”的格式，并用“&”字符連接起來。簽名原始串中，參數(shù)名和參數(shù)值都采用原始值。簽名算法對簽名原始串的尾部加上字符串“&key=”，再加上簽名密鑰值，形成待簽名字符串，使用MD5算法，對待簽名字符串計算MD5值，再轉(zhuǎn)成大寫字符串。示例：JSON數(shù)據(jù)中有3個參數(shù)，其表達為：{”service”:”abc”，”timestamp”:”123”，”version”:”1.0”}。簽名原始串示例為：service=abc&timeStamp=123&version=1.0簽名密鑰值為：123456簽名字符串示例為：service=abc&timeStamp=123&version=1.0&key=123456簽名字符串的MD5值為：88046c2fa808dc6c71a6ee3eb7c9b812簽名字符串的MD5值轉(zhuǎn)換為大寫為：88046C2FA808DC6C71A6EE3EB7C9B812交互協(xié)議公共參數(shù)接口協(xié)議中的請求報文必須包含請求公共參數(shù)的所有字段見表5，接口協(xié)議中應(yīng)答報文必須包含應(yīng)答公共參數(shù)見表6。請求公共參數(shù)序號字段名參數(shù)名長度類型說明1接口版本version<=20字符串例如“1.0”2接口名稱service<=50字符串見各接口說明例如“TermRegist”3通道編號channelCode8字符串通道接入唯一標識例如“00000001”4請求時間timeStamp19字符串發(fā)起請求的時間：YYYY—MM—DDhh:mm:ss，格式見附錄A中的表A.1。例如“2020-11-1009:38:01”5參數(shù)編碼charSet<=10字符串例如“UTF-8”6簽名方式signType<=10字符串例如“MD5”7簽名sign32字符串簽名算法見7.1.5應(yīng)答公共參數(shù)序號字段名參數(shù)名長度類型說明1應(yīng)答時間timeStamp19字符串應(yīng)答時間：YYYY—MM—DDhh:mm:ss，格式見附錄A中的表A.1。例如“2020-11-1009:38:01”2簽名sign32字符串簽名算法見7.1.5收單機構(gòu)注冊接口接口名稱：TerminalRegist。收單機構(gòu)應(yīng)向省級清算管理機構(gòu)請求注冊。每個受理終端上線前收單機構(gòu)應(yīng)先將終端編號（PSAM卡號）發(fā)到省級清算管理機構(gòu)登記，上傳的交易數(shù)據(jù)才能被平臺受理。注冊接口請求參數(shù)見表7，返回參數(shù)見表8。請求參數(shù)序號字段名參數(shù)名長度類型說明1收單機構(gòu)標識iManagerId6字符串6位收單機構(gòu)標識例如“010001”2終端編號itermNo8字符串例如“99990001”返回參數(shù)序號字段名參數(shù)名長度類型說明1返回碼resultCode<=8字符串0：成功其他：錯誤2錯誤消息errMsg<=128字符串例如“系統(tǒng)錯誤！”賬單上送接口名稱：BillUpload。收單機構(gòu)應(yīng)向城市發(fā)碼機構(gòu)和省級清算管理機構(gòu)進行賬單上送。收單機構(gòu)將本地交易記錄（賬單）上傳給本地發(fā)碼機構(gòu)，發(fā)碼機構(gòu)根據(jù)上傳的賬單對用戶進行扣費。收單機構(gòu)將所有交易記錄（賬單）上傳給省級清算管理機構(gòu)，省級清算管理機構(gòu)應(yīng)將跨區(qū)交易記錄（賬單）上傳給本地發(fā)碼機構(gòu)相應(yīng)地市發(fā)碼機構(gòu)，相應(yīng)地市發(fā)碼機構(gòu)根據(jù)上傳的賬單對用戶進行扣費。賬單上送請求參數(shù)見表9，單條交易記錄格式見表10，返回參數(shù)見表11。終端上傳二維碼交易數(shù)據(jù)到服務(wù)端，采取準實時上傳方式，即終端存在未上傳交易時，應(yīng)立即上傳交易數(shù)據(jù)。終端應(yīng)根據(jù)錯誤的計數(shù)延遲上傳，每出現(xiàn)一次錯誤，延遲時間增加30秒，最大延遲時間為300秒。當出現(xiàn)一次響應(yīng)成功時，復(fù)位延遲時間復(fù)位。請求參數(shù)序號字段名參數(shù)名長度類型說明1交易記錄jList根據(jù)實際字符串長度填寫JSON字符串JSON格式：{{…}，{…}….}單條交易記錄格式序號字段名參數(shù)名長度類型說明1收單機構(gòu)標識acquirerId6字符串6位收單機構(gòu)標識例如“010001”2交易標識tranId32字符串收單機構(gòu)標識和收單機構(gòu)交易流水號流水組成，收單機構(gòu)每上送一筆交易，必須賦予數(shù)字交易流水號作為唯一標識，交易重復(fù)發(fā)送時的交易ID須相同，例如“”3支付賬戶號payAcct32字符串二維碼中原數(shù)據(jù)送回，見6.2表24用戶賬戶號userId20字符串城市發(fā)碼機構(gòu)的用戶id二維碼中原數(shù)據(jù)送回，見6.2表25城市發(fā)碼機構(gòu)代碼cardPlt8字符串見6.2表26發(fā)碼平臺代碼qrPlt8字符串填發(fā)碼平臺代碼（當付款方式用），見6.2表27交易金額totalFee<=10整數(shù)單位為分，10進制8應(yīng)收金額payFee<=10整數(shù)單位分，10進制9本次交易時間tranTime8十六進制字符串使用UTC（0時區(qū)）時間1970年1月1日00：00：00到當前的秒數(shù)，高字節(jié)在前10本次交易終端編號termNo8字符串交易時終端編號—應(yīng)取PSAM卡8位終端編號11線路編號lineNo8字符串填入線路編號12二維碼生成時間qrTime8十六進制字符串使用UTC（0時區(qū)）時間1970年1月1日00：00：00到當前的秒數(shù)，高字節(jié)在前13經(jīng)度lng8十六進制字符串掃碼時的終端經(jīng)度，4字節(jié)，共32位，高位在前第1位：0表示東經(jīng)，1表示西經(jīng)第1-31位表示經(jīng)度值，以1E-9度為單位14緯度lat8十六進制字符串掃碼時的終端緯度，4字節(jié)，共32位，高位在前，以1E-9度為單位15二維碼業(yè)務(wù)數(shù)據(jù)qrBiz64字符串城市發(fā)碼機構(gòu)自定義數(shù)據(jù)內(nèi)容表10單條交易記錄格式（續(xù)）序號字段名參數(shù)名長度類型說明16交易類型tranType2字符串第1位:0：普通卡1：乘車券第2位：0：公交消費1：地鐵入閘2：地鐵出閘消費3：地鐵核準交易17終端流水號termSeq10字符串前補“0”18站點編號station4字符串站點名稱19系統(tǒng)授權(quán)過期時間sysauthTime8十六進制字符串對應(yīng)二維碼中系統(tǒng)授權(quán)過期時間賬戶系統(tǒng)授權(quán)過期時間，使用UTC（0時區(qū)）時間1970年1月1日00：00：00到當前的秒數(shù)，高字節(jié)在前20碼類型qrType1字符串1：正常碼2：應(yīng)急碼21外地市二維碼數(shù)據(jù)allCode728十六進制字符串省外發(fā)碼機構(gòu)的二維碼在省內(nèi)受理的，該項必填返回參數(shù)序號字段名參數(shù)名長度類型說明1返回碼resultCode<=4字符串0：成功其他：錯誤2錯誤消息errMsg<=500字符串例如“系統(tǒng)錯誤！”城市發(fā)碼機構(gòu)白名單下載接口接口名稱：AcceptCitysInfo。收單機構(gòu)應(yīng)向省級清算管理機構(gòu)請求城市白名單列表。受理終端通過收單機構(gòu)下載最新的白名單列表信息。獲取白名單請求參數(shù)見表12，返回參數(shù)見表13。請求參數(shù)序號字段名參數(shù)名長度類型說明1收單機構(gòu)標識imanagerId6字符串6位收單機構(gòu)標識返回參數(shù)序號字段名參數(shù)名長度類型說明1城市發(fā)碼機構(gòu)白名單列表whiteList<1000字符串城市發(fā)碼機構(gòu)代碼列表，逗號分隔2返回碼resultCode<=4字符串0：成功其他：錯誤3錯誤消息errMsg<=500字符串例如“系統(tǒng)錯誤！”時鐘同步接口接口名稱：TimeSynchronize。收單機構(gòu)和發(fā)碼機構(gòu)應(yīng)向省級清算管理機構(gòu)請求時鐘同步，受理終端和客戶端軟件應(yīng)分別向收單機構(gòu)和發(fā)碼機構(gòu)申請時間同步，服務(wù)器返回系統(tǒng)標準