1、翼支付客戶端支付應(yīng)用接入指南（HTML5應(yīng)用開(kāi)發(fā)）版本歷史版本/狀態(tài)作者部門日期備注鄧志亮、胡靈敏客戶端2015-9-23H5接入技術(shù)內(nèi)容更新張記文客戶端2015-04-01Onpay 刪除 MERCHANTPWD目錄1使用對(duì)象本文閱讀對(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ō)明安全支付模塊翼支付客戶端中向用戶提供賬戶選擇、訂單確認(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)平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)放給普通用戶上線將商戶應(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)上線

4、準(zhǔn)備，接入生產(chǎn)測(cè)試：8、接入生產(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ō)明客戶

5、端側(cè)接口HTML5本地接I I函數(shù)庫(kù)，定義了支付應(yīng)用與翼支付客戶端原生應(yīng)用本地之間的交互接I lo根據(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.1翼支付提供的資源7.1.1翼支付客戶端連接翼支付生產(chǎn)環(huán)境的客戶端版本。（可自行到官網(wǎng)下載）7.1.2 商戶 ID我們?yōu)樗幸碇Ц犊蛻舳说暮献魃虘舴峙湟粋€(gè)專有的網(wǎng)關(guān)商戶ID,作為商戶的標(biāo)識(shí)。7.1.3翼支付賬號(hào)開(kāi)通應(yīng)用配置到測(cè)試環(huán)境后，合作商戶的手機(jī)號(hào)碼開(kāi)通翼支付賬戶，充值并

6、下發(fā)支付密 碼，供開(kāi)發(fā)測(cè)試使用。7.2商戶準(zhǔn)備的資源7. 2.1翼支付賬號(hào)f合作商戶需在翼支付客戶端注冊(cè)開(kāi)通翼支付賬號(hào)(支持多個(gè))，提供給翼支付運(yùn) 營(yíng)進(jìn)行賬號(hào)配置。7. 2.2 H5 站點(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. 2.3支付應(yīng)用平臺(tái)合作商戶開(kāi)發(fā)的支付應(yīng)用平臺(tái)，與翼支付網(wǎng)關(guān)環(huán)境對(duì)接，進(jìn)行訂單生成，接收并響 應(yīng)支付結(jié)果。7. 3商戶進(jìn)行H5開(kāi)發(fā)使用賬號(hào)登錄翼支付客戶端，即可在首頁(yè)(或者首頁(yè)更多頁(yè))看到商戶自己的應(yīng)用，進(jìn)行頁(yè)面 H5應(yīng)用開(kāi)發(fā)，如需使用翼支付客戶端側(cè)接口(如支付)，在頁(yè)面嵌入即可。7.4注意事項(xiàng)應(yīng)用首頁(yè)必須

7、回退到翼支付大廳，必須使用翼支付，旦只能使用翼支付，不可使用其他第三 方支付工具。翼支付客戶端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è)試提交測(cè)試報(bào)告支付應(yīng)用開(kāi)發(fā)完成并配置到測(cè)試環(huán)境/生產(chǎn)環(huán)境后，需提交測(cè)試報(bào)告，表明支付 應(yīng)用已具備上線集成測(cè)試基礎(chǔ)

8、。測(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è)接口定義9.1 用戶接口 (User)9.1.1 獲取產(chǎn)品號(hào) - getProduct(1)接口描述接口名稱獲取用戶產(chǎn)品號(hào)接口描述獲取用戶產(chǎn)品號(hào)，也就是電話/手機(jī)號(hào)碼接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用應(yīng)用場(chǎng)景業(yè)務(wù)應(yīng)用需要用到當(dāng)前登錄用戶的產(chǎn)

9、品時(shí)，從當(dāng) 前登錄會(huì)話中讀出(2)請(qǐng)求參數(shù)應(yīng)答參數(shù)返回值：返回用戶產(chǎn)品號(hào)的字符串。調(diào)用實(shí)例$_id( ,phone_edit ) .value = User.();9. 2應(yīng)用信息及操作(App)9. 2.1設(shè)置頂部標(biāo)題-setTitle(1)接口描述接口名稱設(shè)置支付應(yīng)用客戶端頂部標(biāo)題接口描述設(shè)置支付應(yīng)用客戶端頂部標(biāo)題接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)主字段含義關(guān)型必填長(zhǎng)度備注Title標(biāo)題ansM20(3)應(yīng)答參數(shù)無(wú)調(diào)用實(shí)例9. 2. 2 獲取客戶端版本號(hào)-getClientVersion(1)接口描述接口名稱獲取客戶端版本號(hào)接口描述獲取客戶端大廳的版本號(hào)接口

10、提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)無(wú)應(yīng)答參數(shù)(4)客戶端大廳版本號(hào)字符串，如調(diào)用實(shí)例0;9. 2. 3 打開(kāi)瀏覽器窗口 - openBrowser(1)接口描述接口名稱打開(kāi)外部瀏覽器接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)字符串，url應(yīng)答參數(shù)無(wú)調(diào)用實(shí)例App. openBrowser ();9.2.4 截?cái)喾祷劓I 一 overrideBackPressed(5)接口描述接口名稱截?cái)喾祷劓I接口描述用戶按返回鍵時(shí)不會(huì)退出渲染頁(yè) 面接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(6)請(qǐng)求參數(shù)主字段含義關(guān)型必填長(zhǎng)度備注bound是否截?cái)郺n

11、sM20true應(yīng)答參數(shù)無(wú)調(diào)用實(shí)例App overrideBackPressed(true);9. 2. 5 功能頁(yè)面跳轉(zhuǎn) - jumpToNativeView(1)接口描述接口名稱跳轉(zhuǎn)至native頁(yè)面接口描述跳轉(zhuǎn)至翼支付客戶端原生頁(yè)面接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)參數(shù)均為字符串參數(shù)值說(shuō)明RealnameVerifyEntranceActivity跳轉(zhuǎn)至翼支付實(shí)名認(rèn)證界面ForgotPaymentPassword跳轉(zhuǎn)至翼支付忘記支付密碼界面More_Ma i nActivity跳轉(zhuǎn)至翼支付客服中心BindCard跳轉(zhuǎn)至翼支付綁卡界面(3)應(yīng)答參數(shù)無(wú)(4)調(diào)

12、用實(shí)例App. jumpToNative (BindCard)9 function()()9. 2. 7 獲取登錄會(huì)話碼- getSessionKey(1)接口描述接口名稱獲取登錄會(huì)話碼接口描述獲取登錄會(huì)話碼接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用請(qǐng)求參數(shù)無(wú)應(yīng)答參數(shù)返回值：返回sessionKey調(diào)用實(shí)例App. getSessionKey ();9. 2. 8 設(shè)置頭部隱藏顯示-setHeaderVisible接口描述接口名稱設(shè)置頭部隱藏顯示接口描述設(shè)置頭部隱藏顯示接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(6)請(qǐng)求參數(shù)主字段含義關(guān)型必填長(zhǎng)度備注isVisible頭部是

13、否隱藏ansM20false(7)應(yīng)答參數(shù)無(wú)App. setHeaderVisible (false);9. 2. 9登錄會(huì)話碼續(xù)期- autoLogin(1)接口描述接口名稱登錄會(huì)話碼續(xù)期接口描述登錄會(huì)話碼續(xù)期，成功后返回新的sessionKey接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)無(wú)(3)應(yīng)答參數(shù)返回值：回調(diào)函數(shù)中返回新的sessionKey調(diào)用實(shí)例App. autoLogin (function(sessionKey)(lf(sessionKey != )=lastAddress;);9. 2.10 獲取網(wǎng)絡(luò)類型-getNetworkType(1)接口描述接口

14、名稱獲取網(wǎng)絡(luò)類型接口描述獲取當(dāng)前手機(jī)連接的網(wǎng)絡(luò)類型接口提供者支付應(yīng)用客戶端接曰使用者HTML5業(yè)務(wù)應(yīng)用請(qǐng)求參數(shù)無(wú)應(yīng)答參數(shù)返回值：網(wǎng)絡(luò)連接類型2g/3g/4g/wifi調(diào)用實(shí)例var nt =();9. 2.11獲取用戶地區(qū)碼- getLocation(1)接口描述接口名稱獲取用戶地區(qū)碼接口描述獲取當(dāng)前用戶所在的城市地區(qū)碼接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)無(wú)應(yīng)答參數(shù)地區(qū)碼好(4)調(diào)用實(shí)例var locationCode =();9. 2.12退出當(dāng)前應(yīng)用-exitApp(5)接口描述接口名稱退出當(dāng)前應(yīng)用接口描述退出當(dāng)前H5應(yīng)用接口提供者支付應(yīng)用客戶端接口使用者HT

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

16、_no;,function(error)；9. 3.2打電話- tel(1)接口描述接口名稱打電話接口描述打電話接口接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)主字段含義關(guān)型必填長(zhǎng)度備注tel電話號(hào)碼ansM30(3)應(yīng)答參數(shù)返回值：返回空字符串。(4)調(diào)用實(shí)例$_id( teservice ) .onclick = function( )(0；9.4原生對(duì)話框(Dialog)9. 4.1俄彈出等待對(duì)話框-showProgressDialog(1)接口描述接口名稱彈出等待對(duì)話框接口描述彈出等待對(duì)話框接口接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)主字

17、段含義關(guān)型必填長(zhǎng)度備注title標(biāo)題ansM50msg消息ans0200(3)應(yīng)答參數(shù)返回值：返回對(duì)話框句柄標(biāo)識(shí)字符串。(4)調(diào)用實(shí)例var dialogid = Dialog. showProgressDialog (提示，正在加載業(yè)務(wù)數(shù)據(jù)，請(qǐng)稍候);9. 4. 2 關(guān)閉等待對(duì)話框- dismissDialog(1)接口描述接口名稱關(guān)閉等待對(duì)話框接口描述關(guān)閉等待對(duì)話框接口接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)主字段含義關(guān)型必填長(zhǎng)度備注iddialogic!ansM50(3)應(yīng)答參數(shù)無(wú)調(diào)用實(shí)例Dialog. dismissDialog(dialogJd);(1)(3

18、)alert(系統(tǒng)繁忙，請(qǐng)稍后再試。9. 4.3關(guān)閉所有彈出的對(duì)話框- closDialog(1)接口描述接口名稱關(guān)閉彈出對(duì)話框接口描述關(guān)閉彈出對(duì)話框接口接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)無(wú)(3)應(yīng)答參數(shù)(4)調(diào)用實(shí)例Dialog. closeDialog();9. 5 掃描接口 (Scanner)9. 5. 1掃描條碼二維碼- scan(1)接口描述接口名稱掃描條碼二維碼接口描述掃描條碼二維碼接1接口提供者支付應(yīng)用客戶端接口使用者HTML5業(yè)務(wù)應(yīng)用(2)請(qǐng)求參數(shù)主字段含義關(guān)型必填長(zhǎng)度備注success調(diào)用成功回 調(diào)函數(shù)funcMfail調(diào)用失敗回 調(diào)函數(shù)func0應(yīng)答參數(shù)無(wú)調(diào)用實(shí)例var success_callback = function()(3)ost(URLj params, submit_callback);；/*訂單提交應(yīng)答回調(diào)函數(shù)*param result -支付應(yīng)用后臺(tái)下單接口返回結(jié)