銀行普通支付快捷支付銀企直連對接操作手冊.doc

銀行普通支付、快捷支付、B2B、銀企直連對接操作手冊一、 普通支付1. 普通網(wǎng)銀支付整體流程時序圖圖1-1 網(wǎng)銀支付整體流程時序圖（可另存下來或放大看）2. 代碼結(jié)構(gòu)圖圖1-2 普通支付代碼結(jié)構(gòu)圖3. 對接銀行開發(fā)步驟1） 首先應(yīng)該有框架代碼，IPaymentService、PaymentServiceImpl、IBankPaymentService、AbstractBankPaymentServiceImpl；2） 新建maven項目，命名為ccb，建立package com.rrtx.payment.ccb.service及com.rrtx.payment.ccb.service.impl；3） 在com.rrtx.payment.ccb.service下編寫ICcbPaymentService接口，擴展自IBankPaymentService接口；4） 在package com.rrtx.payment.ccb.service.impl下創(chuàng)建CcbPaymentServiceImpl，繼承AbstractBankPaymentServiceImpl并實現(xiàn)剛定義的ICcbPaymentService接口，按提示添加須實現(xiàn)的方法，添加完后如下圖：5） 在CcbPaymentServiceImpl中添加com.rrtx.payment.service.IPaymentService.Bank的對象屬性bank，并復寫父類的init方法，在init方法中對bank對象的相關(guān)屬性初始化，此屬性主要封裝了本銀行服務(wù)的相關(guān)信息，比如顯示的圖標、銀行編號、在平臺的代碼、簡稱等，該部分可能需要讀取配置文件perties，該文件約定放在src/main/resources/目錄下，文件里一般還包含了提交的銀行接口地址、在銀行開立的商戶號、證書、密鑰、返回通知本系統(tǒng)的url等信息：6） 在prePayment方法里寫邏輯，將我們平臺的PaymentInput轉(zhuǎn)換成建設(shè)銀行對應(yīng)的報文格式，部分字段可能需要根據(jù)PaymentInput中的字段去數(shù)據(jù)庫查詢；7） 在afterPayment方法中，根據(jù)建行的接口文檔將銀行返回的Map解析出我們平臺的數(shù)據(jù)PaymentOutput對象返回；8） 如果要使用模擬銀行，我們一般在shopDemo中的simBank目錄下放置模擬銀行的應(yīng)答jsp，里面模擬銀行返回信息，然后將上面提到的提交銀行接口的url改成該jsp的請求url。9） 至此銀行普通支付的對接工作基本完成。二、 快捷支付1. 代碼結(jié)構(gòu)圖圖2-1 快捷支付代碼結(jié)構(gòu)圖2. 交互流程描述客戶操作流程：1） 選擇支付方式“快捷支付”，從支持快捷支付的銀行列表中選擇銀行；2） 輸入銀行卡、銀行預留手機號等等信息，閱讀并勾選簽約協(xié)議，提交信息；3） 提示支付成功；系統(tǒng)前后端交互流程：1） 用戶在支付方式頁面選擇快捷支付選項卡后，頁面向后臺請求系統(tǒng)支持的快捷支付的銀行列表并展示銀行快捷支付圖標；2） 用戶選擇銀行后點擊下一步，進入快捷支付頁面，該頁面首先發(fā)起請求判斷當前用戶是否已簽約該銀行的快捷支付；3） 如果沒有則顯示簽約錄入表單，用戶輸入簽約所需的所有信息，并點擊發(fā)送手機短信驗證碼，用戶收到短信驗證碼后輸入并一起提交表單，后臺將該用戶提交的信息發(fā)送至銀行的鑒權(quán)接口，鑒權(quán)返回成功后系統(tǒng)驗證用戶提交的短信驗證碼和支付密碼等信息；驗證通過后系統(tǒng)調(diào)用銀行的簽約接口簽約，完成后前端轉(zhuǎn)入步驟4）；4） 如果已簽約則提示輸入手機號等關(guān)鍵支付信息，提交到后臺，后臺發(fā)送短信驗證碼后，前端彈出驗證碼輸入框，再次提交到后臺驗證，后臺驗證正確后發(fā)送銀行快捷支付接口，成功后返回到前端，提示支付結(jié)果；3. 對接快捷支付開發(fā)步驟開發(fā)步驟和普通網(wǎng)銀支付基本一樣，但是我們有幾項約定：1） 快捷銀行的項目和銀行的簡稱我們都以quick結(jié)尾，比如中信銀行快捷支付項目名叫citicquick；2） 因為不同銀行的快捷支付接口功能統(tǒng)一性不高，因此相對網(wǎng)銀支付我們加了一層適配器來屏蔽接口方法，銀行服務(wù)中只需實現(xiàn)我們本銀行有的接口。3） 因為對快捷支付來說，我們平臺輸出的數(shù)據(jù)與網(wǎng)銀支付不同，因此我們封裝的快捷支付的QuickBank與網(wǎng)銀支付的Bank類中的屬性也不同；三、 B2B銀行對接1. 代碼結(jié)構(gòu)圖圖3-1 B2B銀行對接代碼結(jié)構(gòu)圖2. 與普通支付及快捷支付的異同B2B銀行對接的開發(fā)相對以上兩種方式來說都要簡單，主要區(qū)別在以下幾個方面：1） 所有功能都是一次調(diào)用接口完成，沒有復雜的前后端交互；2） 類圖與快捷支付結(jié)構(gòu)完全一樣，因為不同銀行接口功能統(tǒng)一度很低，因此我們也是用了Adapter來屏蔽各種各樣的接口方法，每個銀行服務(wù)中只須實現(xiàn)本行提供的功能方法即可；3） 與快捷支付相似，我們約定B2B的銀行服務(wù)的簡稱都以B2B結(jié)尾，比如農(nóng)業(yè)銀行服務(wù)簡稱為ABCB2B四、 銀企直連因為銀企直連幾乎與B2B銀行對接完全一樣，因此這里不再重復描述。不同之處