財付通API接口文檔

本文格式為Word版，下載可任意編輯——財付通API接口文檔JavaSDK下載

當(dāng)前版本發(fā)布日期下載鏈接文件大小openapi-JAVA-SDK-1.0.0.zip129k1.0.02023-6-30sdk-javadoc.zip樣例代碼下載

128k當(dāng)前版本發(fā)布日期下載鏈接文件大小版本說明1.0.12023-8-23appdemo-movieticket-java-1.0.1.zip1.28M增加http-p3p頭，解決iframe中無法跟蹤session的問題引言

文檔概述

本文描述了財付通開放平臺的JAVASDK，幫助開發(fā)者輕松實現(xiàn)在線支付、收付款等功能。文檔詳細(xì)介紹了財付通開放平臺的工作方式和開發(fā)過程，可以幫助開發(fā)人員快速入門并把握開發(fā)技能，同時也可以作為日后接口參數(shù)以及參數(shù)類型的速查手冊。

閱讀對象

具有WEB程序開發(fā)背景，了解JAVA語言。

業(yè)務(wù)術(shù)語

術(shù)語說明獨(dú)立軟件供應(yīng)商/IndependentSoftwareVendor，可以是商戶、個人或者第三方中介開發(fā)者指ISV使用財付通開放平臺SDK開發(fā)的WEB應(yīng)用程序，運(yùn)行于第三方服務(wù)器上為最終用戶提供服務(wù)指財付通的商戶，商家可以是ISV。ISV財付通APP商戶開放平臺最終用戶財付通提供給ISV的開發(fā)注冊、應(yīng)用管理、沙箱測試平臺。指通過財付通開放平臺使用財付通APP的財付通用戶接口業(yè)務(wù)流程

支付流程

支付流程中，用戶在財付通APP中購買業(yè)務(wù)，通過財付通支付平臺進(jìn)行支付。典型業(yè)務(wù)流程如下：

買家在財付通APP上瀏覽下單購買一個商品，財付通APP會生成一個支付鏈接，此鏈接通過用戶的瀏覽器跳轉(zhuǎn)到財付通開放平臺，財付通通過此鏈接獲取支付請求的參數(shù)，引導(dǎo)用戶完成支付過程。

用戶在財付通完成支付后，財付通通過return_url將用戶瀏覽重新定向到財付通APP，財付通APP向用戶提醒訂單狀態(tài)和后續(xù)操作。同時，財付通會通過后臺回調(diào)財付通APP的notify_url，財付通APP在收到支付結(jié)果通知后可以根據(jù)通知ID查詢通知內(nèi)容，在確保支付成功后再進(jìn)行業(yè)務(wù)規(guī)律處理（例如發(fā)貨），這樣可以進(jìn)一步提高安全性，防止偽支付成功結(jié)果的詐騙。

通知查詢/訂單查詢流程

通知查詢/訂單查詢是指財付通APP向財付通系統(tǒng)發(fā)送查詢請求，并同步等待財付通系統(tǒng)處理完畢后返回的響應(yīng)數(shù)據(jù)。數(shù)據(jù)交互是財付通APP與財付通服務(wù)器直接通信。

例如用戶在財付通APP查詢時，財付通APP要確認(rèn)用戶某個訂單是否支付成功，可以向財付通發(fā)送一個查詢請求，財付通收到請求后返回查詢結(jié)果，財付通APP處理結(jié)果后再顯示給用戶。

后臺通知流程

后臺通知是指財付通系統(tǒng)主動向財付通APP發(fā)送通知數(shù)據(jù)，并同步等待財付通APP處理完畢后返回的響應(yīng)數(shù)據(jù)。數(shù)據(jù)交互是財付通服務(wù)器與財付通APP直接通信，一般請求采用http的get或post，應(yīng)答用字符串格式。

用戶在財付通支付成功后，財付通會在后臺通過notify_url向財付通APP發(fā)起通知，財付通APP處理后成功返回success，失敗返回fail或其他字符。

補(bǔ)單機(jī)制

對后臺通知流程，假使財付通收到財付通APP的應(yīng)答不是success或由于網(wǎng)絡(luò)異常超時，財付通認(rèn)為通知失敗，財付通會通過一定的策略（如1分鐘、2分鐘、4分鐘、8分鐘、16分鐘、32分鐘，共6次）定期重新發(fā)起通知，盡可能提高通知的成功率，但財付通不保證通知最終能成功。

由于上述原因，可能存在同樣的通知屢屢發(fā)送給財付通APP的狀況。財付通APP必需能夠正確處理，在

收到重復(fù)的后臺通知不重復(fù)引發(fā)業(yè)務(wù)流程（例如發(fā)貨）。

財付通推薦的做法是，當(dāng)收到財付通發(fā)送的通知消息時，需要檢查本系統(tǒng)內(nèi)訂單的狀態(tài)，判斷該通知是否已經(jīng)處理過。為防止并發(fā)產(chǎn)生的問題，在對業(yè)務(wù)數(shù)據(jù)進(jìn)行狀態(tài)檢查和處理之前，要求采用加鎖判斷進(jìn)行并發(fā)控制。

功能劃分

財付通APP負(fù)責(zé)與之業(yè)務(wù)相關(guān)的代碼和頁面。

財付通開放平臺提供支付相關(guān)的業(yè)務(wù)功能和頁面。具體業(yè)務(wù)功能請參照后面章節(jié)SDK說明

支付頁面如下：

在小錢包中：

在普通瀏覽器中：

SDK說明

概述API說明

類名com.tenpay.api.PayRequestcom.tenpay.api.PayResponsecom.tenpay.api.OrderQueryRequestcom.tenpay.api.OrderQueryResponsecom.tenpay.api.NotifyQueryRequestcom.tenpay.api.NotifyQueryRespons