ICS35.200 CCSL70 14 山西省地方标准 DB14/T3024—2024 惠民惠农财政补贴资金"一卡通"服务平台 与代发银行接口规范 2024-05-29发布 2024-08-28实施 山西省市场监督管理局  发布DB14/T3024—2024 I目次 前言..................................................................................II 1范围................................................................................1 2规范性引用文件......................................................................1 3术语和定义..........................................................................1 4接口类型............................................................................1 5接口调用............................................................................2 6接口描述............................................................................3 7安全要求...........................................................................14DB14/T3024—2024 II前言 本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规 定起草。 本文件由山西省财政厅提出、组织实施和监督检查。 山西省市场监督管理局对标准的组织实施情况进行监督检查。 本文件由山西省财政标准化技术委员会（SXS/TC48）归口。 本文件起草单位：山西省财政科学研究院、山西宝佳质量基础研究院（有限合伙）。 本文件主要起草人：葛强、任巍英、张宝林、韩慧彦、李林骏、张素娥、董阿敏、徐维迪、李斌、 石鑫。 DB14/T3024—2024 1惠民惠农财政补贴资金"一卡通"服务平台与代发银行接口规范 1范围 本文件规定了惠民惠农财政补贴资金“一卡通”服务平台（以下简称“一卡通平台”）与代发银行 的接口类型、接口调用、接口描述和安全要求。 本文件适用于代发银行接入一卡通平台的设计、开发和应用。 2规范性引用文件 本文件没有规范性引用文件。 3术语和定义 下列术语和定义适用于本文件。 代发银行 省、市、县（市、区）区域内，依法设置的各项财政补贴资金委托代发银行。 4接口类型 一卡通平台与代发银行接口包括BT001身份登录接口、YH008单笔银行账号验证接口、YH010批量 银行账号验证接口、BT009银行账号验证结果接收接口、YH005补贴明细接收接口、BT006上卡结果接 收接口、YH011查询银行工作状态接口、YH012获取银行回盘文件接口，接口类型如表1所示。 表1接口类型 接口名称 类型描述 BT001身份登录接口该接口由一卡通平台建设，由代发银行调用，用于调用BT009与BT006接口前进行 身份验证 YH008单笔银行账号验证接口该接口由代发银行建设，由一卡通平台调用，用于接收来自一卡通平台的单笔银行 账号（账户名，证件号码，银行账号）信息，验证准确性后同步返回验证结果 YH010批量银行账号验证接口该接口由代发银行建设，由一卡通平台调用，用于接收来自一卡通平台的批量银行 账号信息，验证准确性后通过接口BT009返回验证结果 BT009银行账号验证结果接收接口该接口由一卡通平台建设，由代发银行调用，用于接收来自银行的银行账号异步返 回验证结果 YH005补贴明细接收接口 该接口由代发银行建设，由一卡通平台调用，传递银行上卡明细数据及汇总数据 DB14/T3024—2024 2表1接口类型（续） 接口名称 类型描述 BT006上卡结果接收接口 该接口由一卡通平台建设，由代发银行调用，用于接收代发银行上卡结果 YH011查询银行工作状态接口该接口由代发银行建设，由一卡通平台调用，用于获取银行方某批次验卡或发放状 态结果，返回结果应包含以下状态：未收到请求（默认），未开始验卡、验卡审批 中、验卡进行中、验卡结束；未启动发放、发放审批中、发放结束等 YH012获取银行回盘文件接口该接口由代发银行建设，由一卡通平台调用，用于一卡通平台主动向银行获取回盘 文件 5接口调用 一卡通平台与代发银行使用各数据接口，经过身份认证、信息验证、补贴发放、银行状态查询、获 取银行回盘文件五个步骤实现惠民惠农财政补贴资金的发放，各接口调用如附录A图A.1所示，各阶段 接口调用方式如下： ——身份认证：银行调用“BT001身份登录接口”进行身份认证，认证通过后完成后续阶段业务； ——信息验证：一卡通平台调用“YH008单笔银行账号验证接口”推送单笔银行账号信息，银行验 证准确性后同步返回验证结果；一卡通平台调用“YH010批量银行账号验证接口”推送批量银 行账号信息，银行验证准确性后，调用“BT009银行账号验证结果接收接口”返回验证结果； ——补贴发放：一卡通平台调用“YH005补贴明细接收接口”推送补贴对象明细信息，银行发放结 束后，调用“BT006上卡结果接收接口”返回发放结果； ——银行状态查询：一卡通平台推送成功至银行后，调用“YH011查询银行工作状态接口”，查询 某批次账号验证或补贴发放状态； ——获取银行回盘文件：当一卡通平台网络出现问题，银行未能成功生成回盘详情文件时，一卡 通平台调用“YH012获取银行回盘文件接口”，令银行再次生成回盘详情文件，并读取详情文 件更新数据。DB14/T3024—2024 3 图1接口调用方式 6接口描述 通用要求 6.1.1数据类型 接口参数数据类型包括数值型（number）和字符型（string）两种。 DB14/T3024—2024 46.1.2数据格式 接口之间数据传输采用JSON数据格式。 6.1.3消息结构 6.1.3.1组成 由消息头和消息体组成。消息头格式如表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位） 6.1.3.2返回消息码 6.1.3.2.1数据返回编码如表4所示。 表4数据返回编码表 数据返回编码 返回说明 备注 002 户名不符 - 003 账户信息不正确 - 004 卡冻结 - 005 卡注销 -