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

ICS35.200

14CCSL70

14

山 西 省 地 方 标 准

DB14/T3024—2024

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

2024-05-29发布 2024-08-28实施

山西省市场监督管理局??发布

DB14/T3024

DB14/T3024—2024

DB14/T3024

DB14/T3024—2024

I

I

II

II

目 次

前言 II

范围 1

规范性引用文件 1

术语和定义 1

接口类型 1

接口调用 2

接口描述 3

安全要求 14

前 言

本文件按照GB/T1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定起草。

本文件由山西省财政厅提出、组织实施和监督检查。

山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由山西省财政标准化技术委员会（SXS/TC48）归口。

本文件起草单位：山西省财政科学研究院、山西宝佳质量基础研究院（有限合伙）。

本文件主要起草人：葛强、任巍英、张宝林、韩慧彦、李林骏、张素娥、董阿敏、徐维迪、李斌、石鑫。

DB14/T3024

DB14/T3024—2024

DB14/T3024

DB14/T3024—2024

PAGE

PAGE1

PAGE

PAGE10

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

范围

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

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

规范性引用文件

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

术语和定义

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

代发银行

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

接口类型

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

表1 接口类型

接口名称

类型描述

BT001身份登录接口

该接口由一卡通平台建设，由代发银行调用，用于调用BT009与BT006接口前进行身份验证

YH008单笔银行账号验证接口

该接口由代发银行建设，由一卡通平台调用，用于接收来自一卡通平台的单笔银行账号（账户名，证件号码，银行账号）信息，验证准确性后同步返回验证结果

YH010批量银行账号验证接口

该接口由代发银行建设，由一卡通平台调用，用于接收来自一卡通平台的批量银行账号信息，验证准确性后通过接口BT009返回验证结果

BT009银行账号验证结果接收接口

该接口由一卡通平台建设，由代发银行调用，用于接收来自银行的银行账号异步返回验证结果

YH005补贴明细接收接口

该接口由代发银行建设，由一卡通平台调用，传递银行上卡明细数据及汇总数据

表1 接口类型（续）

接口名称

类型描述

BT006上卡结果接收接口

该接口由一卡通平台建设，由代发银行调用，用于接收代发银行上卡结果

YH011查询银行工作状态接口

该接口由代发银行建设，由一卡通平台调用，用于获取银行方某批次验卡或发放状态结果，返回结果应包含以下状态：未收到请求（默认），未开始验卡、验卡审批中、验卡进行中、验卡结束；未启动发放、发放审批中、发放结束等

YH012获取银行回盘文件接口

该接口由代发银行建设，由一卡通平台调用，用于一卡通平台主动向银行获取回盘文件

接口调用

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

——身份认证：银行调用“BT001身份登录接口”进行身份认证，认证通过后完成后续阶段业务；

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

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

——银行状态查询：一卡通平台推送成功至银行后，调用“YH011查询银行工作状态接口