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

ICS35.200

CCSL70

14

山西省地方标准

DB14/T3024—2024

惠民惠农财政补贴资金"一卡通"服务平台

与代发银行接口规范

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

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

DB14/T3024—2024

目次

前言..................................................................................II

1范围................................................................................1

2规范性引用文件......................................................................1

3术语和定义..........................................................................1

4接口类型............................................................................1

5接口调用............................................................................2

6接口描述............................................................................3

7安全要求...........................................................................14

I

DB14/T3024—2024

前言

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

定起草。

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

山西省市场监督管理局对标准的组织实施情况进行监督检查。

本文件由山西省财政标准化技术委员会（SXS/TC48）归口。

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

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

石鑫。

II

DB14/T3024—2024

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

1范围

本文件规定了惠民惠农财政补贴资金“一卡通”服务平台（以下简称“一卡通平台”）与代发银行

的接口类型、接口调用、接口描述和安全要求。

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

2规范性引用文件

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

3术语和定义

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

代发银行

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

4接口类型

一卡通平台与代发银行接口包括BT001身份登录接口、YH008单笔银行账号验证接口、YH010批量

银行账号验证接口、BT009银行账号验证结果接收接口、YH005补贴明细接收接口、BT006上卡结果接

收接口、YH011查询银行工作状态接口、YH012获取银行回盘文件接口，接口类型如表1所示。

表1接口类型

接口名称类型描述

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

BT001身份登录接口

身份验证

该接口由代发银行建设，由一卡通平台调用，用于接收来自一卡通平台的单笔银行

YH008单笔银行账号验证接口

账号（账户名，证件号码，银行账号）信息，验证准确性后同步返回验证结果

该接口由代发银行建设，由一卡通平台调用，用于接收来自一卡通平台的批量银行

YH010批量银行账号验证接口

账号信息，验证准确性后通过接口BT009返回验证结果

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

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

回验证结果

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

1

DB14/T3024—2024

表1接口类型（续）

接口名称类型描述

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

该接口由代发银行建设，由一卡通平台调用，用于获取银行方某批次验卡或发放状

YH011查询银行工作状态接口态结果，返回结果应包含以下状态：未收到请求（默认），未开始验卡、验卡审批

中、验卡进行中、验卡结束；未启动发放、发放审批中、发放结束等

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

YH012获取银行回盘文件接口

文件

5接口调用

一卡通平台与代发银行使用各数据接口，经过身份认证、信息验证、补贴发放、银行状态查询、获

取银行回盘文件五个步骤实现惠民惠农财政补贴资金的发放，各接口调用如附录A图A.1所示，各阶段

接口调用方式如下：

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

——信息验证：一卡通平台调用“YH008单笔银行账号验证接口”推送单笔银行账号信息，银行验

证准确性后同步返回验证结果；一卡通平台调用“YH010批量银行账号验证接口”推送批量银

行账号信息，银行验证准确性后，调用“BT009银行账号验证结果接收接口”返回验证结果；

——补贴发放：一卡通平台调用“YH005补贴明细接收接口”推送补贴对象明细信息，银行发放结

束后，调用“BT006上卡结果接收接口”返回发放结果；

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

某批次账号验证或补贴发放状态；

——获取银行回盘文件：当一卡通平台网络出现问题，银行未能成功生成回盘详情文件时，一卡

通平台调用“YH012获取银行回盘文件接口”，令银行再次生成回盘详情文件，并读取详情文

件更新数据。

2

DB14/T3024—2024

图1接口调用方式

6接口描述

通用要求

6.1.1数据类型

接口参数数据类型包括数值型（number）和字符型（string）两种。

3

DB14/T3024—2024

6.1.2数据格式

接口之间数据传输采用JSON数据格式。

6.1.3消息结构

组成

由消息头和消息体组成。消息头格式如表2所示；消息体由head与data组成，head包含唯一标

识、日期、银行联行号等通用字段，如表3所示，data对应不同接口功能性字段，详见本章各接口请

求参数。

表2消息头格式

键名称说明

Authorizationjwt身份验证token

表3消息体head格式

参数名称数据类型可选/必选说明

idstring必选接口类型标识

uuidstring必选批次号（32位uuid）

callDatestring必选调用日期

callTimestring必选调用时间

callUserstring必选调用人

areaCodestring必选区域编码（12位）

bankNostring必选银行联行号（12位）

返回消息码

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

表4数据返回编码表

数据返回编码返回说明备注

002户名不符-

003账户信息不正确-

004卡冻结-

005卡注销-

4

DB14/T3024—2024

表4数据返回编码表（续）

006卡休眠-

007卡透支-

008卡挂失-

009其他原因-

010文件异常文件读取解析错误

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

表5接口调用返回编码表

接口调用返回编码返回说明备注

200处理成功OK

202已接受处理请求，但处理尚未完成Accepted

204服务器已接收请求，但尚未处理NoContent

400协议或者参数非法BadRequest

401签名验证失败Unauthorized

403权限异常Forbidden

404