資源描述：
《財付通接口文檔及代碼.docx》由會員上傳分享，免費在線閱讀，更多相關內容在工程資料-天天文庫。
1、財付通API接口文檔樣例代碼引言文檔概述本文描述了財付通開放平臺的JAVASDK，幫助開發(fā)者輕松實現(xiàn)在線支付、收付款等功能。文檔詳細介紹了財付通開放平臺的工作方式和開發(fā)過程，可以幫助開發(fā)人員快速入門并掌握開發(fā)技能，同時也可以作為日后接口參數(shù)以及參數(shù)類型的速查手冊。閱讀對象具有WEB程序開發(fā)背景，了解JAVA語言。業(yè)務術語術語說明ISV獨立軟件供應商/IndependentSoftwareVendor，可以是商戶、個人或者第三方中介開發(fā)者財付通APP指ISV使用財付通開放平臺SDK開發(fā)的WEB應用程序，運行于第三方服
2、務器上為最終用戶提供服務商戶指財付通的商戶，商家可以是ISV。開放平臺財付通提供給ISV的開發(fā)注冊、應用管理、沙箱測試平臺。最終用戶指通過財付通開放平臺使用財付通APP的財付通用戶接口業(yè)務流程支付流程支付流程中，用戶在財付通APP中購買業(yè)務，通過財付通支付平臺進行支付。典型業(yè)務流程如下：買家在財付通APP上瀏覽下單購買一個商品，財付通APP會生成一個支付鏈接，此鏈接通過用戶的瀏覽器跳轉到財付通開放平臺，財付通通過此鏈接獲取支付請求的參數(shù)，引導用戶完成支付過程。用戶在財付通完成支付后，財付通通過return_url將
3、用戶瀏覽重新定向到財付通APP，財付通APP向用戶提示訂單狀態(tài)和后續(xù)操作。同時，財付通會通過后臺回調財付通APP的notify_url，財付通APP在收到支付結果通知后可以根據(jù)通知ID查詢通知內容，在確保支付成功后再進行業(yè)務邏輯處理（例如發(fā)貨），這樣可以進一步提高安全性，防止偽支付成功結果的詐騙。通知查詢/訂單查詢流程通知查詢/訂單查詢是指財付通APP向財付通系統(tǒng)發(fā)送查詢請求，并同步等待財付通系統(tǒng)處理完畢后返回的響應數(shù)據(jù)。數(shù)據(jù)交互是財付通APP與財付通服務器直接通信。例如用戶在財付通APP查詢時，財付通APP要確認
4、用戶某個訂單是否支付成功，可以向財付通發(fā)送一個查詢請求，財付通收到請求后返回查詢結果，財付通APP處理結果后再顯示給用戶。后臺通知流程后臺通知是指財付通系統(tǒng)主動向財付通APP發(fā)送通知數(shù)據(jù)，并同步等待財付通APP處理完畢后返回的響應數(shù)據(jù)。數(shù)據(jù)交互是財付通服務器與財付通APP直接通信，一般請求采用http的get或post，應答用字符串格式。用戶在財付通支付成功后，財付通會在后臺通過notify_url向財付通APP發(fā)起通知，財付通APP處理后成功返回success，失敗返回fail或其他字符。補單機制對后臺通知流程，
5、如果財付通收到財付通APP的應答不是success或由于網絡異常超時，財付通認為通知失敗，財付通會通過一定的策略（如1分鐘、2分鐘、4分鐘、8分鐘、16分鐘、32分鐘，共6次）定期重新發(fā)起通知，盡可能提高通知的成功率，但財付通不保證通知最終能成功。由于上述原因，可能存在同樣的通知多次發(fā)送給財付通APP的情況。財付通APP必須能夠正確處理，在收到重復的后臺通知不重復引發(fā)業(yè)務流程（例如發(fā)貨）。財付通推薦的做法是，當收到財付通發(fā)送的通知消息時，需要檢查本系統(tǒng)內訂單的狀態(tài)，判斷該通知是否已經處理過。為防止并發(fā)產生的問題，在
6、對業(yè)務數(shù)據(jù)進行狀態(tài)檢查和處理之前，要求采用加鎖判斷進行并發(fā)控制。功能劃分財付通APP負責與之業(yè)務相關的代碼和頁面。財付通開放平臺提供支付相關的業(yè)務功能和頁面。具體業(yè)務功能請參照后面章節(jié)SDK說明支付頁面如下：在小錢包中：在普通瀏覽器中：SDK說明概述API說明類名說明com.tenpay.api.PayRequest支付請求com.tenpay.api.PayResponse支付響應com.tenpay.api.OrderQueryRequest訂單查詢請求com.tenpay.api.OrderQueryResp
7、onse訂單查詢響應com.tenpay.api.NotifyQueryRequest通知查詢請求com.tenpay.api.NotifyQueryResponse通知查詢響應com.tenpay.api.ShareLoginState共享登錄用戶信息共享登錄用戶信息接口：1用戶跳轉到應用時，初始化ShareLoginState對象,ShareLoginState.getUserId()即可獲得當前用戶的id支付接口，常見開發(fā)步驟如下：2初始化請求對象PayRequest3設置請求系統(tǒng)級參數(shù)（應用ID等），例如P
8、ayRequest.setAppid(應用ID)4設置請求業(yè)務級參數(shù)，例如PayRequest.setParameters(參數(shù)名稱,參數(shù)值)5生成跳轉URL，例如PayRequest.getURL()6將用戶重定向到跳轉URL，例如Servlet/JSP中的重定向方法response.sendRedirect()或用Javascript進行頁面跳轉通知查詢
