財(cái)付通支付網(wǎng)關(guān)商戶開發(fā)指南.doc_第1頁
財(cái)付通支付網(wǎng)關(guān)商戶開發(fā)指南.doc_第2頁
財(cái)付通支付網(wǎng)關(guān)商戶開發(fā)指南.doc_第3頁
財(cái)付通支付網(wǎng)關(guān)商戶開發(fā)指南.doc_第4頁
財(cái)付通支付網(wǎng)關(guān)商戶開發(fā)指南.doc_第5頁
免費(fèi)預(yù)覽已結(jié)束,剩余15頁可下載查看

下載本文檔

版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請(qǐng)進(jìn)行舉報(bào)或認(rèn)領(lǐng)

文檔簡(jiǎn)介

財(cái)付通支付網(wǎng)關(guān)商戶開發(fā)指南目 錄1引言31.1文檔概述31.2閱讀對(duì)象31.3業(yè)務(wù)術(shù)語42方案概述42.1行業(yè)背景42.2接口介紹42.3業(yè)務(wù)實(shí)現(xiàn)流程53交互模式63.1頁面跳轉(zhuǎn)交互模式63.2后臺(tái)系統(tǒng)調(diào)用交互模式63.3后臺(tái)通知交互模式74數(shù)據(jù)格式74.1GET或POST74.2XML數(shù)據(jù)格式84.3字符串格式85數(shù)字簽名85.1簽名原始串95.2簽名算法95.2.1MD5簽名96補(bǔ)單機(jī)制97接口107.1支付接口107.1.1業(yè)務(wù)功能107.1.2交互模式107.1.3請(qǐng)求參數(shù)列表107.1.4返回結(jié)果和通知參數(shù)列表1137.1.5返回結(jié)果和通知參數(shù)列表2157.1.6后臺(tái)通知結(jié)果反饋167.2通知id驗(yàn)證接口167.2.1業(yè)務(wù)功能167.2.2交互模式167.2.3請(qǐng)求參數(shù)列表177.2.4應(yīng)答參數(shù)列表178實(shí)例189注意事項(xiàng)201 引言1.1 文檔概述本文描述了財(cái)付通針對(duì)合作商戶提供的支付解決方案,幫助商戶輕松實(shí)現(xiàn)在線收款的功能。文檔分別從交互模式、簽名、接口、注意事項(xiàng)等方面詳細(xì)介紹了財(cái)付通的工作方式和開發(fā)過程,可以幫助開發(fā)人員快速入門并掌握開發(fā)技能,同時(shí)也可以作為日后接口參數(shù)以及參數(shù)類型的速查手冊(cè)。1.2 閱讀對(duì)象合作商戶系統(tǒng)的技術(shù)開發(fā)人員,要求具有WEB程序開發(fā)背景,了解http和https請(qǐng)求和應(yīng)答的格式和過程,對(duì)XML格式有所掌握。1.3 業(yè)務(wù)術(shù)語術(shù)語示例說明商戶號(hào)1900000107平臺(tái)的賬號(hào),只用于記賬,由財(cái)付通自動(dòng)分配的10位數(shù)字密鑰9ba2380ad9b2aacb96bca514eda27ac9為保證通訊不被篡改,財(cái)付通與商戶之間約定的32位字符串,算簽名sign時(shí)使用賬戶財(cái)付通賬戶號(hào),目前支持兩種格式:qq號(hào)碼和email賬戶金額100000金額,默認(rèn)為RMB,以分為單位。1000表示RMB10.002 方案概述2.1 行業(yè)背景在電子商務(wù)中,商家、買家、中間服務(wù)方是交易活動(dòng)中的三個(gè)環(huán)節(jié)。買家選購(gòu)商品下發(fā)訂單,商家確認(rèn)訂單,買家通過中間服務(wù)方向商家支付貨款,商家發(fā)貨履行訂單。在這個(gè)過程中商家的網(wǎng)站需要集成中間服務(wù)方的支付功能,讓買家完成貨款的支付。財(cái)付通作為一家專業(yè)的中間服務(wù)方除了提供支付接口外,還提供了支付結(jié)果查詢接口和訂單查詢接口等,幫助商家記錄貨款的往來,讓商家能把更多的精力集中到商品服務(wù)上。商戶的貨款會(huì)按照合同約定以T0T7的頻率結(jié)算到商戶的銀行賬戶,同時(shí)收取手續(xù)費(fèi)。這個(gè)過程由財(cái)付通自動(dòng)完成,商戶無需做相關(guān)開發(fā)工作。2.2 接口介紹接口名請(qǐng)求URL功能說明結(jié)果說明支付接口/gateway/pay.htm調(diào)用該接口時(shí)指定支付參數(shù),完成買家賬戶向商家賬戶的支付,采用頁面跳轉(zhuǎn)交互模式和后臺(tái)通知交互模式結(jié)果分兩路返回:一路為前臺(tái)在return_url后添加參數(shù)返回,表現(xiàn)為頁面跳轉(zhuǎn);一路為后臺(tái)在notify_url后添加參數(shù)返回,要求后臺(tái)notify_url收到通知后進(jìn)行響應(yīng)。通知id驗(yàn)證接口/gateway/simpleverifynotifyid.xml此接口有時(shí)效性商戶在收到后臺(tái)通知后根據(jù)通知ID向財(cái)付通發(fā)起驗(yàn)證確認(rèn),采用后臺(tái)系統(tǒng)調(diào)用交互模式財(cái)付通把具體的通知內(nèi)容按XML格式實(shí)時(shí)返回2.3 業(yè)務(wù)實(shí)現(xiàn)流程2.0調(diào)用支付接口進(jìn)行支付后,財(cái)付通返回支付結(jié)果給前臺(tái)頁面,同時(shí)會(huì)向商戶的服務(wù)器發(fā)送支付是否成功的通知3.0商戶服務(wù)器在收到支付結(jié)果通知后可以根據(jù)通知ID查詢通知內(nèi)容,在確保支付成功后再向用戶發(fā)送提示信息,這樣可以進(jìn)一步提高安全性,防止偽支付成功結(jié)果的詐騙。3 交互模式3.1 頁面跳轉(zhuǎn)交互模式頁面跳轉(zhuǎn)交互模式是指商戶系統(tǒng)與財(cái)付通系統(tǒng)的數(shù)據(jù)交互通過用戶瀏覽器中轉(zhuǎn)進(jìn)行,是一種非實(shí)時(shí)的異步交互。如買家下單買一個(gè)商品,商戶系統(tǒng)會(huì)生成一個(gè)支付鏈接,此鏈接通過用戶的瀏覽器跳轉(zhuǎn)到財(cái)付通系統(tǒng),財(cái)付通通過此鏈接獲取支付請(qǐng)求的參數(shù),這個(gè)支付請(qǐng)求用的就是頁面跳轉(zhuǎn)交易模式。用戶在財(cái)付通頁面完成支付后,財(cái)付通通過return_url跳轉(zhuǎn)到商戶系統(tǒng)。3.2 后臺(tái)系統(tǒng)調(diào)用交互模式后臺(tái)系統(tǒng)調(diào)用交互模式是指商戶系統(tǒng)向財(cái)付通系統(tǒng)發(fā)送請(qǐng)求數(shù)據(jù),并同步等待財(cái)付通系統(tǒng)處理完畢后返回的響應(yīng)數(shù)據(jù)。數(shù)據(jù)交互是商戶服務(wù)器與財(cái)付通服務(wù)器直接通信,一般請(qǐng)求采用http的get或post,應(yīng)答采用xml數(shù)據(jù)格式。如用戶在商戶系統(tǒng)查詢時(shí),商戶要確認(rèn)用戶某個(gè)訂單是否支付成功,可以在服務(wù)器上發(fā)送一個(gè)查詢請(qǐng)求,財(cái)付通收到請(qǐng)求后把查詢結(jié)果以xml格式返回給商戶,商戶處理結(jié)果后再顯示給用戶。3.3 后臺(tái)通知交互模式后臺(tái)通知交互模式是指財(cái)付通系統(tǒng)主動(dòng)向商戶系統(tǒng)發(fā)送通知數(shù)據(jù),并同步等待商戶系統(tǒng)處理完畢后返回的響應(yīng)數(shù)據(jù)。數(shù)據(jù)交互是財(cái)付通服務(wù)器與商戶服務(wù)器直接通信,一般請(qǐng)求采用http的get或post,應(yīng)答用字符串格式。如用戶在財(cái)付通支付成功后,財(cái)付通會(huì)在后臺(tái)通過notify_url向商戶系統(tǒng)發(fā)起通知,商戶處理后成功返回success,失敗返回fail或其他字符。4 數(shù)據(jù)格式4.1 GET或POST采用HTTP標(biāo)準(zhǔn)的GET或POST協(xié)議,為了保證接收方接收數(shù)據(jù)正確,傳遞的參數(shù)如果存在特殊字符(如&、=等)需要進(jìn)行URL Encode。GET或POST一般用于頁面跳轉(zhuǎn)交互模式的請(qǐng)求和通知、后臺(tái)系統(tǒng)調(diào)用模式的請(qǐng)求、后臺(tái)通知模式的請(qǐng)求。4.2 XML數(shù)據(jù)格式采用標(biāo)準(zhǔn)XML協(xié)議,所有參數(shù)只存在一級(jí)節(jié)點(diǎn)中,不采用多級(jí)節(jié)點(diǎn)嵌套。0190000010908DB4A013A8B515349C307F1E448CE836一般有返回碼retcode參數(shù),0表示調(diào)用成功;非0表示調(diào)用失敗,失敗時(shí)結(jié)果不簽名,只有retcode和返回信息retmsg。XML一般用于后臺(tái)系統(tǒng)調(diào)用模式的應(yīng)答。4.3 字符串格式直接以簡(jiǎn)單字符串作為數(shù)據(jù)內(nèi)容,一般用于后臺(tái)通知模式的接口反饋,表示處理是否成功。返回結(jié)果結(jié)果說明success處理成功,財(cái)付通系統(tǒng)收到此結(jié)果后不再進(jìn)行后續(xù)通知fail或其他字符處理不成功,財(cái)付通收到此結(jié)果或者沒有收到任何結(jié)果,系統(tǒng)通過補(bǔ)單機(jī)制(詳見第6節(jié))再次通知5 數(shù)字簽名為了保證數(shù)據(jù)傳輸過程中的數(shù)據(jù)真實(shí)性和完整性,我們需要對(duì)數(shù)據(jù)進(jìn)行數(shù)字簽名,在接收簽名數(shù)據(jù)之后進(jìn)行簽名校驗(yàn)。數(shù)字簽名有兩個(gè)步驟,先按一定規(guī)則拼接要簽名的原始串,再選擇具體的算法和密鑰計(jì)算出簽名結(jié)果。一般失敗的結(jié)果不簽名。5.1 簽名原始串無論是用get、post還是xml,簽名原始串組串方式都一致,除sign字段外,待簽名參數(shù)按照字段名的ascii碼從小到大排序后使用QueryString的格式(即key1=value1&key2=value2)拼接而成,空值不傳遞,不參與簽名。 簽名時(shí)字段名和字段值都采用原始值,不進(jìn)行URL Encode。 簽名的字段包括請(qǐng)求中有所的get或post字段,除了接口中描述的字段外,還應(yīng)包括請(qǐng)求中出現(xiàn)的其它字段。5.2 簽名算法目前暫只支持MD5簽名5.2.1 MD5簽名MD5 是一種摘要生成算法,通過在簽名原始串后加上商戶通信密鑰的內(nèi)容,進(jìn)行MD5運(yùn)算,形成的摘要字符串即為簽名結(jié)果。為了方便比較,簽名結(jié)果統(tǒng)一轉(zhuǎn)換為大寫字符。MD5簽名計(jì)算公式:sign = Md5(原字符串&key=商戶密鑰). toUpperCase如:簽名原始串是:input_charset=GBK&partner=1900000109&total_fee=1商戶密鑰是:8db4a013a8b515349c307f1e448ce836簽名的結(jié)果為:sign=md5(input_charset=GBK&partner=1900000109&total_fee=1&key=8934e7d15453e97507ef794cf7b0519d)= 8DB4A013A8B515349C307F1E448CE8366 補(bǔ)單機(jī)制對(duì)后臺(tái)通知交互模式,如果財(cái)付通收到商戶的應(yīng)答不是success或超時(shí),財(cái)付通認(rèn)為通知失敗,財(cái)付通會(huì)通過一定的策略(如1分鐘、2分鐘、4分鐘、8分鐘、16分鐘、32分鐘,共6次)定期重新發(fā)起通知,盡可能提高通知的成功率,但財(cái)付通不保證通知最終能成功。由于存在重新發(fā)送后臺(tái)通知的情況,因此同樣的通知可能會(huì)多次發(fā)送給商戶系統(tǒng)。商戶系統(tǒng)必須能夠正確處理重復(fù)的通知。財(cái)付通推薦的做法是,當(dāng)收到通知進(jìn)行處理時(shí),首先檢查對(duì)應(yīng)業(yè)務(wù)數(shù)據(jù)的狀態(tài),判斷該通知是否已經(jīng)處理過,如果沒有處理過再進(jìn)行處理,如果處理過直接返回success。在對(duì)業(yè)務(wù)數(shù)據(jù)進(jìn)行狀態(tài)檢查和處理之前,要采用數(shù)據(jù)鎖進(jìn)行并發(fā)控制,以避免函數(shù)重入造成的數(shù)據(jù)混亂。7 接口7.1 支付接口7.1.1 業(yè)務(wù)功能買家在商戶網(wǎng)站拍下商品后,選擇財(cái)付通付款,商戶系統(tǒng)調(diào)用財(cái)付通支付接口,頁面跳轉(zhuǎn)到財(cái)付通支付中心或銀行。用戶完成支付后,財(cái)付通把用戶引導(dǎo)回商戶頁面(return_url),同時(shí)服務(wù)器后臺(tái)通知商戶服務(wù)器(notify_url)支付結(jié)果。建議商戶服務(wù)器(notify_url)接收到財(cái)付通的消息后,立即使用通知id驗(yàn)證接口來判定確認(rèn)此通知id的真?zhèn)巍?.1.2 交互模式請(qǐng)求:頁面跳轉(zhuǎn)交互模式返回結(jié)果+通知:頁面跳轉(zhuǎn)交互模式+后臺(tái)通知交互模式7.1.3 請(qǐng)求參數(shù)列表請(qǐng)求url:/gateway/pay.htm通過get或post請(qǐng)求字段名變量名必填類型說明協(xié)議參數(shù)簽名方式sign_type否String(8)簽名類型,取值:MD5、RSA,默認(rèn):MD5接口版本service_version否String(8)版本號(hào),默認(rèn)為1.0字符集input_charset否String(8)字符編碼,取值:GBK、UTF-8,默認(rèn):GBK。簽名sign是String(32)簽名密鑰序號(hào)sign_key_index否Int多密鑰支持的密鑰序號(hào),默認(rèn)1業(yè)務(wù)參數(shù)銀行類型bank_type否String(16)銀行類型,默認(rèn)為“DEFAULT”財(cái)付通支付中心。銀行直連編碼及額度請(qǐng)與技術(shù)支持聯(lián)系交易模式為中介擔(dān)保時(shí)此參數(shù)無效商品描述body是String(32)商品描述商品名稱subject是String(32)商品名稱(中介交易時(shí)必填)附加數(shù)據(jù)attach否String(255)附加數(shù)據(jù),原樣返回返回URLreturn_url是String(255)交易完成后跳轉(zhuǎn)的URL,需給絕對(duì)路徑,255字符內(nèi),格式如:/ tenpay.asp,通過該路徑直接將支付結(jié)果以Get的方式返回通知URLnotify_url是String(255)接收財(cái)付通通知的URL,需給絕對(duì)路徑,255字符內(nèi),格式如:/ tenpay.asp買方財(cái)付通賬號(hào)buyer_id否String(64)買方的財(cái)付通賬戶(QQ 或EMAIL)。若商戶沒有傳該參數(shù),則在財(cái)付通支付頁面,買家需要輸入其財(cái)付通賬戶。商戶號(hào)partner是String(10)簽名方商戶號(hào)財(cái)付通統(tǒng)一分配的10位正整數(shù)(12XXXXXXXX)號(hào)商戶訂單號(hào)out_trade_no是String(32)商戶系統(tǒng)內(nèi)部的訂單號(hào),32個(gè)字符內(nèi)、可包含字母,確保在商戶系統(tǒng)唯一總金額total_fee是Int訂單總金額,單位為分幣種fee_type是Int現(xiàn)金支付幣種,取值:1(人民幣),默認(rèn)值是1,暫只支持1用戶IPspbill_create_ip是String(15)訂單生成的機(jī)器IP,指用戶瀏覽器端IP,不是商戶服務(wù)器IP交易起始時(shí)間time_start否String(14)訂單生成時(shí)間,格式為yyyymmddhhmmss,如2009年12月25日9點(diǎn)10分10秒表示為20091225091010。時(shí)區(qū)為GMT+8 beijing。該時(shí)間取自商戶服務(wù)器交易結(jié)束時(shí)間time_expire否String(14)訂單失效時(shí)間,格式為yyyymmddhhmmss,如2009年12月27日9點(diǎn)10分10秒表示為20091227091010。時(shí)區(qū)為GMT+8 beijing。該時(shí)間取自商戶服務(wù)器物流費(fèi)用transport_fee否Int需買方另支付的物流費(fèi)用, 單位為分。如已包含在商品價(jià)格中,請(qǐng)?zhí)顚?。如果不填,默認(rèn)為0。如果有值,必須保證transport_fee + product_fee=total_fee商品費(fèi)用product_fee否Int商品費(fèi)用,單位為分。如果有值,必須保證transport_fee + product_fee=total_fee商品標(biāo)記goods_tag否String(32)商品標(biāo)記,優(yōu)惠券時(shí)可能用到交易模式trade_mode否Int交易模式:1即時(shí)到賬(默認(rèn)) 2中介擔(dān)保3后臺(tái)選擇(買家進(jìn)支付中心列表選擇)物流說明transport_desc否String(32)物流公司或物流方式說明交易類型trans_type否Int交易類型:1、實(shí)物交易2、虛擬交易交易模式為中介擔(dān)保時(shí)此參數(shù)有效代理商IDagent_id否String(32)平臺(tái)ID默認(rèn)空代理模式agent_type否Int代理模式:0、無代理(默認(rèn))1、表示卡易售模式2、表示網(wǎng)店模式賣家商戶號(hào)seller_id否String(10)為空則等同于partner7.1.4 返回結(jié)果和通知參數(shù)列表1頁面返回通過請(qǐng)求中的return_url進(jìn)行,采用get方式后臺(tái)通知通過請(qǐng)求中的notify_url進(jìn)行,采用get方式此參數(shù)適用范圍:即時(shí)到賬交易類型參數(shù)如下:字段名變量名必填類型說明范圍協(xié)議參數(shù)簽名方式sign_type否String(8)簽名類型,取值:MD5、RSA,默認(rèn):MD5即時(shí)接口版本service_version否String(8)版本號(hào),默認(rèn)為1.0即時(shí)字符集input_charset否String(8)字符編碼,取值:GBK、UTF-8,默認(rèn):GBK。即時(shí)簽名sign是String(32)簽名即時(shí) 密鑰序號(hào)sign_key_index否Int多密鑰支持的密鑰序號(hào),默認(rèn)1即時(shí)業(yè)務(wù)參數(shù)交易模式trade_mode是Int1- 即時(shí)到賬即時(shí)交易狀態(tài)trade_state是Int交易模式為即時(shí)到帳時(shí),支付結(jié)果:0交易成功即時(shí)支付結(jié)果信息pay_info是String(64)支付結(jié)果信息,支付成功時(shí)為空即時(shí)商戶號(hào)partner是String(10)商戶號(hào),由財(cái)付通統(tǒng)一分配的10位正整數(shù)(12XXXXXXXX)號(hào)即時(shí)付款銀行bank_type是String(16)銀行類型即時(shí)銀行訂單號(hào)bank_billno否String(32)銀行訂單號(hào),若為財(cái)付通余額支付則為空即時(shí)總金額total_fee是Int支付金額,單位為分,如果discount有值,通知的total_fee + discount = 請(qǐng)求的total_fee即時(shí)幣種fee_type是Int現(xiàn)金支付幣種,目前只支持人民幣,默認(rèn)值是1-人民幣即時(shí)通知IDnotify_id是String(64)支付結(jié)果通知id,對(duì)于某些特定商戶,只返回通知id,要求商戶據(jù)此查詢交易結(jié)果即時(shí)財(cái)付通訂單號(hào)transaction_id是String(28)財(cái)付通交易號(hào),28位長(zhǎng)的數(shù)值,其中前10位為商戶號(hào),之后8位為訂單產(chǎn)生的日期,如20090415,最后10位是流水號(hào)。即時(shí)商戶訂單號(hào)out_trade_no是String(32)商戶系統(tǒng)的訂單號(hào),與請(qǐng)求一致。即時(shí) 商家數(shù)據(jù)包attach否String(64)商家數(shù)據(jù)包,原樣返回即時(shí)支付完成時(shí)間time_end是String(14)支付完成時(shí)間,格式為yyyymmddhhmmss,如2009年12月27日9點(diǎn)10分10秒表示為20091227091010。時(shí)區(qū)為GMT+8 beijing。該時(shí)間取自財(cái)付通服務(wù)器即時(shí)物流費(fèi)用transport_fee否Int物流費(fèi)用,單位分,默認(rèn)0。如果有值,必須保證transport_fee + product_fee = total_fee即時(shí)物品費(fèi)用product_fee否Int物品費(fèi)用,單位分。如果有值,必須保證transport_fee + product_fee=total_fee即時(shí)折扣價(jià)格discount否Int折扣價(jià)格,單位分,如果有值,通知的total_fee + discount = 請(qǐng)求的total_fee即時(shí)買家別名buyer_alias否String(64)對(duì)應(yīng)買家賬號(hào)的一個(gè)加密串即時(shí)7.1.5 返回結(jié)果和通知參數(shù)列表2頁面返回通過請(qǐng)求中的return_url進(jìn)行,采用get方式后臺(tái)通知通過請(qǐng)求中的notify_url進(jìn)行,采用get方式此參數(shù)適用范圍:中介擔(dān)保交易類型字段名變量名必填類型說明范圍協(xié)議參數(shù)簽名sign是String(32)簽名中介業(yè)務(wù)參數(shù)交易模式trade_mode是Int2- 中介擔(dān)保中介交易狀態(tài)trade_state是Int交易模式為中介擔(dān)保時(shí),支付結(jié)果:0付款成功1交易創(chuàng)建2收獲地址填寫完畢4賣家發(fā)貨成功5買家收貨確認(rèn),交易成功6交易關(guān)閉,未完成超時(shí)關(guān)閉7修改交易價(jià)格成功8買家發(fā)起退款9退款成功10退款關(guān)閉當(dāng)中介狀態(tài)被更改的時(shí)候,財(cái)付通會(huì)主動(dòng)發(fā)起通知交易到notify_url。中介商戶訂單號(hào)out_trade_no是String(32)商戶系統(tǒng)的訂單號(hào),與請(qǐng)求一致。中介通知IDnotify_id是String(64)支付結(jié)果通知id,對(duì)于某些特定商戶,只返回通知id,要求商戶據(jù)此查詢交易結(jié)果中介財(cái)付通訂單號(hào)transaction_id是String(28)財(cái)付通交易號(hào),28位長(zhǎng)的數(shù)值,其中前10位為商戶號(hào),之后8位為訂單產(chǎn)生的日期,如20090415,最后10位是流水號(hào)。中介商戶號(hào)partner是String(10)商戶號(hào),由財(cái)付通統(tǒng)一分配的10位正整數(shù)(12XXXXXXXX)號(hào)中介7.1.6 后臺(tái)通知結(jié)果反饋財(cái)付通后臺(tái)通過notify_url通知商戶,商戶做業(yè)務(wù)處理后,需要以字符串的形式反饋處理結(jié)果,內(nèi)容如下:返回結(jié)果結(jié)果說明Success處理成功,財(cái)付通系統(tǒng)收到此結(jié)果后不再進(jìn)行后續(xù)通知注意:在中介類交易中,財(cái)付通系統(tǒng)如果收不到到此反饋結(jié)果,支付參數(shù)中的return_url會(huì)被忽略,而將跳轉(zhuǎn)到財(cái)付通默認(rèn)的支付成功頁面(請(qǐng)務(wù)必1:在你的idc服務(wù)器上運(yùn)行、測(cè)試;2:正確返回此標(biāo)識(shí)給財(cái)付通)fail或其它字符處理不成功,財(cái)付通收到此結(jié)果或者沒有收到任何結(jié)果,系統(tǒng)通過補(bǔ)單機(jī)制(詳見第6節(jié))再次通知7.2 通知id驗(yàn)證接口7.2.1 業(yè)務(wù)功能類似于通知查詢接口,本接口用于快速確認(rèn)通知id是否來自于財(cái)付通,但不返回該通知id詳細(xì)的交易信息,只確認(rèn)此通知id的有效性,是一種輕量級(jí)的消息確認(rèn)接口。通知ID具有時(shí)效性,一般用于商家收到財(cái)付通主動(dòng)下發(fā)消息的二次確認(rèn)。使用此接口能確保您的訂單信息安全,推薦使用。7.2.2 交互模式后臺(tái)系統(tǒng)調(diào)用交互模式7.2.3 請(qǐng)求參數(shù)列表請(qǐng)求url:/gateway/simpleverifynotifyid.xml通過get或post請(qǐng)求字段名變量名必填類型說明協(xié)議參數(shù)簽名方式sign_type否String(8)簽名類型,取值:MD5、RSA,默認(rèn):MD5接口版本service_version否String(8)版本號(hào),默認(rèn)為1.0字符集input_charset否String(8)字符編碼,取值:GBK、UTF-8,默認(rèn):GBK。簽名sign是String(32)簽名密鑰序號(hào)sign_key_index否Int多密鑰支持的密鑰序號(hào),默認(rèn)1業(yè)務(wù)參數(shù)商戶號(hào)partner是String(10)財(cái)付通統(tǒng)一分配的10位正整數(shù)(12XXXXXXXX)號(hào)通知IDnotify_id是String(64)支付成功后,財(cái)付通系統(tǒng)反饋的通知ID賣家商戶號(hào)seller_id否String(10)為空則等同于partner7.2.4 應(yīng)答參數(shù)列表數(shù)據(jù)按XML的格式實(shí)時(shí)返回字段名變量名必填類型說明協(xié)議參數(shù)簽名方式sign_type否String(8)簽名類型,取值:MD5、RSA,默認(rèn):MD5接口版本service_version否String(8)版本號(hào),默認(rèn)為1.0字符集input_charset否String(8)字符編碼,取值:GBK、UTF-8,默認(rèn):GBK。簽名sign是String(32)簽名密鑰序號(hào)sign_key_index否Int多密鑰支持的密鑰序號(hào),默認(rèn)1業(yè)務(wù)參數(shù)返回狀態(tài)碼retcode是Int返回狀態(tài)碼:0表示此通知id是財(cái)付通發(fā)起,并在有效期內(nèi)88222005表示通知ID超時(shí)其它未定義8 實(shí)例假設(shè)場(chǎng)景如下:商戶開了一個(gè)服裝網(wǎng)店,售賣各種男女式襯衫,一名用戶小A在網(wǎng)店中選購(gòu)了一件男式襯衫,然后通過財(cái)付通的賬戶支付了貨款,商戶在收到財(cái)付通的支付成功通知后,主動(dòng)又發(fā)起一次通知查詢請(qǐng)求,財(cái)付通實(shí)時(shí)返回了通知的內(nèi)容,然后商戶確認(rèn)交易成功并提示用戶注意查收貨物。業(yè)務(wù)流程實(shí)現(xiàn)如下:支付請(qǐng)求:/gateway/pay.htm?sign_type=MD5&bank_type=&body=男士襯衫一件&return_url=/shop1/payresult.jsp¬ify_url=/shop1/paynotify.jsp&partner=1200000107&out_trade_no=2010051111380001&total_fee=19800&spbill_create_ip=22&sign=8DB4A013A8B515349C307F1E448CE836支付返回結(jié)果:/shop1/payresult.jsp?pay_result=0&pay_info=&partner=1200000107&bank_type=&total_fee=19800¬ify_id=123456789012345678901234567890&transaction_id=1200000107201005111153328847&out_trade_no=2010051111380001&time_end=20100511115436&sign=8DB4A01356B515349C30788E448CE836支付成功通知:/shop1/paynotify.jsp?pay_result=0&pay_info=&partner=1200000107&bank_type=&total_fee=19800¬ify_id=12

溫馨提示

  • 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請(qǐng)下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請(qǐng)聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會(huì)有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫(kù)網(wǎng)僅提供信息存儲(chǔ)空間,僅對(duì)用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對(duì)用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對(duì)任何下載內(nèi)容負(fù)責(zé)。
  • 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請(qǐng)與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時(shí)也不承擔(dān)用戶因使用這些下載資源對(duì)自己和他人造成任何形式的傷害或損失。

評(píng)論

0/150

提交評(píng)論