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

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

1、ICS 03.220.20CCS R 07 44广 东 省 地 方 标 准DB44/T 2310 2021城 市 公 共 交 通 二 维 码 应 用 技 术 规 范 Technical Specification for Two-Dimensional Code in Guangdongs MunicipalPublic Transportation 2021 -06- 13发 布 2021- 09-13实 施广 东 省 市 场 监 督 管 理 局 发 布 DB44/T 2310 2021 I 目 次前 言 .II1 范 围 .12 规 范 性 引 用 文 件 .13 术 语 和 定 义 .1

2、4 缩 略 语 .15 系 统 架 构 .26 二 维 码 数 据 格 式 .3编 码 格 式 .3 数 据 结 构 .3发 码 机 构 自 定 义 域 定 义 和 说 明 .5交 通 行 业 自 定 义 说 明 .57 信 息 接 口 .5说 明 .5交 互 协 议 .68 受 理 终 端 要 求 .119 客 户 端 软 件 要 求 .1110 安 全 规 范 .11附 录 A（ 规 范 性 ） 符 号 定 义 表 .12 DB44/T 2310 2021 II 前 言本 文 件 按 照 GB/T 1.1 2020 标 准 化 工 作 导 则 第 1部 分 ： 标 准 化 文 件 的 结

3、构 和 起 草 规 则 的 规 定起 草 。本 文 件 由 广 东 省 交 通 运 输 厅 提 出 ， 并 组 织 实 施 。本 文 件 由 广 东 省 交 通 运 输 （ 公 路 水 路 ） 标 准 化 技 术 委 员 会 （ GD/TC 133） 归 口 。本 文 件 起 草 单 位 ： 广 东 岭 南 通 股 份 有 限 公 司 、 广 州 羊 城 通 有 限 公 司 、 广 东 省 道 路 运 输 事 务 中 心 、 广州 市 公 共 交 通 数 据 管 理 中 心 、 深 圳 市 腾 讯 计 算 机 系 统 有 限 公 司 。本 文 件 主 要 起 草 人 ： 谢 振 东 、 方 秋

4、 水 、 易 智 君 、 何 建 兵 、 刘 兵 、 袁 勇 、 徐 锋 、 吴 金 成 、 温 晓 丽 、 于航 、 曾 江 、 程 世 勇 、 郭 贵 城 、 陈 历 军 。 DB44/T 2310 2021 1 广 东 省 城 市 公 共 交 通 二 维 码 应 用 技 术 规 范1 范 围本 文 件 规 定 了 广 东 省 城 市 公 共 交 通 领 域 二 维 码 应 用 的 数 据 格 式 、 安 全 性 、 服 务 器 数 据 交 换 协 议 、 受理 终 端 以 及 客 户 端 软 件 的 要 求 。本 文 件 适 用 于 广 东 省 城 市 公 共 交 通 二 维 码 的 服

5、 务 系 统 、 终 端 、 客 户 端 软 件 等 的 设 计 、 研 发 与 应 用 。2 规 范 性 引 用 文 件下 列 文 件 中 的 内 容 通 过 文 中 的 规 范 性 引 用 而 构 成 本 文 件 必 不 可 少 的 条 款 。 其 中 ， 注 日 期 的 引 用 文 件 ， 仅 该 日 期 对 应 的 版 本 适 用 于 本 文 件 ； 不 注 日 期 的 引 用 文 件 ， 其 最 新 版 本 （ 包 括 所 有 的 修 改 单 ） 适 用 于 本文 件 。GB/T 2312 信 息 交 换 用 汉 字 编 码 字 符 集 基 本 集GB/T 18284 2000 快

6、速 响 应 矩 阵 码GB/T 32918（ 所 有 部 分 ） 信 息 安 全 技 术 SM2椭 圆 曲 线 公 钥 密 码 算 法JT/T 978.3 城 市 公 共 交 通 IC卡 技 术 规 范 第 3部 分 ： 读 写 终 端JT/T 1179 2018 交 通 一 卡 通 二 维 码 支 付 技 术 规 范3 术 语 和 定 义JT/T 1179 2018界 定 的 以 及 下 列 术 语 和 定 义 适 用 于 本 文 件 。城 市 公 共 交 通 municipal public transportation 运 用 公 共 汽 电 车 、 城 市 轨 道 交 通 、 城 市

7、客 运 轮 渡 等 运 载 工 具 和 有 关 设 施 ， 按 照 核 定 的 线 路 、 站 点 、时 间 、 票 价 运 营 ， 为 公 众 提 供 基 本 出 行 服 务 的 城 市 客 运 方 式 。4 缩 略 语下 列 缩 略 语 适 用 于 本 文 件 。3DES： 三 重 数 据 加 密 算 法 （ Triple DES）CA： 电 子 商 务 认 证 授 权 机 构 (Certificate Authority)FTP： 文 件 传 输 协 议 (File Transfer Protocol)HTTPS： 超 文 本 安 全 传 输 协 议 (Hyper Text Transf

8、er Protocol over Secure SocketLayer)MAC： 消 息 认 证 码 （ Message Authentication Code）MAK： MAC密 钥 (MAC Key) MD5： 信 息 摘 要 算 法 （ message digest algorithm 5）MMK： 成 员 主 密 钥 (Member Master Key)QR CODE： 快 速 响 应 矩 阵 码 （ Quick Response Code) DB44/T 2310 2021 2 RSA： 一 种 非 对 称 加 解 密 技 术 （ Rivest Shamir Adleman）SM2

9、： SM2椭 圆 曲 线 公 钥 密 码 算 法 (Public Key Cryptographic Algorithm SM2 Based onElliptic Curves)SM3： SM3密 码 杂 凑 算 法 (SM3 Cryptographic Hash Algorithm)SM4： SM4分 组 密 码 加 密 算 法 (SM4 Cryptographic Algorithm)SSL/TLS： 安 全 套 接 层 /传 输 层 安 全 (Secure Sockets Layer/Transport Layer Security)TLV： 标 签 、 长 度 、 值 (Tag Len

10、gth Value)TAC： 交 易 认 证 码 （ (Transaction Authentication Code）UID： 用 户 账 户 标 识 （ User Account Identifier）UIID： 用 户 账 户 发 行 方 标 识 （ User Account Issuer Identity）UTC： 协 调 世 界 时 (Coordinated Universal Time)5 系 统 架 构 广 东 省 城 市 公 共 交 通 二 维 码 应 用 系 统 由 省 级 清 算 管 理 机 构 、 发 码 机 构 、 收 单 机 构 、 受 理 终 端 、 客 户端 软

11、件 组 成 。 系 统 架 构 见 图 1。 图 1 系 统 架 构 示 意 图省 级 清 算 管 理 机 构 ： 省 级 二 维 码 清 结 算 业 务 运 营 主 体 ， 负 责 全 省 二 维 码 交 易 数 据 的 归 集 ， 以 及 负 责省 内 跨 城 市 、 跨 机 构 之 间 的 二 维 码 交 易 清 分 与 结 算 ， 负 责 发 码 机 构 证 书 的 统 一 申 领 和 发 放 ， 负 责 各 发 码 DB44/T 2310 2021 3 机 构 互 联 互 通 的 配 置 管 理 ， 发 码 机 构 、 收 单 机 构 、 受 理 终 端 、 客 户 端 软 件 的

12、时 间 均 同 步 省 级 清 算 管 理 机构 服 务 器 的 时 间 。发 码 机 构 ： 城 市 公 共 交 通 二 维 码 运 营 主 体 或 其 它 二 维 码 运 营 主 体 ， 负 责 用 户 管 理 、 资 金 渠 道 管 理 、二 维 码 密 钥 服 务 、 城 市 二 维 码 数 据 清 结 算 及 交 易 风 险 控 制 。 发 码 机 构 申 请 二 维 码 流 程 、 受 理 终 端 验 证 二维 码 流 程 、 跨 区 域 交 易 清 分 结 算 流 程 应 符 合 JT/T 1179 2018的 要 求 。收 单 机 构 ： 城 市 公 共 交 通 二 维 码 交

13、 易 终 端 运 营 主 体 或 其 它 二 维 码 交 易 终 端 运 营 主 体 ， 负 责 受 理 终 端安 装 、 系 统 维 护 、 交 易 数 据 采 集 和 上 传 。受 理 终 端 ： 用 于 二 维 码 交 易 的 终 端 设 备 。 扫 码 方 式 采 用 受 理 终 端 主 扫 模 式 。客 户 端 软 件 ： 用 于 生 成 二 维 码 的 应 用 程 序 ， 包 括 用 户 注 册 、 用 户 登 录 、 密 钥 申 请 以 及 二 维 码 生 成 等功 能 。6 二 维 码 数 据 格 式 编 码 格 式二 维 码 的 编 码 格 式 应 符 合 JT/T 1179

14、 2018的 要 求 。数 据 结 构二 维 码 数 据 主 要 由 17个 字 段 组 成 ， 包 括 ： 二 维 码 版 本 、 二 维 码 数 据 长 度 、 城 市 发 码 机 构 公 钥 证 书 、支 付 账 户 号 、 用 户 账 户 号 、 城 市 发 码 机 构 代 码 、 发 码 平 台 代 码 、 用 户 账 户 类 型 、 单 次 消 费 金 额 上 限 、 支付 账 户 用 户 公 钥 、 支 付 账 户 系 统 授 权 过 期 时 间 、 二 维 码 有 效 时 间 、 城 市 发 码 机 构 自 定 义 域 长 度 、 城 市 发码 机 构 自 定 域 、 城 市

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

16、码机构授权签名 二维码生成时间 支付账户用户私钥签名1 2 117 16 10 4 4 1 3 33 4 2 1 32 65 4 65 DB44/T 2310 2021 4 表 2 二 维 码 数 据 结 构 说 明序 号 字 段 名 称 长 度 格 式 必 填 字 段 说 明1 二 维 码 版 本 1 B M 范 围 为 0 x80 0 xFF2 二 维 码 数 据 长 度 2 B M 固 定 长 度 为 0 x016C3 城 市 发 码 机 构 公 钥证 书 117 B M 应 符 合 JT/T 1179 2018第 9章 的 要 求4 支 付 账 户 号 16 ans M 由 支 付 账

17、 户 系 统 自 定 义 ， 长 度 不 足 前 补 “ 0” 5 用 户 账 户 号 10 B M 由 城 市 发 码 机 构 账 户 管 理 平 台 定 义 ， 长 度 不 足 前 补 “ 0”6 城 市 发 码 机 构 代 码 4 B M 由 清 算 机 构 统 一 分 配7 发 码 平 台 编 码 4 B M 由 清 算 机 构 统 一 分 配8 用 户 账 户 类 型 1 B M 用 户 账 户 的 类 型 (默 认 为 0 x01)0 x01:普 通 卡0 x02： 学 生 卡0 x03： 老 人 卡0 x04： 测 试 卡0 x05： 军 人 卡其 他 ： 城 市 发 码 机 构

18、 自 定 义 9 单 次 消 费 金 额 上 限 3 B M 二 维 码 支 付 单 次 消 费 金 额 上 限 ， 由 支 付 账 户 系 统 根 据 当 前 用户 消 费 状 态 进 行 授 权 。 此 域 在 单 次 消 费 交 易 时 可 作 为 能 否 乘车 的 判 断 依 据10 用 户 公 钥 33 B M 经 过 压 缩 的 支 付 账 户 系 统 中 用 户 公 钥 数 据 ， 压 缩 方 法 应 符 合GB/T 32918的 要 求11 系 统 授 权 过 期 时 间 4 B M 支 付 账 户 系 统 授 权 过 期 时 间 ， 使 用 UTC（ 0 时 区 ） 时 间

19、1970年 1 月 1 日 00： 00： 00到 当 前 的 秒 数 ， 高 字 节 在 前12 二 维 码 有 效 时 间 2 B M 以 秒 为 单 位 ， 此 域 在 填 写 时 无 须 带 单 位 ， 高 字 节 在 前13 城 市 发 码 机 构 自 定义 域 长 度 1 B M 城 市 发 码 机 构 自 定 义 域 数 据 长 度 为 3214 城 市 发 码 机 构 自 定 义 域 32 B M 城 市 发 码 机 构 自 定 义 ， 由 城 市 发 码 机 构 自 定 义 域 ， 格 式 见 6.315 城 市 发 码 机 构 授 权签 名 65 B M 城 市 发 码 机

20、 构 私 钥 签 名 ， 签 名 数 据 包 括 本 表 中 序 号 为 3 14字 段 ， 应 符 合 JT/T 1179 2018的 要 求16 二 维 码 生 成 时 间 4 B M 二 维 码 生 成 的 时 间 戳 ， 使 用 UTC（ 0 时 区 ） 时 间 1970年 1月 1日 00： 00： 00 到 当 前 的 秒 数 ， 高 字 节 在 前17 支 付 账 户 用 户 私 钥签 名 65 B M 支 付 账 户 用 户 私 钥 签 名 数 据 ， 签 名 数 据 包 括 本 表 序 号 为 116字 段 ， 应 符 合 JT/T 1179 2018的 要 求 DB44/T

21、 2310 2021 5 发 码 机 构 自 定 义 域 定 义 和 说 明发 码 机 构 自 定 义 数 据 结 构 见 表 3。表 3 发 码 机 构 自 定 义 数 据 结 构序 号 名 称 长 度 格 式 标 签 说 明1 发 码 机 构 保 留 区 域 11 B 由 发 码 机 构 定 义2 交 通 行 业 类 型 标 识 1 B 01： 公 交02： 城 市 轨 道03： 轮 渡04： 出 租 车 05： 城 际 轨 道06： 道 路 客 运3 交 通 行 业 自 定 义 数 据 20 B 见 6.4交 通 行 业 自 定 义 说 明发 码 机 构 自 定 义 数 据 结 构 见

22、表 4。表 4 发 码 机 构 自 定 义 数 据 结 构序 号 交 通 行 业类 型 标 识 标 签 说 明 1 02 第 1字 节 为 乘 车 码 验 证 方 式 ， 0 x1 脱 机 验 证 ； 0 x2 联 网 验 证 ； 0 x3 连 防 重 系 统 验 证第 2 3 字 节 为 流 水 号 ， 每 次 交 易 里 程 使 用 一 个 流 水 号第 4字 节 为 车 票 状 态 ， 0 x1初 始 状 态 ； 0 x2 已 进 站 ； 0 x3 已 出 站 ； 0 x4进 站 更 新 状 态 ；0 x5出 站 更 新 状 态第 5 6 字 节 为 车 站 编 码 ， 上 一 次 处

23、理 车 票 的 车 站 编 码 ， 由 线 路 和 站 点 组 成第 7 10字 节 为 车 票 处 理 时 间 ， 上 一 次 处 理 车 票 的 时 间第 11 14字 节 为 行 业 数 据 过 期 时 间第 15 18字 节 为 地 铁 后 台 账 户 ID第 19 20字 节 为 在 线 自 助 更 新 站 点2 其 他 保 留7 信 息 接 口说 明7.1.1 通 讯 方 式 通 讯 方 式 应 使 用 HTTPS协 议 ， POST请 求 数 据 方 法 。7.1.2 数 据 交 换 格 式 DB44/T 2310 2021 6 数 据 交 换 格 式 为 JSON（ JavaS

24、cript Object Notation） 。7.1.3 接 口 数 据 签 名应 对 数 据 进 行 数 字 签 名 ， 在 接 收 签 名 数 据 之 后 进 行 签 名 校 验 。数 字 签 名 有 两 个 步 骤 ， 先 按 7.1.4规 则 拼 接 签 名 原 始 串 ， 再 选 择 7.1.5的 算 法 和 密 钥 计 算 出 签 名 结 果 。7.1.4 签 名 原 始 串签 名 原 始 串 应 按 以 下 方 式 组 装 成 字 符 串 ： 除 签 名 字 段 外 ， 所 有 参 数 按 照 第 一 个 字 符 的 键 值 ASCII 码 递 增 排 序 ， 遇 到 相 同

25、字 符 则 按 照 第二 个 字 符 的 键 值 ASCII 码 递 增 排 序 ， 以 此 类 推 ； 排 序 后 的 参 数 与 其 对 应 值 组 合 成 “参 数 名 =参 数 值 ”的 格 式 ， 并 用 “ &” 字 符 连 接 起 来 。 签 名 原 始串 中 ， 参 数 名 和 参 数 值 都 采 用 原 始 值 。 7.1.5 签 名 算 法对 签 名 原 始 串 的 尾 部 加 上 字 符 串 “ &key=” ， 再 加 上 签 名 密 钥 值 ， 形 成 待 签 名 字 符 串 ， 使 用 MD5算 法 ，对 待 签 名 字 符 串 计 算 MD5值 ， 再 转 成 大

26、 写 字 符 串 。示 例 ：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值 为 ： 88046c2fa808dc6c71a6ee3eb7c9b8

27、12签 名 字 符 串 的 MD5值 转 换 为 大 写 为 ： 88046C2FA808DC6C71A6EE3EB7C9B812交 互 协 议 7.2.1 公 共 参 数接 口 协 议 中 的 请 求 报 文 必 须 包 含 请 求 公 共 参 数 的 所 有 字 段 见 表 5， 接 口 协 议 中 应 答 报 文 必 须 包 含 应答 公 共 参 数 见 表 6。 DB44/T 2310 2021 7 表 5 请 求 公 共 参 数序 号 字 段 名 参 数 名 长 度 类 型 说 明1 接 口 版 本 version =20 字 符 串 例 如 “ 1.0”2 接 口 名 称 serv

28、ice =50 字 符 串 见 各 接 口 说 明例 如 “ TermRegist”3 通 道 编 号 channelCode 8 字 符 串 通 道 接 入 唯 一 标 识例 如 “ 00000001”4 请 求 时 间 timeStamp 19 字 符 串 发 起 请 求 的 时 间 ： YYYY MM DDhh:mm:ss,格 式 见 附 录 A中 的 表 A.1。例 如 “ 2020-11-10 09:38:01” 5 参 数 编 码 charSet =10 字 符 串 例 如 “ UTF-8”6 签 名 方 式 signType =10 字 符 串 例 如 “ MD5”7 签 名 s

29、ign 32 字 符 串 签 名 算 法 见 7.1.5表 6 应 答 公 共 参 数序 号 字 段 名 参 数 名 长 度 类 型 说 明1 应 答 时 间 timeStamp 19 字 符 串 应 答 时 间 ： YYYY MM DDhh:mm:ss,格 式 见 附 录 A中 的 表 A.1。例 如 “ 2020-11-10 09:38:01” 2 签 名 sign 32 字 符 串 签 名 算 法 见 7.1.57.2.2 收 单 机 构 注 册 接 口接 口 名 称 ： TerminalRegist。收 单 机 构 应 向 省 级 清 算 管 理 机 构 请 求 注 册 。 每 个 受

30、 理 终 端 上 线 前 收 单 机 构 应 先 将 终 端 编 号 （ PSAM卡 号 ） 发 到 省 级 清 算 管 理 机 构 登 记 ， 上 传 的 交 易 数 据 才 能 被 平 台 受 理 。 注 册 接 口 请 求 参 数 见 表 7， 返 回参 数 见 表 8。 表 7 请 求 参 数序 号 字 段 名 参 数 名 长 度 类 型 说 明 1 收 单 机 构 标 识 iManagerId 6 字 符 串 6位 收 单 机 构 标 识例 如 “ 010001”2 终 端 编 号 itermNo 8 字 符 串 例 如 “ 99990001” DB44/T 2310 2021 8

31、表 8 返 回 参 数序 号 字 段 名 参 数 名 长 度 类 型 说 明1 返 回 码 resultCode =8 字 符 串 0： 成 功其 他 ： 错 误2 错 误 消 息 errMsg =128 字 符 串 例 如 “ 系 统 错 误 ！ ”7.2.3 账 单 上 送接 口 名 称 ： BillUpload。收 单 机 构 应 向 城 市 发 码 机 构 和 省 级 清 算 管 理 机 构 进 行 账 单 上 送 。 收 单 机 构 将 本 地 交 易 记 录 （ 账 单 ）上 传 给 本 地 发 码 机 构 ， 发 码 机 构 根 据 上 传 的 账 单 对 用 户 进 行 扣 费

32、 。 收 单 机 构 将 所 有 交 易 记 录 （ 账 单 ） 上传 给 省 级 清 算 管 理 机 构 ， 省 级 清 算 管 理 机 构 应 将 跨 区 交 易 记 录 （ 账 单 ） 上 传 给 本 地 发 码 机 构 相 应 地 市 发 码 机 构 ， 相 应 地 市 发 码 机 构 根 据 上 传 的 账 单 对 用 户 进 行 扣 费 。 账 单 上 送 请 求 参 数 见 表 9， 单 条 交 易 记 录格 式 见 表 10， 返 回 参 数 见 表 11。终 端 上 传 二 维 码 交 易 数 据 到 服 务 端 ， 采 取 准 实 时 上 传 方 式 ， 即 终 端 存 在

33、 未 上 传 交 易 时 ， 应 立 即 上 传交 易 数 据 。 终 端 应 根 据 错 误 的 计 数 延 迟 上 传 ， 每 出 现 一 次 错 误 ， 延 迟 时 间 增 加 30秒 ， 最 大 延 迟 时 间 为 300秒 。 当 出 现 一 次 响 应 成 功 时 ， 复 位 延 迟 时 间 复 位 。表 9 请 求 参 数序 号 字 段 名 参 数 名 长 度 类 型 说 明1 交 易 记 录 jList 根 据 实 际 字 符 串 长 度 填 写 JSON字 符 串 JSON格 式 ： , .表 10 单 条 交 易 记 录 格 式 序 号 字 段 名 参 数 名 长 度 类

34、型 说 明1 收 单 机 构 标 识 acquirerId 6 字 符 串 6位 收 单 机 构 标 识例 如 “ 010001”2 交 易 标 识 tranId 32 字 符 串 收 单 机 构 标 识 和 收 单 机 构 交 易 流 水 号 流 水 组 成 ，收 单 机 构 每 上 送 一 笔 交 易 ， 必 须 赋 予 数 字 交 易 流水 号 作 为 唯 一 标 识 ， 交 易 重 复 发 送 时 的 交 易 ID须 相 同 ， 例 如“ 01000100000000000000000000000001”3 支 付 账 户 号 payAcct 32 字 符 串 二 维 码 中 原 数

35、据 送 回 ， 见 6.2 表 24 用 户 账 户 号 userId 20 字 符 串 城 市 发 码 机 构 的 用 户 id二 维 码 中 原 数 据 送 回 ， 见 6.2 表 25 城 市 发 码 机 构 代 码 cardPlt 8 字 符 串 见 6.2 表 26 发 码 平 台 代 码 qrPlt 8 字 符 串 填 发 码 平 台 代 码 （ 当 付 款 方 式 用 ） ， 见 6.2表 27 交 易 金 额 totalFee =10 整 数 单 位 为 分 ， 10进 制8 应 收 金 额 payFee =10 整 数 单 位 分 ， 10进 制 DB44/T 2310 20

36、21 9 表 10 单 条 交 易 记 录 格 式 （ 续 ）序 号 字 段 名 参 数 名 长 度 类 型 说 明9 本 次 交 易 时 间 tranTime 8 十 六 进 制 字 符 串 使 用 UTC（ 0 时 区 ） 时 间 1970年 1月 1日 00：00： 00到 当 前 的 秒 数 ， 高 字 节 在 前10 本 次 交 易 终 端 编 号 termNo 8 字 符 串 交 易 时 终 端 编 号 应 取 PSAM卡 8位 终 端 编 号11 线 路 编 号 lineNo 8 字 符 串 填 入 线 路 编 号12 二 维 码 生 成 时 间 qrTime 8 十 六 进 制

37、 字 符 串 使 用 UTC（ 0 时 区 ） 时 间 1970年 1月 1日 00：00： 00到 当 前 的 秒 数 ， 高 字 节 在 前 13 经 度 lng 8 十 六 进 制 字 符 串 扫 码 时 的 终 端 经 度 ， 4字 节 ， 共 32位 ， 高 位 在 前第 1位 ： 0 表 示 东 经 ， 1表 示 西 经第 1-31位 表 示 经 度 值 ， 以 1E-9度 为 单 位14 纬 度 lat 8 十 六 进 制 字 符 串 扫 码 时 的 终 端 纬 度 ， 4 字 节 ， 共 32位 ， 高 位 在 前 ，以 1E-9度 为 单 位15 二 维 码 业 务 数 据

38、qrBiz 64 字 符 串 城 市 发 码 机 构 自 定 义 数 据 内 容16 交 易 类 型 tranType 2 字 符 串 第 1位 :0： 普 通 卡1： 乘 车 券第 2位 ：0： 公 交 消 费 1： 地 铁 入 闸2： 地 铁 出 闸 消 费3： 地 铁 核 准 交 易17 终 端 流 水 号 termSeq 10 字 符 串 前 补 “ 0”18 站 点 编 号 station 4 字 符 串 站 点 名 称19 系 统 授 权 过 期 时 间 sysauthTime 8 十 六 进 制 字 符 串 对 应 二 维 码 中 系 统 授 权 过 期 时 间 账 户 系 统

39、授 权过 期 时 间 ， 使 用 UTC（ 0 时 区 ） 时 间 1970年 1月 1日 00： 00： 00到 当 前 的 秒 数 ， 高 字 节 在 前20 码 类 型 qrType 1 字 符 串 1： 正 常 码2： 应 急 码 21 外 地 市 二 维 码 数 据 allCode 728 十 六 进 制 字 符 串 省 外 发 码 机 构 的 二 维 码 在 省 内 受 理 的 ， 该 项 必 填表 11 返 回 参 数序 号 字 段 名 参 数 名 长 度 类 型 说 明1 返 回 码 resultCode =4 字 符 串 0： 成 功其 他 ： 错 误2 错 误 消 息 er

40、rMsg =500 字 符 串 例 如 “ 系 统 错 误 ！ ” DB44/T 2310 2021 10 7.2.4 城 市 发 码 机 构 白 名 单 下 载 接 口接 口 名 称 ： AcceptCitysInfo。收 单 机 构 应 向 省 级 清 算 管 理 机 构 请 求 城 市 白 名 单 列 表 。 受 理 终 端 通 过 收 单 机 构 下 载 最 新 的 白 名 单 列表 信 息 。 获 取 白 名 单 请 求 参 数 见 表 12， 返 回 参 数 见 表 13。表 12 请 求 参 数序 号 字 段 名 参 数 名 长 度 类 型 说 明1 收 单 机 构 标 识 im

41、anagerId 6 字 符 串 6位 收 单 机 构 标 识表 13 返 回 参 数 序 号 字 段 名 参 数 名 长 度 类 型 说 明1 城 市 发 码 机 构 白 名 单 列 表 whiteList 1000 字 符 串 城 市 发 码 机 构 代 码 列 表 ， 逗 号 分 隔2 返 回 码 resultCode =4 字 符 串 0： 成 功其 他 ： 错 误3 错 误 消 息 errMsg =500 字 符 串 例 如 “ 系 统 错 误 ！ ”7.2.5 时 钟 同 步 接 口接 口 名 称 ： TimeSynchronize。收 单 机 构 和 发 码 机 构 应 向 省 级 清 算 管 理 机 构 请 求 时 钟 同 步 ， 受 理 终 端 和 客 户 端 软 件 应 分 别 向 收 单 机构 和 发 码