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