T/HBPFS 001.3-2022 雄安新区区块链支付平台 第3部分：场景开发与接入规范

T/HBPFS001.3-2022

ICS号03.060

中国标准文献分类号A11

团体标准

T/HBPFS001.3-2022

雄安新区区块链支付平台

第3部分：场景开发与接入规范

TheStandardofXiong’AnNewAreaBlockchainPaymentPlatform

Part3：ScenarioDevelopmentandAccessSpecifications

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

河北省金融学会发布

T/HBPFS001.3-2022

T/HBPFS001.3-2022

目次

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

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

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

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

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

3.1区块链支付信息服务平台................................................................................................................1

3.2开放开发平台....................................................................................................................................1

3.3场景应用系统....................................................................................................................................1

3.4应用ID...............................................................................................................................................1

3.5应用场景服务提供者账号................................................................................................................1

3.6数字签名..........................................................................................................................................1

3.7灰度测试..........................................................................................................................................2

4接入流程...................................................................................................................................................2

4.1场景入驻..........................................................................................................................................2

4.2创建场景..........................................................................................................................................3

4.3开发场景..........................................................................................................................................3

4.4绑定场景..........................................................................................................................................3

4.5版本管理..........................................................................................................................................3

4.6审核上线..........................................................................................................................................3

4.7运营管理............................................................................................................................................3

4.8应用下架..........................................................................................................................................4

5区块链支付应用接口规范.......................................................................................................................4

5.1自主支付................................................................................................................................................4

5.2审批支付................................................................................................................................................8

5.3自动支付...............................................................................................................................................11

5.4受托支付..............................................................................................................................................13

5.5查询接口..............................................................................................................................................14

I

T/HBPFS001.3-2022

II

T/HBPFS001.3-2022

前言

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

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

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

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

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

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

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

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

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

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

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

构和主要功能介绍；

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

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

方法与接口规范；

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

范等内容；

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

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

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

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

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

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

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

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

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

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

III

T/HBPFS001.3-2022

引言

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

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

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

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

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

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

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

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

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

规范相关接入规范与接口要求，特制定《第3部分：场景开发与接入规范》。

本文件主要描述了开放开发平台应该提供的功能，以及如何通过开放开发平台创建场景应用

系统，完成场景应用系统与区块链支付信息服务平台对接。

IV

T/HBPFS001.3-2022

雄安新区区块链支付平台

第3部分：场景开发与接入规范

1范围

本文件主要描述了开放开发平台应该提供的功能，包括创建场景应用系统，完成场景应用系

统与区块链支付信息服务平台对接。

2规范性引用文件

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

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

改单）适用于本文件。

JR/T0184-2020金融分布式账本技术安全规范

3术语和定义

3.1区块链支付信息服务平台

通过区块链与银行支付网关对接，提供自主支付、审批支付、自动支付、受托支付四大类支

付功能，以及历史账单和支付结果等查询功能。

3.2开放开发平台

把区块链支付信息服务平台的服务封装成一系列的服务接口，以API的形式进行开放，供第

三方开发者使用的开发平台。

3.3场景应用系统

依托开放开发平台，用户可以创建不同的场景应用系统，如建设资金管理、拆迁安置资金管

理、供应链金融等。

3.4应用ID

应用ID是支付平台分配给开发者的场景应用ID，是场景应用的唯一标识。

3.5应用场景服务提供者账号

应用场景服务提供者账号是支付平台分配给应用场景服务提供者的ID，是应用场景服务提供

者的唯一标识。

数字签名

3.6

1

T/HBPFS001.3-2022

数字签名是只有信息的发送者才能产生的别人无法伪造的一段数字串，这段数字串同时也是

对信息的发送者发送信息真实性的一个有效证明。

3.7灰度测试

在产品或应用正式发布前，选择特定人群试用，逐步扩大其试用者数量，以便及时发现和纠

正其中的问题。

4接入流程

图1.场景接入总体流程

4.1场景入驻

开放开发平台应提供如下流程方便开发者入驻，整体流程如下所示：

1）第一步：登陆开放开发平台

开放开发平台应提供给开发者使用个人或企业账号登陆的功能。

2）第二步：选择服务范围

开放开发平台将服务范围区分为自研和第三方软件提供商，根据不同的开发者提供对应的服

务。

3）第三步：填写信息

2

T/HBPFS001.3-2022

开放开发平台应提供给开发者根据实际业务场景和服务范围填写对应信息的页面。

4）第四步：入驻成功

在填写完相关信息后，开发者即完成入驻。

4.2创建场景

在实际开发之前，开放开发平台应该提供空白场景应用模版并生成场景应用系统ID作为唯一

标识，场景应用的实际内容仍需后续开发。

4.3开发场景

开发者通过开放开发平台提供的API接口实现与区块链支付信息服务平台的交互。

4.4绑定场景

场景应用系统ID在开放开发平台创建，归属于对应开发者账号，开放开发平台应提供应用ID

与应用场景服务提供者账号绑定功能，完成绑定后场景应用系统即可调用相关的支付、运营功能。

4.5版本管理

开放开发平台应该提供版本管理功能，根据需要，对相应版本进行管理。

表格1

版本阶段版本说明操作选项

开发版本每次上传的代码都对应独立的开发版本提交审核

正在审核：撤回审核

提交审核的开发版本。通过之后可以进入灰

审核版本审核通过：灰度测试

度测试，否则需要根据驳回原因退回修改

审核失败：退回开发

灰度版本通过审核之后，向特定用户进行灰度测试上架应用

线上版本面向全部用户的正式版本下架应用

下架版本被下架的版本，无法恢复。

表1.版本说明

4.6审核上线

开发者创建应用并完成开发，绑定后，提交审核，当状态将变为已上线，表明应用能够在生

产环境中调用接口。

图2.场景审核流程

4.7运营管理

3

T/HBPFS001.3-2022

4.7.1运营总览

开放开发平台应包含运营信息总览，用来展示当前场景应用的访问数据，账单成交量信息。

4.7.2数据分析

开放开发平台应提供报表统计等数据分析功能，帮助应用场景服务提供者进行产品迭代优化

和场景应用系统的运营推广，运营人员通过报表统计，可查看场景应用系统的相关数据。

4.7.3安全管理

开发者通过开放开发平台提供的API接口实现与区块链支付信息服务平台的交互，需区分开

发、测试、生产环境，要严格管控开发者权限，防止代码泄露。

4.7.4用户反馈

开放开发平台应提供用户反馈渠道，应用场景服务提供者可以根据用户评价、用户反馈提升

系统。

4.7.5优化搜索

开放开发平台应提供优化搜索功能，用户可以查看场景应用系统搜索数据，可以通过数据优

化搜索推广策略。

4.8应用下架

开放开发平台应提供应用下架功能，用户进入版本管理页面，选择要下架的线上版本。注意：

被下架的版本无法恢复，只有重新上传提审才能上架新的版本。

5区块链支付应用接口规范

5.1自主支付

5.1.1点对点支付

场景应用通过调用自主支付接口发起点对点之间转账操作。

表格2

参数含义类型最大长度是否必要描述

APPID应用IDString32是

TOKEN应用授权String40是

BATCH数据批次号String128是

PAYREASON支付依据String50是有关联项目时必须出现

TIMESTAMP时间戳Timestamp19是yyyy-MM-ddHH:mm:ss

PAYINSTRUCID指令IDString200是

USAGE用途编号String50是

PAYCORP付款单位String50是

付款账户银行行是

PAYBANKString60

名

4

T/HBPFS001.3-2022

PAYACCNO付款账户账号String34是

PAY1NONAME付款账户户名String60是

PAYDEPTID付款方机构编号String50是付款方内部机构编号

ACCCORP收款单位String50是

ACCBANKNAME收款方银行行名String60是入账账户银行行名

ACCNO收款方账户账号String34是

ACCNONAME收款方账户户名String60是

DEPID收款方机构编号String60是

ACCNOTYPE账户类型String3是1-银行卡,2-账户

ACCTYPE入账类型String3是

ISPRIVATE对公/对私标志String3是1－未知，2－对私

CURRTYPE币种String3是1－人民币

AMOUNT金额String17是金额单位分

PAYDEPTID付款方机构编号String50是付款方内部机构编号

DEPID收款方机构编号String50是收款方内部机构编号

付款条件列表，最多50个条

PAY_CONDITION_LIST付款条件列表List50是

件

PAY_CONDITION_LIST结构如下：

默认有三级条件，若超过三级，可按列表形式添加

表格3

PAYINSTRUCID指令IDString200是

PAYAGENT付款条件一String50是

PAYAGENTSIGN付款条件一签名String50是

PAYAPPROVER付款条件二String50否

PAYAUDITSIGN付款条件二签名String50否

PAYAGENT付款条件三String50否

PAYAPPROVERSIGN付款条件三签名String50否

5.1.2点对多点支付

场景应用系统通过调用自主支付接口发起点对点之间转账操作，PAYINSTRUCLIST列表中包含

支付指令，支付指令按顺序加入，指令多条时为点对多点支付。

表格4

参数含义类型最大长度是否必要描述

APPID应用IDString32是

TOKEN应用授权String40是

BATCH数据批次号String128是

TOTALNUM批次总笔数