翼支付客戶端支付應(yīng)用接入指南

1、翼支付客戶端支付應(yīng)用接入指南（HTML5應(yīng)用開(kāi)發(fā)）版本歷史版本/狀態(tài)作者部門日期備注鄧志亮、胡靈敏客戶端2015-9-23H5接入技術(shù)內(nèi)容更新張記文客戶端2015-04-01Onpay 刪除 MERCHANTPWD目錄本文閱讀對(duì)彖為中國(guó)電信翼支付客戶端合作商戶的產(chǎn)品開(kāi)發(fā)、研發(fā)相關(guān)技術(shù)人員。2使用用途本文介紹在HTML5平臺(tái)開(kāi)發(fā)符合標(biāo)準(zhǔn)的支付應(yīng)用并與翼支付客戶端集成的技術(shù)細(xì)節(jié)，幫 助商戶將其業(yè)務(wù)與翼支付客戶端系統(tǒng)對(duì)接。3名詞解釋名稱名稱說(shuō)明說(shuō)明安全支付模塊翼支付客戶端中向用戶提供賬戶選擇、訂單確認(rèn)、密碼輸入等功能并保障用戶支 付安全的模塊，供各類支付應(yīng)用客戶端調(diào)用。網(wǎng)關(guān)平臺(tái)中國(guó)電信天翼電子商務(wù)有

2、限公司開(kāi)發(fā)的與翼支付客戶端、商戶支付應(yīng)用平臺(tái)交互 的服務(wù)端系統(tǒng)。支付應(yīng)用客戶端合作商戶開(kāi)發(fā)的可下載集成到翼支付客戶端的客戶端軟件，向手機(jī)用戶提供該合 作商戶的業(yè)務(wù)。支付應(yīng)用平臺(tái)合作商戶的與支付應(yīng)用客戶端和網(wǎng)關(guān)平臺(tái)交互的服務(wù)端系統(tǒng)。翼支付收銀臺(tái)主要用來(lái)向翼支付客戶端及其商戶應(yīng)用提供便捷、安全以及可靠的支付服務(wù)終端平臺(tái)指手機(jī)系統(tǒng)平臺(tái)，android或ios功能驗(yàn)收測(cè)試翼支付根據(jù)商戶提供的測(cè)試報(bào)告進(jìn)行驗(yàn)收測(cè)試，并出具測(cè)試報(bào)告適配測(cè)試在功能驗(yàn)收測(cè)試通過(guò)的前提下，在android和IOS多種不同機(jī)型下進(jìn)行測(cè)試，并出具 適配報(bào)告前置審核產(chǎn)品體驗(yàn)和功能驗(yàn)收測(cè)試通過(guò)之后，山商戶提供產(chǎn)品手冊(cè)和客服腳本，翼支付產(chǎn)

3、品 經(jīng)理審核完成之后安排內(nèi)部客戶體驗(yàn)上線將商戶應(yīng)用開(kāi)放給普通用戶4接入流程1、中請(qǐng)接入：配置測(cè)試環(huán)境和網(wǎng)關(guān)商戶編碼；2、接入測(cè)試：應(yīng)用方發(fā)【應(yīng)用接入 】測(cè)試版本安裝包到我方產(chǎn)品經(jīng)理進(jìn)行測(cè)試環(huán) 境配置，郵件格式見(jiàn)：3、我方產(chǎn)品經(jīng)理通知運(yùn)營(yíng)進(jìn)行應(yīng)用配置；4、接入測(cè)試：測(cè)試環(huán)境配置完成之后通知應(yīng)用方測(cè)試，回復(fù)【應(yīng)用接入】郵件“測(cè) 試環(huán)境配置完成”，同時(shí)發(fā)送客戶端測(cè)試安裝包；5、接入測(cè)試：應(yīng)用提供方發(fā)【測(cè)試報(bào)告】，（測(cè)試報(bào)告中需包含測(cè)試用例）郵件到我 方產(chǎn)品經(jīng)理；6、功能驗(yàn)收測(cè)試：我方根據(jù)提供的測(cè)試報(bào)告進(jìn)行驗(yàn)收測(cè)試，并岀具測(cè)試報(bào)告；7、接入生產(chǎn)環(huán)境：驗(yàn)收測(cè)試通過(guò)后，通知生產(chǎn)上線準(zhǔn)備，接入生產(chǎn)測(cè)試：8、

4、接入生產(chǎn)測(cè)試：生產(chǎn)環(huán)境配置完成之后通知應(yīng)用方生產(chǎn)即正式環(huán)境測(cè)試，回復(fù)【應(yīng) 用接入】郵件“生產(chǎn)環(huán)境配置完成”；9、應(yīng)用提供方發(fā)【測(cè)試報(bào)告】郵件到我方接口人；10、 接入生產(chǎn)測(cè)試：我方根據(jù)應(yīng)用方提供的生產(chǎn)測(cè)試報(bào)告進(jìn)行驗(yàn)收測(cè)試，并岀具測(cè)試 報(bào)告；11、 功能測(cè)試：通過(guò)之后請(qǐng)產(chǎn)品部進(jìn)行產(chǎn)品體驗(yàn)；12、 前置審核：產(chǎn)品體驗(yàn)和功能驗(yàn)收測(cè)試通過(guò)之后需要應(yīng)用方根據(jù)“客戶端客服知識(shí) 庫(kù)內(nèi)容規(guī)范”和“客戶端知識(shí)庫(kù)及客服解釋腳本模板0605”提供產(chǎn)品手冊(cè)和客服腳本, 由產(chǎn)品經(jīng)理審核完成之后安排內(nèi)部客戶體驗(yàn)；12、體驗(yàn)完成之后通知市場(chǎng)部，由市場(chǎng)部完成上線流程并開(kāi)放給普通用戶。5交互流程6接口說(shuō)明客戶端側(cè)接口HTML5

5、本地接I I函數(shù)庫(kù)，定義了支付應(yīng)用與翼支付客戶端原生應(yīng)用本地之間的交互接I Io根據(jù)支付應(yīng)用場(chǎng)景抽象出通用的類庫(kù)，如用戶信息、應(yīng)用、對(duì)話框、通訊錄、掃一掃、支付 模塊等等。詳見(jiàn)。服務(wù)器側(cè)接口支付應(yīng)用平臺(tái)與網(wǎng)關(guān)平臺(tái)間采用http方式通信，見(jiàn)文檔【翼支付移動(dòng)收銀臺(tái)支付接 口開(kāi)發(fā)包標(biāo)準(zhǔn)版-3節(jié)】。7開(kāi)發(fā)調(diào)試7.17.1翼支付提供的資源.1翼支付客戶端翼支付客戶端連接翼支付生產(chǎn)環(huán)境的客戶端版本。（可自行到官網(wǎng)下載）.2 商戶商戶 IDID我們?yōu)樗幸碇Ц犊蛻舳说暮献魃虘舴峙湟粋€(gè)專有的網(wǎng)關(guān)商戶ID,作為商戶的標(biāo)識(shí)。.3翼支付賬號(hào)開(kāi)通翼支付賬號(hào)開(kāi)通應(yīng)用配置到

6、測(cè)試環(huán)境后，合作商戶的手機(jī)號(hào)碼開(kāi)通翼支付賬戶，充值并下發(fā)支付密 碼，供開(kāi)發(fā)測(cè)試使用。72商戶準(zhǔn)備的資源7.7. 2.12.1翼支付賬號(hào)翼支付賬號(hào)f f合作商戶需在翼支付客戶端注冊(cè)開(kāi)通翼支付賬號(hào)(支持多個(gè))，提供給翼支付運(yùn) 營(yíng)進(jìn)行賬號(hào)配置。7.7. 2.22.2 H5H5 站點(diǎn)站點(diǎn)合作商戶開(kāi)發(fā)的H5應(yīng)用(遠(yuǎn)程站點(diǎn))，用于展示合作商戶的業(yè)務(wù)，將應(yīng)用地址提供 翼支付運(yùn)營(yíng)進(jìn)行應(yīng)用配置。7.7. 2.32.3支付應(yīng)用平臺(tái)支付應(yīng)用平臺(tái)合作商戶開(kāi)發(fā)的支付應(yīng)用平臺(tái)，與翼支付網(wǎng)關(guān)環(huán)境對(duì)接，進(jìn)行訂單生成，接收并響 應(yīng)支付結(jié)果。73商戶進(jìn)行H5開(kāi)發(fā)使用賬號(hào)登錄翼支付客戶端，即可在首頁(yè)(或者首頁(yè)更多頁(yè))看到商戶自己的

7、應(yīng)用，進(jìn)行頁(yè)面 H5應(yīng)用開(kāi)發(fā)，如需使用翼支付客戶端側(cè)接口(如支付)，在頁(yè)面嵌入即可。7. 4注意事項(xiàng)應(yīng)用首頁(yè)必須回退到翼支付大廳，必須使用翼支付，且只能使用翼支付，不可使用其他第三 方支付工具。翼支付客戶端H5應(yīng)用容器的topbar區(qū)域?qū)儆趎ative,默認(rèn)情況卞，左上角返回按鈕的事件 為退出當(dāng)前H5應(yīng)用，建議商戶在自己的H5應(yīng)用內(nèi)用topbar控制頁(yè)面返回。=function()(true);返回按鈕事:件交由頁(yè)面js處理(function(event) if (event = backpress) /觸發(fā)返回按鈕事件(對(duì)android來(lái)說(shuō)，包括物理返回鍵)在應(yīng)用首頁(yè)的代碼：()；8提交測(cè)試

8、提交測(cè)試報(bào)告支付應(yīng)用開(kāi)發(fā)完成并配置到測(cè)試環(huán)境/生產(chǎn)環(huán)境后，需提交測(cè)試報(bào)告，表明支付 應(yīng)用己具備上線集成測(cè)試基礎(chǔ)。測(cè)試報(bào)告需涵蓋支付應(yīng)用主要功能用例，包括完整的支付流程測(cè)試。測(cè)試報(bào)告需要以郵件的形式反饋【測(cè)試報(bào)告】【應(yīng)用名稱】測(cè)試環(huán)境/生產(chǎn)環(huán)境測(cè) 試報(bào)告附件：測(cè)試報(bào)告模板。見(jiàn)應(yīng)用需稱終端平臺(tái)應(yīng)用版本測(cè)試報(bào)告模板.Xlsx 此測(cè)試報(bào)告模板的中訂單支付用例必須測(cè)試，且需要提供訂單支付手機(jī)截圖，其他應(yīng) 用功能測(cè)試用例請(qǐng)應(yīng)用提供方補(bǔ)充并完成測(cè)試。9客戶端側(cè)接口定義91用戶接口 (User)9.9. L L 1 1 獲取產(chǎn)品號(hào)獲取產(chǎn)品號(hào)- - getProductgetProduct(1)接口描述接口描述

9、接口名稱獲取用戶產(chǎn)品號(hào)接口描述獲取用戶產(chǎn)品號(hào)，也就是電話/手機(jī)號(hào)碼接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用應(yīng)用場(chǎng)景業(yè)務(wù)應(yīng)用需要用到當(dāng)前登錄用戶的產(chǎn)品時(shí)，從當(dāng) 前登錄會(huì)話中讀岀(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)無(wú)應(yīng)答參數(shù)應(yīng)答參數(shù)返回值：返回用戶產(chǎn)品號(hào)的字符串。接口名稱調(diào)用實(shí)例調(diào)用實(shí)例$_id( ,phone_edit) .value = User.();9. 2應(yīng)用信息及操作(App)9.9. 2.12.1設(shè)置頂部標(biāo)題設(shè)置頂部標(biāo)題- -setTitlesetTitle(1)接口描述接口描述接口名稱設(shè)置支付應(yīng)用客戶端頂部標(biāo)題接口描述設(shè)置支付應(yīng)用客戶端頂部標(biāo)題接口提供者支付應(yīng)用客戶端接口使用者HT

10、51L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)主字段含義炎型必填長(zhǎng)度備注Title標(biāo)題ansM20(3)應(yīng)答參數(shù)應(yīng)答參數(shù)無(wú)調(diào)用實(shí)例調(diào)用實(shí)例(”商品詳情9.9. 2.2. 2 2 獲取客戶端版本號(hào)一獲取客戶端版本號(hào)一 getClientVersiongetClientVersion(1)接口描述接口描述獲取客戶端版本號(hào)接口描述獲取客戶端大廳的版本號(hào)接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)無(wú)應(yīng)答參數(shù)應(yīng)答參數(shù)(4)客戶端人廳版本號(hào)字符串，如調(diào)用實(shí)例如調(diào)用實(shí)例0;9.9. 2.2. 3 3 打開(kāi)瀏覽器窗口打開(kāi)瀏覽器窗口 一一 openBrowseropenBrowser(1

11、)接口描述接口描述接口名稱打開(kāi)外部瀏覽器接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)字符串，url應(yīng)答參數(shù)應(yīng)答參數(shù)無(wú)調(diào)用實(shí)例調(diào)用實(shí)例App. open Browser9.29.24 4 截?cái)喾祷劓I截?cái)喾祷劓I- -overrideBackPressedoverrideBackPressed接口描述接口描述接口名稱截?cái)喾祷劓I接口描述用戶按返回鍵時(shí)不會(huì)退出渲染頁(yè) 面接口提供者支付應(yīng)用客戶端接口使用者HTN1L5業(yè)務(wù)應(yīng)用(6)請(qǐng)求參數(shù)請(qǐng)求參數(shù)主字段含義炎型必填長(zhǎng)度備注bound是否截?cái)郺nsM20t rue(7)應(yīng)答參數(shù)應(yīng)答參數(shù)無(wú)(8)調(diào)用實(shí)例調(diào)用實(shí)例App. over

12、rideBackPressed(true);9.9. 2.2. 5 5 功能頁(yè)面跳轉(zhuǎn)功能頁(yè)面跳轉(zhuǎn) - - jumpToNativeViewjumpToNativeView接口描述接口描述接口名稱跳轉(zhuǎn)至native頁(yè)面接口描述跳轉(zhuǎn)至翼支付客戶端原生頁(yè)面接口提供者支付應(yīng)用客戶端接口使用者HTN1L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)參數(shù)均為字符串參數(shù)均為字符串參數(shù)值說(shuō)明RealnameVerifyEntranceActivity跳轉(zhuǎn)至翼支付實(shí)名認(rèn)證界面ForgotPaymentPassword跳轉(zhuǎn)至翼支付忘記支付密碼界面More_MainActivity跳轉(zhuǎn)至翼支付客服中心BindCard跳轉(zhuǎn)至翼支付

13、綁卡界面(3)應(yīng)答參數(shù)應(yīng)答參數(shù)(4)調(diào)用實(shí)例調(diào)用實(shí)例App. jumpToNative (BindCard)9.9. 2.2. 6 6 支付密碼安全輸入支付密碼安全輸入- - openSafKeyboardopenSafKeyboard(1)接口描述接口描述接口名稱支付接口描述調(diào)起翼支付收銀臺(tái)進(jìn)行支付接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)主字段含義炎型必填填長(zhǎng)度備注len輸入字符長(zhǎng) 度ansM50暫固定6位title彈出框標(biāo)題ansM50暫不可設(shè)置succ_cbk調(diào)用成功回 調(diào)函數(shù)funcM返回加密后的密碼fail_cbk調(diào)用失敗回 調(diào)函數(shù)func0(3)

14、應(yīng)答參數(shù)應(yīng)答參數(shù)無(wú)(4)調(diào)用實(shí)例調(diào)用實(shí)例(6，”，function(pwd)j function()9.9. 2.2. 7 7 獲取登錄會(huì)話碼一獲取登錄會(huì)話碼一 getSessionKeygetSessionKey(1)接口描述接口描述接口名稱獲取登錄會(huì)話碼接口描述獲取登錄會(huì)話碼接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)無(wú)應(yīng)答參數(shù)應(yīng)答參數(shù)返回值：返回sessionKey調(diào)用實(shí)例調(diào)用實(shí)例App getSessionKey ();9.9. 2.2. 8 8 設(shè)置頭部隱藏顯示設(shè)置頭部隱藏顯示- - setHeaderVisiblesetHeaderVisible接口

15、描述接口描述接口名稱設(shè)置頭部隱藏顯示接口描述設(shè)置頭部隱藏顯示接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用(6)請(qǐng)求參數(shù)請(qǐng)求參數(shù)主字段含義炎型必填填長(zhǎng)度備注isVisible頭部是否隱藏ansM M20false(7)應(yīng)答參數(shù)應(yīng)答參數(shù)(8)調(diào)用實(shí)例調(diào)用實(shí)例App. setHeaderVisible (false);9.9. 2.2. 9 9登錄會(huì)話碼續(xù)期登錄會(huì)話碼續(xù)期- - autoLoginautoLogin(1)接口描述接口描述接口名稱登錄會(huì)話碼續(xù)期接口描述登錄會(huì)話碼續(xù)期，成功后返回新的sessionKey接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)

16、無(wú)(3)應(yīng)答參數(shù)應(yīng)答參數(shù)返回值：回調(diào)函數(shù)中返回新的sessionKey調(diào)用實(shí)例調(diào)用實(shí)例App. autoLogin (function(sessionKey)lf(sessionKey != )=lastAddress;9.9. 2.2.1010 獲取網(wǎng)絡(luò)類型獲取網(wǎng)絡(luò)類型- -getNetworkTypegetNetworkType(1)接口描述接口描述接口名稱獲取網(wǎng)絡(luò)類型接口描述獲取當(dāng)前手機(jī)連接的網(wǎng)絡(luò)類型接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)無(wú)應(yīng)答參數(shù)應(yīng)答參數(shù)返回值：網(wǎng)絡(luò)連接類型2g/3g/4g/wifi(4)調(diào)用實(shí)例調(diào)用實(shí)例var nt =();9.9

17、. 2.2.1111獲取用戶地區(qū)碼獲取用戶地區(qū)碼- -getLocationgetLocation接口描述接口描述接口名稱獲取用戶地區(qū)碼接口描述獲取當(dāng)前用戶所在的城市地區(qū)碼接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)無(wú)應(yīng)答參數(shù)應(yīng)答參數(shù)地區(qū)碼好(4)調(diào)用實(shí)例調(diào)用實(shí)例var locationCode =();9.9. 2.2.1212退出當(dāng)前應(yīng)用退出當(dāng)前應(yīng)用- - exitAppexitApp接口描述接口描述接口名稱退岀當(dāng)前應(yīng)用接口描述退出當(dāng)前H5應(yīng)用接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用請(qǐng)求參數(shù)請(qǐng)求參數(shù)無(wú)(7)應(yīng)答參數(shù)應(yīng)答參數(shù)無(wú)調(diào)用實(shí)例調(diào)用實(shí)例$(

18、r,#exitAppw) click9. 3 通信接口 (Contacts)9.9. 3.3.1 1 打開(kāi)聯(lián)系人打開(kāi)聯(lián)系人- -openContactsopenContacts(1)接口描述接口描述接口名稱打開(kāi)聯(lián)系人接口描述打開(kāi)移動(dòng)終端的聯(lián)系人通訊錄對(duì)話框接口接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)主字段含義炎型必填長(zhǎng)度備注success調(diào)用成功時(shí) 執(zhí)行的函數(shù)ansM M30fail調(diào)用失敗時(shí) 執(zhí)行的函數(shù)func0 0(3)應(yīng)答參數(shù)應(yīng)答參數(shù)無(wú)。所讀取的聯(lián)系人返回值通過(guò)回調(diào)函數(shù)獲取。(4)調(diào)用實(shí)例調(diào)用實(shí)例0；function(phone_no)$_id(pho

19、ne_edit)value = phone_no;function(error)；9.9. 3.23.2打電話打電話- - teltel(1)接口描述接口描述接口名稱打電話接口描述打電話接口接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)主字段含義炎型必填長(zhǎng)度備注tel電話號(hào)碼ansM M30(3)應(yīng)答參數(shù)應(yīng)答參數(shù)返回值：返回空字符串。(4)調(diào)用實(shí)例調(diào)用實(shí)例$_id(teleservice).onclick = function()94原生對(duì)話框(Dialog)9.9. 4.4.1 1俄彈出等待對(duì)話框一俄彈出等待對(duì)話框一 showProgressDialogshow

20、ProgressDialog(1)接口描述接口描述接口名稱彈出等待對(duì)話框接口描述彈出等待對(duì)話框接口接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)主字段含義炎型必填長(zhǎng)度備注title標(biāo)題ansM50msg消息ans0200(3)應(yīng)答參數(shù)應(yīng)答參數(shù)返回值：返回對(duì)話框句柄標(biāo)識(shí)字符串。(4)調(diào)用實(shí)例調(diào)用實(shí)例var dialogid = Dialog. showProgressDialog (提示/IE在加載業(yè)務(wù)數(shù)據(jù),請(qǐng)稍候，)；9.9. 4.4. 2 2 關(guān)閉等待對(duì)話框關(guān)閉等待對(duì)話框- - dismissDialogdismissDialog(1)接口描述接口描述接口名稱關(guān)閉等待對(duì)話框接口描述關(guān)閉等待對(duì)話框接口接口提供者支付應(yīng)用客戶端接口使用者HT51L5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)請(qǐng)求參數(shù)主字段含義炎型必填長(zhǎng)度備注iddialogic!ansM50(3)應(yīng)答參數(shù)應(yīng)答參數(shù)無(wú)調(diào)用實(shí)例調(diào)用實(shí)例Dialog dismissDialog(dialog_id);(2)alert(係統(tǒng)繁忙，請(qǐng)稍后再試);9.9. 4.34.3關(guān)閉所有彈出的對(duì)話框關(guān)閉所有彈出的對(duì)話框- - closeDialogcloseDialog(1)接口描述接口描述接口名稱關(guān)閉彈出對(duì)話框接口描述關(guān)閉彈出對(duì)話框接口接口