DB14_T 2543—2022政府非税网上支付平台第三方接入接口规范-(高清正版).pdf
《DB14_T 2543—2022政府非税网上支付平台第三方接入接口规范-(高清正版).pdf》由会员分享,可在线阅读,更多相关《DB14_T 2543—2022政府非税网上支付平台第三方接入接口规范-(高清正版).pdf(16页珍藏版)》请在咨信网上搜索。
1、ICS35.080CCS L 7714山西省地方标准DB 14/T 25432022政府非税网上支付平台第三方接入接口规范2022-09-02 发布2022-12-01 实施山西省市场监督管理局发 布DB 14/T 25432022I目次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.15基本要求.26接口组成.3参考文献.12DB 14/T 25432022II前言本文件按照GB/T 1.12020标准化工作导则第1部分:标准化文件的结构和起草规则的规定起草。本文件由山西省财政厅提出、组织实施和监督检查。本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由
2、山西省财政标准化技术委员会(SXS/TC48)归口。本文件起草单位:山西省财政科学研究院、山西宝佳质量基础研究院。本文件主要起草人:韩慧彦、李林骏、张宝林、任巍英、王永、魏笑甜。DB 14/T 254320221政府非税网上支付平台第三方接入接口规范1范围本文件规定了政府非税网上支付平台第三方接入接口的术语和定义、缩略语、基本要求和接口组成。本文件适用于政府非税网上支付平台第三方接入接口的设计、开发和应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用
3、于本文件。IETF RFC 3629UTF-8,ISO 10646 转换格式(UTF-8,a transformation format of ISO 10646)3术语和定义下列术语和定义适用于本文件。3.1Base64Base64 是一种基于 64 个可打印 ASCII 字符对任意字节数据进行编码的算法。3.2siteCode政府非税收入网上支付平台分配给第三方的接入编码。3.33DES三重数据加密算法,对每个数据块应用三次加密算法。3.4注册中心存储第三方 IP 地址和认证信息的服务。4缩略语下列缩略语适用于本文件。HTTP:超文本传输协议(Hyper Text Transfer Pro
4、tocol)URL:统一资源定位符(Uniform Resource Locator)DB 14/T 2543202225基本要求5.1接口协议接口协议统一采用 HTTP 协议。5.2数据结构5.2.1基本数据类型接口基本数据类型见表 1。表 1基本数据类型类型名类型名类型描述类型描述类型约束类型约束String文本字符串内容为所有的有效字符List列表类型每一项均为一个子数据项,子数据项编码方式与父数据项编码方式相同Date日期类型日期表示为:yyyy-MM-ddFloat浮点数类型内容为浮点数类型字符Int整数类型内容为整型字符File文件流类型内容为对文件的操作定义Boolean布尔类型
5、内容为 True 或 FalseTime时间类型时间表示为:yyyy-MM-dd HH:mm:ss5.2.2数据编码方式应符合 IETF RFC 3629 的规定。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验证和授权通
6、过以下两种方式进行:确保相互访问的地址是可信任的,相关证书通过数字签名进行验证;DB 14/T 254320223IP 验证仅为初步验证请求来源的合法性方法。应将第三方的 IP 及相关认证信息存储至注册中心,政府非税网上支付平台在收到请求时,将请求的 IP 和系统认证信息及注册中心进行对比,确认请求源的合法性。5.4.5政府非税网上支付平台应通过请求频率和请求配额对单一请求方进行限制。5.4.6应通过数字签名校验保证数据不被篡改。6接口组成6.1接口列表政府非税网上支付平台第三方接入应支持的接口见表 2。表 2接口列表接口名称接口名称接口描述接口描述缴款书开具接口本接口用于生成非税收入缴款书,
7、同时生成统一缴款识别码和项目识别码缴款书状态查询接口本接口用于查询非税收入缴款书信息缴款书作废接口本接口用于对已经开具的缴款书进行作废(缴款书必须是未缴款状态)退付申请接口本接口用于对已缴款的缴款书进行退付申请(缴款书必须是已缴款状态)退付申请终止接口本接口用于对已提交缴款书退付申请进行终止(缴款书必须是已缴款状态并且已提交退付申请)缴款书明细查询接口本接口用于查询本单位缴款书开具明细电子票据信息接口本接口用于自动生成电子票据单位可用收费项目接口本接口用于查询第三方接入单位可用的收费项目信息跳转支付页面接口本接口用于缴款书在线支付生成支付二维码接口本接口用于生成缴款书二维码缴款书支付结果异步通
8、知接口本接口用于缴款书支付成功后通知第三方6.2缴款书开具接口缴款书开具接口见表 3。表 3缴款书开具接口接口名称接口名称缴款书开具接口接口接口URLURLhttp:/ip:port/api/issuePayment接口请求方式接口请求方式post请求参数请求参数DB 14/T 254320224表3缴款书开具接口(续)参数代码参数代码参数名称参数名称数据类型数据类型长度长度是否必填是否必填说明说明guid业务idString50是唯一识别码billingDate开票日期String10是yyyy-MM-dd 格式expireDate截止有效期String10否yyyy-MM-dd 格式cha
9、rgeItemCount收费项目个数String10是summary摘要/备注String100否若单一收费项目中含有多项收费标准,需要在此字段详细解释说明,涉及电子发票此项必填totalAmount票据总金额String20是两位小数payerName付款人名称String100是payerType缴款人类型String20是个人/企业payerId缴款人号码String20是企业:统一社会信用代码个人:身份证号contacts联系人名称String50是contactNumber联系电话String20是email邮箱地址String30否entryUser录入人员String30是开具电
10、子发票需要entryTime录入时间String20是yyyy-MM-dd HH:mm:ss 格式auditUser审核人员String30否auditTime审核时间String20否yyyy-MM-dd HH:mm:ss 格式detailData收费项目明细String是响应参数响应参数参数代码参数代码参数名称参数名称数据类型数据类型长度长度是否必填是否必填说明说明guid业务idString50是接入系统单据唯一识别码orderId订单idString50是非税唯一的订单 idpaymentId缴款识别码String20是统一缴款识别码result处理结果String100是status
11、处理状态String10是0-成功其他-失败DB 14/T 2543202256.3缴款书状态查询接口缴款书状态查询接口见表 4。表 4缴款书状态查询接口接口名称接口名称缴款书状态查询接口接口接口URLURLhttp:/ip:port/api/queryPaymentStatus接口请求方式接口请求方式post请求参数请求参数参数代码参数代码参数名称参数名称数据类型数据类型长度长度是否必填是否必填说明说明paymentId缴款识别码String20是统一缴款识别码响应参数响应参数参数代码参数代码参数名称参数名称数据类型数据类型长度长度是否必填是否必填说明说明paymentId缴款识别码Stri
12、ng20是统一缴款识别码orderId订单idString50是非税唯一的订单 idaddTime通知书开具时间String20是yyyy-MM-dd HH:mm:ss 格auditTime通知书审核时间String20否yyyy-MM-dd HH:mm:ss 格式payStatus支付状态String10是10-未支付11-支付中20-已支付payTime支付时间String20否yyyy-MM-dd HH:mm:ss 格invalidTime作废时间String20否yyyy-MM-dd HH:mm:ss 格式payAmount支付金额String20是两位小数refundAmount已退
13、款金额String20否两位小数result处理结果String100是status处理状态String10是0-成功其他-失败6.4缴款书作废接口缴款书作废接口见表 5。DB 14/T 254320226表 5缴款书作废接口接口名称接口名称缴款书作废接口接口接口URLURLhttp:/ip:port/api/invalidPayment接口请求方式接口请求方式post请求参数请求参数参数代码参数代码参数名称参数名称数据类型数据类型长度长度是否必填是否必填说明说明paymentId缴款识别码String20是统一缴款识别码applyUser申请人员String30是applyTime申请时间S
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB14_T 25432022政府非税网上支付平台第三方接入接口规范-高清正版 2543 2022 政府 网上支付 平台 第三 接入 接口 规范 正版
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【Fis****915】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【Fis****915】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。