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

中國電信 融合 支付 平臺技術(shù)要求 全國平臺接口 分 冊 （試行） 中國電信集團公司 2010 年 6 月 前言 本規(guī)范根據(jù)中國電信翼支付產(chǎn)品（基礎(chǔ)版）業(yè)務(wù)規(guī)范制定，描述中國電信融合支付全國平臺的接口。 本規(guī)范適用于中國電信融合支付全國平臺的接口功能開發(fā)。 本規(guī)范解釋權(quán)屬于中國電信股份有限公司。 本規(guī)范起草單位：中國電信股份有限公司移動支付項目組 。 本規(guī)范主要起草人 ： 陳洪 中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 i 目錄 1. 概述 . 1 2. 引用標(biāo)準(zhǔn) . 1 3. 名詞解釋 . 1 4. 系統(tǒng)架構(gòu) . 2 5. 與業(yè)務(wù)平臺或商戶系統(tǒng)的接口（ . 3 定向支付接口 . 3 口描述 . 3 求參數(shù) . 3 答參數(shù) . 4 6. 與銀行 /第三方支付平臺的接口（ . 5 7. 與 臺的接口（ . 5 8. 與 臺的接口（ . 5 9. 與 紐的接口（ . 5 據(jù)類型 . 5 本數(shù)據(jù)類型 . 5 構(gòu)類型 . 6 號定義 . 6 求消息結(jié)構(gòu) . 6 應(yīng)消息結(jié)構(gòu) . 7 口說明 . 8 戶發(fā)卡接口 . 8 戶接口 . 9 戶請求接口 . 11 業(yè)廳掛失接口 . 11 業(yè)廳解掛接口 . 12 態(tài)同步接口 . 13 業(yè)廳換卡接口 . 14 業(yè)廳補卡接口 . 15 數(shù)定義 . 16 類型 ) . 16 否申請個人證書 ) . 17 戶等級 ) . 17 戶類型 ) . 17 登錄密碼 ) . 17 別 ) . 17 件類別 ) . 17 屬地碼 ) . 18 地區(qū)碼 ) . 18 城市碼 ) . 19 郵政編碼 ) . 19 理機構(gòu)碼 ) . 19 受理渠道 ). 20 中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 4 服務(wù)收費標(biāo)志 ) . 20 賬戶類型 ) . 20 轉(zhuǎn)接機構(gòu)碼 ) . 20 支付機構(gòu)碼 ) . 20 出單機構(gòu)碼 ) . 20 商戶號 ) . 20 賬戶狀態(tài) ) . 21 通信設(shè)備狀態(tài) ) . 21 響應(yīng)碼 ) . 21 支付卡卡號） . 21 戶 /賬戶 . 22 碼類型） . 23 信產(chǎn)品號） . 23 端號） . 23 否實名） . 23 品號類型） . 23 錄 A . 23 誤代碼含義 . 23 務(wù)代碼名稱映射 . 26 10. 與 接口（ . 26 11. 與業(yè)務(wù)監(jiān)控系統(tǒng)的接口（ . 27 12. 與卡應(yīng)用管理平臺的接口（ . 27 13. 與省平臺的接口（ . 27 中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 1 頁 共 27 頁 1. 概述 本文 主要針對全國平臺與周邊系統(tǒng)的接口類型、接口字段 及其 格式取值 進行了 規(guī)范 說明 。 2. 引用標(biāo)準(zhǔn) 下列文件通過本文的參考而成為本技術(shù)要求的條款。凡是注日期的參考文件，其隨后所有的修改單（不包括勘誤的內(nèi)容）或修訂版均不適用于本文，凡是不注日期的參考文件，其最新版本適用于本文。 【 1】 中國電信翼支付產(chǎn)品（基礎(chǔ)版）業(yè)務(wù)規(guī)范（試行） 【 2】中國電信融合支付平臺技術(shù)要求 總冊 【 3】中國電信融合支付平臺技術(shù)要求 全國平臺功能分冊 【 4】中國電信融合支付平臺技術(shù)要求 省平臺功能分冊 【 5】中國電信融合支付平臺技術(shù)要求 技術(shù)流程分冊 3. 名詞解釋 術(shù)語 術(shù)語描述 翼支付賬戶 中國電信向用戶提供的電信消費賬戶中的在線支付賬戶 翼支付卡 已經(jīng)寫入電信翼支付賬戶的 翼支付卡號 為用戶翼支付卡分配的翼支付卡號，存放在翼支付卡內(nèi)，用以標(biāo)識翼支付應(yīng)用。 翼支 付賬號 翼支付賬號 是用戶用來登錄及使用翼支付賬戶的號碼，翼支付賬號編碼同電信通行證編碼。 端（接收端機具）接入平臺，分為全國、省兩級。 中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 2 頁 共 27 頁 4. 系統(tǒng)架構(gòu) 全 國 業(yè) 務(wù) 平 臺 或商 戶銀 行 / 第 三 方 支付 平 臺積 分 平 臺O T A 平 臺N S A M 省 前 置U D S P O 平 臺省 平 臺門 戶 網(wǎng) 站I F 1I F 2I F 3I F 4I F 5I F 6業(yè) 務(wù) 監(jiān) 控 系 統(tǒng)I F 7I F 9卡 應(yīng) 用 管 理 平 臺I F 8圖 4國平臺與周邊系統(tǒng)接口示意圖 全國平臺與外部存在以下一些主要接口： 與全國業(yè)務(wù)平臺或商戶系統(tǒng)的接口（ 主要是指在業(yè)務(wù)平臺或商戶系統(tǒng)發(fā)起支付時的頁面跳轉(zhuǎn)接口； 與銀行 /第三方支付機構(gòu)的接口（ 當(dāng)銀行 /第三方支付賬戶作為翼支付賬戶的充值資金源，此接口完成銀行 /第三方支付賬戶的認(rèn)證扣款； 與 臺的接口（ 主要 包括空中圈存、賬戶狀態(tài)控制等接口； 與 臺的接口（ 此接口主要實現(xiàn)網(wǎng)上登錄密碼的認(rèn)證； 與 前置的接口（ 虛擬省的 置系統(tǒng)通過此接口連入全國平臺，實現(xiàn)開戶、銷戶、狀態(tài)同步、掛失解掛、補換卡等功能； 與 接口（ 提供短信能力，實現(xiàn)支付密碼發(fā)送、支付結(jié)果通知等功能； 與業(yè)務(wù)監(jiān)控系統(tǒng)的接口（ 通過此接口監(jiān)控全國平臺的運行； 與卡應(yīng)用管理平臺的接口：實現(xiàn)卡信息同步、卡應(yīng)用控制等功能； 與省平臺的接口：包括省內(nèi)系統(tǒng)發(fā)起的與翼支付相關(guān)的各種接口； 中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 3 頁 共 27 頁 5. 與業(yè)務(wù)平臺或商 戶系統(tǒng)的接口（ 定向支付接口 口描述 接口名稱 重定向支付接口 接口描述 業(yè)務(wù)平臺或商戶系統(tǒng)的門戶網(wǎng)站將支付請求發(fā)送給融合支付全國平臺，通過重定向的方式，將頁面跳轉(zhuǎn)到融合支付全國平臺的網(wǎng)上支付頁面，用戶在融合支付全國平臺的網(wǎng)上支付頁面完成支付后再跳轉(zhuǎn)回業(yè)務(wù)平臺或商戶系統(tǒng)的門戶網(wǎng)站處理頁面。 接口提供者 融合支付全國平臺 接口使用者 業(yè)務(wù)平臺或商戶系統(tǒng)的門戶網(wǎng)站 接口類型 用場景 互聯(lián)網(wǎng)接入流程中的翼支付賬戶支付 備注 求參數(shù) 字段 含義 類型 長度 必填 備注 易 00 M 提交交易數(shù)據(jù)的 址 戶代碼 n 15 M 易訂單號 n 16 M 易金額 n 12 M 單位：分 種 n 3 M 默認(rèn)為人民幣， 156 易時間 n 14 M 訂單提交時間 易類型 n 4 M 面返回地址 00 M 頁面交易接收 臺返回地址 00 M 后臺交易接收 字簽名 56 M 為此次交易提交 關(guān)鍵數(shù)據(jù)的數(shù)字簽名 示例： （這里 內(nèi)容為提交交易數(shù)據(jù)的 址） （ 全國平臺 統(tǒng)一分配給商戶的商戶中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 4 頁 共 27 頁 號， 15 位長度，必填） （商戶提交給 全國平臺 的交易訂單號， 16位長度，必填） （訂單交易金額，單位為分， 12 位長 度 ，左補 0，必填） （訂單交易幣種， 3 位長度，固定為人民幣 156， 必填） （訂單交易日期， 14 位長度，必填） （交易類型， 4 位長度，必填） （頁面交易接收 度不要超過 500 個字節(jié)，必填） （后臺交易接收 度不要超過 500 個字節(jié)，必填） （ 256 字節(jié)長的 ， 為此次交易提交關(guān)鍵數(shù)據(jù)的數(shù)字簽名，必填） 答參數(shù) 示例： （這里 內(nèi)容為提交交易數(shù)據(jù)的 址） 字段 字段含義 類型 長度 必填 備注 回地址 n 32 M 回填 戶代碼 n 15 M 易訂單號 n 16 M 易金額 n 12 M 單位：分 種 n 3 M 默認(rèn)為人民幣， 156 易時間 n 14 M 訂單提交時間 易類型 n 4 M 回代碼 n 4 M 字簽名 56 M 中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 5 頁 共 27 頁 6. 與銀行 /第三方支付平臺的接口 （ 以銀行 /第三方支付平 臺接口為準(zhǔn)。 7. 與 臺的接口（ 全國平臺與 臺的接口主要是為離線應(yīng)用服務(wù)，暫不建設(shè)。 8. 與 臺的接口 （ 以 臺接口規(guī)范為準(zhǔn) ，詳見中國電信用戶數(shù)據(jù)庫 接口與流程規(guī)范 。 9. 與 紐的接口 （ 與 接口采用 口。 據(jù)類型 本數(shù)據(jù)類型 序號 類型 縮寫 類型描述 參考 1 a 字母 a z A、 a、 n 數(shù)字 0 9 1、 12、 s 特殊字符 、 # 4 母和數(shù)字字符 母、數(shù)字和特殊 字符 位數(shù)年份 2010（ 2010 年） 7 份中的月份 03（ 3 月份） 8 份中的日期 25（ 25 號） 9 時（ 24 格式） 15（ 15 點） 10 鐘 30（ 30 分） 11 59（ 59 秒） 中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 6 頁 共 27 頁 構(gòu)類型 序號 類型縮寫 類型描述 參考 1 戶信息類型 2 戶信息類型 號定義 序號 符號縮寫 符號性質(zhì) 符號說明 1 M 強制域 (此域 必選，否則將被認(rèn)為格式出錯 2 C 條件域 (此域在一定條件下必選 3 O 選用域 (此域由發(fā)送方自選 求消息結(jié)構(gòu) 構(gòu)說明 . 素說明 序號 元素名稱 元素說明 次數(shù) 1 元素為根元素 1 2 明本次請求控制信息。屬于消息頭。 1 3 明本次請求業(yè)務(wù)參數(shù)信息。屬于消息體。 1 性說明 序號 屬性名稱 屬性說明 1 務(wù)名稱，參考附錄 務(wù)編碼，參考附錄 國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 7 頁 共 27 頁 序號 屬性名稱 屬性說明 3 求此服務(wù)的客戶端標(biāo)識編碼。 建議格式：省份 版本號 4 機生成的流水，用于維持請求響應(yīng)對 應(yīng)消息結(jié)構(gòu) 構(gòu)說明 000000 素說明 序號 元素名稱 元素說明 次數(shù) 1 元素為根元素 1 2 明本次響應(yīng)的控制信息。屬于消息頭。 1 3 明本次響應(yīng)業(yè)務(wù)參數(shù)信息。屬于消息體。 1 4 明本次響應(yīng)說明信息。屬于消息體。 1 5 明本次響應(yīng)包含結(jié)果集。屬于消息體。 01 6 裝具體結(jié)果集。屬于消息體。 0N 性說明 序號 屬性名稱 屬性說明 1 自對應(yīng)請求 國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 8 頁 共 27 頁 序號 屬性名稱 屬性說明 2 詢類響應(yīng)為 20，其余都為 10 3 自對應(yīng)請求 果成功 ”如果失敗 ”口說明 戶發(fā)卡 接口 口描述 接口名稱 開戶 發(fā)卡 接口 接口描述 用戶在營業(yè)廳開通支付賬戶 和翼支付 省 國 平臺 接口提供者 融合支付 全國 平臺 接口使用者 前置 接口類型 用場景 營業(yè)廳開戶流程 備注 求參數(shù) 字段 含義 類型 長度 必填 參考 號 n 32 M 見 類型 n 1 M 見 戶名 0 M 真實姓名，如張三 錄號 0 M 翼支付登錄別名，初期采用 品號 0 M 見 否已認(rèn)證 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 中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 9 頁 共 27 頁 字段 含義 類型 長度 必填 參考 他電話 n 15 O 地 n 15 M 所開戶的屬地。 見 區(qū)代碼 n 6 M 所開戶的地區(qū)。 見 市編 碼 n 6 M 所開戶的城市。 見 系地址 00 O 位地址 00 O 位郵編 n 6 O 見 位代碼 n 30 O 理機構(gòu)代碼 n 15 M 見 理人 n 20 O 理地區(qū)代碼 n 6 M 受理的地區(qū)。 見 理城市代碼 n 6 M 受理的城市。 見 理渠道 n 2 M 見 理流水 n 20 M 務(wù)收費標(biāo)志 n 1 M 見 務(wù)收費金額 n 12 M 以分為單位 作人員代碼 n 20 O 作時間 n 14 M 式 權(quán)員工標(biāo)識 n 20 O 權(quán)時間 n 14 O 式 答參數(shù) 字段 含義 類型 長度 必填 備注 應(yīng)碼 n 6 M 見 應(yīng)碼描述 00 C 當(dāng)響應(yīng)碼不為 000000 戶接口 口描述 接口名稱 開戶接口 接口描述 用戶在營業(yè)廳開通支付賬戶，省 接口提供者 融合支付全國平臺 接口使用者 前置 接口類型 用場景 營業(yè)廳開戶流程 備注 中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 10 頁 共 27 頁 求參數(shù) 字段 含義 類型 長度 必填 參考 戶名 0 M 真實姓名，如張三 錄號 0 O 翼支付登錄別名，初期采用 品號 0 M 見 否已認(rèn)證 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 所開戶的屬地。見 區(qū)代碼 n 6 M 所開戶的地區(qū)。見 市編碼 n 6 M 所開戶的城市。見 系地址 00 O 位地址 00 O 位郵編 n 6 O 見 位代碼 n 30 O 理機構(gòu)代碼 n 15 M 見 理人 n 20 O 理 地區(qū)代碼 n 6 M 受理的地區(qū)。見 理城市代碼 n 6 M 受理的城市。見 理渠道 n 2 M 見 理流水 n 20 M 務(wù)收費標(biāo)志 n 1 M 見 務(wù)收費金額 n 12 M 以分為單位 作人員代碼 n 20 O 作時間 n 14 M 式 權(quán)員工標(biāo)識 n 20 O 權(quán)時間 n 14 O 式 答參數(shù) 字段 含義 類型 長度 必填 備注 應(yīng)碼 n 6 M 見 應(yīng)碼描述 00 C 當(dāng)響應(yīng)碼不為 000000 中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 11 頁 共 27 頁 戶請求接口 口描述 接口名稱 銷戶請求接口 接口描述 用戶在營業(yè)廳銷戶， 省 相應(yīng)信息發(fā)至到融合支付全國 平臺 接口提供者 融合支付 全國 平臺 接口使用者 前置 接口類型 用場景 營業(yè)廳銷戶流程 備注 求參數(shù) 字段 含義 類型 長度 必填 備注 品號 0 M 見 戶名 0 M 件類型 n 1 M 見 件號碼 n 20 M 理機構(gòu)代碼 n 15 M 見 理人 n 20 O 理地區(qū)代碼 n 6 M 受理的地區(qū)。 見 理城市代碼 n 6 M 受理的城市。 見 理渠道 n 2 M 見 理流水 n 20 M 務(wù)收費標(biāo)志 n 1 M 見 務(wù)收費金額 n 12 M 作人員代碼 n 20 O 作時間 n 14 M 式 權(quán)員工標(biāo)識 n 20 O 權(quán)時間 n 14 O 式 答參數(shù) 字段 含義 類型 長度 必填 備注 應(yīng)碼 n 6 M 見 應(yīng)碼描述 00 C 當(dāng)響應(yīng)碼不為 000000 業(yè)廳掛失接口 口描述 中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 12 頁 共 27 頁 接口名稱 營業(yè)廳掛失接口 接口描述 用戶在營業(yè)廳掛失，省 統(tǒng)將相應(yīng)信息發(fā)至到融合支付全國平臺 接口提供者 融合支付 全國 平臺 接口使用者 前置 接口類型 用場景 營業(yè)廳掛失流程 備注 求參數(shù) 字段 含義 類型 長度 必填 備注 品號 0 M 見 戶名 0 M 件類型 n 1 M 見 件號碼 n 20 M 理機構(gòu)代碼 n 15 M 見 理人 n 20 O 理地區(qū)代碼 n 6 M 受理的地區(qū)。見 理城市代碼 n 6 M 受理的城市。見 理渠道 n 2 M 見 理流水 n 20 M 務(wù)收費標(biāo)志 n 1 M 見 務(wù)收費金額 n 12 M 作人員代碼 n 20 O 作時間 n 14 M 式 權(quán)員工標(biāo)識 n 20 O 權(quán)時間 n 14 O 式 答參數(shù) 字段 含義 類型 長度 必填 備注 應(yīng)碼 n 6 M 見 應(yīng)碼描述 00 C 當(dāng)響應(yīng)碼不為 000000 業(yè)廳解掛接口 口描述 接口名稱 營業(yè)廳解掛接口 接口描述 用戶在營業(yè)廳解除掛失，省 國 平臺 接口提供者 融合支付全國 平臺 中國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 13 頁 共 27 頁 接口使用者 前置 接口類型 用場景 營業(yè)廳解掛流程 備注 求參數(shù) 字段 含義 類型 長度 必填 備注 品號 0 M 見 戶名 0 M 件類型 n 1 M 見 件號碼 n 20 M 理機構(gòu)代碼 n 15 M 見 理人 n 20 O 理地區(qū)代碼 n 6 M 受理的地區(qū)。見 理城市代碼 n 6 M 受理的城市。見 理渠道 n 2 M 見 理流水 n 20 M 務(wù)收費標(biāo)志 n 1 M 見 務(wù)收費金額 n 12 M 作人員代碼 n 20 O 作時間 n 14 M 式 權(quán)員工標(biāo)識 n 20 O 權(quán)時間 n 14 O 式 答參數(shù) 字段 含義 類型 長度 必填 備注 應(yīng)碼 n 6 M 見 應(yīng)碼描述 00 C 當(dāng)響應(yīng)碼不為 000000 態(tài)同步接口 口描述 接口名稱 狀態(tài)同步接口 接口描述 用戶在營業(yè)廳變更翼支付賬戶狀態(tài)，省 步給融合支付全國 平臺 接口提供者 融合支付全國 平臺 接口使用者 前置 接口類型 國電信融合支付平臺技術(shù)要求 全國平臺 接口 分冊 第 14 頁 共 27 頁 應(yīng)用場景 營業(yè)廳賬戶狀態(tài)變更流程 備注 求參數(shù) 字段 含義 類型 長度 必填 備注 品號 0 M 見 信狀態(tài) n 20 M 見 理機構(gòu)代碼 n 15 M 見 理人 n 20 O 理地區(qū)代碼 n 6 M 受理的地區(qū)。 見 理城市代碼 n 6 M 受理的城市。 見 理渠道 n 2 M 見 理流水 n 20 M 務(wù)收費標(biāo)志 n 1 O 見 務(wù)收費金額 n 1