DB14-T 2543-2022 政府非税网上支付平台第三方接入接口规范

ICS35.080CCSL7714IDB14/T2543—2022前言 2规范性引用文件 3术语和定义 4缩略语 5基本要求 26接口组成 3参考文献 DB14/T2543—2022本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件由山西省财政厅提出、组织实施和监督检查。本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由山西省财政标准化技术委员会(SXS/TC48)归口。本文件起草单位：山西省财政科学研究院、山西宝佳质量基础研究院。本文件主要起草人：韩慧彦、李林骏、张宝林、任巍英、王永、魏笑甜。1DB14/T2543—2022政府非税网上支付平台第三方接入接口规范本文件规定了政府非税网上支付平台第三方接入接口的术语和定义、缩略语、基本要求和接口组成。本文件适用于政府非税网上支付平台第三方接入接口的设计、开发和应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。IETFRFC3629UTF-8,ISO10646转换格式（UTF-8,atransformationformatofISO10646）3术语和定义下列术语和定义适用于本文件。3.1Base64Base64是一种基于64个可打印ASCII字符对任意字节数据进行编码的算法。3.2siteCode政府非税收入网上支付平台分配给第三方的接入编码。3.33DES三重数据加密算法，对每个数据块应用三次加密算法。3.4注册中心存储第三方IP地址和认证信息的服务。4缩略语下列缩略语适用于本文件。HTTP:超文本传输协议（HyperTextTransferProtocol）URL:统一资源定位符（UniformResourceLocator）2DB14/T2543—20225基本要求5.1接口协议接口协议统一采用HTTP协议。5.2数据结构5.2.1基本数据类型接口基本数据类型见表1。表1基本数据类型每一项均为一个子数据项，子数据项编码方式与父5.2.2数据编码方式应符合IETFRFC3629的规定。5.2.3数据交换格式应采用JSON传输数据。5.3接口调用地址应向政府非税网上支付平台获取接口调用地址及端口号。5.4安全策略5.4.1在政府非税网上支付平台与第三方互联过程中，应采取必要的通信安全措施，采用TLS.IP验证、数字签名、用户身份验证等方法。5.4.2应采用Base64加密解密保证数据在传输过程中的机密性。5.4.3宜使用3DES、MD5及以上算法，保证数据在传输过程中的完整性。5.4.4验证和授权通过以下两种方式进行：——确保相互访问的地址是可信任的，相关证书通过数字签名进行验证；3DB14/T2543—2022——IP验证仅为初步验证请求来源的合法性方法。应将第三方的IP及相关认证信息存储至注册中心，政府非税网上支付平台在收到请求时，将请求的IP和系统认证信息及注册中心进行对比，确认请求源的合法性。5.4.5政府非税网上支付平台应通过请求频率和请求配额对单一请求方进行限制。5.4.6应通过数字签名校验保证数据不被篡改。6接口组成6.1接口列表政府非税网上支付平台第三方接入应支持的接口见表2。表2接口列表本接口用于生成非税收入缴款书，同时生成统一缴款本接口用于对已经开具的缴款书进行作废（缴款书本接口用于对已缴款的缴款书进行退付申请（缴款书本接口用于对已提交缴款书退付申请进行终止（缴款书必须是已缴款状态并且已提6.2缴款书开具接口缴款书开具接口见表3。表3缴款书开具接口http://ip:port/api/issuePa4DB14/T2543—2022表3缴款书开具接口（续）是是否是否是是是是是是否是是否否是是是是是是5DB14/T2543—20226.3缴款书状态查询接口缴款书状态查询接口见表4。表4缴款书状态查询接口http://ip:port/api/queryPaymentS是是是是否是否否是否是是6.4缴款书作废接口缴款书作废接口见表5。6DB14/T2543—2022表5缴款书作废接口http://ip:port/api/invalidPa是是是是是是是是6.5退付申请接口退付申请接口见表6。表6退付申请接口http://ip:port/api/applyR是是是是是7DB14/T2543—2022表6退付申请接口（续）是否否否否是是是是6.6退付申请终止接口退付申请终止接口见表7。表7退付申请终止接口http://ip:port/api/stopR是是是是是8DB14/T2543—2022表7退付申请终止接口（续）是是是是6.7缴款书明细查询接口缴款书明细查询接口见表8。表8缴款书明细查询接口http://ip:port/api/queryPaymen是是是是是是是是否否否9DB14/T2543—20226.8电子票据信息接口电子票据信息接口见表9。表9电子票据信息接口http://ip:port/api/getElectroni是是否是是6.9单位可用收费项目接口单位可用收费项目接口见表10。表10单位可用收费项目接口http://ip:port/api/queryCharge是是是否否否DB14/T2543—20226.10跳转支付页面接口跳转支付页面接口见表11。表11跳转支付页面接口http://ip:port/api/go是是否是是是6.11生成支付二维码接口生成支付二维码接口见表12。表12生成支付二维码接口http://ip:port/api/getPayQ是是是是DB14/T2543—2022表12生成支付二维码接口（续）是是6.12缴款书支付结果异步通知接口缴款书支付结果异步通知接口见表13。表13