中国电信融合支付平台技术要求-全国平台接口分册（试行）

中国电信 融合 支付 平台技术要求 全国平台接口 分 册 （试行） 中国电信集团公司 2010 年 6 月 前言 本规范根据中国电信翼支付产品（基础版）业务规范制定，描述中国电信融合支付全国平台的接口。 本规范适用于中国电信融合支付全国平台的接口功能开发。 本规范解释权属于中国电信股份有限公司。 本规范起草单位：中国电信股份有限公司移动支付项目组 。 本规范主要起草人 ： 陈洪 中国电信融合支付平台技术要求 全国平台 接口 分册 i 目录 1. 概述 . 1 2. 引用标准 . 1 3. 名词解释 . 1 4. 系统架构 . 2 5. 与业务平台或商户系统的接口（ . 3 定向支付接口 . 3 口描述 . 3 求参数 . 3 答参数 . 4 6. 与银行 /第三方支付平台的接口（ . 5 7. 与 台的接口（ . 5 8. 与 台的接口（ . 5 9. 与 纽的接口（ . 5 据类型 . 5 本数据类型 . 5 构类型 . 6 号定义 . 6 求消息结构 . 6 应消息结构 . 7 口说明 . 8 户发卡接口 . 8 户接口 . 9 户请求接口 . 11 业厅挂失接口 . 11 业厅解挂接口 . 12 态同步接口 . 13 业厅换卡接口 . 14 业厅补卡接口 . 15 数定义 . 16 类型 ) . 16 否申请个人证书 ) . 17 户等级 ) . 17 户类型 ) . 17 登录密码 ) . 17 别 ) . 17 件类别 ) . 17 属地码 ) . 18 地区码 ) . 18 城市码 ) . 19 邮政编码 ) . 19 理机构码 ) . 19 受理渠道 ). 20 中国电信融合支付平台技术要求 全国平台 接口 分册 4 服务收费标志 ) . 20 账户类型 ) . 20 转接机构码 ) . 20 支付机构码 ) . 20 出单机构码 ) . 20 商户号 ) . 20 账户状态 ) . 21 通信设备状态 ) . 21 响应码 ) . 21 支付卡卡号） . 21 户 /账户 . 22 码类型） . 23 信产品号） . 23 端号） . 23 否实名） . 23 品号类型） . 23 录 A . 23 误代码含义 . 23 务代码名称映射 . 26 10. 与 接口（ . 26 11. 与业务监控系统的接口（ . 27 12. 与卡应用管理平台的接口（ . 27 13. 与省平台的接口（ . 27 中国电信融合支付平台技术要求 全国平台 接口 分册 第 1 页 共 27 页 1. 概述 本文 主要针对全国平台与周边系统的接口类型、接口字段 及其 格式取值 进行了 规范 说明 。 2. 引用标准 下列文件通过本文的参考而成为本技术要求的条款。凡是注日期的参考文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其最新版本适用于本文。 【 1】 中国电信翼支付产品（基础版）业务规范（试行） 【 2】中国电信融合支付平台技术要求 总册 【 3】中国电信融合支付平台技术要求 全国平台功能分册 【 4】中国电信融合支付平台技术要求 省平台功能分册 【 5】中国电信融合支付平台技术要求 技术流程分册 3. 名词解释 术语 术语描述 翼支付账户 中国电信向用户提供的电信消费账户中的在线支付账户 翼支付卡 已经写入电信翼支付账户的 翼支付卡号 为用户翼支付卡分配的翼支付卡号，存放在翼支付卡内，用以标识翼支付应用。 翼支 付账号 翼支付账号 是用户用来登录及使用翼支付账户的号码，翼支付账号编码同电信通行证编码。 端（接收端机具）接入平台，分为全国、省两级。 中国电信融合支付平台技术要求 全国平台 接口 分册 第 2 页 共 27 页 4. 系统架构 全 国 业 务 平 台 或商 户银 行 / 第 三 方 支付 平 台积 分 平 台O T A 平 台N S A M 省 前 置U D S P O 平 台省 平 台门 户 网 站I F 1I F 2I F 3I F 4I F 5I F 6业 务 监 控 系 统I F 7I F 9卡 应 用 管 理 平 台I F 8图 4国平台与周边系统接口示意图 全国平台与外部存在以下一些主要接口： 与全国业务平台或商户系统的接口（ 主要是指在业务平台或商户系统发起支付时的页面跳转接口； 与银行 /第三方支付机构的接口（ 当银行 /第三方支付账户作为翼支付账户的充值资金源，此接口完成银行 /第三方支付账户的认证扣款； 与 台的接口（ 主要 包括空中圈存、账户状态控制等接口； 与 台的接口（ 此接口主要实现网上登录密码的认证； 与 前置的接口（ 虚拟省的 置系统通过此接口连入全国平台，实现开户、销户、状态同步、挂失解挂、补换卡等功能； 与 接口（ 提供短信能力，实现支付密码发送、支付结果通知等功能； 与业务监控系统的接口（ 通过此接口监控全国平台的运行； 与卡应用管理平台的接口：实现卡信息同步、卡应用控制等功能； 与省平台的接口：包括省内系统发起的与翼支付相关的各种接口； 中国电信融合支付平台技术要求 全国平台 接口 分册 第 3 页 共 27 页 5. 与业务平台或商 户系统的接口（ 定向支付接口 口描述 接口名称 重定向支付接口 接口描述 业务平台或商户系统的门户网站将支付请求发送给融合支付全国平台，通过重定向的方式，将页面跳转到融合支付全国平台的网上支付页面，用户在融合支付全国平台的网上支付页面完成支付后再跳转回业务平台或商户系统的门户网站处理页面。 接口提供者 融合支付全国平台 接口使用者 业务平台或商户系统的门户网站 接口类型 用场景 互联网接入流程中的翼支付账户支付 备注 求参数 字段 含义 类型 长度 必填 备注 易 00 M 提交交易数据的 址 户代码 n 15 M 易订单号 n 16 M 易金额 n 12 M 单位：分 种 n 3 M 默认为人民币， 156 易时间 n 14 M 订单提交时间 易类型 n 4 M 面返回地址 00 M 页面交易接收 台返回地址 00 M 后台交易接收 字签名 56 M 为此次交易提交 关键数据的数字签名 示例： （这里 内容为提交交易数据的 址） （ 全国平台 统一分配给商户的商户中国电信融合支付平台技术要求 全国平台 接口 分册 第 4 页 共 27 页 号， 15 位长度，必填） （商户提交给 全国平台 的交易订单号， 16位长度，必填） （订单交易金额，单位为分， 12 位长 度 ，左补 0，必填） （订单交易币种， 3 位长度，固定为人民币 156， 必填） （订单交易日期， 14 位长度，必填） （交易类型， 4 位长度，必填） （页面交易接收 度不要超过 500 个字节，必填） （后台交易接收 度不要超过 500 个字节，必填） （ 256 字节长的 ， 为此次交易提交关键数据的数字签名，必填） 答参数 示例： （这里 内容为提交交易数据的 址） 字段 字段含义 类型 长度 必填 备注 回地址 n 32 M 回填 户代码 n 15 M 易订单号 n 16 M 易金额 n 12 M 单位：分 种 n 3 M 默认为人民币， 156 易时间 n 14 M 订单提交时间 易类型 n 4 M 回代码 n 4 M 字签名 56 M 中国电信融合支付平台技术要求 全国平台 接口 分册 第 5 页 共 27 页 6. 与银行 /第三方支付平台的接口 （ 以银行 /第三方支付平 台接口为准。 7. 与 台的接口（ 全国平台与 台的接口主要是为离线应用服务，暂不建设。 8. 与 台的接口 （ 以 台接口规范为准 ，详见中国电信用户数据库 接口与流程规范 。 9. 与 纽的接口 （ 与 接口采用 口。 据类型 本数据类型 序号 类型 缩写 类型描述 参考 1 a 字母 a z A、 a、 n 数字 0 9 1、 12、 s 特殊字符 、 # 4 母和数字字符 母、数字和特殊 字符 位数年份 2010（ 2010 年） 7 份中的月份 03（ 3 月份） 8 份中的日期 25（ 25 号） 9 时（ 24 格式） 15（ 15 点） 10 钟 30（ 30 分） 11 59（ 59 秒） 中国电信融合支付平台技术要求 全国平台 接口 分册 第 6 页 共 27 页 构类型 序号 类型缩写 类型描述 参考 1 户信息类型 2 户信息类型 号定义 序号 符号缩写 符号性质 符号说明 1 M 强制域 (此域 必选，否则将被认为格式出错 2 C 条件域 (此域在一定条件下必选 3 O 选用域 (此域由发送方自选 求消息结构 构说明 . 素说明 序号 元素名称 元素说明 次数 1 元素为根元素 1 2 明本次请求控制信息。属于消息头。 1 3 明本次请求业务参数信息。属于消息体。 1 性说明 序号 属性名称 属性说明 1 务名称，参考附录 务编码，参考附录 国电信融合支付平台技术要求 全国平台 接口 分册 第 7 页 共 27 页 序号 属性名称 属性说明 3 求此服务的客户端标识编码。 建议格式：省份 版本号 4 机生成的流水，用于维持请求响应对 应消息结构 构说明 000000 素说明 序号 元素名称 元素说明 次数 1 元素为根元素 1 2 明本次响应的控制信息。属于消息头。 1 3 明本次响应业务参数信息。属于消息体。 1 4 明本次响应说明信息。属于消息体。 1 5 明本次响应包含结果集。属于消息体。 01 6 装具体结果集。属于消息体。 0N 性说明 序号 属性名称 属性说明 1 自对应请求 国电信融合支付平台技术要求 全国平台 接口 分册 第 8 页 共 27 页 序号 属性名称 属性说明 2 询类响应为 20，其余都为 10 3 自对应请求 果成功 ”如果失败 ”口说明 户发卡 接口 口描述 接口名称 开户 发卡 接口 接口描述 用户在营业厅开通支付账户 和翼支付 省 国 平台 接口提供者 融合支付 全国 平台 接口使用者 前置 接口类型 用场景 营业厅开户流程 备注 求参数 字段 含义 类型 长度 必填 参考 号 n 32 M 见 类型 n 1 M 见 户名 0 M 真实姓名，如张三 录号 0 M 翼支付登录别名，初期采用 品号 0 M 见 否已认证 n 1 M 见 户级别 n 1 M 见 户类别 n 1 M 见 系手机 n 15 M 如系邮箱 00 M 如密码 n 16 O 见 别 n 1 O 见 件类型 n 1 M 见 件号码 n 20 M 系电话 n 15 O 如 02188888888 中国电信融合支付平台技术要求 全国平台 接口 分册 第 9 页 共 27 页 字段 含义 类型 长度 必填 参考 他电话 n 15 O 地 n 15 M 所开户的属地。 见 区代码 n 6 M 所开户的地区。 见 市编 码 n 6 M 所开户的城市。 见 系地址 00 O 位地址 00 O 位邮编 n 6 O 见 位代码 n 30 O 理机构代码 n 15 M 见 理人 n 20 O 理地区代码 n 6 M 受理的地区。 见 理城市代码 n 6 M 受理的城市。 见 理渠道 n 2 M 见 理流水 n 20 M 务收费标志 n 1 M 见 务收费金额 n 12 M 以分为单位 作人员代码 n 20 O 作时间 n 14 M 式 权员工标识 n 20 O 权时间 n 14 O 式 答参数 字段 含义 类型 长度 必填 备注 应码 n 6 M 见 应码描述 00 C 当响应码不为 000000 户接口 口描述 接口名称 开户接口 接口描述 用户在营业厅开通支付账户，省 接口提供者 融合支付全国平台 接口使用者 前置 接口类型 用场景 营业厅开户流程 备注 中国电信融合支付平台技术要求 全国平台 接口 分册 第 10 页 共 27 页 求参数 字段 含义 类型 长度 必填 参考 户名 0 M 真实姓名，如张三 录号 0 O 翼支付登录别名，初期采用 品号 0 M 见 否已认证 n 1 M 见 户级别 n 1 M 见 户类别 n 1 M 见 系手机 n 15 M 如系邮箱 00 M 如密码 n 16 O 见 别 n 1 O 见 件类型 n 1 M 见 件号码 n 20 M 系电话 n 15 O 如 02188888888 他电话 n 15 O 地 n 15 M 所开户的属地。见 区代码 n 6 M 所开户的地区。见 市编码 n 6 M 所开户的城市。见 系地址 00 O 位地址 00 O 位邮编 n 6 O 见 位代码 n 30 O 理机构代码 n 15 M 见 理人 n 20 O 理 地区代码 n 6 M 受理的地区。见 理城市代码 n 6 M 受理的城市。见 理渠道 n 2 M 见 理流水 n 20 M 务收费标志 n 1 M 见 务收费金额 n 12 M 以分为单位 作人员代码 n 20 O 作时间 n 14 M 式 权员工标识 n 20 O 权时间 n 14 O 式 答参数 字段 含义 类型 长度 必填 备注 应码 n 6 M 见 应码描述 00 C 当响应码不为 000000 中国电信融合支付平台技术要求 全国平台 接口 分册 第 11 页 共 27 页 户请求接口 口描述 接口名称 销户请求接口 接口描述 用户在营业厅销户， 省 相应信息发至到融合支付全国 平台 接口提供者 融合支付 全国 平台 接口使用者 前置 接口类型 用场景 营业厅销户流程 备注 求参数 字段 含义 类型 长度 必填 备注 品号 0 M 见 户名 0 M 件类型 n 1 M 见 件号码 n 20 M 理机构代码 n 15 M 见 理人 n 20 O 理地区代码 n 6 M 受理的地区。 见 理城市代码 n 6 M 受理的城市。 见 理渠道 n 2 M 见 理流水 n 20 M 务收费标志 n 1 M 见 务收费金额 n 12 M 作人员代码 n 20 O 作时间 n 14 M 式 权员工标识 n 20 O 权时间 n 14 O 式 答参数 字段 含义 类型 长度 必填 备注 应码 n 6 M 见 应码描述 00 C 当响应码不为 000000 业厅挂失接口 口描述 中国电信融合支付平台技术要求 全国平台 接口 分册 第 12 页 共 27 页 接口名称 营业厅挂失接口 接口描述 用户在营业厅挂失，省 统将相应信息发至到融合支付全国平台 接口提供者 融合支付 全国 平台 接口使用者 前置 接口类型 用场景 营业厅挂失流程 备注 求参数 字段 含义 类型 长度 必填 备注 品号 0 M 见 户名 0 M 件类型 n 1 M 见 件号码 n 20 M 理机构代码 n 15 M 见 理人 n 20 O 理地区代码 n 6 M 受理的地区。见 理城市代码 n 6 M 受理的城市。见 理渠道 n 2 M 见 理流水 n 20 M 务收费标志 n 1 M 见 务收费金额 n 12 M 作人员代码 n 20 O 作时间 n 14 M 式 权员工标识 n 20 O 权时间 n 14 O 式 答参数 字段 含义 类型 长度 必填 备注 应码 n 6 M 见 应码描述 00 C 当响应码不为 000000 业厅解挂接口 口描述 接口名称 营业厅解挂接口 接口描述 用户在营业厅解除挂失，省 国 平台 接口提供者 融合支付全国 平台 中国电信融合支付平台技术要求 全国平台 接口 分册 第 13 页 共 27 页 接口使用者 前置 接口类型 用场景 营业厅解挂流程 备注 求参数 字段 含义 类型 长度 必填 备注 品号 0 M 见 户名 0 M 件类型 n 1 M 见 件号码 n 20 M 理机构代码 n 15 M 见 理人 n 20 O 理地区代码 n 6 M 受理的地区。见 理城市代码 n 6 M 受理的城市。见 理渠道 n 2 M 见 理流水 n 20 M 务收费标志 n 1 M 见 务收费金额 n 12 M 作人员代码 n 20 O 作时间 n 14 M 式 权员工标识 n 20 O 权时间 n 14 O 式 答参数 字段 含义 类型 长度 必填 备注 应码 n 6 M 见 应码描述 00 C 当响应码不为 000000 态同步接口 口描述 接口名称 状态同步接口 接口描述 用户在营业厅变更翼支付账户状态，省 步给融合支付全国 平台 接口提供者 融合支付全国 平台 接口使用者 前置 接口类型 国电信融合支付平台技术要求 全国平台 接口 分册 第 14 页 共 27 页 应用场景 营业厅账户状态变更流程 备注 求参数 字段 含义 类型 长度 必填 备注 品号 0 M 见 信状态 n 20 M 见 理机构代码 n 15 M 见 理人 n 20 O 理地区代码 n 6 M 受理的地区。 见 理城市代码 n 6 M 受理的城市。 见 理渠道 n 2 M 见 理流水 n 20 M 务收费标志 n 1 O 见 务收费金额 n 1