《DB32∕T 3961-2020 江苏交通一卡通二维码支付技术规范(江苏省).pdf》由会员分享，可在线阅读，更多相关《DB32∕T 3961-2020 江苏交通一卡通二维码支付技术规范(江苏省).pdf（85页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、TCS 93.080 CCS Q 84 DB32 江苏省白山T目，方标准DB 32/T 3961-2020 江苏交通一卡通二维码支付技术规范Technical Specification for Two-Dimensional Code Payment of Jiangsu T-union 2020-12-15发布2021-01-15实施江苏省市场监督管理局发布DB32/T 3961-2020 目次前言.111 号|言.1V 1 范围.1 2 规范性引用文件.1 3 术语及定义.1 4 缩略语.2 5 总体架构和流程.2 5.1 应用体系架构.2 5.2 业务架构和流程.4 5.3 密钥工作流
2、程.9 6 二维码要求.四6.1 二维码数据结构.12 6.2 二维码数据结构说明.12 7 APP要求.13 7.1 二维码生成.13 7.2 存储安全.14 7.3 其他要求.14 8 受理终端要求.14 8.1 多码兼容要求.15 8.2 密钥管理.15 8.3 受理终端交易流程.15 8.4 受理终端功能.17 8.5 受理终点端交易上传.18 8.6 硬件要求.18 8.7 其他要求.19 9 洁分结算.四9.1青分结算流程.19 9.2 洁分结算流程说明.DB32/T 3961-2020 10.5 信息安全.22 10.6 支付安全.22 10.7 用户安全.22 10.8 其他要
3、求.22 1 信息接口.22 11.1 概述.22 11.2 HTTPS方式.23 11.3 FTP方式.23 11.4 流传输方式.24 11.5 HTTPS接口.30 11.6 文件接口.47 附录A规范性)附录B规范性)附录c(规范性)符号定义.71 签名处理方式.73 TLV.74 附录o资料性)发卡机构公钥证书.78 附录E(规范性)二维码自定义区编码规则.79 参考文献.80 II DB32/T 3961-2020 目IJ昌本文件按照GB!T1.1-2020(JT/T 1179-2018)二维码结构、密钥应用流程和安全要求基础上，针对本省交通一卡迪移动支付二维码应用实际情况，优化了
4、机具交易流程，细化了机具硬件性能要求，补充了信息接口种类，增加了业务模式和二维码结构中白定义部分的定义。IV DB32/T 3961-2020 江苏交通一卡通二维码支付技术规范1 范围本文件规定了江苏交通一卡通二维码支付应用的体系架构及业务模式和流程、二维码数据结构、APP应用、受理终端、清分结算、信息接口等。本文件主要用于江苏省内交通运输行业移动支付二维码的设计、开发、管理与应用等，必要时可支持全国范围的跨省应用。2 规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件:不注日期的引用文件，其最新版本(包括所有的
5、修改单)适用于本文件。GB/T 2312信息交换用汉字编码字符集基本集JT/T 978.4-2015 城市公共交通IC卡技术规范第4部分:信息接口JT/T1179-2018 交通一卡迪二维码支付技术规范3 术语及定义JT/T1179-2018界定的以及下列术语和定义适用于本文件。3.1 移动应用mobileapp I i cat i on 负责用户交互相关的行为管理，为用户申请乘车二维码、生成二维码和管理二维码等。3.2 城市公共交通public traffic 运用公共汽电车、出租车、公共自行车、有轨电车、无轨电车、地铁、城市客运轮渡、索道、农村公交等运载工具和相关设施，按照核定的线路、站点
6、、时间、票价运营，为城市及邻近区域公众提供基本出行服务。3.3 乘车二维码twodimensional code by bus 公众用来乘坐城市公共交通工具的二维码，其中包含时间戳、支付及安全校验信息等，可被乘车二维码受理终端快速读取。3.4 DB32/T 3961-2020 清分clearing对交易数据根据机构类型和交易类型进行分类汇总，并计算结算金额的过程。3.5 清算settleaccount 根据清分结果对交易数据进行金额轧差的过程C3.6 结算closean account 根据清分清算的结果进行资金划拨的过程。3.7 PDF417 Portable Data File 417 一
7、种堆叠式二维条码，目前应用最为广泛的一种二维码格式。4 宿略语下列缩略词适用于本文件。http:超文本传输协议，HyperText Transfer Protocol GPS:全球定位系统，Global Positioning System PDF:便携数据文件，Portable Data File TEE:可信执行环境，Trusted Execution Environ配5 总体架构和流程5.1 应用体系架构5.1.1 应用体系架构图具体应用体系架构见图105.1.2 应用架构说明5.1.2.1 部级平台部级平台主要由以下子系统构成:a)机构管理实现对全国交通行业入网机构的统一管理。b)CA
8、证书管理实现全国交通一卡通二维码发卡机构公钥证书的签发、认证等管理。c)洁分结算系统实现交通一卡通二维码跨域交易洁结算。5.1.2.2 省级平台省级平台主要由以下子系统构成:a)机构管理实现对省内交通行业入网机构的统一管理。b)密钥管理负责帮省内交通一卡迪二维码发卡机构向部级平台申请公钥证书、下发等。2 DB32/T 3961-2020 c)洁分结算系统实现交通一卡通二维码省内跨域交易洁结算。省级平台机构管理H 密阳广洁分约1平系统L 主1一交易管理系统2 收单机构叫了丰丁叫|。工Fmffl一l叫干十管验证、处理-斗支付、结算图1应用体系架构图5.1.2.3 收单机构收单机构主要有以下子系统构
9、成:a)乘车二维码受理终端由收单机构管理，负责识别二维码、解析验证二维码、定期更新解码密钥证书、上传交易。b)收单系统负责本地行业交易规则制定、交易受理终端管理、二维码支付交易接收和上送。c)清算系统负责本地二维码交易的清算。3 DB32/T 3961-2020 5.1.2.4 发码机构发码机构主要有以下子系统构成:a)发码系统负责用户实名及信用管理、为用户提供生成二维码、二维码安全密钥管理，发码系统可以是城市交通行业自主发码系统或非城市交通行业的第三方发码系统。b)支付结算实现用户二维码交易支寸和结算。c)APP应用给用户提供二维码服务申请开通和使用二维码乘车的入口O5.2 业务架构和流程5
10、.2.1 业务架构图具体业务架构图见图2。部级干台洁结算系统1 省级平fT移动支付管理系统钊J 咐寸|l统系斗寸支|统系户用APP应用于-t3v町图2业务架构图5.2.2 业务架说明5.2.2.1 部级平台清分结算系统部级平台洁分结算系统(简称:部级平台)由部级管理机构授权建设，负责全国入网机构管理、白名单生成和下发、异地交易洁分结算、发卡机构公钥证书签发管理等。5.2.2.2 省级平台移动支付管理系统省级平台移动支付管理系统(简称:省级平台)由省级管理机构授权建设，负责全省入网机构管理、自名单下发、i青分结算、发卡机构密钥管理、交易及用户数据归集分析。5.2.2.3 收单系统4 DB32/T
11、 3961-2020 收单系统由收单机构建设，负责与省移动支付管理系统对接，制定行业交易规则和计费、交易上传至省移动支付管理系统、受理终端管理、自名单下发更新。5.2.2.4 受理终端受理终端由收单机构负责建设管理，负责扫码解析，验证二维码、交易上传。5.2.2.5 发码系统发码系统由发码机构建设，负责用户管理、二维码服务开通、二维码生成、提交二维码交易数据至账户系统扣款及支付账户密钥管理。5.2.2.6 支付系统支付系统由发码机构建设或收单机构建设，负责二维码交易的支付扣款。5.2.2.7 APP应用APP应用由发码机构建设或经授权接入发码系统第三方建设，负责提供用户开通二维码服务、生成二维
12、码、展示二维码。5.2.3 业务模式和流程5.2.3.1 业务模式根据省级平台在整个二维码应用中所承担的业务功能来进行划分。具体业务模式种类详见表10表1业务模式模式一模式二模式三省级平台地IJ入网机构省级平台地lJ入网机构省级平台地IJ入网机构发码J J J 密钥管理J J J 入网机构管现J J J 内名单管理J J J 内名单下发J J J 终端管理J J J 交易规则管理J J J 交易il费管理J J J 交易il费J J J yj(:单清结算J J J 交易送J J J 跨域清结算J J J 5.2.3.2 业务模式一和流程5 DB32/T 3961-2020 业务模式一指各收单机
13、构委托省级平台代理发码与清结算，统一由省级平台完成二维码生成、交易验证及清分结算:收单机构只负责行业交易规则及交易计费管理与交易上传。业务模式一业务流程见图30 丁维码业务tL和APp!dm 受迎终端i收单系统省移功支十J平台止血己dz-m I liiTli I一图3业务模式一业务流程步骤说明:a)省级平台下发新入网机构白名单到收单系统，本步骤流程在非交易时段完成。b)收单系统将入网机构臼名单更新到扫码受理终端中。c)扫码受理终端在验证二维码时，先验证发码机构号是否在入网白名单中。d)省级平台通过入网机构白名单来验证收单机构上传的数据，并通过入网机构号清分数据。e)用户在APP应用上请求生成乘
14、车二维码。f)省移动支付平台发码系统验证用户身份合法性、信用等级等合理性验证。g)生成二维码数据返回APP应用端!lG授权APP端在授权期限范围内离线生成二维码数据并展示。h)用户将二维码靠近受理终端进行扫描。i)受理终端解析井验证二维码有效性。j)验证通过，提示用户过闸。k)受理终端准实时上传交易至收单管理平台。1)收单管理平台根据交易规则计算交易费用。m)收单机构上传交易至省移动支付管理平台。6 DB32/T 3961-2020 n)省级平台进行支付交易扣款。)省级平台向APP应用发送交易扣款结果(支付通知)。p)省级平台进行交易清算。q)收单机构确认交易清算结果。5.2.3.3 业务模式
15、二和流程业务模式二指收单机构委托省级平台代理清结算，收单机构上传交易至省级平台，由省级平台请分交易至发码系统，并与发码系统进行结算。(注:发码系统，既包括第二方发码，也包括城市白发码)业务模式二业务流程见图40APPIL用省移动支付平台EE，1三1!z.1!l1I I xitmm r 0-1 图4业务模式二业务流程步骤说明:a)省级平台下发新入网机构臼名单到收单系统，本步骤流程在非交易时段完成。b)收单系统将入网机构自名单更新到扫码受理终端中。c)扫码受理终端在验证二维码时，先验证发码机构号是否在入网白名单中。d)省级平台通过入网机构自名单来验证收单机构上传的数据，并通过入网机构号清分数据。7
16、 DB32/T 3961-2020 e)用户在APP应用上请求生成乘车二维码。f)发码系统验证用户身份合法性、信用等级等合理性验证。g)生成二维码数据返回APP应用端或授权APP端在授权期限范围内离线生成二维码数据并展示。g-1)用户开通时，发码系统上传用户信息至省级平台进行数据归集及分析。h)用户将二维码靠近受理终端进行扫描。i)受理终端解析并验证二维码有效性。j)验证通过，提示用户过闸。k)受理终端准实时上传交易至收单系统。1)收单系统根据交易规则计算交易费用。m)收单机构上传交易至省级平台。n)省级平台进行交易洁分至发码系统。)发码系统进行交易支付扣款。1)发码系统完成交易支付扣款后向A
17、PP应用发送支付结果通知，通知用户交易付款成功。p)省级平台清算交易结果。q)收单系统确认清算交易结果。r)交易数据归集管理，用户交通出行大数据分析管理平台Cs)发码系统反馈洁分数据结果。5.2.3.4 业务模式三和流程业务模式三指省级平台只负责大数据分析与管理，由收单机构与各个发码系统对接，并完成交易洁分结算，由收单系统与发码系统将交易信息和码信息及用户信息上传至省级平台，省级平台负责交通出行大数据分析与管理。业务模式二业务流程说明见图50业务流程步骤说明:a)省级平台下发新入网机构白名单到收单系统，本步骤流程在非交易时段完成。b)收单系统将入网机构自名单更新到扫码受理终端中。c)扫码受理终
18、端在验证二维码时，先验证发码机构号是否在入网白名单中Cd)省级平台通过入网机构白名单来验证收单机构上传的数据，并通过入网机构号清分数据。e)用户在APP应用上请求生成乘车二维码。f)发码系统验证用户身份合法性、信用等级等合理性验证。g)生成二维码数据返回APP应用端或授权APP端在授权期限范围内离线生成二维码数据并展示。g-1)用户开通时，发码系统上传用户信息至收单机构进行数据归集及分析。g-2)用户开通时，收单机构将通过发码系统收集到的用户信息上传至省级平台进行数据归集及分析。8 DB32/T 3961-2020 二维码业务流程I.PPJ_i，用发问系统g-l g-2-1-1 Et 垂r叫王
19、0-1 p日羊干-p-l图5业务模式三h)用户将二维码靠近受理终端进行扫描。i)受理终端解析井验证二维码有效性。j)验证通过，提示用户过闸Ok)受理终端准实时上传交易至收单系统。1)收单系统根据交易规则计算交易费用。有格动支f才丰台1-1)收单系统同时将原始交易上传至省级平台，用于交通出行大数据分析与管理。m)收单机构上传交易至发码系统。n)发码系统进行交易支付扣款。)发码系统进行交易清分结算。0-1)发码系统完成交易支付扣款后，向APP应用发送用户支付通知。p)收单系统进行清算结果确认。p-1)发码系统同时将支付结果交易信息上传至省级平台，用于交通出行大数据分析与管理。5_ 3 密钥工作流程
20、5.3.1 根证书下发流程证书管理中心与收单机构双方提前约定用于通讯保护的非对称密钥对，并交换公钥。证书管理中心9 DB32/T 3961-2020 向收单机构下发根公钥证书流程如下:a)建立连接。b)交换临时通讯密钥。c)证书管理中心向收单机构下发证书管理中心公钥证书文件。d)断开连接。5.3.2 发卡机构证书申请流程发卡机构向证书管理中心申请发卡机构公钥证书的前提要求如下:a)发卡机构应根据S陋的要求生成用于二维码签名的公私钥对。b)证书管理中心与发卡机构双方提前约定用于通讯保护的非对称密钥对，并交换公钥05.3.3 发卡机构证书下发流程证书管理中心向发卡机构下发根公钥证书流程如下:a)建
21、立连接。b)交换临时通讯密钥。c)发卡机构上传公钥证书请求文件。d)证书管理中心下发发卡机构公钥证书。e)断开连接。5.3.4 数据加密流程应使用发卡机构级密钥和发码系统用户级密钥对交通一卡通二维码数据进行加密，由支付账户系统为用户分配独立、不重复的一组或多组支付账户用户公私钥对。具体要求如下:a)若用户密钥安全存储于智能终端客户端，应保证智能终端客户端和密钥存储的安全性。b)若用户密钥存放于支付账户系统中，应以密文形式存储。交通一卡通二维码数据加密流程见图6。说明:1)使用中心私钥为发卡机构签发的发卡机构公钥证书:2)使用发卡机构私钥对二维码数据进行签名生成二维码发卡机构授权签名数据:3)使
22、用支付账户用户私钥对二维码数据进行签名生成支付账户用户私钥签名数据。5.3.5 受理终端验签流程受理终端验证交通一卡迪二维码签名数据流程如下:a)受理终端使用证书管理中心的公钥验证发卡机构公钥证书的合法性和有效性。b)受理终端使用二维码中发卡机构公钥验证发卡机构授权签名数据的合法性和有效性。c)受理终端使用二维码中包含支付账户用户公钥验证二维码中支付账户用户私钥签名数据的合法性和有效性。10-行1月一维码数据发卡机构公钥lc书;只卡机构授权数据支付账户用户私钥签名如居图6交通一卡通二维码数据加密流程图受理终端验证交通一卡通二维码签名数据流程见国70什什书合法性凡|二-/与主中心窄、钳&卡机构私
23、钥支付账户用户私钥开之 二DB32/T 3961-2020 11 DB32/T 3961-2020 图7受理终端验证交通一卡通二维码签名数据流程图6 二维码要求。1二维码数据结构交通一卡迪二维码结构主要由二维码版本、二维码数据长度、发卡机构公钥证书、支付账户号、用户账户号、发卡机构代码、发码系统编码、卡账户类型、单次消费金额上限、支付账户用户公钥、支付账户系统授权过期时间、二维码有效时间、发卡机构自定义域长度、发卡机构自定义域(详见附录E)、发卡机构授权签名、二维码生成时间和支付账户用户私钥签名组成。具体二维码结构见表20发卡机构自定义域，规范了入口的定义与管理，从而达到支持多码兼容的目的。具
24、体见附录E。表2二维码结构一维J)约十iJ如部王在 构A业1 上组唱态吗A层h 非账/M 尸公t女u j f 吉布突构 是ta 户击名t 百雪翻 H出Z 也付 账号户 支尸账尸号时发怕自y;用 户 账户j去牛冯Z 维F版本l fT于4冯t 寸、类iU 成H|R才l 限州时I叫名2 117 16 10 4 生3:B 4 2:12 fi，4 fi，注:参照交通一卡通二维码技术规范(JT/T 1179-2018章节7.1.1)中定义的码结构。6.2 二维码数据结构说明交通一卡迪二维码数据结构说明见表30表3二维码数据结构说明是否必序号字段名长度说明格式土豆1 二维码版本1 版本范围Ox80OxFF。
25、B M 2 二维码数据长度2 第317宁段的总长度。B M 3 发卡机构公钥k书117 发卡机构公告月k书内容J1表170B M 4 支付账户号16 由支付账户系统白定义。ans M 5 用户账户号10 由发卡机构账户管理平台定义OB M 6 发卡机构代码4 由清分结算机构统一分配。B M 7 发码机构代码4 由清分结算机构统一分配。B M 12 DB32/T 3961-2020 续表3是否必序号字段名长度说明格式用户账户的类型。见JT/T 978.2-2015中表A.1中发卡8 用户账户类型1 B 机构特殊数据元第20宁节卡种类型。二维码支付单次消费金额上限，出支付账户系统根据当9 单J欠消
26、费金额卜限3 前用户消费状态进行授权。此I或在单次消费交易时可作B 为能否乘芹的判断依据。经过压缩的支付账户系统中用户公钥数据，压缩方法见10 支付账户时户公钥33 B GM/T 00030 立付账户系统授权过期时间，使用UTC(0时区)时间11 支付账户系统授权过期时间4 B 1970年1月1日00:00:00到当前的秒数。12 二维码有效时间2 以秒为单位，此域在填写时元需带单位。B 13 发卡机构白定义域长度1 发卡机构自定义域数据长度，最大320B 发卡机构自定义，出发卡机构自定义域。按照自定义编14 发卡机构自定义域32 B 码标j佐填写15 发卡机构授权徐名65 发卡机构私钥徐名，
27、给名数据包括:本表中314宁段。B 二维码生成的时间戳，使用UTC(0时区)时间1970年16 二维码生成时间4 B 1月1Fl 00:00:00到当前的秒数。支付账户用户私钥签名数据，签名数据包括:本表中117 支付账户用户私钥签名65 B 16字段。注:交通一卡通二维码数据总长度为332364字节。注:参照交通一卡通二维码技术规范(JT/T 1179-2018章节7.1.2)中定义的码结构说明。7 APP要求7.1 二维码生成APP生成二维码业务流程见图80生成二维码业务流程步骤说明:a)用户在APP应用端申请开通二维码乘车服务，APP应用端向发码系统申请，发码系统授权用户开通二维码。b)
28、发码系统生成用户二维码离线数据，并向密管系统请求发卡机构证书对离线数据签名。c)生成用户二维码离线数据及签名。d)发码系统返回签名高线数据到APP应用端。e)APP应用将用户离线数据安全存储。f)用户在APP应用端离线申请二维码，APP应用调取发卡机构签名的用户二维码离线数据。13 土豆M M M M M M C M M M DB32/T 3961-2020 g)APP应用端验证用户离线发卡机构签名授权数据信息有效性。h)APP应用端生成用户动态数据，并使用用户证书签名。i)生成二维码。牛成均tli在拌飞pp应用j轩管系统发码系统|耳边讲ij一一;二|投川|在线离线一蚓一-mi-P价-i-tM
29、fllE才下llllIF-|一边i-JE一一太而一-习一一动一-3一图8生成二维码流程图7.2 存储安全应保障用户公私钥、机构授权等信息的安全，采用敏感数据分段存储，且智能终端客户端程序应保证分段数据组合过程编程逻辑的安全性。应禁止在身份认证结束后明文存储账户信息，防止账户信息泄露。二维码支付交易中涉及敏感数据高线存储需要进行安全保护，例如:发卡机构签名授权二维码离线数据存储在于机安全区域，如SE、TEE等。7.3 其他要求其他移动应用终端要求参考1T/T1179-2018的第11节(智能终端客户端软件要求)。8 受理终端要求14 DB32/T 3961-2020 8.1 多码兼容要求机具统一
30、采用证书方式兼容多发码方生产的二维码在公共交通领域的使用。8.2 密钥管理按照发码机构在入网时分配的机构号区分，由各发码机构提供根证书或安全DLL存储在受理终端安全存储区内。在发码机构入网时，需要提供根证书(或封装根证书的DLL:eX;SDK)，由各地收单机构决定是否需要更新发码机构的臼名单和证书，更新证书后将机构根证书下发到受理终端，受理终端目iJ可接受该发码机构的二维码交易。8.3 受理终端交易流程8.3.1 离线交易终端交易流程是指设备受理二维码交易的整体交易流程。具体流程如图90计始村问+末 书:别在位研+技lllA卡机构、:TrLj)L构辛工J+3舍扣L杉j国名叫V+排问白交女时间+
31、发|、机构刽J怕主主主获lk挫阳门r;女扣街上|担+址否具备iGmK条件+f民钳JfLIr+扣责成功井t存父届+L 立即l京同图9终端离线受理二维码交易流程流程步骤说明:a)终端须验证二维码有效时间，终端的本地时钟校准必须与北京时间定时同步，要求误差不大于1秒。b)终端根据发码机构号，检索发码机构存放在终端内的根证书，并使用根证书验证二维码中的发码机构公钥证书是否合法。15 DB32/T 3961-2020 c)通过二维码中的发卡机构公钥证书(格式见附录D)验证发卡机构签名信息。d)通过二维码中的用户公钥证书验证用户签名信息。e)终端根据本地基础票价以及折扣率参数，计算出的扣费票价必须小于二维
32、码数据结构中定义的单次扣费上限。但交易是复合消费、收单系统计费时，发现单边账可自定义计费规则，例如;1)按照基础票价计费2)按照最高票价计费。8.3.2 在线交易终端交易流程是指设备受理二维码交易的整体交易流程。具体流程如图10。N L:金流程步骤说明:队.lStlL之工?王账户;立即如f吃.1;it!li:i.川油d:-俨土飞监HI但q户采贪丛合胡E甘失于1J图10终端受理二维码在线交易流程a)终端须验证二维码有效时间，终端的本地时钟校准必须与北京时间定时同步，要求误差不大于1秒。16 DB32/T 3961-2020 b)终端根据发卡机构号，检索发卡机构存放在终端内的根证书，并使用根证书验
33、证二维码中的发码机构公钥证书是否合法。c)通过二维码中的用户公钥证书验证用户签名信息。d)通过二维码中的发卡机构公钥证书验证发卡机构签名信息。e)基础验证通过后，将码信息及POS交易信息发送给收单系统，收单系统判断是否为复合消费，根据码类型计算费用并形成交易。单次消费时，收单系统根据本地基础票价以及折扣率参数，计算出的扣费票价必须小于二维码数据结构中定义的单次消费金额上限。复合消费时，收单系统根据交易进出站类型进行交易合法性校验:进站时，收单系统根据本地全线最高票价以及折扣率参数，计算出的扣费票价必须小于二维码数据结构中定义的单次消费金额上限。出站时，收单系统读取进站数据，配合出站数据进行计费
34、。说明:当出现无进站数据时，无法出站，收单机构可自定义扣费计算原则，例如:1)按照基础票价计算。2)按照最高票价计算。当收单系统中只有进站数据而无出站数据时，收单机构可自定义扣费计算原则，例如:1)按照基础票价计算。2)按照最高票价计算。8.4 受理终端功能机具具体功能列表见表40类型自名单系统时间乘叶飞二维码合法验证交易记录表4机具功能列表功能:tM述备泣发码机构内名单下载发码机构内名单存储时间|司步与北京时间误差小于1秒i卖取乘芹二维码解析乘车二维码模块非法发码机构码拦截验证时间不超过300毫秒:|叫一码豆复扫码|叫一用户豆复扫码(10秒内)交易记录生成交易记录存储，安时上传交易j住实时上
35、传交易17 DB32/T 3961-2020 8.5 受理终点端交易上传机具二维码交易上传流程见图11，具体数据信息接口定义见11.6.4.1(GB/T2260-2007)和县以下行政区划代码编制划则(GB/T10114-2003);各接入方可自行引用规范编码使用。11.5.2.1.2 请求参数参考公用请求参数11.5.2.1.3 应答参数区域查询应答参数见下表190表19区域查询应答参数字段areaList areaNo areaName 11.5.2.2 申请开通签约11.5.2.2.1 接口描述含义响应结果集区域编码区域名称申请开通签约接口描述见下表20。类型长度必土真ans M 日向应
36、结果集An 8 M An 50 M 表20申请开通签约接口描述申请开通签约备;主Json字符申地区代码地区名称接口名称接口拙述该接口用于用户开通城市二维码服务31 DB32/T 3961-2020 接口类型post 服务地址HTTPS:/xxx.xxx.xxx.xxx:xxxx/api/qrcode/apply/open 应用场景代发码代清算模式下，用户选定指定城市进行二维码乘车服务升迪备注异步回洲通知O与签约二接U二j在一11.5.2.2.2 请求参数申请开通签约请求参数见下表210表21申请开通签约请求参数字段含义类型长度必坝备注memberNo App会员号ans 32 M APP会员号
37、payChannelNo 支付机构编码n 6 M 1001.微信areaNo 区域编码an 10 M 医域编码可通过怪域查询接U获取1:android platform 来源类型n 1 M 2:ios 3:微信小程序01:普通卡02:学生卡memberType 用户账户类型n 2 M 03:老人卡04:测试卡05:车人卡sex 性别n 1。性别C1:男2:女)name 姓名ans 20 M phone 子机号码n 11 M idType 证件类型(0:身份证)证件类型n l M 可参考通用参数说明idCardNum 证件号码ans 20 M 11.5.2.2.3 应答参数申请开通签约应答参数见
38、下表220表22申请开通签约应答参数字段含义类型长度必填备注用于唤醒第=方app签redirectUrl 跳转URLans/N 约(当前参数不为空的话，必须跳转支付渠道方进行签约32 cardNo 11.5.2.3 申请服务关闭11.5.2.3.1 接口描述用户账户号申请服务关闭接口描述见下表230n 20 M 表23申请服务关闭接口描述才妾口名称申请二维码服务关闭接口描述用户关闭当前城li二维码服务接口类型post DB32/T 3961-2020 操作)由发卡机构账户管理平台(接入方的用户账户标识)定义。服务地址HTTPS:/xxx.xxx.xxx.xxx:xxxx/api/qrcode/
39、apply/close 应用场景代发码代清算模式下使用备注与签约二接口二选一11.5.2.3.2 请求参数申请服务关闭请求参数见下表240表24申请服务关闭请求参数字段含义类型长度必填备注memberNo App会员号ans 32 M APP会员号areaNo 区域编码an 10 M 区域编码可通过区域查询接口获取11.5.2.3.3 应答参数申请服务关闭应答参数下表250表25申请服务关闭应答参数字段含义备注公用参数33 11.5.2.4 申请免密支付解约11.5.2.4.1 接口描述申请免密支付解约接口描述见下表260表26申请免密支付解约接口描述接口名稍申请免密支付解约接口描述接口类型p
40、ost DB32/T 3961-2020 服务地址HTTPS:/xxx.xxx.xxx.xxx:xxxx/api/qrcode/apply/pay/close 应用场景代发码代清算模式川吏用备注11.5.2.4.2 请求参数申请免密支付解约请求参数见下表280表28申请免密支付解约请求参数字段含义memberNo App会员号11.5.2.4.3 应答参数申请免密支付解约应答参数见下表290表29申请免密支付解约应答参数字段含义11.5.2.5 服务开通/关闭回调通知11.5.2.5.1 接口描述公用参数服务开通/关闭回调通知接口描述见下表30。表30服务开通/关闭回调通知接口描述接口名称免密
41、支付签约/解约结果通知备注APP会员号备注34 DB32/T 3961-2020 接口描述该接口提供时户申请免密支付签约、解约时，通知其申请的结果。接口类型支持HTTPS才妾口地址山接入方在申请入网时提供。应用场景用户告知用户的免乎有支付签约或者解约请求的处理结果。备注11.5.2.5.2 通知参数服务开通/关闭回调通知参数见下表310表31服务开通/关闭回调通知字段含义类型长度必项备注memberNo App会员号ans 32 M APP会员号orderId 签约订单号ans 32 M changeType 变更类型an 1 M 商户可通过该字段判断是签约回训还是解约回训1:开通2:关闭ch
42、angeMode 变更方式an 36 C 当变更类型为2(解约)、j才有该返回值1:i在j户平台关闭2:用户主动关闭processingTime 半台处坦时间an 14 M 时间格式字符串yyyyMMddHHmmss11.5.2.5.3 应答参数服务开通/关闭回调通知应答参数见下表320表32服务开通/关闭回调通知应答字段含义类型长度必填备注resultCode 业务返回码n 2 M SUCCESS/FAIL SUCCESS表示由j户接收通知成功并校验成功resultDesc 业务返回码描述ans 256 M 返回信4息，如非窄，为错误原因:答名失败、参数格式校驳错误无公共参数无需力口答11.
43、5.2.6 二维码服务开通查询35 DB32/T 3961-2020 11.5.2.6.1 接口描述二维码服务开通查询接口描述见下表330表33二维码服务开通查询接口描述接U名称二维码服务开通查词接U描述该接U提供二维码服务开通查询的功能。接口类型支持HTTPS接口地址HTTPS:/xxx.xxx.xxx.xxx:xxxx/api/qrcode/getstate 应用场景用户需要开通二维码功能时，APP需要先查询用户是否己开通1备注11.5.2.6.2 请求参数二维码服务开通查询请求参数见下表340字段memberNo areaNo 11.5.2.6.3 应答参数表34二维码服务开通查询请求参
44、数含义App会员号Lt或号二维码服务开通查询应答参数见下表350表35二维码服务开通查询应答参数字段含义类型J长度必填status 开通状态n M 备注APP会员号备注。:初始化1:在首2:解约中3:关闭cardNo 卡号n 20 C 当开通状态为1时，必填111.5.2.7 支付回调通知11.5.2.7.1 接口描述支付回调通知描述见下表36036 DB32/T 3961-2020 表36支付回调通知描述接口名称交易回调通知接口描述该接口是山发码平白发起，推送用户交易订单代扣缴费结果到APP后台服务，再山APP后台服务推送到时户的于机端，从向达到实现通知用户的效果:接口类型支持HTTPS接口
45、地址商户入网时捉供的noticeUrl+POST 请求应用场景发码半台针对用户的每笔消费完成扣款后，发送通知到商户后台，通知商户的用户此消费的扣款结果:备注11.5.2.7.2 请求参数支付回调通知请求参数见下表370表37支付回调通知请求参数宁段含义类塑长度必填备注memberNo 会员号n 32 M 由APPi句户定义。由发卡机构账户管理平台(接入方cardNo 用户账户号n 20 M 的用户账户标识)定义。status 订单类型n M 1:缴费成功2:缴费失败tradeOrderNo 交易订单号an 36 M payOrderNo 支付订单号an 36 C 当查询条件中订单类型为1时必填
46、tradeAmt 交易金额n 18 M 单位:分payAmt 实际交易金额n 12 M 单位:分discountAmt 优惠金额tradeTime 交易时间goodsName 商品名称11.5.2.7.3 应答参数支付回调通知应答参数见下表380宇段含义resu1tCode 业务返回码n 12 M 单位:分n 14 M yyyyMMddHHmmss ans 50 M 商品名称(乘车信息城市十线路J)表38支付回调通知应答参数类型n 备注SUCCESS/FAIL SUCCESS表示商户接收通知成功并37 DB32/T 3961-2020 resultDesc 业务返回码描述11.5.2.8 乘车
47、记录查询11.5.2.8.1 接口描述乘车记录查询接口描述见下表39。接口名称校验成功ans 256 M 返回信息，如非空，为错误原冈签名失败参数格式校验错误无公共参数无需加签表39乘车记录查询接口描述乘车记录查询接口描述该接口提供查询乘一于记录的功能，记录包含己缴费和未缴费:接口类型支持HTTPS接口地址HTTPS:/xxx.xxx.xxx.xxx:xxxx/api/qrcode/order/query 应用场景备注11.5.2.8.2 请求参数乘车记录查询请求参数见下表400字段含义memberNo App会员号orderType 订单类型page 起始页rows 每:.条数11.5.2.
48、8.3 应答参数乘车记录查询应答参数见下表410字段total 含义总条数用户需要查看自己的乘车记录:只支持分页查询，查询结果包含在HTTP响应中。表40乘车记录查询请求参数类型J长度必填备注ans 32 M APP会员号n M。:未缴费1:己缴费N 2 M N 2 M 表41乘车记录查询应答参数备注38 DB32/T 3961-2020 续表41字段含义类型长度必填各注totalPages 总页数n 4 M page 当前页N 4 M rows 每页条数n 2 M rescontentlist 查询纯果集ans 2048 M SON 查询结果集tradeOrderNo 交易订单号an 36
49、M payOrderNo 支付订单号an 36 C 当查询条件中订单类型为1时必土豆tradeAmt 手j飞了勿巨/市，占千Mn 18 M 单位:分tradeTime 交易时间n 14 M yyyyMMddHHmmss 山发卡机构账户管理平台(接入方cardNo 用户账户号n 20 M 的用户账户标识)定义。areaNo 区域编码An 10 M areaName 仁主域名称Ans 50 M 11.5.2.9 欠费补缴11.5.2.9.1 摆口描述欠费补缴接口描述见下表420表42欠费补缴接口描述接口名(欠费补缴接口捕述该接口提供用户提交欠费消费补缴功能:接口类型支持HTTPS，POST 接口地
50、址HTTPS:/xxx.xxx.xxx.xxx:xxxx/api/qrcode/order/payback 应用场景用户有欠费订单时使用1备注11.5.2.9.2 请求参数欠费补缴请求参数见下表430表43欠费朴缴请求参数宇段含义备注memberNo App会员号APP会员号39 DB32/T 3961-2020 续表43字段含义类型长度必填各注orderList 交易订单ans 256 M son 交易订单tradeOrderNo 交易订单号an 36 M tradeAmt 交易金额n 18 M 单位:分tradeTi日le交易时间n 14 M yyyyMMddHHlmns s 由发卡机构账