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

I C S 0 3.2 2 0.2 0C C S R 0 744广 东 省 地 方 标 准D B 4 4/T 2 3 1 0 2 0 2 1城 市 公 共 交 通 二 维 码 应 用 技 术 规 范T e c h n i c a l S p e c i f i c a t i o n f o r T w o-D i m e n s i o n a l C o d e i n G u a n g d o n g s M u n i c i p a lP u b l i c T r a n s p o r t a t i o n2 0 2 1-0 6-1 3 发 布 2 0 2 1-0 9-1 3 实 施广 东 省 市 场 监 督 管 理 局 发 布D B 4 4/T 2 3 1 0 2 0 2 1I目 次前 言.I I1 范 围.12 规 范 性 引 用 文 件.13 术 语 和 定 义.14 缩 略 语.15 系 统 架 构.26 二 维 码 数 据 格 式.3编 码 格 式.3数 据 结 构.3发 码 机 构 自 定 义 域 定 义 和 说 明.5交 通 行 业 自 定 义 说 明.57 信 息 接 口.5说 明.5交 互 协 议.68 受 理 终 端 要 求.1 19 客 户 端 软 件 要 求.1 11 0 安 全 规 范.1 1附 录 A（规 范 性）符 号 定 义 表.1 2D B 4 4/T 2 3 1 0 2 0 2 1I I前 言本 文 件 按 照 G B/T 1.1 2 0 2 0 标 准 化 工 作 导 则 第 1 部 分：标 准 化 文 件 的 结 构 和 起 草 规 则 的 规 定起 草。本 文 件 由 广 东 省 交 通 运 输 厅 提 出，并 组 织 实 施。本 文 件 由 广 东 省 交 通 运 输（公 路 水 路）标 准 化 技 术 委 员 会（G D/T C 1 3 3）归 口。本 文 件 起 草 单 位：广 东 岭 南 通 股 份 有 限 公 司、广 州 羊 城 通 有 限 公 司、广 东 省 道 路 运 输 事 务 中 心、广州 市 公 共 交 通 数 据 管 理 中 心、深 圳 市 腾 讯 计 算 机 系 统 有 限 公 司。本 文 件 主 要 起 草 人：谢 振 东、方 秋 水、易 智 君、何 建 兵、刘 兵、袁 勇、徐 锋、吴 金 成、温 晓 丽、于航、曾 江、程 世 勇、郭 贵 城、陈 历 军。D B 4 4/T 2 3 1 0 2 0 2 11广 东 省 城 市 公 共 交 通 二 维 码 应 用 技 术 规 范1 范 围本 文 件 规 定 了 广 东 省 城 市 公 共 交 通 领 域 二 维 码 应 用 的 数 据 格 式、安 全 性、服 务 器 数 据 交 换 协 议、受理 终 端 以 及 客 户 端 软 件 的 要 求。本 文 件 适 用 于 广 东 省 城 市 公 共 交 通 二 维 码 的 服 务 系 统、终 端、客 户 端 软 件 等 的 设 计、研 发 与 应 用。2 规 范 性 引 用 文 件下 列 文 件 中 的 内 容 通 过 文 中 的 规 范 性 引 用 而 构 成 本 文 件 必 不 可 少 的 条 款。其 中，注 日 期 的 引 用 文 件，仅 该 日 期 对 应 的 版 本 适 用 于 本 文 件；不 注 日 期 的 引 用 文 件，其 最 新 版 本（包 括 所 有 的 修 改 单）适 用 于 本文 件。G B/T 2 3 1 2 信 息 交 换 用 汉 字 编 码 字 符 集 基 本 集G B/T 1 8 2 8 4 2 0 0 0 快 速 响 应 矩 阵 码G B/T 3 2 9 1 8（所 有 部 分）信 息 安 全 技 术 S M 2 椭 圆 曲 线 公 钥 密 码 算 法J T/T 9 7 8.3 城 市 公 共 交 通 I C 卡 技 术 规 范 第 3 部 分：读 写 终 端J T/T 1 1 7 9 2 0 1 8 交 通 一 卡 通 二 维 码 支 付 技 术 规 范3 术 语 和 定 义J T/T 1 1 7 9 2 0 1 8 界 定 的 以 及 下 列 术 语 和 定 义 适 用 于 本 文 件。城 市 公 共 交 通 m u n i c i p a l p u b l i c t r a n s p o r t a t i o n运 用 公 共 汽 电 车、城 市 轨 道 交 通、城 市 客 运 轮 渡 等 运 载 工 具 和 有 关 设 施，按 照 核 定 的 线 路、站 点、时 间、票 价 运 营，为 公 众 提 供 基 本 出 行 服 务 的 城 市 客 运 方 式。4 缩 略 语下 列 缩 略 语 适 用 于 本 文 件。3 D E S：三 重 数 据 加 密 算 法（T r i p l e D E S）C A：电 子 商 务 认 证 授 权 机 构(C e r t i f i c a t e A u t h o r i t y)F T P：文 件 传 输 协 议(F i l e T r a n s f e r P r o t o c o l)H T T P S：超 文 本 安 全 传 输 协 议(H y p e r T e x t T r a n s f e r P r o t o c o l o v e r S e c u r e S o c k e tL a y e r)M A C：消 息 认 证 码（M e s s a g e A u t h e n t i c a t i o n C o d e）M A K：M A C 密 钥(M A C K e y)M D 5：信 息 摘 要 算 法（m e s s a g e d i g e s t a l g o r i t h m 5）M M K：成 员 主 密 钥(M e m b e r M a s t e r K e y)Q R C O D E：快 速 响 应 矩 阵 码（Q u i c k R e s p o n s e C o d e)D B 4 4/T 2 3 1 0 2 0 2 12R S A：一 种 非 对 称 加 解 密 技 术（R i v e s t S h a m i r A d l e m a n）S M 2：S M 2 椭 圆 曲 线 公 钥 密 码 算 法(P u b l i c K e y C r y p t o g r a p h i c A l g o r i t h m S M 2 B a s e d o nE l l i p t i c C u r v e s)S M 3：S M 3 密 码 杂 凑 算 法(S M 3 C r y p t o g r a p h i c H a s h A l g o r i t h m)S M 4：S M 4 分 组 密 码 加 密 算 法(S M 4 C r y p t o g r a p h i c A l g o r i t h m)S S L/T L S：安 全 套 接 层/传 输 层 安 全(S e c u r e S o c k e t s L a y e r/T r a n s p o r t L a y e r S e c u r i t y)T L V：标 签、长 度、值(T a g L e n g t h V a l u e)T A C：交 易 认 证 码（(T r a n s a c t i o n A u t h e n t i c a t i o n C o d e）U I D：用 户 账 户 标 识（U s e r A c c o u n t I d e n t i f i e r）U I I D：用 户 账 户 发 行 方 标 识（U s e r A c c o u n t I s s u e r I d e n t i t y）U T C：协 调 世 界 时(C o o r d i n a t e d U n i v e r s a l T i m e)5 系 统 架 构广 东 省 城 市 公 共 交 通 二 维 码 应 用 系 统 由 省 级 清 算 管 理 机 构、发 码 机 构、收 单 机 构、受 理 终 端、客 户端 软 件 组 成。系 统 架 构 见 图 1。图 1 系 统 架 构 示 意 图省 级 清 算 管 理 机 构：省 级 二 维 码 清 结 算 业 务 运 营 主 体，负 责 全 省 二 维 码 交 易 数 据 的 归 集，以 及 负 责省 内 跨 城 市、跨 机 构 之 间 的 二 维 码 交 易 清 分 与 结 算，负 责 发 码 机 构 证 书 的 统 一 申 领 和 发 放，负 责 各 发 码D B 4 4/T 2 3 1 0 2 0 2 13机 构 互 联 互 通 的 配 置 管 理，发 码 机 构、收 单 机 构、受 理 终 端、客 户 端 软 件 的 时 间 均 同 步 省 级 清 算 管 理 机构 服 务 器 的 时 间。发 码 机 构：城 市 公 共 交 通 二 维 码 运 营 主 体 或 其 它 二 维 码 运 营 主 体，负 责 用 户 管 理、资 金 渠 道 管 理、二 维 码 密 钥 服 务、城 市 二 维 码 数 据 清 结 算 及 交 易 风 险 控 制。发 码 机 构 申 请 二 维 码 流 程、受 理 终 端 验 证 二维 码 流 程、跨 区 域 交 易 清 分 结 算 流 程 应 符 合 J T/T 1 1 7 9 2 0 1 8 的 要 求。收 单 机 构：城 市 公 共 交 通 二 维 码 交 易 终 端 运 营 主 体 或 其 它 二 维 码 交 易 终 端 运 营 主 体，负 责 受 理 终 端安 装、系 统 维 护、交 易 数 据 采 集 和 上 传。受 理 终 端：用 于 二 维 码 交 易 的 终 端 设 备。扫 码 方 式 采 用 受 理 终 端 主 扫 模 式。客 户 端 软 件：用 于 生 成 二 维 码 的 应 用 程 序，包 括 用 户 注 册、用 户 登 录、密 钥 申 请 以 及 二 维 码 生 成 等功 能。6 二 维 码 数 据 格 式编 码 格 式二 维 码 的 编 码 格 式 应 符 合 J T/T 1 1 7 9 2 0 1 8 的 要 求。数 据 结 构二 维 码 数 据 主 要 由 1 7 个 字 段 组 成，包 括：二 维 码 版 本、二 维 码 数 据 长 度、城 市 发 码 机 构 公 钥 证 书、支 付 账 户 号、用 户 账 户 号、城 市 发 码 机 构 代 码、发 码 平 台 代 码、用 户 账 户 类 型、单 次 消 费 金 额 上 限、支付 账 户 用 户 公 钥、支 付 账 户 系 统 授 权 过 期 时 间、二 维 码 有 效 时 间、城 市 发 码 机 构 自 定 义 域 长 度、城 市 发码 机 构 自 定 域、城 市 发 码 机 构 授 权 签 名、二 维 码 生 成 时 间 和 支 付 账 户 用 户 私 钥 签 名。二 维 码 数 据 结 构 见表 1，二 维 码 数 据 结 构 说 明 见 表 2，二 维 码 数 据 结 构 说 明 中 出 现 的 格 式 符 号 要 求 见 附 录 A。表 1 二 维 码 数 据 结 构二维码结构二维码版本二维码数据长度城市发码机构公钥证书支付账户号用户账户号城市发码机构代码发码平台代码用户账户类型单次消费金额上限支付账户用户公钥支付账户系统授权过期时间二维码有效时间城市发码机构自定义域长度城市发码机构自定域城市发码机构授权签名二维码生成时间支付账户用户私钥签名1 2 1 1 7 1 6 1 0 4 4 1 3 3 3 4 2 1 3 2 6 5 4 6 5D B 4 4/T 2 3 1 0 2 0 2 14表 2 二 维 码 数 据 结 构 说 明序号 字段名称 长度 格式 必填 字段说明1 二维码版本 1 B M 范围为 0 x 8 0 0 x F F2 二维码数据长度 2 B M 固定长度为 0 x 0 1 6 C3城市发码机构公钥证书1 1 7 B M 应符合 J T/T 1 1 7 9 2 0 1 8 第 9 章的要求4 支付账户号 1 6 a n s M 由支付账户系统自定义，长度不足前补“0”5 用户账户号 1 0 B M 由城市发码机构账户管理平台定义，长度不足前补“0”6 城市发码机构代码 4 B M 由清算机构统一分配7 发码平台编码 4 B M 由清算机构统一分配8 用户账户类型 1 B M用户账户的类型(默认为 0 x 0 1)0 x 0 1:普通卡0 x 0 2：学生卡0 x 0 3：老人卡0 x 0 4：测试卡0 x 0 5：军人卡其他：城市发码机构自定义9 单次消费金额上限 3 B M二维码支付单次消费金额上限，由支付账户系统根据当前用户消费状态进行授权。此域在单次消费交易时可作为能否乘车的判断依据1 0 用户公钥 3 3 B M经过压缩的支付账户系统中用户公钥数据，压缩方法应符合G B/T 3 2 9 1 8 的要求1 1 系统授权过期时间 4 B M支付账户系统授权过期时间，使用 U T C（0 时区）时间 1 9 7 0年 1 月 1 日 0 0：0 0：0 0 到当前的秒数，高字节在前1 2 二维码有效时间 2 B M 以秒为单位，此域在填写时无须带单位，高字节在前1 3城市发码机构自定义域长度1 B M 城市发码机构自定义域数据长度为 3 21 4城市发码机构自定义域3 2 B M 城市发码机构自定义，由城市发码机构自定义域，格式见 6.31 5城市发码机构授权签名6 5 B M城市发码机构私钥签名，签名数据包括本表中序号为 3 1 4字段，应符合 J T/T 1 1 7 9 2 0 1 8 的要求1 6 二维码生成时间 4 B M二维码生成的时间戳，使用 U T C（0 时区）时间 1 9 7 0 年 1月 1 日 0 0：0 0：0 0 到当前的秒数，高字节在前1 7支付账户用户私钥签名6 5 B M支付账户用户私钥签名数据，签名数据包括本表序号为 1 1 6 字段，应符合 J T/T 1 1 7 9 2 0 1 8 的要求D B 4 4/T 2 3 1 0 2 0 2 15发 码 机 构 自 定 义 域 定 义 和 说 明发 码 机 构 自 定 义 数 据 结 构 见 表 3。表 3 发 码 机 构 自 定 义 数 据 结 构序号 名称 长度 格式 标签说明1 发码机构保留区域 1 1 B 由发码机构定义2 交通行业类型标识 1 B0 1：公交0 2：城市轨道0 3：轮渡0 4：出租车0 5：城际轨道0 6：道路客运3 交通行业自定义数据 2 0 B 见 6.4交 通 行 业 自 定 义 说 明发 码 机 构 自 定 义 数 据 结 构 见 表 4。表 4 发 码 机 构 自 定 义 数 据 结 构序号交通行业类型标识标签说明1 0 2第 1 字节为乘车码验证方式，0 x 1 脱机验证；0 x 2 联网验证；0 x 3 连防重系统验证第 2 3 字节为流水号，每次交易里程使用一个流水号第 4 字节为车票状态，0 x 1 初始状态；0 x 2 已进站；0 x 3 已出站；0 x 4 进站更新状态；0 x 5 出站更新状态第 5 6 字节为车站编码，上一次处理车票的车站编码，由线路和站点组成第 7 1 0 字节为车票处理时间，上一次处理车票的时间第 1 1 1 4 字节为行业数据过期时间第 1 5 1 8 字节为地铁后台账户 I D第 1 9 2 0 字节为在线自助更新站点2 其他 保留7 信 息 接 口说 明7.1.1 通 讯 方 式通 讯 方 式 应 使 用 H T T P S 协 议，P O S T 请 求 数 据 方 法。7.1.2 数 据 交 换 格 式D B 4 4/T 2 3 1 0 2 0 2 16数 据 交 换 格 式 为 J S O N（J a v a S c r i p t O b j e c t N o t a t i o n）。7.1.3 接 口 数 据 签 名应 对 数 据 进 行 数 字 签 名，在 接 收 签 名 数 据 之 后 进 行 签 名 校 验。数 字 签 名 有 两 个 步 骤，先 按 7.1.4 规 则 拼 接 签 名 原 始 串，再 选 择 7.1.5 的 算 法 和 密 钥 计 算 出 签 名 结 果。7.1.4 签 名 原 始 串签 名 原 始 串 应 按 以 下 方 式 组 装 成 字 符 串：除 签 名 字 段 外，所 有 参 数 按 照 第 一 个 字 符 的 键 值 A S C I I 码 递 增 排 序，遇 到 相 同 字 符 则 按 照 第二 个 字 符 的 键 值 A S C I I 码 递 增 排 序，以 此 类 推；排 序 后 的 参 数 与 其 对 应 值 组 合 成“参 数 名=参 数 值”的 格 式，并 用“&”字 符 连 接 起 来。签 名 原 始串 中，参 数 名 和 参 数 值 都 采 用 原 始 值。7.1.5 签 名 算 法对 签 名 原 始 串 的 尾 部 加 上 字 符 串“&k e y=”，再 加 上 签 名 密 钥 值，形 成 待 签 名 字 符 串，使 用 M D 5 算 法，对 待 签 名 字 符 串 计 算 M D 5 值，再 转 成 大 写 字 符 串。示例：J S O N 数据中有3 个参数，其表达为：”s e r v i c e”:”a b c”,”t i m e s t a m p”:”1 2 3”,”v e r s i o n”:”1.0”。签名原始串示例为：s e r v i c e=a b c&t i m e S t a m p=1 2 3&v e r s i o n=1.0签名密钥值为：1 2 3 4 5 6签名字符串示例为：s e r v i c e=a b c&t i m e S t a m p=1 2 3&v e r s i o n=1.0&k e y=1 2 3 4 5 6签名字符串的M D 5 值为：8 8 0 4 6 c 2 f a 8 0 8 d c 6 c 7 1 a 6 e e 3 e b 7 c 9 b 8 1 2签名字符串的M D 5 值转换为大写为：8 8 0 4 6 C 2 F A 8 0 8 D C 6 C 7 1 A 6 E E 3 E B 7 C 9 B 8 1 2交 互 协 议7.2.1 公 共 参 数接 口 协 议 中 的 请 求 报 文 必 须 包 含 请 求 公 共 参 数 的 所 有 字 段 见 表 5，接 口 协 议 中 应 答 报 文 必 须 包 含 应答 公 共 参 数 见 表 6。D B 4 4/T 2 3 1 0 2 0 2 17表 5 请 求 公 共 参 数序号 字段名 参数名 长度 类型 说明1 接口版本 v e r s i o n=2 0 字符串 例如“1.0”2 接口名称 s e r v i c e=5 0 字符串见各接口说明例如“T e r m R e g i s t”3 通道编号 c h a n n e l C o d e 8 字符串通道接入唯一标识例如“0 0 0 0 0 0 0 1”4 请求时间 t i m e S t a m p 1 9 字符串发 起 请 求 的 时 间：Y Y Y Y M M D Dh h:m m:s s,格式见附录 A 中的 表 A.1。例如“2 0 2 0-1 1-1 0 0 9:3 8:0 1”5 参数编码 c h a r S e t=1 0 字符串 例如“U T F-8”6 签名方式 s i g n T y p e=1 0 字符串 例如“M D 5”7 签名 s i g n 3 2 字符串 签名算法见 7.1.5表 6 应 答 公 共 参 数序号 字段名 参数名 长度 类型 说明1 应答时间 t i m e S t a m p 1 9 字符串应 答 时 间：Y Y Y Y M M D Dh h:m m:s s,格式见附录 A 中的表 A.1。例如“2 0 2 0-1 1-1 0 0 9:3 8:0 1”2 签名 s i g n 3 2 字符串 签名算法见 7.1.57.2.2 收 单 机 构 注 册 接 口接 口 名 称：T e r m i n a l R e g i s t。收 单 机 构 应 向 省 级 清 算 管 理 机 构 请 求 注 册。每 个 受 理 终 端 上 线 前 收 单 机 构 应 先 将 终 端 编 号（P S A M卡 号）发 到 省 级 清 算 管 理 机 构 登 记，上 传 的 交 易 数 据 才 能 被 平 台 受 理。注 册 接 口 请 求 参 数 见 表 7，返 回参 数 见 表 8。表 7 请 求 参 数序号 字段名 参数名 长度 类型 说明1 收单机构标识 i M a n a g e r I d 6 字符串6 位收单机构标识例如“0 1 0 0 0 1”2 终端编号 i t e r m N o 8 字符串 例如“9 9 9 9 0 0 0 1”D B 4 4/T 2 3 1 0 2 0 2 18表 8 返 回 参 数序号 字段名 参数名 长度 类型 说明1 返回码 r e s u l t C o d e=8 字符串0：成功其他：错误2 错误消息 e r r M s g=1 2 8 字符串 例如“系统错误！”7.2.3 账 单 上 送接 口 名 称：B i l l U p l o a d。收 单 机 构 应 向 城 市 发 码 机 构 和 省 级 清 算 管 理 机 构 进 行 账 单 上 送。收 单 机 构 将 本 地 交 易 记 录（账 单）上 传 给 本 地 发 码 机 构，发 码 机 构 根 据 上 传 的 账 单 对 用 户 进 行 扣 费。收 单 机 构 将 所 有 交 易 记 录（账 单）上传 给 省 级 清 算 管 理 机 构，省 级 清 算 管 理 机 构 应 将 跨 区 交 易 记 录（账 单）上 传 给 本 地 发 码 机 构 相 应 地 市 发码 机 构，相 应 地 市 发 码 机 构 根 据 上 传 的 账 单 对 用 户 进 行 扣 费。账 单 上 送 请 求 参 数 见 表 9，单 条 交 易 记 录格 式 见 表 1 0，返 回 参 数 见 表 1 1。终 端 上 传 二 维 码 交 易 数 据 到 服 务 端，采 取 准 实 时 上 传 方 式，即 终 端 存 在 未 上 传 交 易 时，应 立 即 上 传交 易 数 据。终 端 应 根 据 错 误 的 计 数 延 迟 上 传，每 出 现 一 次 错 误，延 迟 时 间 增 加 3 0 秒，最 大 延 迟 时 间 为 3 0 0秒。当 出 现 一 次 响 应 成 功 时，复 位 延 迟 时 间 复 位。表 9 请 求 参 数序号 字段名 参数名 长度 类型 说明1 交易记录 j L i s t 根据实际字符串长度填写 J S O N 字符串 J S O N 格式：,.表 1 0 单 条 交 易 记 录 格 式序号 字段名 参数名 长度 类型 说明1 收单机构标识 a c q u i r e r I d 6 字符串6 位收单机构标识例如“0 1 0 0 0 1”2 交易标识 t r a n I d 3 2 字符串收单机构标识和收单机构交易流水号流水组成，收单机构每上送一笔交易，必须赋予数字交易流水号作为唯一标识，交易重复发送时的交易 I D须相同，例如“0 1 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1”3 支付账户号 p a y A c c t 3 2 字符串 二维码中原数据送回，见 6.2 表 24 用户账户号 u s e r I d 2 0 字符串城市发码机构的用户 i d 二维码中原数据送回，见 6.2 表 25 城市发码机构代码 c a r d P l t 8 字符串 见 6.2 表 26 发码平台代码 q r P l t 8 字符串 填发码平台代码（当付款方式用），见 6.2 表 27 交易金额 t o t a l F e e=1 0 整数 单位为分，1 0 进制8 应收金额 p a y F e e=1 0 整数 单位分，1 0 进制D B 4 4/T 2 3 1 0 2 0 2 19表 1 0 单 条 交 易 记 录 格 式（续）序号 字段名 参数名 长度 类型 说明9 本次交易时间 t r a n T i m e 8 十六进制字符串使用 U T C（0 时区）时间 1 9 7 0 年 1 月 1 日 0 0：0 0：0 0 到当前的秒数，高字节在前1 0 本次交易终端编号 t e r m N o 8 字符串 交易时终端编号应取 P S A M 卡 8 位终端编号1 1 线路编号 l i n e N o 8 字符串 填入线路编号1 2 二维码生成时间 q r T i m e 8 十六进制字符串使用 U T C（0 时区）时间 1 9 7 0 年 1 月 1 日 0 0：0 0：0 0 到当前的秒数，高字节在前1 3 经度 l n g 8 十六进制字符串扫码时的终端经度，4 字节，共 3 2 位，高位在前第 1 位：0 表示东经，1 表示西经第 1-3 1 位表示经度值，以 1 E-9 度为单位1 4 纬度 l a t 8 十六进制字符串扫码时的终端纬度，4 字节，共 3 2 位，高位在前，以 1 E-9 度为单位1 5 二维码业务数据 q r B i z 6 4 字符串 城市发码机构自定义数据内容1 6 交易类型 t r a n T y p e 2 字符串第 1 位:0：普通卡1：乘车券第 2 位：0：公交消费1：地铁入闸2：地铁出闸消费3：地铁核准交易1 7 终端流水号 t e r m S e q 1 0 字符串 前补“0”1 8 站点编号 s t a t i o n 4 字符串 站点名称1 9 系统授权过期时间 s y s a u t h T i m e 8 十六进制字符串对应二维码中系统授权过期时间账户系统授权过期时间，使用 U T C（0 时区）时间 1 9 7 0 年 1月 1 日 0 0：0 0：0 0 到当前的秒数，高字节在前2 0 码类型 q r T y p e 1 字符串1：正常码2：应急码2 1 外地市二维码数据 a l l C o d e 7 2 8 十六进制字符串 省外发码机构的二维码在省内受理的，该项必填表 1 1 返 回 参 数序号 字段名 参数名 长度 类型 说明1 返回码 r e s u l t C o d e=4 字符串0：成功其他：错误2 错误消息 e r r M s g=5 0 0 字符串 例如“系统错误！”D B 4 4/T 2 3 1 0 2 0 2 11 07.2.4 城 市 发 码 机 构 白 名 单 下 载 接 口接 口 名 称：A c c e p t C i t y s I n f o。收 单 机 构 应 向 省 级 清 算 管 理 机 构 请 求 城 市 白 名 单 列 表。受 理 终 端 通 过 收 单 机 构 下 载 最 新 的 白 名 单 列表 信 息。获 取 白 名 单 请 求 参 数 见 表 1 2，返 回 参 数 见 表 1 3。表 1 2 请 求 参 数序号 字段名 参数名 长度 类型 说明1 收单机构标识 i m a n a g e r I d 6 字符串 6 位收单机构标识表 1 3 返 回 参 数序号 字段名 参数名 长度 类型 说明1 城市发码机构白名单列表 w h i t e L i s t 1 0 0 0 字符串 城市发码机构代码列表，逗号分隔2 返回码 r e s u l t C o d e=4 字符串0：成功其他：错误3 错误消息 e r r M s g=5 0 0 字符串 例如“系统错误！”7.2.5 时 钟 同 步 接 口接 口 名 称：T i m e S y n c h r o n i z e。收 单 机 构 和 发 码 机 构 应 向 省 级 清 算 管 理 机 构 请 求 时 钟 同 步，受 理 终 端 和 客 户 端 软 件 应 分 别 向 收 单 机构 和 发 码 机 构 申 请 时 间 同 步，服 务 器 返 回 系 统 标 准 时 间。时 钟 同 步 请 求 参 数 见 表 1 4，返 回 参 数 见 表 1 5。表 1 4 请 求 参 数序号 字段名 参数名 长度 类型 说明1 收单机构标识 i m a n a g e r I d 6 字符串 6 位收单机构标识2 终端编号 i t e r m N o 8 字符串 8 位 P s a m 卡号表 1 5 返 回 参 数序号 字段名 参数名 长度 类型 说明1 服务器时间 o s e r v e r T i m e 8 十六进制字符串使用 U T C（0 时区）时间 1 9 7 0 年 1月 1 日 0 0：0 0：0 0 到当前的秒数，高字节在前2 返回码 r e s u l t C o d e=4 字符串0：成功其他：错误3 错误消息 e r r M s g=5 0 0 字符串 例如“系统错误！”D B 4 4/T 2 3 1 0 2 0 2 11 18 受 理 终 端 要 求受 理 终 端 应 符 合 J T/T 9 7 8.3 和 J T/T 1 1 7 9 2 0 1 8 第 1 0 章 的 要 求。9 客 户 端 软 件 要 求客 户 端 软 件 要 求 应 符 合 J T/T 1 1 7 9 2 0 1 8 第 1 1 章 的 要 求。1 0 安 全 规 范安 全 规 范 应 符 合 J T/T 1 1 7 9 2 0 1 8 第 9 章 的 要 求。D B 4 4/T 2 3 1 0 2 0 2 11 2A A附 录 A（规 范 性）符 号 定 义 表文 件 记 录 格 式 中 出 现 的 符 号 定 义，见 表 A.1。表 A.1 符 号 定 义 表符号 定义a 字母字符，A Z，a z,向左靠，右边多余位填空格b 数据的二进制表示，后跟数字表示位（b i t）的个数B 用于表示变长的二进制数，后跟数字表示二进制数据所占字节（B y t e）的个数n 数值，0 9，右靠，首位有效数字前填零。若表示人民币金额，则最右二位为角、分H E X 1 6 进制数字 0 9、A Za n 字母和数字字符，左靠，右边多余位填空格a s 字母和数字字符，左靠，右边多余位填空格c n 压缩数字码，即 B C D 码，后跟数字表示 B C D 码的个数n s 数字和特殊字符，左靠，右边多余位填空格a n s 字母、数字和特殊字符，左靠，右边多余位填空格M 必填项，若此信息为空，则信息报错M M 月份，0 1 1 2D D 日期，0 1 3 1Y Y Y Y 年份，0 0 0 0 9 9 9 9h h 时，0 0 2 3m m 分，0 0 5 9s s 秒，0 0 5 9