第三方支付管理平臺(tái)支付開發(fā)指南

/CMＭＢ第三方支付管理平臺(tái)開發(fā)指南Veｒsｉon:1．0Ｐｕblｉcdate：2010—3-3０Allｃoｐyrightreserved文檔描述文檔說明本操作手冊(cè)用來指導(dǎo)網(wǎng)上營(yíng)業(yè)廳實(shí)現(xiàn)與CMMＢ第三方支付管理平臺(tái)(下文簡(jiǎn)稱POＭP，ｐayment-oｎlinｅmａnagerplａt(yī)ｆorm，或支付管理平臺(tái))支付網(wǎng)關(guān)系統(tǒng)的順利對(duì)接.請(qǐng)相關(guān)技術(shù)人員詳細(xì)閱讀本手冊(cè)。文中黑粗的內(nèi)容表示要重點(diǎn)注意的內(nèi)容。版本20１0—3-3０創(chuàng)建文檔閱讀對(duì)象開發(fā)人員接口聯(lián)系人職責(zé)技術(shù)支持姓名王興立電話EmaｉｌwａnｇxinglQQ４5774348５職責(zé)技術(shù)支持姓名曾章華電話EmailｚenｇzｈanｇhuQQ122７9579１業(yè)務(wù)功能描述作業(yè)流程簡(jiǎn)述網(wǎng)廳根據(jù)客戶的支付行為生成訂單，包括渠道編號(hào)、訂單號(hào)、金額、等支付要素，并提交支付請(qǐng)求.用戶進(jìn)入支付管理平臺(tái)，選擇支付方式并支付成功后，支付管理平臺(tái)將后臺(tái)調(diào)用方式將支付結(jié)果實(shí)時(shí)返回網(wǎng)廳。網(wǎng)廳接收到支付成功請(qǐng)求后，輸出反饋信息給支付管理平臺(tái)，并完成相關(guān)業(yè)務(wù)邏輯.支付管理平臺(tái)接收到網(wǎng)廳返回的成功信息，再將用戶引導(dǎo)回網(wǎng)廳頁面。接口通知流程返回結(jié)果在此通知接口模式中,網(wǎng)廳需要確保ｎｏtiｃｅ_url穩(wěn)定可靠.該notｉce_url完成接收支付管理平臺(tái)發(fā)送的支付結(jié)果信息,交易結(jié)果信息將以POＳＴ方式傳遞至網(wǎng)廳。支付管理平臺(tái)只將支付成功的訂單進(jìn)行返回。在傳送給網(wǎng)廳的參數(shù)中,包含使用支付管理平臺(tái)私鑰對(duì)交易結(jié)果數(shù)據(jù)的數(shù)字簽名。網(wǎng)廳應(yīng)該先用密鑰驗(yàn)證該數(shù)字簽名，確認(rèn)該通知信息的合法性。然后完成相關(guān)業(yè)務(wù)邏輯。輸出反饋支付管理平臺(tái)要求網(wǎng)廳ｎotice_uｒl輸出以下代碼:－—－—－－-－－－—-—－--－—-－-—-—--－－－-—————－-－—-—-—－－-—-———－-—－—－—-－——－————-－—--——－——-－—--—<htｍl〉〈hｅad><mｅtanａmｅ＝"POMP＿ONＬＩNE_PAＹM(fèi)ENT"cｏnｔeｎｔ=＂POMP”〉〈scｒiptｌaｎgｕaｇe=”javaｓｃrｉpt"〉ｗinｄｏw。locａt(yī)ion．href='’;</scｒｉpt〉＜/heａd〉〈body〉</bodｙ〉〈/ｈtml>—－—－-——-——-－—--－-—-－—－———-—－——-—-———－—-－—－--————－—-－-－－-—-－－－－—--—-——－--－-—-——--－-—-－－—不允許在noｔice_ｕｒl中發(fā)生任何跳轉(zhuǎn)，并要求網(wǎng)廳第一時(shí)間輸出〈metanamｅ="POMP_ONLＩNＥ_(tái)PAYMENT”ｃonｔｅnt=＂POMP"＞此為支付管理平臺(tái)判斷是否成功返回支付結(jié)果的唯一憑證。用戶返回支付管理平臺(tái)接收到以上反饋信息后,將引導(dǎo)用戶返回進(jìn)行瀏覽安全控制支付管理平臺(tái)與網(wǎng)廳間數(shù)據(jù)交互都使用加密,并使用數(shù)字簽名進(jìn)行數(shù)據(jù)驗(yàn)證，確保數(shù)據(jù)的完整性和不可抵賴性系統(tǒng)原理支付流程此處對(duì)其中步驟進(jìn)行詳細(xì)描述,請(qǐng)仔細(xì)閱讀。流程說明：用戶進(jìn)入網(wǎng)廳產(chǎn)品訂購(gòu)頁面，并選擇要訂購(gòu)的產(chǎn)品.網(wǎng)廳向boss發(fā)送產(chǎn)品費(fèi)用計(jì)算請(qǐng)求.boss計(jì)算出此次產(chǎn)品費(fèi)用。boss把結(jié)果返回給網(wǎng)廳。網(wǎng)廳收到ｂoｓs返回的結(jié)果后,把費(fèi)用返回給用戶。用戶選擇網(wǎng)上支付。網(wǎng)廳記錄訂單信息。根據(jù)CＭMB第三方支付管理平臺(tái)的要求格式,生成請(qǐng)求格式，進(jìn)入CMMB第三方支付平臺(tái)交易頁面。用戶選擇第三方支付方式。CMＭＢ第三方支付管理平臺(tái)進(jìn)行數(shù)據(jù)處理。CMMＢ第三方支付管理平臺(tái)根據(jù)第三方支付平臺(tái)的接口要求生成支付請(qǐng)求格式(各個(gè)支付平臺(tái)的請(qǐng)求格式不同），并展示給用戶確認(rèn).用戶確認(rèn)進(jìn)行支付確認(rèn)根據(jù)用戶確認(rèn)動(dòng)作，CMMB第三方支付管理平臺(tái)處理支付申請(qǐng)，進(jìn)入第三方支付平臺(tái)交易頁面用戶在第三方支付平臺(tái)上輸入信息進(jìn)行支付.第三方支付平臺(tái)驗(yàn)證交易單信息,生成支付引導(dǎo)頁面展示給用戶。用戶填寫付款賬戶信息，并確認(rèn)提交。第三方支付平臺(tái)把處理結(jié)果后臺(tái)通知到第三方支付管理平臺(tái)。(16。1如果是支付寶的話，頁面會(huì)跳轉(zhuǎn)到支付管理平臺(tái)）第三方支付管理平臺(tái)驗(yàn)證通知結(jié)果的真實(shí)性。第三方支付管理平臺(tái)記錄交易日志.第三方支付管理平臺(tái)把結(jié)果反饋給第三方支付平臺(tái)。（１９.1如果是財(cái)付通的話,平臺(tái)會(huì)跳轉(zhuǎn)回支付管理平臺(tái)）第三方支付管理平臺(tái)同時(shí)把處理結(jié)果也返回給網(wǎng)廳。網(wǎng)廳對(duì)第三方支付管理平臺(tái)返回的結(jié)果的真實(shí)性進(jìn)行驗(yàn)證。網(wǎng)廳記錄數(shù)據(jù)處理結(jié)果.網(wǎng)廳對(duì)bｏｓs發(fā)起訂購(gòu)?fù)ㄖｏss進(jìn)行訂購(gòu)請(qǐng)求處理。處理完后，把訂購(gòu)結(jié)果返回給網(wǎng)廳.網(wǎng)廳記錄ｂoｓｓ處理結(jié)果。并把處理結(jié)果返回給第三方支付管理平臺(tái)。第三方支付管理平臺(tái)收到網(wǎng)廳通知后并跳轉(zhuǎn)回網(wǎng)廳頁面網(wǎng)廳把結(jié)果展示給用戶看.支付請(qǐng)求接口協(xié)議接入U(xiǎn)ＲL接入方式POST／ＧET方式協(xié)議參數(shù)字段名填寫類型說明cmｄnｏ必填業(yè)務(wù)代碼,支付接口填1date必填網(wǎng)廳日期：如２0100３30ｄｅｓc必填交易的商品名稱,120個(gè)字符60漢字內(nèi)，不包含特殊符號(hào)如果有多個(gè)產(chǎn)品，用~連接.比如中央一套～精彩電影~精彩體育purｃｈａser_id必填用戶ｉｄ(casiｄ）echanｎｅl＿id必填渠道編號(hào)（ＥCID），由支付管理平臺(tái)統(tǒng)一分配transactioｎ_id必填交易號(hào)(訂單號(hào)），由網(wǎng)廳產(chǎn)生(建議順序累加)，一對(duì)請(qǐng)求和應(yīng)答的交易號(hào)必須相同）。traｎｓacｔioｎ_iｄ為28位長(zhǎng)的數(shù)值,其中前１0位為渠道編號(hào)（ECID）,由支付管理平臺(tái)統(tǒng)一分配；之后８位為訂單產(chǎn)生的日期，如;最后10位網(wǎng)廳需要保證一天內(nèi)不同的事務(wù)（用戶訂購(gòu)一次產(chǎn)品)，其ID不相同。此訂單號(hào)必須保持唯一,不能重復(fù)，支付管理平臺(tái)根據(jù)此定單號(hào)通知網(wǎng)廳數(shù)據(jù)更新等.ec_oｒderno必填網(wǎng)廳內(nèi)部的定單號(hào),此參數(shù)僅在對(duì)賬時(shí)提供,28個(gè)字符內(nèi)。tｏｔal_fee必填總金額，以分為單位，不允許包含任何字符fee＿ｔype必填現(xiàn)金支付幣種，目前只支持人民幣,碼編請(qǐng)參見附件中的notice_urｌ必填接收支付管理平臺(tái)通知結(jié)果的URＬ(推薦使用ip）ａt(yī)tach必填渠道數(shù)據(jù)包，原樣返回（如果無特殊用處，可傳遞1即可）siｇｎ必填MD5簽名結(jié)果inｐｕt_chartset選填輸入編碼，默認(rèn)是utf-8(目前固定傳遞utf—8）簽名規(guī)則順序sign=md5(cmｄno＝1＆daｔｅ=201003３0＆echａnnｅl_id＝440010100２＆trａｎｓａction_id=１12１38＆ｅc_oｒdｅrno=11１1＆total＿ｆee=1300&fｅe(cuò)＿type=1＆notｉｃe_uｒl=&&ｋey=100000０3０1）以上拼湊值不要有空格!使用標(biāo)準(zhǔn)MＤ5算法對(duì)該字符串進(jìn)行加密，加密結(jié)果全部轉(zhuǎn)換成大寫后,即為我們所需的訂單ＭＤ５校驗(yàn)碼，將其寫入sign字段即可.支付通知接口協(xié)議通知ｕrl用戶提供的return_ｕｒl通知方式Ｇeｔ方式協(xié)議參數(shù)MD５支付通知目的UＲLｎｏtice_uｒｌ字段名填寫類型說明cｍdno必填任務(wù)代碼1paｙ_reｓｕｌt必填支付結(jié)果，詳見“返回值編碼定義”,0—成功ｐay_ｉnｆo可選支付結(jié)果信息，支付成功時(shí)為空daｔe必填網(wǎng)廳日期ｅchanｎel＿id必填渠道編碼（ECIＤ）traｎsａction_id必填財(cái)付通交易號(hào)(訂單號(hào)）ec＿ordｅｒno必填網(wǎng)廳內(nèi)部的定單號(hào),此參數(shù)僅在對(duì)賬時(shí)提供，28個(gè)字符內(nèi)。totaｌ_fee必填訂單總金額，以分為單位ｆeｅ_tyｐｅ必填現(xiàn)金支付幣種ａt(yī)tach必填渠道數(shù)據(jù)包，原樣返回pay＿channel必填支付渠道ＺFＢ：支付寶CFT：財(cái)付通WY:網(wǎng)銀YL：銀聯(lián)sｉgｎ必填MD5簽名結(jié)果簽名規(guī)則sigｎ＝ｍd5（cｍdno=１&pay_result=0＆ｄate=2０0５１2２０&traｎsaction_id=100004&ｅc_ordｅｒnｏ=k０0０00000０１＆total_ｆee=１０0&ｆee_tｙpe=1&ａｔtａcｈ=ｔest_attaｃh＆pay_cｈａｎｎeｌ=ＣＦＴ&key＝10000０0301)注意：以上拼湊值不要有空格！使用標(biāo)準(zhǔn)ＭD５算法對(duì)該字符串進(jìn)行加密，加密結(jié)果全部轉(zhuǎn)換成大寫后，即為我們所需的訂單ＭD５校驗(yàn)碼枚舉類型貨幣類型1–RMB?人民幣2-ＵSD美元3-HＫD港幣返回值編碼pay_ｒesuｌt返回值編碼：成功自動(dòng)補(bǔ)單機(jī)制POＭＰ支持自動(dòng)補(bǔ)單,補(bǔ)單通過重復(fù)請(qǐng)求網(wǎng)廳提供的回調(diào)頁面(請(qǐng)求接口參數(shù)ｎｏｔｉｃe_ｕrl指定）實(shí)現(xiàn)。網(wǎng)廳開發(fā)人員編