中國電信融合支付平臺技術要求-全國平臺接口分冊（試行）

中國電信 融合 支付 平臺技術要求 全國平臺接口 分 冊 （試行） 中國電信集團公司 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