DB54 ICS 35.240.01 L 67 西 藏 自 治 区 地 方 标 准 DB54/T 0266—2022 政务服务统一公共支付对接技术规范 2022-05-06 发布 2022-06-06 实施 西藏自治区市场监督管理局 发 布 DB54/T 0266—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/T 0266—2022 前 言 本文件按照 GB/T 1.1—2020《标准化工作导则 第 1 部分：标准化文件的结构和起草规则》的规 定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本文件由西藏自治区人民政府办公厅提出并归口。 本文件主要起草单位：西藏自治区人民政府办公厅电子政务中心。 本文件主要起草人：冉仕平、桑珠次仁、普布卓玛、赵伟栋、李峰涛、赵登勇、张新宇、纵忍、 楚光、加措、段明超、李嘉欣、唐春霞、樊磊、陈利、秦健明、刘肖骏、万龙。 III DB54/T 0266—2022 政务服务统一公共支付对接技术规范 1 范围 本文件规定了西藏自治区统一公共支付平台网上支付收费流程中涉及的对接要求以及接口字段 说明等，并给出了接口对接参数示例。 本文件适用于指导西藏自治区业务系统和统一公共支付平台的对接。 2 规范性引用文件 本文件没有规范性引用文件。 3 术语和定义 下列术语和定义适用于本文件。 3.1 统一公共支付平台 按照“统一规划、一点接入”的思路，由自治区财政厅负责统建统管，依托政府非税收入收缴体 系，整合线上线下支付渠道，拓展支付、结算和管理功能的支付平台。 4 4.1 概述 通信协议 可采用 HTTP 或者 HTTPS 方式进行通讯，其中 HTTPS 将数据进行加密操作，可有效的保证传输 过程中的安全性。 4.2 接入流程 接入流程见图 1。 图1 4.3 接入流程 接口对接参数示例 接口对接参数示例见附录 A。 5 5.1 接口字段说明 总体说明 1 DB54/T 0266—2022 接入接口有两个通用字段，服务响应状态、响应信息。此两个字段不参与签名验签操作，只用于 表示交易的状态。比如交易成功时，返回的服务响应状态为 true，交易失败时，服务响应状态为 false， 响应信息对应的是错误的描述信息，见表 1。 表1 接口说明 5.2 接口字段 名称 数据类型 数据长度 是否必输 Success 服务响应状态 VarChar2 2 必输 Reason 响应信息 VarChar2 2000 非必输 备注 true-成功 false-失败 缴费方式查询接口 5.2.1 输入接口 缴费方式查询输入接口字段应符合表 2，请求 url 为： http://IP:port/xxx/tyzfInterface/openPayment/querySysDictListByParentCode.do。 表2 缴费方式查询输入接口 接口字段 名称 数据类型 数据长度 是否必输 备注 ApiKey 统一公共支付平 台授权 key VarChar2 32 必输 统一公共支付平台授权 key SystemPwd 统一公共支付平 台授权密码 VarChar2 500 必输 统一公共支付平台授权 密码 payCode 统一公共支付平 台缴款编码 VarChar2 100 必输 RequestData 请求的数据 VarChar2 2000 必输 利用 RSA 将上述参数拼 接成 json，获取密文信息 DataSign 签名信息 VarChar2 2000 必输 利用 SHA1withRSA 将 RequestData 字符串并私 钥签名 5.2.2 输出接口 缴费方式查询输出接口字段应符合表 3。 表3 缴费方式查询输出接口 5.3 接口字段 名称 tyzfPayMap 支付方式的 map 集合 VarChar2 InterfaceCode 统一公共支付平 台支付方式编码 InterfaceName 统一公共支付平 台支付方式名称 支付页面跳转接口 5.3.1 接口说明 2 数据类型 数据长度 是否必输 备注 500 必输 支付方式的 map 集合 （key 为 InterfaceCode，value 为 InterfaceName） VarChar2 100 必输 统一公共支付平台支 付方式编码 VarChar2 100 必输 统一公共支付平台支 付方式名称 DB54/T 0266—2022 用于开发者生成支付订单信息。输入接口和输出接口中的参数都需要以 json 串的形式进行传递， 输入接口和输出接口中的参数都需要按照 key=value&key=value 的形式拼接字符串进行签名和验签。 拼接字符串的字段顺序即为接口字段定义的顺序。 5.3.2 输入接口 输入接口字段应符合表 4，请求 URL： http://IP:port/xxx/tyzfInterface/openPayment/lifeCreateOrderOnline.do。 表4 支付页面跳转输入接口 接口字段 名称 数据类型 数据长度 是否必输 备注 ApiKey 统一公共支付平 台授权 key VarChar2 32 必输 统一公共支付平台授权 key SystemPwd 统一公共支付平 台授权密码 VarChar2 500 必输 统一公共支付平台授权密码 InterfaceCode 统一公共支付平 台支付方式编码 VarChar2 100 必输 统一公共支付平台支付方式 编码 payCode 统一公共支付平 台缴款编码 VarChar2 100 必输 returnUrl 付款后返回的 url VarChar2 100 非必输 付款后返回的 url IsMobile 端口标志 VarChar2 1 必输 端口标志，0-PC 端，1-手机 APP，2-微信公众号 手机端标志，端口标志是 1， 2 时候，该项必填； mobileTpye 手机端标志 VarChar2 2 非必输 RequestData 请求的数据 VarChar2 2000 必输 利用 RSA/SM2 将上述参数 拼接成 json，获取密文信息 DataSign 签名信息 VarChar2 2000 必输 利用 SHA1withRSA 将 RequestData 字符串并私钥签 名 21-ios 客户端，22-android 客 户端 5.3.3 输出接口 输出