城市智慧卡互联互通充值数据接口

城市智慧卡互联互通充值数据接口

国家标准 GB/T39465一2020 城市智慧卡互联互通充值数据接口 Cardofsmartcityunmion一Interfaceforchargingdata 2020-11-19发布 2021-06-01实施 国家市场监督管理总局 发布 国家标涯花警理委员会国家标准
GB/T39465一2020 次 目 前言 范围 2 规范性引用文件 3 术语和定义 缩略语 充值架构及功能 报文和接口数据定义 充值申请 充值操作 充值异常处理 10对账文件处理 参考文献 15
GB/39465一2020 前 言 本标准按照GB/T1.1一2009给出的规则起草 本标准由住房和城乡建设部提出 本标准由全国智能建筑及居住区数字化标准化技术委员会(SAC/TC426)归口 本标准起草单位:北京亿速码数据处理有限责任公司、中外建设信息有限责任公司,城联数据有限 公司北京智芯微电子科技有限公司、东信和平科技股份有限公司、中城智物联网技术研究(深圳)有限 公司、天津通卡智能网络科技股份有限公司、山东华冠智能卡有限公司、上海复旦微电子集团股份有限 公司、浙江创建科技有限公司、北京握奇数据股份有限公司,武汉天喻信息产业股份有限公司、青岛海纳 云科技控股有限公司、广东天波教育科技有限公司、广东永华通讯科技有限公司、杭州国朗科技有限公 司、珠海市珠海通科技有限公司、中建新疆建工(集团)有限公司 本标准主要起草人;蔡文成、张永刚、谢跃文、马虹、王莎、金学明,范琳琳、周亮、尚治宇、孙式方、 李小帅、林翌锁、白嬉,徐湖伟、李德褪,何全、梁浩析、张佳燕、沈阳,李世强
GB/39465一2020 城市智慧卡互联互通充值数据接口 范围 本标准规定了城市智慧卡互联互通充值架构及功能、报文和接口数据定义、充值申请、充值操作、充 值异常处理及对账文件处理等 本标准适用于城市智慧卡互联互通充值数据接口的设计、开发和应用 规范性引用文件 下列文件对于本文件的应用是必不可少的 凡是注日期的引用文件,仅注日期的版本适用于本文 件 凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件 GB/T1988一1998信息技术信息交换用七位编码字符集 GB/T130002010信息技术通用多八位编码字符集(UcS) GB/T31778一2015数字城市一卡通互联互通通用技术要求 术语和定义 下列术语和定义适用于本文件 3.1 城市智慧卡cardofsmarteity 用于城市内综合交通(公共汽车、地铁、轻轨、轮渡、出租车、公共自行车)、公共事业缴费、风景园林、 社区/园区应用、停车场管理等多项业务需求,具有微处理器芯片的识别卡 注本标准中提到的Ic卡均指城市智慧卡 3.2 充值平台platformftorcharge 通过通信网络实现对城市智慧卡充值申请、操作,异常处理和对账的系统 3.3 清分eearing 当日的全部网络交易数据按照平台间进行汇总、整理,分类的过程 3.4 报文message 充值终端和城市智慧卡相互发送,不含传输控制字符的字节串 3.5 圈存load 持卡人将相关账户上的资金划转到城市智慧卡电子钱包的过程 [JR/T0025.22010,定义3.19] 缩略语 下列缩略语适用于本文件 APDU应用协议数据单元(ApplieationProtocolDataUnit)
GB/T39465一2020 APP应用(Applieation) .SE嵌人式安全单元(embeddedSeeureElement) FTP文件传输协议(FileTransferProtocol) HCE基于主机的卡模拟(HostbasedCardEmlation) IC 集成电路(IntegratedCircuit) In 身份标识号(Identity) ]sON脚本对象简谱JavaSeriptObjetNotation) AuthenticationCode MAC报文认证码(Message MD5报文摘要算法5(Message-DigestAlgorithm 5 RsA非对称加密算法(Rivest/Shamir/Adlemanasymmetricalgorithm) SE安全单元(SecureElemen nt SM2安全消息算法2(SecureMessage2) 充值架构及功能 S 5.1系统充值架构 城市智慧卡互联互通平台与第三方充值平台的充值数据接口应按照充值申请,充值操作,充值异常 处理、对账文件处理的流程进行规范,并约定报文和接口数据要求 城市智慧卡第三方充值架构,见 图1 城市智慧卡互联互通平台 充值异常处理 对账文件处理 充值申请 充值操作 充值申请 对账文件处理 充值操作 充值异常处理 第三方充值平台 充值终端 充值终满 充值终端 充值终端 C首助 CE钱包 AP eSE钱包 城市智慧卡 城市智慧卡 城市智慧卡第三方充值架构
GB/39465一2020 5.2功能要求 城市智慧卡互联互通平台充值数据接口应符合下列要求 应具备与第三方充值平台的充值申请、充值操作和充值异常处理、对账文件处理等进行对接的 a 功能; b 应实现充值数据的清分结算和第三方充值平台对账文件的处理,清分结算内容应符合 GB/T317782015的规定; 宜兼容手机APP充值终端、自助充值终端、手机eSE钱包和手机HCE钱包等多种充值方式 报文和接口数据定义 6. 报文格式说明 报文格式应符合下列要求 通信方式应采用请求-响应协议，使用投递方式提交请求参数，编码字符集应符合 a GB/T19881998和GB/T130002010中8位元(UTF-8)的要求 数据的格式应为JSON 格式 示例1;("Vversion",".0","Forma""soN","Chure","UTF-8","rimestamp""201903-281l:30;45","sign type";"RSA","sign" ,Parastr";"请求参数报文集合"注意;发送报文为;data="Version";"1.0"," "JsO","Charset ""RSA","Sign" Format" ";,"201903-2811;30;45",Ssign_type" "Timestamp"; Parastr";"请求参数报文集合 报文体内容也应为JsON格式 示例2;("Name";"charge","Plat_id";"2253123456781234","App_idl";"123456790010",CardNo;"1234567890123456" b应答参数数据格式应为JSON格式 示例3:("Version";"l.0","Formmat";"JSON","Charset";"UTF-8","Timestamp";"2019-03-28ll;30;45","Sign_ty pe";"RSA","Sign" ,Parastr";"返回参数集合" 报文体内容也应为JsON格式， 示例4"Nume","dhuge","PlLid "2253123456781234", "Apid"" "123456790010",CardNo;"1234567890123456" 报文中的数据应区分大小写 c d 通信应使用短链接 6.2报文安全说明 报文安全应符合下列要求 报文内容中应包含签名信息,报文发送方用本方的私钥对报文进行签名,报文接收方用对方的 公钥验签,当服务端验签失败,应返回失败并丢弃报文; b 通卡平台应下发公钥给充值平台,充值平台接人通卡平台前,应提供公钥给通卡平台,通卡平 台将充值平台的公钥进行配置 6.3接口及数据域定义 接口及数据域定义应符合表1的规定
GB/T39465一2020 表1接口及数据域定义 序号 内容 名称 类型 备注 Version 接口版本号 请求参数格式,仅支持JsoN Format 应符合GB/T1988一1998和GB/T130002010中 Charset UTF-8的要求 通用请求参数 Timestamp -MMddHH:mm;ss格式 发起请求的时间，yyy Sign_type 签名方式,SM2、MD5、RSA等 Signm 签名 Parastr 参数集合 Name 交易类型名称,含验卡、,圈存、查询 发起充值请求的平台标识 Plat_id 充值服务提供商在充值平台上的注册D App_id CardNo 1 卡号,卡密钥分散因子 Orderid 12 充值订单号,流水号 String 充值订单状态,分订单创建、充值成功、充值失败、 13 OrderStatus 充值异常,订单关闭、订单处理中等用于标识订单 在交易流程中的不同情况 充值金额 Amount 1t 15 充值交易参数 Pay_type 交易支付类型 16 APDUset APDU指令序列,可包含多个APDU指令 APpU指令执行结果,可包含多个APpU 17 APDUresp 支持多版本APDU,可用于标识APDU是否加密 18 APDUver 0,APDU指令信息为非空,下发APDU指令,执行 完APDU指令后提交结果继续圈存过程 19 APDUflag 1;APDU指令信息为空,圈存结束 20 TerminalNo 终端机编号 状态码,0;成功;非0为其他错误码 21 Statuscode 22 状态描述 Statusdescription 充值申请 7.1操作流程 充值申请操作应符合下列要求 充值申请操作应包括订单预处理和订单确认; a D)持卡人应通过充值终端连接充值平台,通过充值平台与通卡后台的充值申请接口通信,实现 IC卡的充值申请操作,并完成向通卡平台账户的充值; 充值申请时序图见图2
GB/39465一2020 C卡 充值终端 充值平台 通卡平台 订单申请请求 订单申请请求 订半预处理 -返回订单校验结果 组织充值申请指令 下发指令集 -下发指令 我互指令 -返回指令响应- 返回指令响应 -指令响应上传 订单确认 返回处理结果 返回处理结果 图2充值申请时序图 7.2通卡平台充值申请流程 -般规定 7.2.1 通卡平台充值申请业务流程见图3
GB/T39465一2020 第三方充值平台 调用充值申请接口 订单预处理 下发选应用、读卡指令 充值平台上送指令结果 卡片是否允许 不允许进行充值并终止 充值校验 创建订单成功 允许进行充值 图3通卡平台充值申请业务流程 7.2.2订单预处理 当充值平台接收到充值终端发起的充值申请时,应验证申请报文是否符合6.3的要求,同时将订单 请求上送给通卡平台验证订单状态是否合法 当得到通卡平台的验证结果后,如果不合法,应申请终 止,否则组织并下发读取C卡指令,启动充值申请操作 7.2.3订单确认 充值终端接收并向lC卡转发指令,IC卡执行相应指令,并将结果返回 充值终端收到命令响应报 文后,通过充值平台将响应数据传给通卡后台 通卡平台确认该IC卡是否正常从而做最终的订单确 认 当订单确认成功,则进行接下来的充值操作;否则,需返回错误状态至充值平台,充值平台通知充值 终端中止交易 订单确认包含的内容如下 IC卡读取指令返回码认证 a bb) c卡见去为本菜统卡 e IC卡是否为黑名单 卡状态是否正常是否锁定或退卡) d e 充值余额是否达到上限 8 充值操作 8.1一般规定 持卡人通过充值终端连接充值平台,通过充值平台与通卡后台的充值接口通信,实现IC卡充值操 作,持卡人可将相应账户上的资金划人电子存折或电子钱包中 充值操作接口应支持用户充值平台和
GB/39465一2020 通卡后台间信息交互,交易过程可能存在多次交互 充值操作流程见图4 第三充您台 调用充值接口 充值失败 刘判断订单 提示充做 是香存在 中请接口 完成记是香 为充值完成 下发选应具 扔始花指零 充值失败 接收指令返回结果 提示卡号与订单中 判断卡号是香与订单 卡号不匹配 中的卡号一致 斯充值终机编 判断这易让数器 买 是香增加 战朵t品 更新M中记录的 充值失败 校验MAc 否 交易计败器为当i前 是香合法 提示非法卡 计数器 下发圈存指令并 保存充值记录 下发澈取TAC指令 T 太 交易可疑并终止 她背通过 充值完成 图4充值操作流程
GB/T39465一2020 充值时序见图5 c卡 充值终端 充值平台 通卡平台 充值请求 充值请求 组织INTIALIZFOR LoAD指令 下发NTIALzFOR LoAD指令 下发INTIALzEFOR LoAD指令 下发INITIALIzEFoR LoAD指令 执行指令,生成MAC 返回指令结果 返回指令结果 返回指令结果 验证MACI,组织 CREDTFORLOAD指令 下发CRETFOR 下发CREDITFOR LoAD指令 下发CREDTFOR LoAD指令 LoAD指令 热行指令，生成TAc 返回指令结果 返回指令结果 返回指令结果 验证TAC,入库交易 返回处理结果 返回处理结果 图5充值时序图 8.2流程说明 8.2.1组织圈存初始化(INIIAL1zEoRLoAD)指令 当充值平台接收到充值终端发起的充值请求时,应组织并下发INITIALIZEFORL0AD指令启
GB/39465一2020 动充值操作 8.2.2处理圈存初始化(INITIALIZEFoRL.oAD)指令 充值终端接收并转发INITIAL1ZEF:ORLOAD指令至Ic卡,IC卡将进行下列操作 检查钱包是否被灰锁 如果灰锁,应回送状态码‘9408',但不回送其他信息,同时终止命令的 a 处理过程 b 检查是否支持命令中包含的密钥索引号 如果不支持,应回送状态码‘9403',但不回送任何其 他数据,同时终止命令的处理过程 产生一个伪随机数,过程密钥和一个报文认证码(MACI),供通卡后台验证充值操作及IC卡 的合法性 d)Ic卡将INITIALIZEFoRLoAD响应报文回送给充值终端处理 如果ICc卡回送的状态码 不是‘9000',充值操作应终止 8.2.3验证报文认证码1(MIAc1) 收到INITIALIZEFORLOAD命令响应报文后,充值终端通过充值平台将响应数据传给通卡后 台 通卡后台将生成并确认MAC1是否有效 如果MMAC1有效,充值操作将继续执行 否则,应返回 错误状态至充值平台,充值平台通知充值终端中止交易 8.2.4组织圈存(CREDIrFoRLoAD)指令 确认充值交易后,充值平台将从持卡人在的相应账户中扣减充值金额,并通知通卡平台 通卡平台 一个报文认证码3(MAC2),用于Ic卡对通卡平台合法性检查 产生一 成功充值交易后,通卡平台将电子存折联机交易序号或电子钱包联机交易序号加1,并向充值平台 发送一个充值交易接受报文,其中包括MAC2,交易日期和交易时间,充值平台根据报文组织CREDIT FORLOAD指令 8.2.5处理圈存(CREDITFORLOAD)指令 充值终端收到充值平台CREDITFORLOAD指令后下发到1cC卡,更新卡上电子存折或电子钱包 余额 8.2.6验证报文认证码2(MAC2 收到CREDITFORIOAD命令后,Ic卡应确认MAC2的有效性 如果MAC2有效.,IcC卡将电子 存折联机交易序号或电子钱包联机交易序号加1.并且把交易金额加在电子存折或电子钱包的余额上， IC卡将根据充值交易信息生成TAC 否则将向终端回送状态码‘9302',充值操作结束,进人异常 处理 8.2.7返回确认 在MAC验证成功后,IcC卡通过CREDITFORLOAD命令的响应报文将TAC回送给充值终端 充值终端将通过充值平台将TAC上送给通卡平台,通卡平台验证TAC后,向充值平台返回验证结果， 若通过,充值平台应通知充值终端充值操作完成,否则应进人充值异常处理 充值异常处理 g.1一般规定 充值平台对接通卡平台充值异常可包括下列情况
GB/T39465一2020 调用充值接口,没有获得交易应答信息 a b调用充值接口,交易应答信息中的返回码,非“0”; 从通卡平台获得的充值指令传至IC卡,没有从IC卡获得应答代码 c 充值平台应根据异常情况,重新发起充值接口的调用,通卡平台在接口调用过程中,根据IC卡充值 状态进行异常处理,也可调用充值结果查询接口,根据返回结果选择退款或重新发起充值 充值异常操作时序见图6 IC卡 充值终端 充值平台 通卡平台 充值异常，重新 发起充值操作 判断订单状态 返回结果，下发指令 透传下发指令 -执行指令 返回指令结果 返回指令结果 透传返回指令结果 根据异常流租 处理业务 返回结果， 下发指令集台 透传下发指令 执行指令 返回指令结果 返回指令结果 透传返回指令结果 校验充值结果 充值完成 图6充值异常操作时序图 0
GB/39465一2020 g.2通卡平台异常处理流程 通卡平台下发圈存初始化指令给充值平台,充值平台执行指令并上送指令执行结果 通卡平台针 对交易前后IC卡交易计数器的值进行比较,判断流程见图7,并应符合下列要求 IC卡计数器未发生变化充值失败,继续进行充值流程,校验MAC1成功下发圈存指令,继续 完成充值流程; C卡计数器增加;比较最后一条交易记录的充值终端机编号是否与充值平台该订单使用的充 b 值终端机编号相同,如果相同,证明充值成功,下发获取TAc的指令,完成充值 如果不相 同,应更新该订单的交易计数器为当前计数器,校验MAc1成功下发圈存指令,继续完成充值 流程; 判断为失败的充值交易,充值平台可选择调用充值结果查询接口,根据返回结果选择退款或重 新发起充值,也可不调用充值结果查询接口,直接调用充值接口充值,这时交易日期和时间应 变化,以充值成功日期为准; d 判断为成功的充值交易,进行正常的清分与结算处理; 判断为可疑的充值交易,由通卡平台的清分部门根据该卡后续的交易情况进行可疑交易调整 调整为成功交易的正常清分与结算处理,调整为失败的交易通知充值平台退款 11
GB/T39465一2020 充值台返回存 初始化指令结果 到断充值终端机编 判断交易计数器 是香为该订单记录的 是否增加 否 否 更新订单中记录的 充值失败 校验MACl1 否 交易计数器为当前 是否合法 提示非法井终止 计数器 下发重取 下发圈存指令并 TAC指令 保存充值记录 接受指令返回 否 交易可疑并终止 验证C是否通过 是 充值完成 图7充值异常判断流程 10对账文件处理 0.1一般规定 充值平台和通卡平台对账应符合下列要求 a 通卡平台每日生成充值交易明细数据文件作为对账的依据; D通卡平台只要在充值操作中发出CREDITFORLOAD指令,即视作充值成功,记录至充值交 易明细数据文件; 通卡平台在轧差中如发现以前的充值不成功,应在发现的当日在充值交易明细数据文件中进 行结算修正; 12
GB/39465一2020 d 如果不一致,双方可协商采用人工对账并查出原因 10.2对账流程 对账数据处理流程应符合下列要求 通卡平台T十1日时先对T日的实时充值交易的数据统计,根据不同的充值平台生成相应的 充值交易明细数据文件,并把数据文件放至指定的FTP目录上 充值平台从不同的通卡平台通过FTP获取T十0日充值交易明细数据文件， b 充值平台按规定格式检查和解析充值交易明细数据文件,并按城市分类对账 c 10.3对账数据备份 对账数据的备份应每天进行当天交易日志的增量备份,定期进行全量数据备份,根据需要进行整个 数据库备份 通卡平台和充值平台备份数据应至少保留3年 10.4充值交易明细数据文件 10.4.1用途 用于规范地方通卡平台下发的充值交易明细文件,并应符合下列要求 结算标志为结算成功表示生成该充值交易明细数据文件时地方通卡公司认为成功的交易 a b)结算标志为结算修正表示地方通卡公司通过清分确认充值失败; 文件内容属于应包含的,通卡公司可增加自定义内容 c 10.4.2 命名规则 文件应采用txt格式,充值交易明细数据文件命名规则应符合表2的规定 表2充值交易明细数据文件命名规则 值 数据元 数据类型 长度 文件标识 CZ 日期 YYMMDD 地方通卡机构代码 0000000l99999999 String 序列号 000000999999 0000000199999999 充值平台代码 10.4.3文件格式 交易下发包文件格式应符合表3的规定 13
GB/T39465一2020 表3充值交易明细数据文件格式 数据元 数据类型 长度 说明 版本号 0 文件 交易类型 2100表示充值交易 说明区 回车符 0x0d和0xOa 记录总数 取值范围为00001~99999 由地方级数据处理系统指定的编号;取值范围 地方通卡公司代码 交易头 为0000000199999999 单笔交易长度 包含回车换行取值范围为owo1~9999 回车符 0x0d和0x0a 地方通卡公司充值流水号 String 32 长度不足前补00 城市代码(卡属地 卡属地城市代码 取值范围为 0000000000000001 16 用户卡应用序列号 FFFFFFFFFFFFFFFF 单位为分,取值范围为0000000199999999 交易数据交易金额 交易发生日期 YY'YYMMIDD HHMMss 交易发生时间 结算标志 0为结算成功;l为结算修正 回车符 0x0d和0xOa 14
GB/39465一2020 参 考文献 [1]JR/T0025.2一2010金融集成电路(IC)卡规范第2部分;电子钱包/电子存折应用 规范

城市智慧卡互联互通充值数据接口GB/T39465-2020

随着城市智慧化建设的推进，城市智慧卡已经成为了人们生活中不可或缺的一部分。然而，由于不同城市之间的智慧卡系统存在着不兼容的情况，使得用户出行时需要面对充值不便、转移困难等问题。为了解决这一问题，国家标准化管理委员会于2020年发布了城市智慧卡互联互通充值数据接口GB/T39465-2020。 该标准规定了城市智慧卡互联互通充值数据接口的技术要求、测试方法和使用规范等方面的内容。通过此标准，不同城市之间的智慧卡系统可以实现互联互通，用户可以在全国范围内使用同一张智慧卡进行充值和使用，大大提高了出行便利性和用户体验。 该标准涉及的主要技术要求包括：智慧卡充值数据元素、互联互通充值数据格式、充值交易流程与安全保障、充值终端设备规范等方面。其中，互联互通充值数据格式是该标准的核心内容之一，它将不同城市之间的智慧卡系统进行了统一编码，实现了互联互通。同时，标准还规定了智慧卡充值交易过程中的安全保障措施，确保用户个人信息和资金安全。 总之，城市智慧卡互联互通充值数据接口GB/T39465-2020标准的发布，为解决城市智慧卡系统不兼容问题提供了重要的技术支持，也为智慧城市建设和人民群众出行提供了更加便捷的服务。希望各地能够积极推广该标准，将城市智慧卡系统打造成真正意义上的“一卡通”。

城市智慧卡互联互通充值数据接口的相关资料

和城市智慧卡互联互通充值数据接口类似的标准

GB/T39465-2020

城市智慧卡互联互通充值数据接口

2022/7/19 8:28:33 现行