惠农财政补贴资金“一卡通”服务平台与代发银行接口规范.docxVIP

惠农财政补贴资金“一卡通”服务平台与代发银行接口规范.docx

  1. 1、本文档共24页,可阅读全部内容。
  2. 2、有哪些信誉好的足球投注网站(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
  3. 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载
  4. 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
  5. 5、该文档为VIP文档,如果想要下载,成为VIP会员后,下载免费。
  6. 6、成为VIP后,下载本文档将扣除1次下载权益。下载后,不支持退款、换文档。如有疑问请联系我们
  7. 7、成为VIP后,您将拥有八大权益,权益包括:VIP文档下载权益、阅读免打扰、文档格式转换、高级专利检索、专属身份标志、高级客服、多端互通、版权登记。
  8. 8、VIP文档为合作方或网友上传,每下载1次, 网站将根据用户上传文档的质量评分、类型等,对文档贡献者给予高额补贴、流量扶持。如果你也想贡献VIP文档。上传文档
查看更多

1

惠民惠农财政补贴资金一卡通服务平台与代发银行接口规范

1范围

本文件规定了惠民惠农财政补贴资金“一卡通”服务平台(以下简称“一卡通平台”)与代发银行接口类型、接口调用、接口要求和安全要求。

本文件适用于代发银行接入一卡通平台的设计、开发和应用。

2规范性引用文

本文件没有规范性引用文件。

3术语和定义

3.1下列术语和定义适用于本文件。

代发银行

省、市、县(市、区)区域内,依法设置的各项财政补贴资金委托代发银行。

4接口类型

一卡通平台与代发银行接口包括BT001身份登录接口、YH008单笔银行账号验证接口、YH010批量银行账号验证接口、BT009银行账号验证结果接收接口、YH005补贴明细接收接口、BT006上卡结果接收接口、YH011查询银行工作状态接口、YH012获取银行回盘文件接口。

5接口调用

一卡通平台与代发银行使用各数据接口,经过身份认证、信息验证、补贴发放、银行状态查询、获取银行回盘文件五个步骤实现惠民惠农财政补贴资金的发放,各接口调用方式如图1所示,各阶段接口调用方式如下:

——身份认证:银行调用一卡通平台建设的“BT001身份登录接口”进行身份认证,认证通过后完成后续阶段业务;

——信息验证:一卡通平台调用银行建设的“YH008单笔银行账号验证接口”推送单笔银行账号信息,银行验证准确性后同步返回验证结果;一卡通平台调用银行建设的“YH010批量银行账号验证接口”推送批量银行账号信息,银行验证准确性后,调用一卡通平台建设的“BT009银行账号验证结果接收接口”返回验证结果;

——补贴发放:一卡通平台调用银行建设的“YH005补贴明细接收接口”推送补贴对象明细信息,银行发放结束后,调用一卡通平台建设的“BT006上卡结果接收接口”返回发放结果;

——银行状态查询:一卡通平台推送成功至银行后,调用”YH011银行状态查询接口”,查询某批次账号验证或补贴发放状态;

——获取银行回盘

文件:当一卡通平台网络出现问题,银行未能成功生成回盘详情文件时,一卡

2

通平台调用“YH012获取银行回盘文件接口”,令银行再次生成回盘详情文件,并读取详情文件更新数据。

图1接口调用方式

6接口描述

6.1通用要求

6.1.1数据类型

接口数据类型如表1所示。

表1数据类型

类型名

类型描述

类型约束

数值类型

number

数值

字符串类型

string

字符串

6.1.2数据格式

接口采用JSON数据格式。

3

6.1.3消息结构

组成

由消息头和消息体组成。消息头格式如表2所示;消息体由head与data组成,head包含唯一标识、日期、银行联行号等通用字段,如表3所示,data对应不同接口功能性字段,详见本章各接口请求参数。

表2消息头格式

键名称

说明

Authorization

jwt身份验证token

表3消息体head格式

参数名称

数据类型

可选/必选

说明

id

string

必选

接口类型标识

uuid

string

必选

批次号(32位uuid)

callDate

string

必选

调用日期

callTime

string

必选

调用时间

callUser

string

必选

调用人

areaCode

string

必选

区域编码(12位)

bankNo

string

必选

银行联行号(12位)

返回消息码

.1数据返回编码如表4所示。

表4数据返回编码表

数据返回编码

返回说明

备注

002

户名不符

003

账户信息不正确

004

卡冻结

005

卡注销

006

卡休眠

007

卡挂失

008

卡挂失

009

其他原因

010

文件异常

文件读取解析错误

.2接口调用返回编码如表5所示。

表5接口调用返回编码表

接口调用返回编码

返回说明

备注

200

处理成功

OK

4

表5接口调用返回编码表(续)

202

服务端请求失败

Accepted

204

服务器已接收请求,但尚未处理

NoContent

400

协议或者参数非法

BadRequest

401

签名验证失败

Unauthorized

403

权限异常

Forbidden

404

请求的资源不存在

NotFound

429

请求超过频率限制

TooManyRequests

500

系统错误

ServerError

502

服务下线,暂时不可用

BadGateway

503

服务不可用,过载保护

ServiceUnavailable

900

请求参数不符合业务要求

-

901

返回参数

文档评论(0)

法律咨询 + 关注
实名认证
服务提供商

法律职业资格证、中级金融资格证持证人

法律咨询服务,专业法律知识解答和服务。

版权声明书
用户编号:8027066055000030
领域认证该用户于2023年04月14日上传了法律职业资格证、中级金融资格证

1亿VIP精品文档

相关文档