DB54/T 0266-2022 政务服务统一公共支付对接技术规范

ICS35.240.01

L67DB54

西藏自治区地方标准

DB54/T0266—2022

政务服务统一公共支付对接技术规范

2022-05-06发布2022-06-06实施

西藏自治区市场监督管理局发布

DB54/T0266—2022

目次

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

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

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

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

4概述................................................................................1

4.1通信协议........................................................................1

4.2接入流程........................................................................1

4.3接口对接参数示例................................................................1

5接口字段说明........................................................................1

5.1总体说明........................................................................1

5.2缴费方式查询接口................................................................2

5.3支付页面跳转接口................................................................2

5.4缴费订单生成接口................................................................3

5.5缴费订单查询接口................................................................5

5.6缴费订单退费接口................................................................6

5.7缴费订单退费查询接口............................................................7

5.8每日对账单推送..................................................................9

5.9对账单日期查询.................................................................10

附录A（资料性）接口对接参数示例...................................................12

参考文献.........................................................................14

I

DB54/T0266—2022

前言

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

定起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。

本文件由西藏自治区人民政府办公厅提出并归口。

本文件主要起草单位：西藏自治区人民政府办公厅电子政务中心。

本文件主要起草人：冉仕平、桑珠次仁、普布卓玛、赵伟栋、李峰涛、赵登勇、张新宇、纵忍、

楚光、加措、段明超、李嘉欣、唐春霞、樊磊、陈利、秦健明、刘肖骏、万龙。

III

DB54/T0266—2022

政务服务统一公共支付对接技术规范

1范围

本文件规定了西藏自治区统一公共支付平台网上支付收费流程中涉及的对接要求以及接口字段

说明等，并给出了接口对接参数示例。

本文件适用于指导西藏自治区业务系统和统一公共支付平台的对接。

2规范性引用文件

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

3术语和定义

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

3.1

统一公共支付平台

按照“统一规划、一点接入”的思路，由自治区财政厅负责统建统管，依托政府非税收入收缴体

系，整合线上线下支付渠道，拓展支付、结算和管理功能的支付平台。

4概述

4.1通信协议

可采用HTTP或者HTTPS方式进行通讯，其中HTTPS将数据进行加密操作，可有效的保证传输

过程中的安全性。

4.2接入流程

接入流程见图1。

图1接入流程

4.3接口对接参数示例

接口对接参数示例见附录A。

5接口字段说明

5.1总体说明

1

DB54/T0266—2022

接入接口有两个通用字段，服务响应状态、响应信息。此两个字段不参与签名验签操作，只用于

表示交易的状态。比如交易成功时，返回的服务响应状态为true，交易失败时，服务响应状态为false，

响应信息对应的是错误的描述信息，见表1。

表1接口说明

接口字段名称数据类型数据长度是否必输备注

true-成功

Success服务响应状态VarChar22必输

false-失败

Reason响应信息VarChar22000非必输

5.2缴费方式查询接口

5.2.1输入接口

缴费方式查询输入接口字段应符合表2，请求url为：

http://IP:port/xxx/tyzfInterface/openPayment/querySysDictListByParentCode.do。

表2缴费方式查询输入接口

接口字段名称数据类型数据长度是否必输备注

统一公共支付平统一公共支付平台授权

ApiKeyVarChar232必输

台授权keykey

统一公共支付平统一公共支付平台授权

SystemPwdVarChar2500必输

台授权密码密码

统一公共支付平

必输

payCode台缴款编码VarChar2100

利用RSA将上述参数拼

RequestData请求的数据VarChar22000必输

接成json，获取密文信息

利用SHA1withRSA将

DataSign签名信息VarChar22000必输RequestData字符串并私

钥签名

5.2.2输出接口

缴费方式查询输出接口字段应符合表3。

表3缴费方式查询输出接口

接口字段名称数据类型数据长度是否必输备注

支付方式的map集合

支付方式的map（key为

tyzfPayMapVarChar2500必输

集合InterfaceCode，value

为InterfaceName）

统一公共支付平统一公共支付平台支

必输

InterfaceCode台支付方式编码VarChar2100付方式编码

统一公共支付平统一公共支付平台支

必输

InterfaceName台支付方式名称VarChar2100付方式名称

5.3支付页面跳转接口

5.3.1接口说明

2

DB54/T0266—2022

用于开发者生成支付订单信息。输入接口和输出接口中的参数都需要以json串的形式进行传递，

输入接口和输出接口中的参数都需要按照key=value&key=value的形式拼接字符串进行签名和验签。

拼接字符串的字段顺序即为接口字段定义的顺序。

5.3.2输入接口

输入接口字段应符合表4，请求URL：

http://IP:port/xxx/tyzfInterface/openPayment/lifeCreateOrderOnline.do。

表4支付页面跳转输入接口

接口字段名称数据类型数据长度是否必输备注

统一公共支付平

ApiKeyVarChar232必输统一公共支付平台授权key

台授权key

统一公共支付平

必输统一公共支付平台授权密码

SystemPwd台授权密码VarChar2500

统一公共支付平统一公共支付平台支付方式

必输

InterfaceCode台支付方式编码VarChar2100编码

统一公共支付平

必输

payCode台缴款编码VarChar2100

付款后返回的

returnUrlVarChar2100非必输付款后返回的url

url

端口标志，0-PC端，1-手机

IsMobile端口标志VarChar21必输

APP，2-微信公众号

手机端标志，端口标志是1，

2时候，该项必填；

mobileTpye手机端标志VarChar22非必输

21-ios客户端，22-android客

户端

利用RSA/SM2将上述参数

RequestData请求的数据VarChar22000必输

拼接成json，获取密文信息

利用SHA1withRSA将

DataSign签名信息VarChar22000必输RequestData字符串并私钥签

名

5.3.3输出接口

输出接口字段应符合表5。

表5支付页面跳转输出接口

接口字段名称数据类型数据长度是否必输备注

返回的收银台返回直接重定向到

redirectUrlVarChar2300必输

URL对应的url

5.4缴费订单生成接口

5.4.1输入接口

输入接口字段应符合表6，请求URL：

http://IP:port/xxx/tyzfInterface/openPayment/createOrderPayInterface.do。

3

DB54/T0266—2022

表6缴费订单生成输入接口

接口字段名称数据类型数据长度是否必输备注

统一公共支付统一公共支付平台授

ApiKeyString32必输

平台授权key权key

统一公共支付统一公共支付平台授

SystemPwdString