DB54 T 0266-2022 政务服务统一公共支付对接技术规范.pdf
《DB54 T 0266-2022 政务服务统一公共支付对接技术规范.pdf》由会员分享,可在线阅读,更多相关《DB54 T 0266-2022 政务服务统一公共支付对接技术规范.pdf(20页珍藏版)》请在麦多课文档分享上搜索。
1、D B 5 4/T 0 2 6 6 2 0 2 2西 藏 自 治 区 地 方 标 准政 务 服 务 统 一 公 共 支 付 对 接 技 术 规 范2 0 2 2-0 5-0 6 发 布 2 0 2 2-0 6-0 6 实 施西 藏 自 治 区 市 场 监 督 管 理 局发 布I C S 3 5.2 4 0.0 1L 6 7DB54D B 5 4/T 0 2 6 6 2 0 2 2I目 次前 言.I I I1 范 围.12 规 范 性 引 用 文 件.13 术 语 和 定 义.14 概 述.14.1 通 信 协 议.14.2 接 入 流 程.14.3 接 口 对 接 参 数 示 例.15 接 口
2、 字 段 说 明.15.1 总 体 说 明.15.2 缴 费 方 式 查 询 接 口.25.3 支 付 页 面 跳 转 接 口.25.4 缴 费 订 单 生 成 接 口.35.5 缴 费 订 单 查 询 接 口.55.6 缴 费 订 单 退 费 接 口.65.7 缴 费 订 单 退 费 查 询 接 口.75.8 每 日 对 账 单 推 送.95.9 对 账 单 日 期 查 询.1 0附 录 A(资 料 性)接 口 对 接 参 数 示 例.1 2参 考 文 献.1 4D B 5 4/T 0 2 6 6 2 0 2 2I I I前 言本 文 件 按 照 G B/T 1.1 2 0 2 0 标 准
3、化 工 作 导 则 第 1 部 分:标 准 化 文 件 的 结 构 和 起 草 规 则 的 规定 起 草。请 注 意 本 文 件 的 某 些 内 容 可 能 涉 及 专 利。本 文 件 的 发 布 机 构 不 承 担 识 别 这 些 专 利 的 责 任。本 文 件 由 西 藏 自 治 区 人 民 政 府 办 公 厅 提 出 并 归 口。本 文 件 主 要 起 草 单 位:西 藏 自 治 区 人 民 政 府 办 公 厅 电 子 政 务 中 心。本 文 件 主 要 起 草 人:冉 仕 平、桑 珠 次 仁、普 布 卓 玛、赵 伟 栋、李 峰 涛、赵 登 勇、张 新 宇、纵 忍、楚 光、加 措、段 明
4、 超、李 嘉 欣、唐 春 霞、樊 磊、陈 利、秦 健 明、刘 肖 骏、万 龙。D B 5 4/T 0 2 6 6 2 0 2 21政 务 服 务 统 一 公 共 支 付 对 接 技 术 规 范1 范 围本 文 件 规 定 了 西 藏 自 治 区 统 一 公 共 支 付 平 台 网 上 支 付 收 费 流 程 中 涉 及 的 对 接 要 求 以 及 接 口 字 段说 明 等,并 给 出 了 接 口 对 接 参 数 示 例。本 文 件 适 用 于 指 导 西 藏 自 治 区 业 务 系 统 和 统 一 公 共 支 付 平 台 的 对 接。2 规 范 性 引 用 文 件本 文 件 没 有 规 范 性
5、 引 用 文 件。3 术 语 和 定 义下 列 术 语 和 定 义 适 用 于 本 文 件。3.1统 一 公 共 支 付 平 台按 照“统 一 规 划、一 点 接 入”的 思 路,由 自 治 区 财 政 厅 负 责 统 建 统 管,依 托 政 府 非 税 收 入 收 缴 体系,整 合 线 上 线 下 支 付 渠 道,拓 展 支 付、结 算 和 管 理 功 能 的 支 付 平 台。4 概 述4.1 通 信 协 议可 采 用 H T T P 或 者 H T T P S 方 式 进 行 通 讯,其 中 H T T P S 将 数 据 进 行 加 密 操 作,可 有 效 的 保 证 传 输过 程 中
6、的 安 全 性。4.2 接 入 流 程接 入 流 程 见 图 1。图 1 接 入 流 程4.3 接 口 对 接 参 数 示 例接 口 对 接 参 数 示 例 见 附 录 A。5 接 口 字 段 说 明5.1 总 体 说 明D B 5 4/T 0 2 6 6 2 0 2 22接 入 接 口 有 两 个 通 用 字 段,服 务 响 应 状 态、响 应 信 息。此 两 个 字 段 不 参 与 签 名 验 签 操 作,只 用 于表 示 交 易 的 状 态。比 如 交 易 成 功 时,返 回 的 服 务 响 应 状 态 为 t r u e,交 易 失 败 时,服 务 响 应 状 态 为 f a l s
7、e,响 应 信 息 对 应 的 是 错 误 的 描 述 信 息,见 表 1。表 1 接 口 说 明接口字段 名称 数据类型 数据长度 是否必输 备注S u c c e s s 服务响应状态 V a r C h a r 2 2 必输t r u e-成功f a l s e-失败R e a s o n 响应信息 V a r C h a r 2 2 0 0 0 非必输5.2 缴 费 方 式 查 询 接 口5.2.1 输 入 接 口缴 费 方 式 查 询 输 入 接 口 字 段 应 符 合 表 2,请 求 u r l 为:h t t p:/I P:p o r t/x x x/t y z f I n t
8、e r f a c e/o p e n P a y m e n t/q u e r y S y s D i c t L i s t B y P a r e n t C o d e.d o。表 2 缴 费 方 式 查 询 输 入 接 口接口字段 名称 数据类型 数据长度 是否必输 备注A p i K e y统一公共支付平台授权 k e yV a r C h a r 2 3 2 必输统一公共支付平台授权k e yS y s t e m P w d统一公共支付平台授权密码V a r C h a r 2 5 0 0 必输统一公共支付平台授权密码p a y C o d e统一公共支付平台缴款编码V a
9、r C h a r 2 1 0 0 必输R e q u e s t D a t a 请求的数据 V a r C h a r 2 2 0 0 0 必输利用 R S A 将上述参数拼接成 j s o n,获取密文信息D a t a S i g n 签名信息 V a r C h a r 2 2 0 0 0 必输利用 S H A 1 w i t h R S A 将R e q u e s t D a t a 字符串并私钥签名5.2.2 输 出 接 口缴 费 方 式 查 询 输 出 接 口 字 段 应 符 合 表 3。表 3 缴 费 方 式 查 询 输 出 接 口接口字段 名称 数据类型 数据长度 是否必
10、输 备注t y z f P a y M a p支付方式的 m a p集合V a r C h a r 2 5 0 0 必输支付方式的 m a p 集合(k e y 为I n t e r f a c e C o d e,v a l u e为 I n t e r f a c e N a m e)I n t e r f a c e C o d e统一公共支付平台支付方式编码V a r C h a r 2 1 0 0 必输统一公共支付平台支付方式编码I n t e r f a c e N a m e统一公共支付平台支付方式名称V a r C h a r 2 1 0 0 必输统一公共支付平台支付方式名称5
11、.3 支 付 页 面 跳 转 接 口5.3.1 接 口 说 明D B 5 4/T 0 2 6 6 2 0 2 23用 于 开 发 者 生 成 支 付 订 单 信 息。输 入 接 口 和 输 出 接 口 中 的 参 数 都 需 要 以 j s o n 串 的 形 式 进 行 传 递,输 入 接 口 和 输 出 接 口 中 的 参 数 都 需 要 按 照 k e y=v a l u e&k e y=v a l u e 的 形 式 拼 接 字 符 串 进 行 签 名 和 验 签。拼 接 字 符 串 的 字 段 顺 序 即 为 接 口 字 段 定 义 的 顺 序。5.3.2 输 入 接 口输 入 接
12、口 字 段 应 符 合 表 4,请 求 U R L:h t t p:/I P:p o r t/x x x/t y z f I n t e r f a c e/o p e n P a y m e n t/l i f e C r e a t e O r d e r O n l i n e.d o。表 4 支 付 页 面 跳 转 输 入 接 口接口字段 名称 数据类型 数据长度 是否必输 备注A p i K e y统一公共支付平台授权 k e yV a r C h a r 2 3 2 必输 统一公共支付平台授权 k e yS y s t e m P w d统一公共支付平台授权密码V a r C h
13、a r 2 5 0 0 必输 统一公共支付平台授权密码I n t e r f a c e C o d e统一公共支付平台支付方式编码V a r C h a r 2 1 0 0 必输统一公共支付平台支付方式编码p a y C o d e统一公共支付平台缴款编码V a r C h a r 2 1 0 0 必输r e t u r n U r l付款后返回的u r lV a r C h a r 2 1 0 0 非必输 付款后返回的 u r lI s M o b i l e 端口标志 V a r C h a r 2 1 必输端口标志,0-P C 端,1-手机A P P,2-微信公众号m o b i l
14、e T p y e 手机端标志 V a r C h a r 2 2 非必输手机端标志,端口标志是 1,2 时候,该项必填;2 1-i o s 客户端,2 2-a n d r o i d 客户端R e q u e s t D a t a 请求的数据 V a r C h a r 2 2 0 0 0 必输利用 R S A/S M 2 将上述参数拼接成 j s o n,获取密文信息D a t a S i g n 签名信息 V a r C h a r 2 2 0 0 0 必输利用 S H A 1 w i t h R S A 将R e q u e s t D a t a 字符串并私钥签名5.3.3 输 出
15、 接 口输 出 接 口 字 段 应 符 合 表 5。表 5 支 付 页 面 跳 转 输 出 接 口接口字段 名称 数据类型 数据长度 是否必输 备注r e d i r e c t U r l返回的收银台U R LV a r C h a r 2 3 0 0 必输返回直接重定向到对应的 u r l5.4 缴 费 订 单 生 成 接 口5.4.1 输 入 接 口输 入 接 口 字 段 应 符 合 表 6,请 求 U R L:h t t p:/I P:p o r t/x x x/t y z f I n t e r f a c e/o p e n P a y m e n t/c r e a t e O
16、r d e r P a y I n t e r f a c e.d o。D B 5 4/T 0 2 6 6 2 0 2 24表 6 缴 费 订 单 生 成 输 入 接 口接口字段 名称 数据类型 数据长度 是否必输 备注A p i K e y统一公共支付平台授权 k e yS t r i n g 3 2 必输统一公共支付平台授权 k e yS y s t e m P w d统一公共支付平台授权密码S t r i n g 5 0 0 必输统一公共支付平台授权密码I n t e r f a c e C o d e统一公共支付平台支付方式编码S t r i n g 1 0 0 必输统一公共支付平台支
17、付方式编码邮政:Z G Y Z Y Ho r d e r T o t a l F e e支付金额(邮费)S t r i n g 1 0 0 必输费用 单位是元,可保留 2 位小数r e t u r n U r l 返回地址 S t r i n g 1 0 0 非必输非必填,支付服务器主动通知商户服务器里指定的页面n o t i f y U r l 异步通知地址 S t r i n g 1 0 0 非必输非必填,支付平台将支付结果异步通知到此地址R e q u e s t D a t a 请求的数据 S t r i n g 2 0 0 0 必输利用 R S A 将上述参数拼接成 j s o n,
18、获取密文信息D a t a S i g n 签名信息 S t r i n g 2 0 0 0 必输利用 S H A 1 w i t h R S A将 R e q u e s t D a t a 字符串并私钥签名D B 5 4/T 0 2 6 6 2 0 2 255.4.2 输 出 接 口输 出 接 口 字 段 应 符 合 表 7。表 7 缴 费 订 单 生 成 输 出 接 口接口字段 名称 数据类型 数据长度 是否必输 备注r e d i r e c t H t m l返回的收银台H T M LS t r i n g 3 0 0 0 必输页面展示对应的h t m l5.5 缴 费 订 单 查
19、询 接 口5.5.1 输 入 接 口输 入 接 口 字 段 应 符 合 表 8,请 求 U R L:h t t p:/I P:p o r t/x x x/t y z f I n t e r f a c e/o p e n P a y m e n t/q u e r y O r d e r P a y I n t e r f a c e.d o。表 8 缴 费 订 单 查 询 输 入 接 口接口字段 名称 数据类型 数据长度 是否必输 备注A p i K e y统一公共支付平台授权 k e yS t r i n g 3 2 必输统一公共支付平台授权 k e yS y s t e m P w d统
20、一公共支付平台授权密码S t r i n g 5 0 0 必输统一公共支付平台授权密码I n t e r f a c e C o d e统一公共支付平台支付方式编码S t r i n g 1 0 0 必输统一公共支付平台支付方式编码邮政:Z G Y Z Y Ho r d e r N o统一公共支付平台的订单号S t r i n g 1 0 0统一公共支付平台的订单号 和政务服务平台订单号二选 1统一公共支付平台的订单号g a O r d e r N o政务服务平台订单号S t r i n g 1 0 0 政务服务平台订单号R e q u e s t D a t a 请求的数据 S t r i
21、n g 2 0 0 0 必输利用 R S A 将上述参数拼接成 j s o n,获取密文信息D a t a S i g n 签名信息 S t r i n g 2 0 0 0 必输利用 S H A 1 w i t h R S A将 R e q u e s t D a t a 字符串并私钥签名5.5.2 输 出 接 口输 出 接 口 字 段 应 符 合 表 9。表 9 缴 费 订 单 查 询 输 出 接 口接口字段 名称 数据类型 数据长度 是否必输 备注P a y I n f o J s o n 返回订单的详细 j s o n S t r i n g 3 0 0 0 必输 见表 1 0D B 5
22、 4/T 0 2 6 6 2 0 2 26P a y I n f o J s o n 具 体 响 应 字 段 应 符 合 表 1 0。表 1 0 缴 费 订 单 查 询 输 出 接 口 的 P a y I n f o J s o n 具 体 响 应 内 容接口字段 名称 数据类型 是否必输 备注o r d e r N o统一公共支付平台的订单号S t r i n g 是g a O r d e r N o政务服务平台订单号S t r i n g 是t r a d e A m o u n t 交易金额 S t r i n g 否实际支付金额,单位是元,可保留2 位小数t r a d e S t a
23、 t u s 交易状态 S t r i n g 是0:未支付1:支付成功2:已退款,表示交易金额已全部退款3:部分退款t r a d e D a t e 交易日期 S t r i n g 否 格式:y y y y-M M-d d H H:m m:s sp a y T y p e 支付方式 S t r i n g 否W:微信 F:支付宝 U:银联云闪付r e f u n d A m o u n t 已退款金额 S t r i n g 否 单位是元,可保留 2 位小数c o u p o n N o 优惠券号 S t r i n g 否c o u p o n F e e 优惠券金额 S t r i
24、n g 否t r a d e D e t a i l I n f o 交易明细信息 S t r i n g 否 J S O N 数据e x t e n d P a r a m s 扩展参数 S t r i n g 否交易明细信息内容f e e I t e m C o d e 费用项代码 S t r i n g 否 0 6:邮费f e e 费用 S t r i n g 否 单位是元,可保留 2 位小数t r a d e S t a t u s 交易状态 S t r i n g 否1:支付成功2:已退款t r a d e D a t e 交易日期 S t r i n g 否i s U s e C
25、o u p o n s 是否使用优惠券 S t r i n g 是 0:未使用 1:使用c o u p o n N o 优惠券号 S t r i n g 否c o u p o n F e e 优惠券金额 S t r i n g 否r e f u n d D a t e 退款日期 S t r i n g 否5.6 缴 费 订 单 退 费 接 口5.6.1 输 入 接 口输 入 接 口 字 段 应 符 合 表 1 1,请 求 U R L:h t t p:/I P:p o r t/x x x/t y z f I n t e r f a c e/o p e n P a y m e n t/r e f
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB54 0266-2022 政务服务统一公共支付对接技术规范 0266 2022 政务 服务 统一 公共 支付 对接 技术规范
