T/HBPFS 001.5-2022 雄安新区区块链支付平台 第5部分：数据服务规范

T/HBPFS001.5-2022

ICS号03.060

中国标准文献分类号A11

团体标准

T/HBPFS001.5-2022

雄安新区区块链支付平台

第5部分：数据服务规范

TheStandardofXiong’AnNewAreaBlockchainPaymentPlatform

Part5：DataServiceSpecifications

2022-12-27发布2022-12-27实施

河北省金融学会发布

T/HBPFS001.5-2022

目次

前言.......................................................................................................................................................III

引言.......................................................................................................................................................IV

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

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

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

3.1Restful..............................................................................................................................................1

3.2JSON................................................................................................................................................1

3.3TOKEN............................................................................................................................................1

3.4会话机制........................................................................................................................................1

3.5JWT..................................................................................................................................................1

3.6签名算法........................................................................................................................................2

3.7分布式账本....................................................................................................................................2

3.8对等网络........................................................................................................................................2

3.9区块链............................................................................................................................................2

3.10共识机制......................................................................................................................................2

3.11智能合约.......................................................................................................................................2

4数据服务................................................................................................................................................2

4.1区块链数据结构............................................................................................................................2

4.2区块链数据种类............................................................................................................................4

4.3区块链数据格式............................................................................................................................5

4.4接口规范概述..............................................................................................................................14

4.5数据查询......................................................................................................................................15

4.6数据推送......................................................................................................................................22

4.7数据下载......................................................................................................................................24

4.8事件订阅......................................................................................................................................25

I

T/HBPFS001.5-2022

II

T/HBPFS001.5-2022

前言

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

的规定起草。区块链支付信息服务是以区块链与智能合约技术为核心，通过业务流程触发形成支

付指令，并对接银行支付网关实现资金支付的一种创新性区块链应用。前期，为解决工程建设资

金管理场景中从业主体多、业务流程复杂、资金流向监管难等问题，雄安新区已基于上述区块链

支付信息服务模式研发应用了工程建设资金管理区块链平台，实现了工程建设资金从业主到总、

分包单位的及时、准确与高效拨付，具备按需支付、可信支付、穿透支付和无损支付等特点。根

据区块链支付信息服务模式与特点，我们认为该模式亦可在政府资金监管、多级供应链等多个复

杂企业支付场景进行应用，具备较好复制与推广应用前景。

为促进雄安新区区块链+支付模式应用，便于政府、银行和企业各方接入区块链支付平台并

规范相关接入规范与接口要求，特制定《雄安新区区块链支付平台》。本标准由以下6部分构成：

——第1部分：参考模型及流程规范，总体阐述区块链支付定义、业务参考模型、技术架

构和主要功能介绍；

——第2部分：银行接入规范，重点阐述银行接入区块链支付平台的接入方法与接口规范；

——第3部分：场景开发与接入规范，重点阐述客户通过开放场景接入区块链支付平台的

方法与接口规范；

——第4部分：安全与隐私规范，重点阐述区块链支付基础安全规范、数据安全与隐私规

范等内容；

——第5部分：数据服务规范，重点阐述区块链支付平台提供数据服务的方式、内容；

——第6部分：管理规范，重点阐述区块链支付平台基础管理、银行与客户准入、交易安

全与管理等基础管理规范。

本文件为该标准的第5部分

本文件负责起草单位：中国人民银行雄安新区营业管理部、雄安新区区块链实验室、中国工

商银行股份有限公司河北雄安分行、中国农业银行股份有限公司河北雄安分行、中国银行股份有

限公司河北雄安分行、中国建设银行股份有限公司河北雄安分行、中信银行股份有限公司河北雄

安分行、中国农业银行总行研发中心金融科技创新中心

本文件主要起草人：孟宏伟、赵天奕、高远、焦欣欣、王蒙、左爵希、宋正罡、穆文涛、唐

上淳、李亚科、王桐、楚会永、耿浩杰、康宁、胡园园、杨耀华、刘兰真、王婷

III

T/HBPFS001.5-2022

引言

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

的规定起草。区块链支付信息服务是以区块链与智能合约技术为核心，通过业务流程触发形成支

付指令，并对接银行支付网关实现资金支付的一种创新性区块链应用。前期，为解决工程建设资

金管理场景中从业主体多、业务流程复杂、资金流向监管难等问题，雄安新区已基于上述区块链

支付信息服务模式研发应用了工程建设资金管理区块链平台，实现了工程建设资金从业主到总、

分包单位的及时、准确与高效拨付，具备按需支付、可信支付、穿透支付和无损支付等特点。根

据区块链支付信息服务模式与特点，我们认为该模式亦可在政府资金监管、多级供应链等多个复

杂企业支付场景进行应用，具备较好复制与推广应用前景。

为促进雄安新区区块链+支付模式应用，便于政府、银行和企业各方接入区块链支付平台并

规范相关接入规范与接口要求，特制定《第5部分：数据服务规范》。

区块链支付的场景众多且比较复杂，不同机构、不同部门、不同业务之间的信息交换和信息

共享变的越来越频繁，统一交易流程模型及数据元可以有效加强银行、非金融支付机构等的互联

互通及信息共享，降低成本、提高效率。

考虑到区块链支付涉及面广且复杂以及银行和非金融支付服务组织的系统现状，本文件仅对

使用区块链支付提供相关的数据服务进行说明。

IV

T/HBPFS001.5-2022

雄安新区区块链支付平台

第5部分：数据服务规范

1范围

本文件描述了区块链支付提供的数据服务，帮助接入者了解并使用区块链支付提供的数据服

务能力。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引

用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修

改单）适用于本文件。

GB18030《信息技术中文编码字符集》

GB/T7408―2005《数据元和交换格式信息交换日期和时间表示法》

GB/T25069―2010《信息安全技术术语》

W3CUDDIv2《数据结构规范》

ITU-TF.751.0《分布式账本系统需求》

3术语和定义

3.1Restful

RESTFUL是一种网络应用程序的设计风格和开发方式，基于HTTP，可以使用XML格式定义或

JSON格式定义。RESTFUL适用于移动互联网厂商作为业务接口的场景，实现第三方OTT调用移动

网络资源的功能，动作类型为新增、变更、删除所调用资源。

3.2JSON

JSON(JavaScriptObjectNotation)是一种轻量级的数据交换格式。

3.3TOKEN

Token的意思是“令牌”，是服务端生成的一串字符串，作为客户端进行请求的一个标识。

3.4会话机制

每次请求响应完成后连接就断开了，下一次的请求需要重新连接，会话机制可以保存用户的

身份信息和行为信息。

3.5JWT

JWT的全称是JsonWebToken，是一种基于JSON的、用于在网络上声明某种主张的令牌(token)

1

T/HBPFS001.5-2022

规范。

3.6签名算法

对数据进行签名后，确保数据来源是经过认证的。

3.7分布式账本

在分布式节点间共享并使用共识机制实现的具有最终一致性的账本。

3.8对等网络

一种包含对控制和操作能力等效的节点计算机网络。

3.9区块链

一种由多方共同维护，使用密码学保证传输和访问安全的能够实现数据一致性、防篡改、防

抵赖的技术体系。

3.10共识机制

分布式账本系统体系中为保证各节点保持一致性的计算方法。

3.11智能合约

一种以信息化方式传播、验证或执行合同的计算机协议，在分布式账本上体现为按条件触发

的可自动执行的计算机程序。

4数据服务

4.1区块链数据结构

区块链支付平台提供了强大的支付、数据处理能力，通过开放平台以接口形式提供给场景

应用系统，节点或认证机构可依照数据服务规范在平台实现数据的多条件查询、数据下载、数据

推送和数据订阅服务。

节点或认证机构之间可根据业务场景不同，自行约定隐私数据，本规范只以与支付相关的基

础数据进行说明。

节点或认证机构访问区块链支付平台的数据，建议采用证书、白名单等认证体系，确保数据

访问的安全性。

2

T/HBPFS001.5-2022

图1：接口调用模型示意图

3

T/HBPFS001.5-2022

图2：接口服务描述图

4.2区块链数据种类

1）数据种类

区块链相关的数据种类包括区块、事务、实体、合约、账户、配置数据六类，如下图所示。

4

T/HBPFS001.5-2022

图3：数据种类示意图

2）区块数据

区块指一段给定时间内发生的事务处理会被编组成的数据结构。通常情况下，区块由区块头

和区块体组成。区块头包含区块相关的控制信息，区块体包含具体的事务数据。

3）实体数据

实体是事务的一些具体属性，包括发起方地址、接收方地址、存储数据和实体数据备注。

4）合约数据

合约又称智能合约，是一套以计算机代码形式定义的承诺，以及合约参与方可执行承诺的协

议，即：用计算机代码形式编写合约参与方达成的条件型协议，当条件被触发时区块链系统自动

执行该协议。根据应用场景的不同需求，区块链系统可有选择性地提供智能合约功能。

5）事务数据

事务指区块链系统上承载的具体业务动作，事务既包括涉及数字资产的交易类型事务，也包

括其他非交易类型事务。

6）账户数据

账户是区块链事务的实际发起者和相关方，区块中记录的事务信息均被关联到相关的账户之

上。每个区块链服务客户必须拥有一个或多个账户来使用区块链服务。

7）配置数据

配置数据指区块链系统正常运行过程中所需的配置信息，包括共识协议版本号、软件版本号

和网络通信底层对等节点配置信息等。

4.3区块链数据格式

1）账户数据

账户公钥

表格1

属

内容

性

类

字符串

型

长

定长，推荐64字节

度

5

T/HBPFS001.5-2022

说

为用户生成的密钥对里，可公开的部分

明

备

必选

注

账户私钥

表格2

属

内容

性

类

字符串

型

长

定长，推荐32字节

度

说

为用户生成的密钥对里，不公开的部分

明

备

必选

注

数字证书

表格3

属

内容

性

类

数组

型

长

不定长

度

数字证书是一个经证书授权中心数字签名的

说

包含公开密

明

钥拥有者信息以及公开密钥的文件

备

可选

注

账户所属机构

表格4

属

内容

性

类

数组

型

长

不定长

度

机构为加入到区块链网络的、独立运作的成

说

员，可以为

明

企业、组织、团体等，账户可以在组织关系上

6

T/HBPFS001.5-2022

归属于某

个机构

备

可选

注

2）配置数据

协议版本号

表格5

属

内容

性

类

字符串

型

长

不定长

度

针对区块链节点之间以及外部应用和区块链

说

节点通信，

明

交互的协议，使用版本号标识不同的协议版本

区块链协议可以随着软件版本升级，具备不同

的接口、

功能，一般区块链软件应在协议层面向下兼

备

容，采用协

注

议版本号进行区分，一套软件可以对使用不同

的协议的

各种客户端提供服务。可选

软件版本号

表格6

属

内容

性

类

字符串

型

长

不定长

度

说针对区块链软件本身,含代码和二进制软件形态,使

明用版本号标识不同的发行版本

区块链软件可以针对不同的软件生命周期，以

备及不同的

注应用场景，不同的目标用户，采用不同的版本。

必选

节点标识

表格7

属内容

7

T/HBPFS001.5-2022

性

类

字符串

型

长

不定长

度

说区块链节点的唯一标识，可选用节点的公钥做

明为唯一标识

备

必选

注

节点地址

表格8

属

内容

性

类

字符串

型

长

按照IPv6定义长度

度

说

区块链网络节点的IP地址

明

备

必选

注

节点公钥

表格9

属

内容

性

类

字符串

型

长

定长

度

说

区块链网络节点的公钥信息

明

备

可选

注

3）区块数据

区块高度

表格10

属

内容

性

类

整数

型

8

T/HBPFS001.5-2022

长

定长

度

说

区块序号，描述区块在区块链中的位置

明

备

可选

注

区块标识

表格11

属

内容

性

类

字符串

型

长

定长，推荐32字节

度

说

指区块哈希，区块在区块链中的统一标识

明

备

必选

注

版本信息

表格12

属

内容

性

类

字符串

型

长

不定长

度

说当前区块版本号，主要对应当前区块头的结构及各

明个字段的含义

备

可选

注

前一区块哈希值

表格13

属

内容

性

类

字符串

型

长

定长，推荐32字节

度

说指前一区块的区块哈希，区块在区块链中的唯

明一标识

9

T/HBPFS001.5-2022

备

必选

注

默克尔根

表格14

属

内容

性

类

字符串

型

长

定长，推荐32字节

度

说由本区块里相关的信息通过树状结构算法汇总生成

明的哈希值

备

事务树必选

注

区块时间戳

表格15

属

内容

性

类

整数

型

长

定长，推荐8字节

度

说

UNIX时间戳，精确到毫秒

明

备

必选

注

事务列表

表格16

属

内容

性

类

数组

型

长

不定长

度

说区块链中的事务列表，每个事务通常表示一个

明业务操作

备

必选

注

4）实体数据

发起方地址

10

T/HBPFS001.5-2022

表格17

属

内容

性

类

字符串

型

长

定长