ICS03.220.20

CCSR07

44

廣東省地方標(biāo)準(zhǔn)

DB44/T2310—2021

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

TechnicalSpecificationforTwo-DimensionalCodeinGuangdong'sMunicipal

PublicTransportation

2021-06-13發(fā)布2021-09-13實(shí)施

廣東省市場(chǎng)監(jiān)督管理局??發(fā)布

DB44/T2310—2021

目次

前言.......................................................................................................................................................................II

1范圍...................................................................................................................................................................1

2規(guī)范性引用文件...............................................................................................................................................1

3術(shù)語和定義.......................................................................................................................................................1

4縮略語...............................................................................................................................................................1

5系統(tǒng)架構(gòu)...........................................................................................................................................................2

6二維碼數(shù)據(jù)格式...............................................................................................................................................3

編碼格式...................................................................................................................................................3

數(shù)據(jù)結(jié)構(gòu)...................................................................................................................................................3

發(fā)碼機(jī)構(gòu)自定義域定義和說明...............................................................................................................5

交通行業(yè)自定義說明...............................................................................................................................5

7信息接口...........................................................................................................................................................5

說明...........................................................................................................................................................5

交互協(xié)議...................................................................................................................................................6

8受理終端要求.................................................................................................................................................11

9客戶端軟件要求.............................................................................................................................................11

10安全規(guī)范.......................................................................................................................................................11

附錄A（規(guī)范性）符號(hào)定義表........................................................................................................................12

I

DB44/T2310—2021

前言

本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定

起草。

本文件由廣東省交通運(yùn)輸廳提出，并組織實(shí)施。

本文件由廣東省交通運(yùn)輸（公路水路）標(biāo)準(zhǔn)化技術(shù)委員會(huì)（GD/TC133）歸口。

本文件起草單位：廣東嶺南通股份有限公司、廣州羊城通有限公司、廣東省道路運(yùn)輸事務(wù)中心、廣

州市公共交通數(shù)據(jù)管理中心、深圳市騰訊計(jì)算機(jī)系統(tǒng)有限公司。

本文件主要起草人：謝振東、方秋水、易智君、何建兵、劉兵、袁勇、徐鋒、吳金成、溫曉麗、于

航、曾江、程世勇、郭貴城、陳歷軍。

II

DB44/T2310—2021

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

1范圍

本文件規(guī)定了廣東省城市公共交通領(lǐng)域二維碼應(yīng)用的數(shù)據(jù)格式、安全性、服務(wù)器數(shù)據(jù)交換協(xié)議、受

理終端以及客戶端軟件的要求。

本文件適用于廣東省城市公共交通二維碼的服務(wù)系統(tǒng)、終端、客戶端軟件等的設(shè)計(jì)、研發(fā)與應(yīng)用。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對(duì)應(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ī)范

3術(shù)語和定義

JT/T1179—2018界定的以及下列術(shù)語和定義適用于本文件。

城市公共交通municipalpublictransportation

運(yùn)用公共汽電車、城市軌道交通、城市客運(yùn)輪渡等運(yùn)載工具和有關(guān)設(shè)施，按照核定的線路、站點(diǎn)、

時(shí)間、票價(jià)運(yùn)營，為公眾提供基本出行服務(wù)的城市客運(yùn)方式。

4縮略語

下列縮略語適用于本文件。

3DES：三重?cái)?shù)據(jù)加密算法（TripleDES）

CA：電子商務(wù)認(rèn)證授權(quán)機(jī)構(gòu)(CertificateAuthority)

FTP：文件傳輸協(xié)議(FileTransferProtocol)

HTTPS：超文本安全傳輸協(xié)議(HyperTextTransferProtocoloverSecureSocket

Layer)

MAC：消息認(rèn)證碼（MessageAuthenticationCode）

MAK：MAC密鑰(MACKey)

MD5：信息—摘要算法（message—digestalgorithm5）

MMK：成員主密鑰(MemberMasterKey)

QRCODE：快速響應(yīng)矩陣碼（QuickResponseCode)

1

DB44/T2310—2021

RSA：一種非對(duì)稱加解密技術(shù)（RivestShamirAdleman）

SM2：SM2橢圓曲線公鑰密碼算法(PublicKeyCryptographicAlgorithmSM2Basedon

EllipticCurves)

SM3：SM3密碼雜湊算法(SM3CryptographicHashAlgorithm)

SM4：SM4分組密碼加密算法(SM4CryptographicAlgorithm)

SSL/TLS：安全套接層/傳輸層安全(SecureSocketsLayer/TransportLayerSecurity)

TLV：標(biāo)簽、長度、值(TagLengthValue)

TAC：交易認(rèn)證碼（(TransactionAuthenticationCode）

UID：用戶賬戶標(biāo)識(shí)（UserAccountIdentifier）

UIID：用戶賬戶發(fā)行方標(biāo)識(shí)（UserAccountIssuerIdentity）

UTC：協(xié)調(diào)世界時(shí)(CoordinatedUniversalTime)

5系統(tǒng)架構(gòu)

廣東省城市公共交通二維碼應(yīng)用系統(tǒng)由省級(jí)清算管理機(jī)構(gòu)、發(fā)碼機(jī)構(gòu)、收單機(jī)構(gòu)、受理終端、客戶

端軟件組成。系統(tǒng)架構(gòu)見圖1。

圖1系統(tǒng)架構(gòu)示意圖

省級(jí)清算管理機(jī)構(gòu)：省級(jí)二維碼清結(jié)算業(yè)務(wù)運(yùn)營主體，負(fù)責(zé)全省二維碼交易數(shù)據(jù)的歸集，以及負(fù)責(zé)

省內(nèi)跨城市、跨機(jī)構(gòu)之間的二維碼交易清分與結(jié)算，負(fù)責(zé)發(fā)碼機(jī)構(gòu)證書的統(tǒng)一申領(lǐng)和發(fā)放，負(fù)責(zé)各發(fā)碼

2

DB44/T2310—2021

機(jī)構(gòu)互聯(lián)互通的配置管理，發(fā)碼機(jī)構(gòu)、收單機(jī)構(gòu)、受理終端、客戶端軟件的時(shí)間均同步省級(jí)清算管理機(jī)

構(gòu)服務(wù)器的時(shí)間。

發(fā)碼機(jī)構(gòu)：城市公共交通二維碼運(yùn)營主體或其它二維碼運(yùn)營主體，負(fù)責(zé)用戶管理、資金渠道管理、

二維碼密鑰服務(wù)、城市二維碼數(shù)據(jù)清結(jié)算及交易風(fēng)險(xiǎn)控制。發(fā)碼機(jī)構(gòu)申請(qǐng)二維碼流程、受理終端驗(yàn)證二

維碼流程、跨區(qū)域交易清分結(jié)算流程應(yīng)符合JT/T1179—2018的要求。

收單機(jī)構(gòu)：城市公共交通二維碼交易終端運(yùn)營主體或其它二維碼交易終端運(yùn)營主體，負(fù)責(zé)受理終端

安裝、系統(tǒng)維護(hù)、交易數(shù)據(jù)采集和上傳。

受理終端：用于二維碼交易的終端設(shè)備。掃碼方式采用受理終端主掃模式。

客戶端軟件：用于生成二維碼的應(yīng)用程序，包括用戶注冊(cè)、用戶登錄、密鑰申請(qǐng)以及二維碼生成等

功能。

6二維碼數(shù)據(jù)格式

編碼格式

二維碼的編碼格式應(yīng)符合JT/T1179—2018的要求。

數(shù)據(jù)結(jié)構(gòu)

二維碼數(shù)據(jù)主要由17個(gè)字段組成，包括：二維碼版本、二維碼數(shù)據(jù)長度、城市發(fā)碼機(jī)構(gòu)公鑰證書、

支付賬戶號(hào)、用戶賬戶號(hào)、城市發(fā)碼機(jī)構(gòu)代碼、發(fā)碼平臺(tái)代碼、用戶賬戶類型、單次消費(fèi)金額上限、支

付賬戶用戶公鑰、支付賬戶系統(tǒng)授權(quán)過期時(shí)間、二維碼有效時(shí)間、城市發(fā)碼機(jī)構(gòu)自定義域長度、城市發(fā)

碼機(jī)構(gòu)自定域、城市發(fā)碼機(jī)構(gòu)授權(quán)簽名、二維碼生成時(shí)間和支付賬戶用戶私鑰簽名。二維碼數(shù)據(jù)結(jié)構(gòu)見

表1，二維碼數(shù)據(jù)結(jié)構(gòu)說明見表2，二維碼數(shù)據(jù)結(jié)構(gòu)說明中出現(xiàn)的格式符號(hào)要求見附錄A。

表1二維碼數(shù)據(jù)結(jié)構(gòu)

二維碼結(jié)構(gòu)

支城

城付市城支

城

市城單支賬發(fā)市付

二二市二

發(fā)市發(fā)用次付戶碼發(fā)賬

二維支用維發(fā)維

碼發(fā)碼戶消賬系機(jī)碼戶

維碼付戶碼碼碼

機(jī)碼平賬費(fèi)戶統(tǒng)構(gòu)機(jī)用

碼數(shù)賬賬有機(jī)生

構(gòu)機(jī)臺(tái)戶金用授自構(gòu)戶

版據(jù)戶戶效構(gòu)成

公構(gòu)代類額戶權(quán)定授私

本長號(hào)號(hào)時(shí)自時(shí)

鑰代碼型上公過義權(quán)鑰

度間定間

證碼限鑰期域簽簽

域

書時(shí)長名名

間度

1211716104413334213265465

3

DB44/T2310—2021

表2二維碼數(shù)據(jù)結(jié)構(gòu)說明

序號(hào)字段名稱長度格式必填字段說明

1二維碼版本1BM范圍為0x80—0xFF

2二維碼數(shù)據(jù)長度2BM固定長度為0x016C

城市發(fā)碼機(jī)構(gòu)公鑰

3117BM應(yīng)符合JT/T1179—2018第9章的要求

證書

4支付賬戶號(hào)16ansM由支付賬戶系統(tǒng)自定義，長度不足前補(bǔ)“0”

5用戶賬戶號(hào)10BM由城市發(fā)碼機(jī)構(gòu)賬戶管理平臺(tái)定義，長度不足前補(bǔ)“0”

6城市發(fā)碼機(jī)構(gòu)代碼4BM由清算機(jī)構(gòu)統(tǒng)一分配

7發(fā)碼平臺(tái)編碼4BM由清算機(jī)構(gòu)統(tǒng)一分配

用戶賬戶的類型(默認(rèn)為0x01)

0x01:普通卡

0x02：學(xué)生卡

8用戶賬戶類型1BM0x03：老人卡

0x04：測(cè)試卡

0x05：軍人卡

其他：城市發(fā)碼機(jī)構(gòu)自定義

二維碼支付單次消費(fèi)金額上限，由支付賬戶系統(tǒng)根據(jù)當(dāng)前用

9單次消費(fèi)金額上限3BM戶消費(fèi)狀態(tài)進(jìn)行授權(quán)。此域在單次消費(fèi)交易時(shí)可作為能否乘

車的判斷依據(jù)

經(jīng)過壓縮的支付賬戶系統(tǒng)中用戶公鑰數(shù)據(jù)，壓縮方法應(yīng)符合

10用戶公鑰33BM

GB/T32918的要求

支付賬戶系統(tǒng)授權(quán)過期時(shí)間，使用UTC（0時(shí)區(qū)）時(shí)間1970

11系統(tǒng)授權(quán)過期時(shí)間4BM

年1月1日00：00：00到當(dāng)前的秒數(shù)，高字節(jié)在前

12二維碼有效時(shí)間2BM以秒為單位，此域在填寫時(shí)無須帶單位，高字節(jié)在前

城市發(fā)碼機(jī)構(gòu)自定

131BM城市發(fā)碼機(jī)構(gòu)自定義域數(shù)據(jù)長度為32

義域長度

城市發(fā)碼機(jī)構(gòu)自定

1432BM城市發(fā)碼機(jī)構(gòu)自定義，由城市發(fā)碼機(jī)構(gòu)自定義域，格式見6.3

義域

城市發(fā)碼機(jī)構(gòu)授權(quán)城市發(fā)碼機(jī)構(gòu)私鑰簽名，簽名數(shù)據(jù)包括本表中序號(hào)為3—14

1565BM

簽名字段，應(yīng)符合JT/T1179—2018的要求

二維碼生成的時(shí)間戳，使用UTC（0時(shí)區(qū)）時(shí)間1970年1

16二維碼生成時(shí)間4BM

月1日00：00：00到當(dāng)前的秒數(shù)，高字節(jié)在前

支付賬戶用戶私鑰支付賬戶用戶私鑰簽名數(shù)據(jù)，簽名數(shù)據(jù)包括本表序號(hào)為1—

1765BM

簽名16字段，應(yīng)符合JT/T1179—2018的要求

4

DB44/T2310—2021

發(fā)碼機(jī)構(gòu)自定義域定義和說明

發(fā)碼機(jī)構(gòu)自定義數(shù)據(jù)結(jié)構(gòu)見表3。

表3發(fā)碼機(jī)構(gòu)自定義數(shù)據(jù)結(jié)構(gòu)

序號(hào)名稱長度格式標(biāo)簽說明

1發(fā)碼機(jī)構(gòu)保留區(qū)域11B由發(fā)碼機(jī)構(gòu)定義

01：公交

02：城市軌道

03：輪渡

2交通行業(yè)類型標(biāo)識(shí)1B

04：出租車

05：城際軌道

06：道路客運(yùn)

3交通行業(yè)自定義數(shù)據(jù)20B見6.4

交通行業(yè)自定義說明

發(fā)碼機(jī)構(gòu)自定義數(shù)據(jù)結(jié)構(gòu)見表4。

表4發(fā)碼機(jī)構(gòu)自定義數(shù)據(jù)結(jié)構(gòu)

交通行業(yè)

序號(hào)標(biāo)簽說明

類型標(biāo)識(shí)

第1字節(jié)為乘車碼驗(yàn)證方式，0x1脫機(jī)驗(yàn)證；0x2聯(lián)網(wǎng)驗(yàn)證；0x3連防重系統(tǒng)驗(yàn)證

第2—3字節(jié)為流水號(hào)，每次交易里程使用一個(gè)流水號(hào)

第4字節(jié)為車票狀態(tài)，0x1初始狀態(tài)；0x2已進(jìn)站；0x3已出站；0x4進(jìn)站更新狀態(tài)；

0x5出站更新狀態(tài)

102第5—6字節(jié)為車站編碼，上一次處理車票的車站編碼，由線路和站點(diǎn)組成

第7—10字節(jié)為車票處理時(shí)間，上一次處理車票的時(shí)間

第11—14字節(jié)為行業(yè)數(shù)據(jù)過期時(shí)間

第15—18字節(jié)為地鐵后臺(tái)賬戶ID

第19—20字節(jié)為在線自助更新站點(diǎn)

2其他保留

7信息接口

說明

7.1.1通訊方式

通訊方式應(yīng)使用HTTPS協(xié)議，POST請(qǐng)求數(shù)據(jù)方法。

7.1.2數(shù)據(jù)交換格式

5

DB44/T2310—2021

數(shù)據(jù)交換格式為JSON（JavaScriptObjectNotation）。

7.1.3接口數(shù)據(jù)簽名

應(yīng)對(duì)數(shù)據(jù)進(jìn)行數(shù)字簽名，在接收簽名數(shù)據(jù)之后進(jìn)行簽名校驗(yàn)。

數(shù)字簽名有兩個(gè)步驟，先按7.1.4規(guī)則拼接簽名原始串，再選擇7.1.5的算法和密鑰計(jì)算出簽名結(jié)果。

7.1.4簽名原始串

簽名原始串應(yīng)按以下方式組裝成字符串：

——除簽名字段外，所有參數(shù)按照第一個(gè)字符的鍵值A(chǔ)SCII碼遞增排序，遇到相同字符則按照第

二個(gè)字符的鍵值A(chǔ)SCII碼遞增排序，以此類推；

——排序后的參數(shù)與其對(duì)應(yīng)值組合成“參數(shù)名=參數(shù)值”的格式，并用“&”字符連接起來。簽名原始

串中，參數(shù)名和參數(shù)值都采用原始值。

7.1.5簽名算法

對(duì)簽名原始串的尾部加上字符串“&key=”，再加上簽名密鑰值，形成待簽名字符串，使用MD5算法，

對(duì)待簽名字符串計(jì)算MD5值，再轉(zhuǎn)成大寫字符串。

示例：

JSON數(shù)據(jù)中有3個(gè)參數(shù)，其表達(dá)為：{”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é)議

7.2.1公共參數(shù)

接口協(xié)議中的請(qǐng)求報(bào)文必須包含請(qǐng)求公共參數(shù)的所有字段見表5，接口協(xié)議中應(yīng)答報(bào)文必須包含應(yīng)

答公共參數(shù)見表6。

6

DB44/T2310—2021

表5請(qǐng)求公共參數(shù)

序號(hào)字段名參數(shù)名長度類型說明

1接口版本version<=20字符串例如“1.0”

見各接口說明

2接口名稱service<=50字符串

例如“TermRegist”

通道接入唯一標(biāo)識(shí)

3通道編號(hào)channelCode8字符串

例如“00000001”

發(fā)起請(qǐng)求的時(shí)間：YYYY—MM—DD

4請(qǐng)求時(shí)間timeStamp19字符串hh: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

表6應(yīng)答公共參數(shù)

序號(hào)字段名參數(shù)名長度類型說明

應(yīng)答時(shí)間：YYYY—MM—DD

1應(yīng)答時(shí)間timeStamp19字符串hh:mm:ss,格式見附錄A中的表A.1。

例如“2020-11-1009:38:01”

2簽名sign32字符串簽名算法見7.1.5

7.2.2收單機(jī)構(gòu)注冊(cè)接口

接口名稱：TerminalRegist。

收單機(jī)構(gòu)應(yīng)向省級(jí)清算管理機(jī)構(gòu)請(qǐng)求注冊(cè)。每個(gè)受理終端上線前收單機(jī)構(gòu)應(yīng)先將終端編號(hào)（PSAM

卡號(hào)）發(fā)到省級(jí)清算管理機(jī)構(gòu)登記，上傳的交易數(shù)據(jù)才能被平臺(tái)受理。注冊(cè)接口請(qǐng)求參數(shù)見表7，返回

參數(shù)見表8。

表7請(qǐng)求參數(shù)

序號(hào)字段名參數(shù)名長度類型說明

6位收單機(jī)構(gòu)標(biāo)識(shí)

1收單機(jī)構(gòu)標(biāo)識(shí)iManagerId6字符串

例如“010001”

2終端編號(hào)itermNo8字符串例如“99990001”

7

DB44/T2310—2021

表8返回參數(shù)

序號(hào)字段名參數(shù)名長度類型說明

0：成功

1返回碼resultCode<=8字符串

其他：錯(cuò)誤

2錯(cuò)誤消息errMsg<=128字符串例如“系統(tǒng)錯(cuò)誤！”

7.2.3賬單上送

接口名稱：BillUpload。

收單機(jī)構(gòu)應(yīng)向城市發(fā)碼機(jī)構(gòu)和省級(jí)清算管理機(jī)構(gòu)進(jìn)行賬單上送。收單機(jī)構(gòu)將本地交易記錄（賬單）

上傳給本地發(fā)碼機(jī)構(gòu)，發(fā)碼機(jī)構(gòu)根據(jù)上傳的賬單對(duì)用戶進(jìn)行扣費(fèi)。收單機(jī)構(gòu)將所有交易記錄（賬單）上

傳給省級(jí)清算管理機(jī)構(gòu)，省級(jí)清算管理機(jī)構(gòu)應(yīng)將跨區(qū)交易記錄（賬單）上傳給本地發(fā)碼機(jī)構(gòu)相應(yīng)地市發(fā)

碼機(jī)構(gòu)，相應(yīng)地市發(fā)碼機(jī)構(gòu)根據(jù)上傳的賬單對(duì)用戶進(jìn)行扣費(fèi)。賬單上送請(qǐng)求參數(shù)見表9，單條交易記錄

格式見表10，返回參數(shù)見表11。

終端上傳二維碼交易數(shù)據(jù)到服務(wù)端，采取準(zhǔn)實(shí)時(shí)上傳方式，即終端存在未上傳交易時(shí)，應(yīng)立即上傳

交易數(shù)據(jù)。終端應(yīng)根據(jù)錯(cuò)誤的計(jì)數(shù)延遲上傳，每出現(xiàn)一次錯(cuò)誤，延遲時(shí)間增加30秒，最大延遲時(shí)間為300

秒。當(dāng)出現(xiàn)一次響應(yīng)成功時(shí)，復(fù)位延遲時(shí)間復(fù)位。

表9請(qǐng)求參數(shù)

序號(hào)字段名參數(shù)名長度類型說明

1交易記錄jList根據(jù)實(shí)際字符串長度填寫JSON字符串JSON格式：{{…},{…}….}

表10單條交易記錄格式

序號(hào)字段名參數(shù)名長度類型說明

6位收單機(jī)構(gòu)標(biāo)識(shí)

1收單機(jī)構(gòu)標(biāo)識(shí)acquirerId6字符串

例如“010001”

收單機(jī)構(gòu)標(biāo)識(shí)和收單機(jī)構(gòu)交易流水號(hào)流水組成，

收單機(jī)構(gòu)每上送一筆交易，必須賦予數(shù)字交易流

2交易標(biāo)識(shí)tranId32字符串水號(hào)作為唯一標(biāo)識(shí)，交易重復(fù)發(fā)送時(shí)的交易ID

須相同，例如

“01000100000000000000000000000001”

3支付賬戶號(hào)payAcct32字符串二維碼中原數(shù)據(jù)送回，見6.2表2

城市發(fā)碼機(jī)構(gòu)的用戶id二維碼中原數(shù)據(jù)送回，

4用戶賬戶號(hào)userId20字符串

見6.2表2

5城市發(fā)碼機(jī)構(gòu)代碼cardPlt8字符串見6.2表2

6發(fā)碼平臺(tái)代碼qrPlt8字符串填發(fā)碼平臺(tái)代碼（當(dāng)付款方式用），見6.2表2

7交易金額totalFee<=10整數(shù)單位為分，10進(jìn)制

8應(yīng)收金額payFee<=10整數(shù)單位分，10進(jìn)制

8

DB44/T2310—2021

表10單條交易記錄格式（續(xù)）

序號(hào)字段名參數(shù)名長度類型說明

使用UTC（0時(shí)區(qū)）時(shí)間1970年1月1日00：

9本次交易時(shí)間tranTime8十六進(jìn)制字符串

00：00到當(dāng)前的秒數(shù)，高字節(jié)在前

10本次交易終端編號(hào)termNo8字符串交易時(shí)終端編號(hào)—應(yīng)取PSAM卡8位終端編號(hào)

11線路編號(hào)lineNo8字符串填入線路編號(hào)

使用UTC（0時(shí)區(qū)）時(shí)間1970年1月1日00：

12二維碼生成時(shí)間qrTime8十六進(jìn)制字符串

00：00到當(dāng)前的秒數(shù)，高字節(jié)在前

掃碼時(shí)的終端經(jīng)度，4字節(jié)，共32位，高位在前

13經(jīng)度lng8十六進(jìn)制字符串第1位：0表示東經(jīng)，1表示西經(jīng)

第1-31位表示經(jīng)度值，以1E-9度為單位

掃碼時(shí)的終端緯度，4字節(jié)，共32位，高位在前，

14緯度lat8十六進(jìn)制字符串

以1E-9度為單位

15二維碼業(yè)務(wù)數(shù)據(jù)qrBiz64字符串城市發(fā)碼機(jī)構(gòu)自定義數(shù)據(jù)內(nèi)容

第1位:

0：普通卡

1：乘車券

第2位：

16交易類型tranType2字符串

0：公交消費(fèi)

1：地鐵入閘

2：地鐵出閘消費(fèi)

3：地鐵核準(zhǔn)交易

17終端流水號(hào)termSeq10字符串前補(bǔ)“0”

18站點(diǎn)編號(hào)station4字符串站點(diǎn)名稱

對(duì)應(yīng)二維碼中系統(tǒng)授權(quán)過期時(shí)間賬戶系統(tǒng)授權(quán)

19系統(tǒng)授權(quán)過期時(shí)間sysauthTime8十六進(jìn)制字符串過期時(shí)間，使用UTC（0時(shí)區(qū)）時(shí)間1970年1

月1日00：00：00到當(dāng)前的秒數(shù)，高字節(jié)在前

1：正常碼

20碼類型qrType1字符串

2：應(yīng)急碼

21外地市二維碼數(shù)據(jù)allCode728十六進(jìn)制字符串省外發(fā)碼機(jī)構(gòu)的二維碼在省內(nèi)受理的，該項(xiàng)必填

表11返回參數(shù)

序號(hào)字段名參數(shù)名長度類型說明

0：成功

1返回碼resultCode<=4字符串

其他：錯(cuò)誤

2錯(cuò)誤消息errMsg<=500字符串例如“系統(tǒng)錯(cuò)誤！”

9

DB44/T2310—2021

7.2.4城市發(fā)碼機(jī)構(gòu)白名單下載接口

接口名稱：AcceptCitysInfo。

收單機(jī)構(gòu)應(yīng)向省級(jí)清算管理機(jī)構(gòu)請(qǐng)求城市白名單列表。受理終端通過收單機(jī)構(gòu)下載最新的白名單列

表信息。獲取白名單請(qǐng)求參數(shù)見表12，返回參數(shù)見表13。

表12請(qǐng)求參數(shù)

序號(hào)字段名參數(shù)名長度類型說明

1收單機(jī)構(gòu)標(biāo)識(shí)imanagerId6字符串6位收單機(jī)構(gòu)標(biāo)識(shí)

表13返回參數(shù)

序號(hào)字段名參數(shù)名長度類型說明

1城市發(fā)碼機(jī)構(gòu)白名單列表whiteList<1000字符串城市發(fā)碼機(jī)構(gòu)代碼列表，逗號(hào)分隔

0：成功

2返回碼resultCode<=4字符串

其他：錯(cuò)誤

3錯(cuò)誤消息errMsg<=500字符串例如“系統(tǒng)錯(cuò)誤！”

7.2.5時(shí)鐘同步接口

接口名稱：TimeSynchronize。

收單機(jī)構(gòu)和發(fā)碼機(jī)構(gòu)應(yīng)向省級(jí)清算管理機(jī)構(gòu)請(qǐng)求時(shí)鐘同步，受理終端和客戶端軟件應(yīng)分別向收單機(jī)

構(gòu)和發(fā)碼機(jī)構(gòu)申請(qǐng)時(shí)間同步，服務(wù)器返回系統(tǒng)標(biāo)準(zhǔn)時(shí)間。時(shí)鐘同步請(qǐng)求參數(shù)見表14，返回參數(shù)見表15。

表14請(qǐng)求參數(shù)

序號(hào)字段名參數(shù)名長度類型說明

1收單機(jī)構(gòu)標(biāo)識(shí)imanagerId6字符串6位收單機(jī)構(gòu)標(biāo)識(shí)