DB36∕T 1096-2018 政务服务统一支付平台接入要求

ICS 35.080 L 07 DB36 江西省地方标准 DB 36/T 10962018 政务服务统一支付平台接入要求 Access requirements of unified payment platform for government services 2018 - 12 - 29 发布 2019 - 07 - 01 实施 江西省市场监督管理局 发 布 DB36/T 10962018 I 目 次 前 言 II 引 言 . III 1 范围 4 2 规范性引用文件 4 3 术语和定义 4 4 统一支付平台概述 4 5 与非税系统的交互 6 6 统一支付平台业务流程 9 附录 A （规范性附录） 系统接口说明 12 附录 B （规范性附录） 缴款流程示例 18 DB36/T 10962018 II 前 言 本标准按照GB/T 1.1-2009给出的规则编写。 本标准由江西省发展和改革委员会提出并归口。 本标准主要起草单位：江西省信息中心。 本标准主要起草人：金俊平、吴俐、孙杨、李新华、黄振、侯文刚、王云翔、胡坚勇、龚松、占晓 华、王克峰。 DB36/T 10962018 III 引 言 根据江西省人民政府关于印发江西省加快推进“互联网+政务服务”工作实施方案的通知（赣 府厅字20172号）要求，进一步完善优化江西政务服务网功能，建设全省政务服务统一支付对接平 台，在现有支付渠道之外，开展在线支付服务，实现非涉税行政收费以及公共服务收费网上支付，实现 全省政务服务事项一张网受理、办结、反馈，做到“建好一张网、办成所有事”。 DB36/T 10962018 4 政务服务统一支付平台接入要求 1 范围 本标准规定了江西省政务服务统一支付对接平台（以下简称统一支付平台）的概述、与非税系统的 交互、和业务流程。 本标准适用于全省各级政府部门政务服务系统（以下简称政务服务系统）。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。分时注明日期的引用文件，仅注明日期的版本适用于 本文件。凡是不注明日期的引用文件，其最新版本适用于本文件。 “互联网+政务服务”技术体系建设指南 (国办函2016108号) 3 术语和定义 下列术语和定义适用于本文件。 3.1 政务服务系统 各级政府部门建设的面向社会公众提供政务服务门户和业务系统。 3.2 非税支付 政务服务系统内提供支付业务的功能模块， 面向缴款人提供业务服务， 并使用订单作为数据基础与 统一支付平台进行缴款数据交互的功能模块。 3.3 电子缴款书 纳税人直接向国库或国库经收处缴纳税款、 国家能源交通重点建设基金、 预算调节基金以及税务机 关汇总交库时使用的电子凭证。 3.4 缴款码 电子缴款书上用于各级政务服务系统非税支付的唯一编号。 3.5 代收机构 受托办理江西省非税收入代收的商业银行、银行卡清算机构和非银行支付机构。 4 统一支付平台概述 4.1 平台总体接入架构 统一支付平台总体接入构架示意图见图1。 DB36/T 10962018 5 统一支付平台 电子缴费 统一网关 资金安全监 控子系统 数据分析 子系统 客服服务 子系统 后台管理 子系统 缴费人缴款 服务子系统 收款单位 服务子系统 非税 系统 非税系 统- 清 分子系 统 代收 机构 交易 系统 非税系 统- 电子 票据 信 息库 政务服务系统 （非税支付） 缴款服务 缴款 信息 同步 电 子 票 电子票 资金 流水 对账 资金 到账 对账 监管账户 对账 图1 统一支付平台总体接入架构示意图 注1：统一支付平台对接政务服务系统（非税支付）：提供缴款服务，保障各项非税支付业务能够顺利、正常进行， 并且缴款资金进入财政厅监管账户。 注2：统一支付平台组成：由电子缴费统一网关、缴费人服务子系统、收款单位服务子系统、后台管理子系统、资 金安全监控子系统、数据分析子系统、客户服务子系统七大模块组成。 注3：统一支付平台与非税系统对接：统一支付平台通过系统接口与数据加密手段与江西省非税收入收缴一体化系 统（以下简称非税系统）对接，依据财政厅资金监管与清分要求，进行缴款信息同步、电子票开具、资金流 水对账，并协助非税系统进行监管账户对账。 注4：统一支付平台与代收机构交易系统对接：通过与建设银行、江西银行、农业银行、邮储银行、支付宝等代收 机构对接，实现网上银行、支付宝、微信、银联等多种支付手段。 4.2 统一支付平台功能定位 统一支付平台对接非税系统，提供面向政务服务系统非税支付业务，功能如下： a) 提供用于支付的缴款码； b) 提供权威的电子缴款书； c) 提供权威的电子票据。 4.3 系统支付渠道说明 统一支付平台在与多家商业银行网上支付系统、第三方支付系统（如支付宝、微信、银联等），实 现系统功能对接的基础上，能够提供电脑网银缴费、电脑聚合二维码缴费、手机网银缴费、手机app跳 转缴费等多样化和丰富快捷的缴费方式。 4.4 订单模式 统一支付平台使用订单作为支付基础。政务服务系统非税支付使用统一支付平台提供的接口服务， 秉承信息最小化单元原则， 政务服务系统非税支付无法获取到江西省财政厅的的缴款书信息， 只能获取 到统一支付平台封装好的订单信息，具体参照附录A、B。 DB36/T 10962018 6 5 与非税系统的交互 5.1 统一支付平台对接非税系统 统一支付平台对接省财政非税系统信息管理、电子票据管理、资金清算管理等相关系统，平台所代 收资金纳入省财政厅和人民银行的监管范围， 直接进入省政府非税收入内部结算账户， 日终统一清分进 入各级财政金库。 5.2 账户信息同步 由财政厅非税系统每日定时发起账户数据更新、 与监管账户数据更新， 统一支付平台通过数据接口 接收数据，具体流程见图2。 统一支付平台与财政厅非税系统服务交互流程账户信息同步 统一支付平台财政厅非税系统 账户更新数据接收 监管账户数据接收 发起 发起 图2 账户信息同步流程图 5.3 赋码服务、赋虚拟账号服务 由财政厅非税系统每日定时赋码更新、 与赋虚拟账号数据更新， 统一支付平台通过数据接口接收数 据，具体流程见图3。 统一支付平台与财政厅非税系统服务交互流程申请赋码、赋虚拟账号 统一支付平台财政厅非税系统 赋码服务 赋虚拟账号服务 发起 发起 图3 赋码服务、赋虚拟账号服务流程图 DB36/T 10962018 7 5.4 缴款服务 5.4.1 在使用统一支付平台进行缴款时，统一支付平台将会查询财政厅非税系统内的缴款信息，进行 缴款中的执收单位、收费事项、收费金额的核对。 5.4.2 在支付完成后，统一支付平台将与查询财政厅非税系统进行缴款信息确认，告知非税系统已经 支付完成，具体流程见图 4。 统一支付平台与财政厅非税系统服务交互流程缴款服务 统一支付平台财政厅非税系统 缴款信息查询 缴款信息确认 发起 发起 图4 缴款服务流程图 5.5 缴款资金流水对账 在每日的日终时， 统一支付平台将与财政厅非税系统进行日终的资金流水对账， 将支付平台的日终 流水明细悉数发往非税系统，同时完成资金流水明细数据的监管，具体流程见图5。 统一支付平台与财政厅非税系统服务交互流程资金流水对账 统一支付平台财政厅非税系统 接收待确认账户 资金流水对账数据通知 发起通知 发起查询 待确认账户 资金流水对账数据查询 发起 账户资金流水 对账结果接收 图 5 缴款资金流水对账流程图 5.6 缴款资金到账对账 DB36/T 10962018 8 在每日的日终时， 统一支付平台将与财政厅非税系统进行日终的资金到账金额对账， 将支付平台的 日终金额汇总发往非税系统，同时完成资金金额的监管，具体流程见图6。 统一支付平台与财政厅非税系统服务交互流程资金到账对账 统一支付平台财政厅非税系统 接收待确认账户 资金到账对账数据通知 发起通知 发起查询 待确认账户 资金到账对账数据查询 发起 账户资金流水 资金到账对账结果接收 图 6 缴款资金到账对账流程图 5.7 财政监管账户对账 在每日的日终时， 财政厅非税系统将资金代收机构系统进行财政监管账户的资金对账， 确保代收机 构将资金划转到财政监管账户，具体流程见图7。 统一支付平台与财政厅非税系统服务交互流程财政监管账户对账 统一支付平台财政厅非税系统 接收财政监管账户 对账数据通知 发起通知 发起查询 财政监管账户 对账数据查询 图 7 财政监管账户对账流程图 6 统一支付平台业务流程 6.1 网上缴费业务流程 DB36/T 10962018 9 网上缴费业务按照以下流程，参见图8： a) 缴款人登录政务服务系统，选择要办理的业务； b) 缴款人填写相关业务材料信息，政务服务系统将自动生成缴款信息，缴款人确认缴款； c) 政务服务系统向统一支付平台发送缴款请求申请，统一支付平台对缴费信息进行验证； d) 统一支付平台对缴费信息验证通过后展示支付页面给缴款人， 若验证不通过， 返回错误信息页 面并结束本流程； e) 缴款人选择支付方式、支付银行等，确认后；统一支付平台将调用银行或第三方代收系统，由 缴款人在银行或第三方代收系统内完成支付； f) 缴款人支付完成后， 统一支付平台将展示支付成功网页提示缴款人， 缴款人可根据网页上的提 示信息继续后续业务办理； g) 同时统一支付平台将在缴款人支付完成后通知政务服务系统交易结果； h) 政务服务系统在收到统一支付平台的交易结果通知时， 应将交易处理结果的回执通知给统一支 付平台。 缴款人 统一支付平台 政府服务系统 (非税支付) 图8 网上缴费业务流程 6.2 日终对账日终对账流程流程 日终时， 政务服务系统与统一支付平台必须进行流水核对， 政务服务系统从统一支付平台下载缴费 订单结算明细逐笔进行核对, 具体流程见图9。 a) 统一支付平台向代收机构发起日终结算数据对账查询请求， 代收机构验证请求通过后， 根据结 算的情况返回相应的对账单数据， 统一支付平台根据返回的对账单数据对缴款订单进行核对处 理； b) 统一支付平台与代收机构日终结算成功后， 统一支付平台向财政非税票据系统发起日终缴款确 认信息对账， 财政非税票据根据收到的日终确认信息， 对缴款书进行逐个核对与缴款确认处理， 以保障数据的一致性； DB36/T 10962018 10 c) 在统一支付平台日终结算数据对账成功后，政务服务系统（非税支付）向统一支付平台发起结 算单查询，统一支付平台在收到请求时，根据结算的情况返回结算单数据，以实现政务服务系 统（非税支付）能够对每笔缴款书进行缴款确认，以保证双方交易数据的一致性。 d) 代收机构根据日终结算的结算资金划转至指定账户后， 将所产生的资金入账流水信息提供给统 一支付平台，统一支付平台将根据该入账流水信息进行资金到账处理； e) 统一支付平台在资金到账处理成功后， 统一支付平台向财政厅非税系统发起日终缴款资金到账 对账， 非税系统根据收到的日终资金到账对账进行资金到账处理， 以保证资金流与数据流一致 性，方可实现后续资金清分处理。 代收机构 非税系统 统一支付平台 政务服务系统 (非税支付) 图9 日终对账流程 DB36/T 10962018 11 附 录 A （规范性附录） 系统接口说明 A.1 统一支付平台接口规范 A.1.1 本接口规范中所有服务接口的数据交互方式，均采用 HTTP 协议，并以 POST 请求方式提交。 且请求数据与返回数据均使用JSON格式。 A.1.2 统一支付平台接口规范内容见表A.1。 表A.1 统一支付平台接口规范表 说明 本表格定义所有接口中的通用请求报文与返回报文格式 接口地址 本规范中所有接口使用同一个接口地址： http:/IP 地址:端口/JNS/jns/entpaybusmgr/uniformResAllocation.do 请求参数 参数名 参数说明 类型定义 强制 签名 参数 备注 merapp 接入标识符 Str(30) 是 是 由统一支付平台提供 version 接口版本号 Str(10) 是 是 由统一支付平台提供 device 终端类型 Str(10) 是 是 终端设备类型；1：桌面电脑 ， 2：手机，3：自助机 tranName 交易名称 Str(100) 是 是 由统一支付平台提供 reqData 请求数据 Str 不限定 是 是 请求数据报文使用 JSON 格 式 并采用 base64 编码 sign 签名 Str 不限定 是 否 RSA 签名，详见附录 B 缴款 流程示例 charset 字符集 Str(10) 否 否 默认： UTF-8;请求参数的编码字 符集，仅支持 UTF-8/GBK 返回参数 参数名 参数说明 类型定义 强制 签名 参数 说明 respCode 响应码 Str(10) 是 是 000：响应成功 999：响应失败 respData 响应数据 Str(不限) 是 是 响应数据报文使用 JSON 格式并采 用 base64 编码 sign 签名 Str 不限定 是 否 RSA 签名，详见 附录 B 缴款流 程示例 DB36/T 10962018 12 表 A.1 统一支付平台接口规范表（续） charset 字符集 Str(10) 否 否 默认：UTF-8;请求参数的编 码字符集，仅支持 UTF-8/GBK A.2 统一支付平台接口说明 A.2.1 缴款请求接口(政务服务系统统一支付平台) 统一支付平台缴款请求接口说明见表A.2。 表A.2 缴款请求接口说明表 接口说明 缴款人在政务服务系统中填写完相关业务资料，确认无误后，政务服务系统生成相应的缴款信息，调用缴 款请求接口，统一支付平台将返回支付页面给缴款人。 交易名称 payOrder 请求数据 参数名 参数说明 类型定义 强 制 说明 appName 应用名称 Str(30) 是 由统一支付平台提供 appVersion 应用版本 Str(15) 是 由统一支付平台提供 ordNo 订单号 Str(30) 是 本商户必须唯一 ordDate 订单日期 Str(8) 是 格式：yyyyMMdd amount 订单总金额 NUMBER(16, 2) 是 格式：0.00 redirectUrl 跳转地址 Str(200) 否 页面跳转地址 notifyUrl 通知地址 Str(200) 否 服务通知地址 quantity 子订单数量 NUMBER(16, 0) 是 commpara 通用参数 Str(200) 否 统一支付平台不做处理， 当缴费成功 后，在支付 结果通知时， 以通知参数 转发给政务服务系统 payerName 付款人 Str(80) 是 phone 付款人手机号 Str(11) 是 remark1 备注 1 Str(200) 否 remark2 备注 2 Str(200) 否 remark3 备注 3 Str(200) 否 feeData (缴款 信息) payCode 缴款识别码 Str(不限) 是 JSON 格式 eBillCode 电子票据类型 Str(32) 是 同一订单业务缴款明细唯 一 orgUnicode 单位唯一码 Str(30) 是 sum 金额合计 NUMBER(16, 2) 是 payMan 缴款人 Str(200) 否 未指定缴款人时， 为 付 款人(payerName) note1 备注 1 Str(200) 否 note2 备注 2 Str(200) 否 chrgDetail （收入明细 项目） itemUnicode 收入项目码 Str(15) 是 unit 计量单位 Str(20) 是 standard 执收标准 NUMBER(16, 2) 是 DB36/T 10962018 13 表 A.2 缴款请求接口说明表（续） amount 执收数量 NUMBER(16, 0) 是 payment 执收金额 NUMBER(16, 2) 是 请求时间 reqTime Str(17) 是 格式：yyyyMMddHHmmss 返回 数据 参数名 参数说明 类型定义 强 制 说明 code 处理码 Str(10) 是 000：处理正常，其他为处 理失败 message 处理详情信息 Str(200) 是 requrl 请求 url Str(100) 否 code=000 时，必有值，支 付跳转的 html5 的 url A.2.2 交易结果页面跳转接口(统一支付平台政务服务系统) 统一支付平台交易结果页面跳转接口说明见表A.3。 表A.3 交易结果页面跳转接口说明表 接口说明 支付成功后，统一支付平台生成支付结果信息，以页面跳转的方式，将支付结果信息用 URL 参数，跳转 政务服务系统的页面（页面 url 由缴款请求接口中跳转地址 (redirectUrl)参数指定，若未指定则从该商户 的基础配置信息中获取跳转地址） 以便于政务服务系统可以做下一步处理。 交易名称 notifyOrder 服务地址 服务地址均采用缴款请求接口的参数地址优先，商户配置信息次之的处理方式；即，若缴款请求时，如果 未填写跳转地址(redirectUrl)， 则从该商户的基础配置信息中获取跳转地址， 否则直接使用跳转地址进行页 面跳转。 请求数据 参数名 参数说明 类型定义 强 制 说明 ordNo 订单号 Str(20) 是 ordDate 订单日期 Str(8) 是 格式为：yyyyMMdd amount 订单总金额 NUMBER(16,2) 是 格式：0.00 tranStatus 交易状态 Str(1) 是 1：交易成功 platformNo 平台流水号 Str(30) 是 tranBankNo 交易流水号 Str(30) 是 tranDate 交易日期 Str(8) 是 格式为：yyyyMMdd tranTime 交易时间 Str(6) 是 格式为：HHmmss commpara 通用参数 Str(200) 否 返回数据 参数名 参数说明 类型定义 强 制 说明 ordNo 订单号 Str(20) 是 oprStatus 处理状态 Str(1) 是 1：处理成功，0：处理失败 DB36/T 10962018 14 A.2.3 交易结果服务通知接口(统一支付平台政务服务系统) 统一支付平台交易结果服务通知接口说明见表A.4。 表A.4 交易结果服务通知接口说明表 接口说明 支付成功后，统一支付平台生成支付结果信息，以页面跳转的方式，将支付结果信息用 URL 参 数，跳转政务服务系统的页面（页面 url 由缴款请求接口中跳转地址 (redirectUrl)参数指定，若未 指定则从该商户的基础配置信息中获取跳转地址） ， 以便于政务服务系统可以做下一步处理。 交易名称 notifyOrder 服务地址 服务地址均采用缴款请求接口的参数地址优先，商户配置信息次之的处理方式；即，若缴款请求 时，如果未填写跳转地址(redirectUrl)，则从该商户的基础配 置信息中获取跳转地址，否则直接使 用跳转地址进行页面跳转。 业务约束 交易结果通知可能会有多次同时通知政务服务系统，政务服务系统须加约束以避免重复处理；政 务服务系统应在收到通知时，须将处理结果反馈给统一支付平台；如果统一支付平台未收到政务 服务系统反馈信息，将在 24 小时内进行多次通知。 交易成功后，统一支付平台使用相同的平台流水号进行交易结果通知时，政务服务系统须按幂等 处理方式对交易结果进行处理与反馈。 请求数据 参数名 参数说明 类型定义 强 制 说明 ordNo 订单号 Str(20) 是 ordDate 订单日期 Str(8) 是 格式为：yyyyMMdd amount 订单总金额 NUMBER(16,2) 是 格式：0.00 tranStatus 交易状态 Str(1) 是 1：交易成功 platformNo 平台流水号 Str(30) 是 tranBankNo 交易流水号 Str(30) 是 tranDate 交易日期 Str(8) 是 格式为：yyyyMMdd tranTime 交易时间 Str(6) 是 格式为：HHmmss commpara 通用参数 Str(200) 否 返回数据 参数名 参数说明 类型定义 强 制 说明 ordNo 订单号 Str(20) 是 oprStatus 处理状态 Str(1) 是 1:处理成功，0:处理失败 DB36/T 10962018 15 A.2.4 缴款订单交易结果查询接口(政务服务系统统一支付平台) 统一支付平台缴款订单交易结果查询接口说明见表A.5。 表A.5 缴款订单交易结果查询接口说明表 接口说明 当订单完成后，业务系统可依据此接口查询指定缴款订单的当前实时交易结果情况。 交易名称 qryPayOrder 请求数据 参数名 参数说明 类型定义 强 制 说明 ordNo 订单号 Str(20) 是 ordDate 订单日期 Str(8) 是 格式为：yyyyMMdd 返回数据 参数名 参数说明 类型定义 强 制 说明 ordNo 订单号 Str(20) 是 ordDate 订单日期 Str(8) 是 格式为：yyyyMMdd amount 订单总金额 NUMBER(16,2) 是 格式：0.00 tranStatus 交易状态 Str(1) 是 1：交易成功，2：交易 失败 ，3:待确认 platformNo 平台流水号 Str(30) 是 tranBankNo 交易流水号 Str(30) 否 tranDate 交易日期 Str(8) 否 格式为：yyyyMMdd tranTime 交易时间 Str(6) 否 格式为：HHmmss commpara 通用参数 Str(200) 否 DB36/T 10962018 16 A.2.5 缴款订单结算单查询接口(政务服务系统统一支付平台) 统一支付平台缴款订单结算单查询接口说明见表A.6。 表A.6 缴款订单结算单查询接口说明表 接口说明 查询指定范围内的所有缴款订单结算数据的明细列表情况，基于政务服务系统与统一支付平台中 的缴款订单的交易结果数据须是一致的前提下，政务服务系统须在日终后通过缴款订单结算单查 询接口，从统一支付平台批量下载缴款结算明细，以逐笔核对数据。 交易名称 listStlOrder 请求数据 参数名 参数说明 类型定义 强 制 说明 stlDate 结算日期 Str(8) 是 格式：yyyyMMdd pageNo 页码 NUMBER(4) 是 记录的第几页数据，从 1 开始 pageSize 每页记录数 NUMBER(4) 是 每页记录数取值范围 1000,5000 返回数据 参数名