城市公共交通二维码应用技术规范(DB44-T 2310-2021).pdf

《城市公共交通二维码应用技术规范(DB44-T 2310-2021).pdf》由会员分享，可在线阅读，更多相关《城市公共交通二维码应用技术规范(DB44-T 2310-2021).pdf（15页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、ICS03.220.20CCS R 0744广东省地方标准DB44/T 23102021城市公共交通二维码应用技术规范Technical Specification for Two-Dimensional Code in Guangdongs MunicipalPublic Transportation2021-06-13 发布2021-09-13 实施广东省市场监督管理局发 布DB44/T 23102021I目次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.15系统架构.26二维码数据格式.3编码格式.3数据结构.3发码机构自定义域定义和说明.5交通行业自定义说明.57信

2、息接口.5说明.5交互协议.68受理终端要求.119客户端软件要求.1110安全规范.11附录 A（规范性）符号定义表.12DB44/T 23102021II前言本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。本文件由广东省交通运输厅提出，并组织实施。本文件由广东省交通运输（公路水路）标准化技术委员会（GD/TC133）归口。本文件起草单位：广东岭南通股份有限公司、广州羊城通有限公司、广东省道路运输事务中心、广州市公共交通数据管理中心、深圳市腾讯计算机系统有限公司。本文件主要起草人：谢振东、方秋水、易智君、何建兵、刘兵、袁勇、徐锋、吴金成、温晓丽

3、、于航、曾江、程世勇、郭贵城、陈历军。DB44/T 231020211广东省城市公共交通二维码应用技术规范1范围本文件规定了广东省城市公共交通领域二维码应用的数据格式、安全性、服务器数据交换协议、受理终端以及客户端软件的要求。本文件适用于广东省城市公共交通二维码的服务系统、终端、客户端软件等的设计、研发与应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 2312信息交换用汉字编码字符集基本集GB/T 182842000快速响应矩阵

4、码GB/T 32918（所有部分）信息安全技术SM2椭圆曲线公钥密码算法JT/T 978.3城市公共交通IC卡技术规范第3部分：读写终端JT/T 11792018交通一卡通二维码支付技术规范3术语和定义JT/T 11792018界定的以及下列术语和定义适用于本文件。城市公共交通municipalpublictransportation运用公共汽电车、城市轨道交通、城市客运轮渡等运载工具和有关设施，按照核定的线路、站点、时间、票价运营，为公众提供基本出行服务的城市客运方式。4缩略语下列缩略语适用于本文件。3DES：三重数据加密算法（TripleDES）CA：电子商务认证授权机构(Certific

5、ateAuthority)FTP：文件传输协议(FileTransferProtocol)HTTPS：超文本安全传输协议(HyperTextTransferProtocoloverSecureSocketLayer)MAC：消息认证码（MessageAuthenticationCode）MAK：MAC密钥(MACKey)MD5：信息摘要算法（messagedigestalgorithm5）MMK：成员主密钥(MemberMasterKey)QRCODE：快速响应矩阵码（QuickResponseCode)DB44/T 231020212RSA：一种非对称加解密技术（RivestShamirAd

6、leman）SM2：SM2椭圆曲线公钥密码算法(PublicKeyCryptographicAlgorithmSM2BasedonEllipticCurves)SM3：SM3密码杂凑算法(SM3CryptographicHashAlgorithm)SM4：SM4分组密码加密算法(SM4CryptographicAlgorithm)SSL/TLS：安全套接层/传输层安全(SecureSocketsLayer/TransportLayerSecurity)TLV：标签、长度、值(TagLengthValue)TAC：交易认证码（(TransactionAuthenticationCode）UID：

7、用户账户标识（UserAccountIdentifier）UIID：用户账户发行方标识（UserAccountIssuerIdentity）UTC：协调世界时(CoordinatedUniversalTime)5系统架构广东省城市公共交通二维码应用系统由省级清算管理机构、发码机构、收单机构、受理终端、客户端软件组成。系统架构见图1。图 1系统架构示意图省级清算管理机构：省级二维码清结算业务运营主体，负责全省二维码交易数据的归集，以及负责省内跨城市、跨机构之间的二维码交易清分与结算，负责发码机构证书的统一申领和发放，负责各发码DB44/T 231020213机构互联互通的配置管理，发码机构、收单

8、机构、受理终端、客户端软件的时间均同步省级清算管理机构服务器的时间。发码机构：城市公共交通二维码运营主体或其它二维码运营主体，负责用户管理、资金渠道管理、二维码密钥服务、城市二维码数据清结算及交易风险控制。发码机构申请二维码流程、受理终端验证二维码流程、跨区域交易清分结算流程应符合JT/T 11792018的要求。收单机构：城市公共交通二维码交易终端运营主体或其它二维码交易终端运营主体，负责受理终端安装、系统维护、交易数据采集和上传。受理终端：用于二维码交易的终端设备。扫码方式采用受理终端主扫模式。客户端软件：用于生成二维码的应用程序，包括用户注册、用户登录、密钥申请以及二维码生成等功能。6二

9、维码数据格式编码格式二维码的编码格式应符合JT/T 11792018的要求。数据结构二维码数据主要由17个字段组成，包括：二维码版本、二维码数据长度、城市发码机构公钥证书、支付账户号、用户账户号、城市发码机构代码、发码平台代码、用户账户类型、单次消费金额上限、支付账户用户公钥、支付账户系统授权过期时间、二维码有效时间、城市发码机构自定义域长度、城市发码机构自定域、城市发码机构授权签名、二维码生成时间和支付账户用户私钥签名。二维码数据结构见表1，二维码数据结构说明见表2，二维码数据结构说明中出现的格式符号要求见附录A。表 1二维码数据结构二维码结构二维码版本二维码数据长度城市发码机构公钥证书支付

10、账户号用户账户号城市发码机构代码发码平台代码用户账户类型单次消费金额上限支付账户用户公钥支付账户系统授权过期时间二维码有效时间城市发码机构自定义域长度城市发码机构自定域城市发码机构授权签名二维码生成时间支付账户用户私钥签名1211716104413334213265465DB44/T 231020214表 2二维码数据结构说明序号字段名称长度格式必填字段说明1二维码版本1BM范围为 0 x800 xFF2二维码数据长度2BM固定长度为 0 x016C3城市发码机构公钥证书117BM应符合 JT/T11792018 第 9 章的要求4支付账户号16ansM由支付账户系统自定义，长度不足前补“0”

11、5用户账户号10BM由城市发码机构账户管理平台定义，长度不足前补“0”6城市发码机构代码4BM由清算机构统一分配7发码平台编码4BM由清算机构统一分配8用户账户类型1BM用户账户的类型(默认为 0 x01)0 x01:普通卡0 x02：学生卡0 x03：老人卡0 x04：测试卡0 x05：军人卡其他：城市发码机构自定义9单次消费金额上限3BM二维码支付单次消费金额上限，由支付账户系统根据当前用户消费状态进行授权。此域在单次消费交易时可作为能否乘车的判断依据10用户公钥33BM经过压缩的支付账户系统中用户公钥数据，压缩方法应符合GB/T32918 的要求11系统授权过期时间4BM支付账户系统授权

12、过期时间，使用 UTC（0时区）时间 1970年 1月 1 日 00：00：00 到当前的秒数，高字节在前12二维码有效时间2BM以秒为单位，此域在填写时无须带单位，高字节在前13城市发码机构自定义域长度1BM城市发码机构自定义域数据长度为 3214城市发码机构自定义域32BM城市发码机构自定义，由城市发码机构自定义域，格式见 6.315城市发码机构授权签名65BM城市发码机构私钥签名，签名数据包括本表中序号为 314字段，应符合 JT/T11792018 的要求16二维码生成时间4BM二维码生成的时间戳，使用 UTC（0时区）时间 1970 年 1月 1 日 00：00：00到当前的秒数，高

13、字节在前17支付账户用户私钥签名65BM支付账户用户私钥签名数据，签名数据包括本表序号为 116 字段，应符合 JT/T11792018 的要求DB44/T 231020215发码机构自定义域定义和说明发码机构自定义数据结构见表3。表 3发码机构自定义数据结构序号名称长度格式标签说明1发码机构保留区域11B由发码机构定义2交通行业类型标识1B01：公交02：城市轨道03：轮渡04：出租车05：城际轨道06：道路客运3交通行业自定义数据20B见 6.4交通行业自定义说明发码机构自定义数据结构见表4。表 4发码机构自定义数据结构序号交通行业类型标识标签说明102第 1 字节为乘车码验证方式，0 x

14、1脱机验证；0 x2联网验证；0 x3连防重系统验证第 23 字节为流水号，每次交易里程使用一个流水号第 4 字节为车票状态，0 x1 初始状态；0 x2 已进站；0 x3已出站；0 x4 进站更新状态；0 x5 出站更新状态第 56 字节为车站编码，上一次处理车票的车站编码，由线路和站点组成第 710 字节为车票处理时间，上一次处理车票的时间第 1114 字节为行业数据过期时间第 1518 字节为地铁后台账户 ID第 1920 字节为在线自助更新站点2其他保留7信息接口说明7.1.1通讯方式通讯方式应使用HTTPS协议，POST请求数据方法。7.1.2数据交换格式DB44/T 2310202

15、16数据交换格式为JSON（JavaScriptObjectNotation）。7.1.3接口数据签名应对数据进行数字签名，在接收签名数据之后进行签名校验。数字签名有两个步骤，先按7.1.4规则拼接签名原始串，再选择7.1.5的算法和密钥计算出签名结果。7.1.4签名原始串签名原始串应按以下方式组装成字符串：除签名字段外，所有参数按照第一个字符的键值 ASCII 码递增排序，遇到相同字符则按照第二个字符的键值 ASCII 码递增排序，以此类推；排序后的参数与其对应值组合成“参数名=参数值”的格式，并用“&”字符连接起来。签名原始串中，参数名和参数值都采用原始值。7.1.5签名算法对签名原始串的

16、尾部加上字符串“&key=”，再加上签名密钥值，形成待签名字符串，使用MD5算法，对待签名字符串计算MD5值，再转成大写字符串。示例：JSON数据中有3个参数，其表达为：”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签名字符串

17、的MD5值转换为大写为：88046C2FA808DC6C71A6EE3EB7C9B812交互协议7.2.1公共参数接口协议中的请求报文必须包含请求公共参数的所有字段见表5，接口协议中应答报文必须包含应答公共参数见表6。DB44/T 231020217表 5请求公共参数序号字段名参数名长度类型说明1接口版本version=20字符串例如“1.0”2接口名称service=50字符串见各接口说明例如“TermRegist”3通道编号channelCode8字符串通道接入唯一标识例如“00000001”4请求时间timeStamp19字符串发起请求的时间：YYYYMMDDhh:mm:ss,格式见附录

18、A 中的表 A.1。例如“2020-11-1009:38:01”5参数编码charSet=10字符串例如“UTF-8”6签名方式signType=10字符串例如“MD5”7签名sign32字符串签名算法见 7.1.5表 6应答公共参数序号字段名参数名长度类型说明1应答时间timeStamp19字符串应 答 时 间：YYYY MM DDhh:mm:ss,格式见附录 A 中的表 A.1。例如“2020-11-1009:38:01”2签名sign32字符串签名算法见 7.1.57.2.2收单机构注册接口接口名称：TerminalRegist。收单机构应向省级清算管理机构请求注册。每个受理终端上线前收

19、单机构应先将终端编号（PSAM卡号）发到省级清算管理机构登记，上传的交易数据才能被平台受理。注册接口请求参数见表7，返回参数见表8。表 7请求参数序号字段名参数名长度类型说明1收单机构标识iManagerId6字符串6 位收单机构标识例如“010001”2终端编号itermNo8字符串例如“99990001”DB44/T 231020218表 8返回参数序号字段名参数名长度类型说明1返回码resultCode=8字符串0：成功其他：错误2错误消息errMsg=128字符串例如“系统错误！”7.2.3账单上送接口名称：BillUpload。收单机构应向城市发码机构和省级清算管理机构进行账单上送。

20、收单机构将本地交易记录（账单）上传给本地发码机构，发码机构根据上传的账单对用户进行扣费。收单机构将所有交易记录（账单）上传给省级清算管理机构，省级清算管理机构应将跨区交易记录（账单）上传给本地发码机构相应地市发码机构，相应地市发码机构根据上传的账单对用户进行扣费。账单上送请求参数见表9，单条交易记录格式见表10，返回参数见表11。终端上传二维码交易数据到服务端，采取准实时上传方式，即终端存在未上传交易时，应立即上传交易数据。终端应根据错误的计数延迟上传，每出现一次错误，延迟时间增加30秒，最大延迟时间为300秒。当出现一次响应成功时，复位延迟时间复位。表 9请求参数序号字段名参数名长度类型说明

21、1交易记录jList根据实际字符串长度填写JSON 字符串JSON 格式：,.表 10单条交易记录格式序号字段名参数名长度类型说明1收单机构标识acquirerId6字符串6 位收单机构标识例如“010001”2交易标识tranId32字符串收单机构标识和收单机构交易流水号流水组成，收单机构每上送一笔交易，必须赋予数字交易流水号作为唯一标识，交易重复发送时的交易 ID须相同，例如“01000100000000000000000000000001”3支付账户号payAcct32字符串二维码中原数据送回，见 6.2 表 24用户账户号userId20字符串城市发码机构的用户 id 二维码中原数据送

22、回，见 6.2 表 25城市发码机构代码cardPlt8字符串见 6.2 表 26发码平台代码qrPlt8字符串填发码平台代码（当付款方式用），见 6.2 表 27交易金额totalFee=10整数单位为分，10 进制8应收金额payFee=10整数单位分，10 进制DB44/T 231020219表10单条交易记录格式（续）序号字段名参数名长度类型说明9本次交易时间tranTime8十六进制字符串使用 UTC（0时区）时间 1970 年 1 月 1 日 00：00：00 到当前的秒数，高字节在前10本次交易终端编号termNo8字符串交易时终端编号应取 PSAM 卡 8 位终端编号11线路编

23、号lineNo8字符串填入线路编号12二维码生成时间qrTime8十六进制字符串使用 UTC（0时区）时间 1970 年 1 月 1 日 00：00：00 到当前的秒数，高字节在前13经度lng8十六进制字符串扫码时的终端经度，4 字节，共 32 位，高位在前第 1 位：0 表示东经，1 表示西经第 1-31 位表示经度值，以 1E-9 度为单位14纬度lat8十六进制字符串扫码时的终端纬度，4 字节，共 32 位，高位在前，以 1E-9 度为单位15二维码业务数据qrBiz64字符串城市发码机构自定义数据内容16交易类型tranType2字符串第 1 位:0：普通卡1：乘车券第 2 位：0：

24、公交消费1：地铁入闸2：地铁出闸消费3：地铁核准交易17终端流水号termSeq10字符串前补“0”18站点编号station4字符串站点名称19系统授权过期时间sysauthTime8十六进制字符串对应二维码中系统授权过期时间账户系统授权过期时间，使用 UTC（0时区）时间 1970 年 1月 1 日 00：00：00 到当前的秒数，高字节在前20码类型qrType1字符串1：正常码2：应急码21外地市二维码数据allCode728十六进制字符串省外发码机构的二维码在省内受理的，该项必填表 11返回参数序号字段名参数名长度类型说明1返回码resultCode=4字符串0：成功其他：错误2错误

25、消息errMsg=500字符串例如“系统错误！”DB44/T 23102021107.2.4城市发码机构白名单下载接口接口名称：AcceptCitysInfo。收单机构应向省级清算管理机构请求城市白名单列表。受理终端通过收单机构下载最新的白名单列表信息。获取白名单请求参数见表12，返回参数见表13。表 12请求参数序号字段名参数名长度类型说明1收单机构标识imanagerId6字符串6 位收单机构标识表 13返回参数序号字段名参数名长度类型说明1城市发码机构白名单列表whiteList1000字符串城市发码机构代码列表，逗号分隔2返回码resultCode=4字符串0：成功其他：错误3错误消息

26、errMsg=500字符串例如“系统错误！”7.2.5时钟同步接口接口名称：TimeSynchronize。收单机构和发码机构应向省级清算管理机构请求时钟同步，受理终端和客户端软件应分别向收单机构和发码机构申请时间同步，服务器返回系统标准时间。时钟同步请求参数见表14，返回参数见表15。表 14请求参数序号字段名参数名长度类型说明1收单机构标识imanagerId6字符串6 位收单机构标识2终端编号itermNo8字符串8 位 Psam 卡号表 15返回参数序号字段名参数名长度类型说明1服务器时间oserverTime8十六进制字符串使用 UTC（0时区）时间 1970 年 1月 1 日 00

27、：00：00到当前的秒数，高字节在前2返回码resultCode=4字符串0：成功其他：错误3错误消息errMsg=500字符串例如“系统错误！”DB44/T 23102021118受理终端要求受理终端应符合JT/T 978.3和JT/T 11792018第10章的要求。9客户端软件要求客户端软件要求应符合JT/T 11792018第11章的要求。10安全规范安全规范应符合JT/T 11792018第9章的要求。DB44/T 2310202112AA附录A（规范性）符号定义表文件记录格式中出现的符号定义，见表A.1。表 A.1 符号定义表符号定义a字母字符，AZ，az,向左靠，右边多余位填空格

28、b数据的二进制表示，后跟数字表示位（bit）的个数B用于表示变长的二进制数，后跟数字表示二进制数据所占字节（Byte）的个数n数值，09，右靠，首位有效数字前填零。若表示人民币金额，则最右二位为角、分HEX16 进制数字 09、AZan字母和数字字符，左靠，右边多余位填空格as字母和数字字符，左靠，右边多余位填空格cn压缩数字码，即 BCD 码，后跟数字表示 BCD 码的个数ns数字和特殊字符，左靠，右边多余位填空格ans字母、数字和特殊字符，左靠，右边多余位填空格M必填项，若此信息为空，则信息报错MM月份，0112DD日期，0131YYYY年份，00009999hh时，0023mm分，0059ss秒，0059