ICS 35.240 L 65 中华人民共和国国家标准 GB/T39465—2020 城市智慧卡互联互通 充值数据接口 Card of smart city unionInterface for charging data 2021-06-01实施 2020-11-19 发布 国家市场监督管理总局 发布 国家标准化管理委员会 GB/T39465—2020 目 次 前言 1 范围 2 规范性引用文件 3 术语和定义 缩略语 5 充值架构及功能 报文和接口数据定义 7 充值申请 8 充值操作 9 充值异常处理 10 对账文件处理 12 参考文献 15 GB/T39465—2020 前言 本标准按照GB/T1.1一2009给出的规则起草 本标准由中华人民共和国住房和城乡建设部提出。 本标准由全国智能建筑及居住区数字化标准化技术委员会（SAC/TC426）归口。 本标准起草单位：北京亿速码数据处理有限责任公司、中外建设信息有限责任公司、城联数据有限 公司、北京智芯微电子科技有限公司、东信和平科技股份有限公司、中城智物联网技术研究（深圳）有限 公司、天津通卡智能网络科技股份有限公司、山东华冠智能卡有限公司、上海复旦微电子集团股份有限 公司、浙江创建科技有限公司、北京握奇数据股份有限公司、武汉天喻信息产业股份有限公司、青岛海纳 云科技控股有限公司、广东天波教育科技有限公司、广东永华通讯科技有限公司、杭州国朗科技有限公 司、珠海市珠海通科技有限公司、中建新疆建工（集团）有限公司。 本标准主要起草人：蔡文成、张永刚、谢跃文、马虹、王莎、金学明、范琳琳、周亮、尚治宇、孙式方、 李小帅、林翌桢、白婧、徐湖伟、李德昶、何全、梁浩、张佳燕、沈阳、李世强。 GB/T39465—2020 城市智慧卡互联互通 充值数据接口 1范围 本标准规定了城市智慧卡互联互通充值架构及功能、报文和接口数据定义、充值申请、充值操作、充 值异常处理及对账文件处理等。 本标准适用于城市智慧卡互联互通充值数据接口的设计、开发和应用。 2规范性引用文件 2 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T1988—1998信息技术信息交换用七位编码字符集 GB/T13000—2010信息技术通用多八位编码字符集（UCS) GB/T31778一2015数字城市一卡通互联互通通用技术要求 3 术语和定义 下列术语和定义适用于本文件。 3.1 城市智慧卡 card of smart city 用于城市内综合交通（公共汽车、地铁、轻轨、轮渡、出租车、公共自行车）、公共事业缴费、风景园林、 社区/园区应用、停车场管理等多项业务需求，具有微处理器芯片的识别卡。 注：本标准中提到的IC卡均指城市智慧卡。 3.2 充值平台 platform for charge 通过通信网络实现对城市智慧卡充值申请、操作、异常处理和对账的系统。 3.3 清分 clearing 当日的全部网络交易数据按照平台间进行汇总、整理、分类的过程。 3.4 报文 message 充值终端和城市智慧卡相互发送，不含传输控制字符的字节串。 3.5 圈存load 持卡人将相关账户上的资金划转到城市智慧卡电子钱包的过程。 [JR/T0025.2—2010,定义3.19] 4缩略语 下列缩略语适用于本文件。 APDU应用协议数据单元（ApplicationProtocolDataUnit） 1 GB/T39465—2020 APP应用（Application） eSE嵌人式安全单元（embeddedSecureElement) FTP文件传输协议（FileTransferProtocol) HCE基于主机的卡模拟（Host-basedCardEmulation） IC 集成电路(IntegratedCircuit) 身份标识号（Identity） JSON脚本对象简谱(JavaScriptObjectNotation) MAC 报文认证码（MessageAuthenticationCode) MD5 报文摘要算法5(Message-DigestAlgorithm5) RSA非对称加密算法（Rivest/Shamir/Adlemanasymmetricalgorithm） SE安全单元（SecureElement） SM2 2安全消息算法2（SecureMessage2） 5充值架构及功能 5.1系统充值架构 城市智慧卡互联互通平台与第三方充值平台的充值数据接口应按照充值申请、充值操作、充值异常 处理、对账文件处理的流程进行规范，并约定报文和接口数据要求。城市智慧卡第三方充值架构，见 图1。 城市慧卡五联五通平台 充值中请 充值异常处理 充值操作 对账文件处理 充值申请 充值操作 充值异常处理 对账文件处理 第三方充值平台 充终端 充值终端 充值终端 充值终端 (APP) (自助) （eSE钱包） （HCE钱包） 城市智慈卡 城市智慧卡 SAC 图1城市智慧卡第三方充值架构 GB/T39465—2020 5.2 2功能要求 城市智慧卡互联互通平台充值数据接口应符合下列要求： a)J 应具备与第三方充值平台的充值申请、充值操作和充值异常处理、对账文件处理等进行对接的 功能； b）应实现充值数据的清分结算和第三方充值平台对账文件的处理，清分结算内容应符合 GB/T31778—2015的规定； c) 宜兼容手机APP充值终端、自助充值终端、手机eSE钱包和手机HCE钱包等多种充值方式。 6 报文和接口数据定义 6.1报文格式说明 报文格式应符合下列要求： 通信方式应采用请求-响应协议，使用投递方式提交请求参数，编码字符集应符合 GB/T1988—1998和GB/T13000—2010中8位元（UTF-8）的要求。数据的格式应为JSON 格式。 **"，Parastr"："请求参数报文集合"})。 报文体内容也应为JSON格式。 示例2："Name"："charge"，"Plat_id"："2253123456781234"，"App_id"："123456790010",CardNo："1234567890123456"】。 b）应答参数数据格式应为JSON格式。 pe"："RSA"."Sign"："******".Parastr"："返回参数集合"}。 报文体内容也应为JSON格式。 示例4：{"Name"："charge"，"Plat_id"："2253123456781234"，"App_id"："123456790010"，CardNo："1234567890123456"。 c）# 报文中的数据应区分大小写。 d）通信应使用短链接， 6.2报文安全说明 报文安全应符合下列要求： a) 报文内容中应包含签名信息，报文发送方用本方的私钥对报文进行签名，报文接收方用对方的 公钥验签，当服务端验签失败，应返回失败并丢弃报文； b) 台将充值平台的公钥进行配置。 6.3 3接口及数据域定义 接口及数据域定义应符合表1的规定。 3 GB/T39465—2020 表 1 接口及数据域定义 序号 内容 名称 类型 备注 1 Version 接口版本号 Format 2 请求参数格式，仅支持JSON 应符合GB/T1988—1998和GB/T13000—2010中 3 Charset UTF-8的要求 通用请求参数 4 Timestamp 发起请求的时间，yyyy-MM-ddHH：mm：ss格式 5 Sign_type 签名方式，SM2、MD5、RSA等 6 Sign 签名 7 Parastr 参数集合 8 Name 交易类型名称，含验卡、圈存、查询 9 Plat_id 发起充值请求的平台标识 10 App_id 充值服务提供商在充值平台上的注册ID 11 CardNo 卡号，卡密钥分散因子 12 Orderid 充值订单号、流水号 String 充值订单状态，分订单创建、充值成功、充值失败、 13 OrderStatus 充值异常、订单关闭、订单处理中等用于标识订单 在交易流程中的不同情况 14 Amount 充值金额 15 充值交易参数 Pay_type 交易支付类型 16 APDUset APDU指令序列，可包含多个APDU指令 17 APDUresp APDU指令执行结果，可包含多个APDU 18 APDUver 支持多版本APDU.可用于标识APDU是否加密 O：APDU指令信息为非空，下发APDU指令，执行 19 APDUflag 完APDU指令后提交结果继续圈存过程。 1：APDU指令信息为空，圈存结束 20 TerminalNo 终端机编号 21 Statuscode 状态码，0：成功：非0为其他错误码 22 Statusdescription 状态描述 7 充值申请 7.1 操作流程 充值申请操作应符合下列要求： a) 充值申请操作应包括订单预处理和订单确认； b) 持卡人应通过充值终端连接充值平台，通过充值平台与通卡后台的充值申请接口通信，实现 IC卡的充值申请操作，并完成向通卡平台账户的充值； 充值申请时序图见图2。 9 4