标准名称江西省人民政府.docx
- 文档编号:10481783
- 上传时间:2023-02-13
- 格式:DOCX
- 页数:48
- 大小:391.68KB
标准名称江西省人民政府.docx
《标准名称江西省人民政府.docx》由会员分享,可在线阅读,更多相关《标准名称江西省人民政府.docx(48页珍藏版)》请在冰豆网上搜索。
标准名称江西省人民政府
ICS35.200
L65
DB36
江西省地方标准
DB36/TXXXX—XXXX
统一支付对接平台对接规范
UnifiedPaymentDockingPlatformDockingSpecification
forGovernmentServicePortal
XXXXX发布
XXXXXXX实施
江西省质量技术监督局发布
目 录
目 录I
前 言III
引 言IV
统一支付对接平台对接规范5
1范围5
2规范性引用文件5
3术语5
4统一支付对接平台系统7
5业务流程10
附 录 A系统接口说明15
1统一支付对接平台接口规范15
2统一支付对接平台接口说明-商户模式16
3统一支付对接平台接口说明–非税业务模式27
附 录 B签名机制36
1流程描述36
2示例36
3签名36
附 录 CJSON说明40
附 录 D响应失败数据34
附 录 E缴款渠道一览表35
前 言
本标准按照GB/T1.1-2009《标准化工作导则第1部分:
标准的结构和编写》的规定编写。
本标准由江西省发展和改革委员会提出并归口。
本标准主要起草单位:
江西省信息中心。
本标准主要起草人:
金俊平、吴俐、孙杨、李新华、黄振、王云翔、侯文刚、胡坚勇、龚松、占晓华。
引 言
根据《江西省人民政府办公厅关于在全省推行“三单一网”工作的通知》(赣府厅字〔2015〕10号)、《江西省人民政府办公厅关于转发省发改委江西省网上审批系统建设工作方案的通知》(赣府厅发〔2014〕28号)要求,为进一步明确全省政务服务网项目建设工作,科学、规范地指导全省各市、县(区)政务服务网分厅及相关系统建设,特制定此规范。
本规范是规定了江西政务服务网市、县(区)政务服务网分厅对接江西省政务服务统一支付对接平台要求和数据接口标准规范。
统一支付对接平台对接规范
范围
本标准规定了江西省政务服务统一支付对接平台(以下简称统一支付平台)建设技术标准编制的基本原则、标准体系、标准制(修)定、持续改进与推广应用的要求。
本标准适用于指导各级(市、县区)政务服务系统建设工作的规划、制定、修订、应用与管理等工作。
规范性引用文件
下列文件对于本文件的应用是必不可少的。
分时注明日期的引用文件,仅注明日期的版本适用于本文件。
凡是不注明日期的引用文件,其最新版本适用于本文件。
《“互联网+政务服务”技术体系建设指南》(国办函〔2016〕108号)
术语
下列术语和定义适用于本文件。
UTF-8
UNICODE的一种变长字符编码,又称万国码,用在网页上可以在同一页面显示中文简体、繁体及其它语言(如日文、韩文)。
XMLSchema
文件描述了XML文档的结构,它的作用是定义一份XML文档的合法组件群。
StructuralData
即行数据,存储在数据库里,可以用二维表结构来逻辑表达实现的数据。
UnstructuralData
不方便用数据库二维逻辑表来表现的数据称为非结构化数据,包括所有格式的办公文档、文本、图片、XML、HTML、各类报表、图像和音频/视频信息等等。
WebService
又称XMLWebService,WebService是一种可以接收从Internet或者Internet上的其它系统中传递过来的请求,轻量级的独立的通讯技术。
即通过SOAP在Web上提供的软件服务,使用WSDL文件进行说明,并通过UDDI进行注册。
XML
扩展型可标记语言,面向短期的临时数据处理、面向万维网络,是SOAP的基础。
WSDL
全称WebServicesDescriptionLanguage,WSDL文件是一个XML文档,用于说明一组SOAP消息以及如何交换这些消息,大多数情况下由软件自动生成和使用。
REST
REST描述了一个架构样式的互联系统(如Web应用程序)。
REST约束条件作为一个整体应用时,将生成一个简单、可扩展、有效、安全、可靠的架构。
由于它简便、轻量级以及通过HTTP直接传输数据的特性,RESTFulWeb服务成为基于SOAP服务的一个最有前途的替代方案。
用于Web服务和动态Web应用程序的多层架构可以实现可重用性、简单性、可扩展性和组件可响应性的清晰分离。
统一支付对接平台系统
总体构架
江西省政务服务统一支付对接平台主要由设备接入层、前台交互层、支付交易层、后台管理层、辅助服务、客户服务、短信服务、信息数据层、基础设施层、统一安全保障体系和统一数据交换机制组成,全省集中式部署和存储,其总体框架如下图所示:
图1江西省政务服务统一支付对接平台逻辑架构图
服务组织结构
江西省政务服务统一支付对接平台主要用于支付交易、缴费配置管理、资金安全监控、数据分析等,按照系统建设目标规划,根据对江西省政务服务统一支付对接平台的业务和功能需求进行梳理和分析,结合未来业务的拓展需要,业务功能包括电子缴费统一网关、缴费人服务子系统、收款单位服务子系统、后台管理子系统、资金安全监控子系统、数据分析子系统、客户服务子系统等7大业务功能。
本系统规划功能结构如图1所示:
图2江西省政务服务统一支付对接平台系统架构
服务交互图
缴费平台和地方非税系统间,在交互财政非税收入收缴业务相关电子信息(电子凭证)时的服务交互流程如下,包括应用间的数据流、交互处理原则等
图3统一支付平台系统交互图
建设方式
本平台系统采用省级平台统一部署、地市级平台各组成系统对接省级平台的建设方式。
业务流程
商户模式
此模式中,商户系统指代面向缴款人提供业务服务,并使用订单作为数据基础与统一支付平台进行缴款数据交互的系统。
商户模式中,商户系统无法获取到每一笔订单的缴款书信息,只能获取到统一支付对接平台封装好的订单信息。
网上缴费业务流程
图4网上缴费业务流程
网上缴费流程步骤说明:
1)缴款人登录商户系统,选择要办理的业务;
2)缴款人填写相关业务材料信息,商户系统将自动生成缴款信息,缴款人确认缴款;
3)商户系统向支付平台发送缴款请求申请,支付平台对缴费信息进行验证;
4)支付平台对缴费信息验证通过后展示支付页面给缴款人,若验证不通过,返回错误信息页面并结束本流程;
5)缴款人选择支付方式、支付银行等,确认后;支付平台将调用银行网银系统,由缴款人在银行网银端完成支付;
6)缴款人支付完成后,支付平台将展示支付成功网页提示缴款人,缴款人可根据网页上的提示信息继续后续业务办理;
7)同时支付平台将在缴款人支付完成后通知商户系统交易结果;
8)商户系统在收到支付平台的交易结果通知时,应将交易处理结果的回执通知给支付平台。
日终对账
日终时,商户系统与支付平台必须进行流水核对,商户系统从支付平台下载缴费订单结算明细逐笔进行核对。
图5日终对账流程
流程说明:
(1)支付平台向代收机构发起日终结算数据对账查询请求,代收机构验证请求通过后,根据结算的情况返回相应的对账单数据,支付平台根据返回的对账单数据对缴款订单进行核对处理;
(2)支付平台与代收机构日终结算成功后,支付平台向财政非税票据系统发起日终缴款确认信息对账,财政非税票据根据收到的日终确认信息,对缴款书进行逐个核对与缴款确认处理,以保障数据的一致性;
(3)在支付平台日终结算数据对账成功后,业务系统向支付平台发起结算单查询,支付平台在收到请求时,根据结算的情况返回结算单数据,以实现业务系统能够对每笔缴款书进行缴款确认,以保证双方交易数据的一致性。
(4)代收机构根据日终结算的结算资金划转至指定账户后,将所产生的资金入账流水信息提供给支付平台,支付平台将根据该入账流水信息进行资金到账处理;
(5)支付平台在资金到账处理成功后,支付平台向财政非税票据系统发起日终缴款资金到账对账,财政非税票据根据收到的日终资金到账对账进行资金到账处理,以保证资金流与数据流一致性,方可实现后续资金清分处理。
(6)特别说明:
资金到账流水的流水号需与现有通知非税系统的流水号保持一致。
非税业务模式
非税业务模式主要面向于江西省“互联网+政务服务”平台系统,提供符合江西省财政厅文件《财政业务基础数据规范(2.0版)》的一整套流程化的支付交付服务。
网上缴费业务流程
图6网上缴费业务流程
网上缴费流程步骤说明:
1)缴款用户登录业务系统,选择要办理的业务;
2)在业务需缴款时,业务系统向支付平台发送申请开具电子缴款书,支付平台对缴费信息进行验证,通过验证后返回缴款书信息给业务系统;并由业务系统展现缴款信息供缴款用户查看;
3)缴款用户根据缴款书信息登录支付平台查看缴款书信息,待核对信息无误后,可申请网上缴款,缴款平台将根据用户的请求生成缴款订单信息并申请代收机构进行网上支付请求,缴款用户通过代收机构的交易系统操作完成支付交易处理;代收机构在收到交易成功结果后通知支付平台交易结果,由支付平台处理交易结果;
4)支付平台在处理交易结果成功后,支付平台将返回相应缴费成功提示;
5)同时支付平台将在缴款人支付完成后通知业务系统缴款书缴款结果;业务系统对交易结果信息进行数据处理。
日终对账
日终时,业务系统与支付平台必须进行流水核对,业务系统从支付平台下载缴费书结算明细逐笔进行核对。
请参考本文“6.1.2日终对账”。
附 录 A
系统接口说明
1 统一支付对接平台接口规范
1.1 数据交互协议
本接口规范中所有服务接口的数据交互方式,均采用HTTP协议,并以POST请求方式提交。
1.2 接口服务地址
请各单位向江西省信息中心申请接口服务的IP地址与端口。
根据IP地址与端口与特定字符串拼接后,江西省统一支付对接平台提供的接口服务地址如下:
http:
//IP地址:
端口/JNS/jns/entpaybusmgr/uniformResAllocation.do
1.3 请求报文规范
表1请求报文规范
参数中文名
参数名
类型定义
强制
签名
参数
说明
接入标识符
merapp
Str(MAX30)
是
是
由支付平台提供
接口版本号
version
Str(MAX10)
是
是
由支付平台提供
终端类型
device
Str(MAX10)
是
是
终端设备类型;
1:
桌面电脑2:
手机3:
自助机
交易名称
tranName
Str(MAX100)
是
是
由支付平台提供
请求数据
reqData
Str不限定
是
是
请求数据报文,json格式并采用base64编码,详见《附录CJSON说明》
签名
sign
Str不限定
是
否
RSA签名,详见《附录B签名机制》
字符集
charset
Str(MAX10)
否
否
默认:
UTF-8;请求参数的编码字符集,
仅支持UTF-8/GBK
1.4
返回格式规范
请求返回采用Json格式;
表2请求返回采用Json格式
属性中文名
属性名
类型定义
强制
签名
参数
说明
响应码
respCode
Str(MAX10)
是
是
000:
响应成功
999:
响应失败
响应数据
respData
Str(不限)
是
是
响应数据报文,json格式并采用base64编码,详见《附录CJSON说明》;其中,响应失败数据请查阅《附录D响应失败数据》
签名
sign
Str不限定
是
否
RSA签名,详见《附录B签名机制》
字符集
charset
Str(MAX10)
否
否
默认:
UTF-8;请求参数的编码字符集,
仅支持UTF-8/GBK
2 统一支付对接平台接口说明-商户模式
2.1 缴款请求接口(商户系统-->支付平台)
2.1.1 描述
缴款人在商户系统中填写完相关业务资料,确认无误后,商户系统生成相应的缴款信息,调用缴款请求接口,支付平台将返回支付页面给缴款人。
2.1.2 交易名称
缴款请求:
payOrder
2.1.3 请求数据(reqData)
表3请求数据
参数中文名
参数名
类型定义
强制
说明
应用名称
appName
Str(MAX30)
是
由支付平台提供
应用版本
appVersion
Str(MAX15)
是
由支付平台提供
订单号
ordNo
Str(MAX
30)
是
本商户必须唯一
订单日期
ordDate
Str(8)
是
格式:
yyyyMMdd
订单总金额
amount
NUMBER(16,2)
是
格式:
0.00
跳转地址
redirectUrl
Str(MAX
200)
否
页面跳转地址
通知地址
notifyUrl
Str(MAX
200)
否
服务通知地址
子订单数量
quantity
NUMBER(16,0)
是
通用参数
commpara
Str(MAX
200)
否
支付平台不做处理,当缴费成功后,在支付结果通知时,以通知参数转发给商户系统
付款人
payerName
Str(MAX
80)
是
付款人手机号
phone
Str(11)
是
备注1
remark1
Str(MAX
200)
否
备注2
remark2
Str(MAX
200)
否
备注3
remark3
Str(MAX
200)
否
缴款信息
feeData
Str(不限)
是
json格式
请求时间
reqTime
Str(MAX
17)
是
格式:
yyyyMMddHHmmss
缴款信息(feeData)参数说明:
(可具有多个缴款信息)
表4缴款信息
参数中文名
参数名
类型定义
强制
说明
缴款识别码
payCode
Str(MAX32)
是
同一订单业务缴款明细唯一
电子票据类型
eBillCode
Str(MAX30)
是
单位唯一码
orgUnicode
Str(MAX30)
是
金额合计
sum
NUMBER(16,2)
是
缴款人
payMan
Str(MAX200)
否
未指定缴款人时,为付款人(payerName)
备注1
note1
Str(MAX200)
否
备注2
note2
Str(MAX200)
否
收入明细项目
chrgDetail
Str(不限)
是
json格式
收入明细项目(chrgDetail)参数说明:
(可具有多个收入明细项)
表5收入明细项目
参数中文名
参数名
类型定义
强制
说明
收入项目码
itemUnicode
Str(max15)
是
计量单位
unit
Str(max20)
是
执收标准
standard
NUMBER(16,2)
是
执收数量
amount
NUMBER(16,0)
是
执收金额
payment
NUMBER(16,2)
是
2.1.4 接口返回
支付平台接收到支付请求后,根据终端设备类型(5.3请求报文规范),返回对应的数据形式。
共有“桌面电脑终端”,“手机终端”,“自助机终端”,“条码付终端”四种设备类型。
2.1.4.1 桌面电脑终端
发送桌面电脑终端订单请求数据后,跳转到PC电脑的网页版页面,返回数据:
表6桌面电脑终端
属性中文名
属性名
类型定义
强制
说明
处理码
code
Str(MAX10)
是
000:
处理正常其他为处理失败
处理详情信息
message
Str(MAX200)
是
请求url
requrl
Str(MAX100)
否
code=000时,必有值,支付跳转的html5的url
2.1.4.2
手机终端
发送手机终端订单请求数据后,跳转到手机终端的页面,手机终端返回数据(respData):
表7手机终端
属性中文名
属性名
类型定义
强制
说明
处理码
code
Str(MAX10)
是
000:
处理正常其他为处理失败
处理详情信息
message
Str(MAX200)
是
请求url
requrl
Str(MAX100)
否
code=000时,必有值,支付跳转的html5的url
注:
手机终端在请求支付时,在处理正常(code=000)的情况下,需根据返回的请求url(requrl)值,完成请求支付跳转的操作。
2.1.4.3 自助机终端
自助机终端返回数据(respData):
表8自助机终端
属性中文名
属性名
类型定义
强制
说明
处理码
code
Str(MAX10)
是
000:
处理正常
其他为处理失败
处理详情信息
message
Str(MAX200)
是
返回订单信息
ordData
Str(不限)
否
code=000时,必有值,Json对象
返回订单信息(ordData):
表9返回订单信息
属性中文名
属性名
类型定义
强制
说明
订单号
ordNo
Str(MAX20)
是
订单日期
ordDate
Str(8)
是
格式:
yyyyMMdd
订单时间
ordTime
Str(6)
是
格式:
HHmmss
平台流水号
platformNo
Str(MAX30)
是
订单总金额
amount
NUMBER(16,2)
是
缴款人
payMan
List
是
Json数组
支付渠道列表
payChannel
Str(不限)
否
Json对象列表
支付渠道(payChannel):
表10支付渠道
属性中文名
属性名
类型定义
强制
说明
渠道编码
channelCode
Str(MAX20)
是
渠道名称
channelName
Str(MAX80)
是
渠道描述
description
Str(MAX300)
否
2.1.4.4 条码付终端
条码付终端返回数据(respData):
表11条码付终端返回数据
属性中文名
属性名
类型定义
强制
说明
处理码
code
Str(MAX10)
是
000:
处理正常其他为处理失败
处理详情信息
message
Str(MAX200)
是
返回订单信息
ordData
Str(不限)
否
code=000时,必有值,Json对象
返回订单信息(ordData):
表12返回订单信息
属性中文名
属性名
类型定义
强制
说明
订单号
ordNo
Str(MAX20)
是
订单日期
ordDate
Str(8)
是
格式:
yyyyMMdd
订单时间
ordTime
Str(6)
是
格式:
HHmmss
平台流水号
platformNo
Str(MAX30)
是
订单总金额
amount
NUMBER(16,2)
是
缴款人列表
payMan
List
是
Json对象列表
支付渠道列表
payChannel
Str(不限)
否
Json对象列表
支付渠道(payChannel):
表13支付渠道
属性中文名
属性名
类型定义
强制
说明
渠道编码
channelCode
Str(MAX20)
是
渠道名称
channelName
Str(MAX80)
是
渠道描述
description
Str(MAX300)
否
2.2 条码支付接口(商户系统-->支付平台)
2.2.1 描述
条码支付为窗口工作人员使用扫码设备(如:
手持条码扫描枪、平台式扫描平台、二维码扫描器等)主动扫描缴款人的付款码,或手动输入缴款人付款码的方式进行支付扣款请求。
2.2.2 交易名称
条码支付:
reqCodePay。
2.2.3 请求数据(reqData)
表14请求数据
参数中文名
参数名
类型定义
强制
说明
订单号
ordNo
Str(MAX20)
是
订单日期
ordDate
Str(8)
是
格式为:
yyyyMMdd
平台流水号
platformNo
Str(MAX30)
是
渠道编码
channelCode
Str(MAX20)
是
付款码
payCode
Str(MAX128)
是
2.2.4
返回数据(respData)
表15返回数据
属性中文名
属性名
类型定义
强制
说明
订单号
ordNo
Str(MAX20)
是
订单日期
ordDate
Str(8)
是
格式为:
yyyyMMdd
订单总金额
amount
NUMBER(16,2)
是
格式:
0.00
交易状态
tranStatus
Str
(1)
是
1:
交易成功2:
交易失败3:
待确认
平台流水号
platformNo
Str(MAX30)
是
交易流水号
tranBankNo
Str(MAX30)
否
交易日期
tranDate
Str(MAX8)
否
格式为:
yyyyMMdd
交易时间
tranTime
Str(MAX6)
否
格式为:
HHmmss
通用参数
commpara
Str(MAX200)
否
2.3 交易结果页面跳转接口(支付平台-->商户系统)
2.3.1 描述
支付成功后,支付平台生成支付结果信息,以页面跳转的方式,将支付结果信息用URL参数,跳转商户系统的页面(页面url由缴款请求接口中跳转地址(redirectUrl)参数指定,若未指定则从该商户的基础配置信息中获取跳转地址),以便于商户系统可以做下一步处理。
2.3.2 交易名称
交易结果跳转服务:
notifyOrder
2.3.3 请求数据(reqData)
表16请求数据
参数中文名
参数名
类型定义
强制
说明
订单号
ordNo
Str(MAX20)
是
订单日期
ordDate
Str(8)
是
格式为:
yyyyMMdd
订单总金额
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 标准 名称 江西省 人民政府
![提示](https://static.bdocx.com/images/bang_tan.gif)