AliPay支付寶標(biāo)準(zhǔn)快速付款接口文檔V151

1、純網(wǎng)關(guān)接口文檔藹 靶 襖 岸 叭 巴 扳 邦副標(biāo)題：埃網(wǎng)銀直連修訂歷史捌版本號(hào)搬作者哀修訂章節(jié)愛(ài)修訂原因芭修訂日期傲V岸1.0伴技術(shù)支持團(tuán)隊(duì)按全版修改矮加強(qiáng)文檔結(jié)構(gòu)的矮合理性班2008-11吧-17襖V1.1案甘寧壩訂正部分接口參皚數(shù)和描述信息，鞍例如：即時(shí)支付跋支持錯(cuò)誤通知地笆址（隘error_n拔otify_u巴rl百）壩更新簽約接口內(nèi)把容襖接口升級(jí)、增加礙查詢(xún)簽約接口挨2009-8-安2邦V1.2瓣甘寧盎重新整理流程以藹及文檔說(shuō)明癌使文檔閱讀性更艾強(qiáng)擺2009-12皚-骯8愛(ài)V1.3斑甘寧稗增加罷“半公用回傳參數(shù)俺”邦滿(mǎn)足用戶(hù)自定義斑參數(shù)的要求佰2010-3-扳18挨V1.4癌甘寧氨通知

2、中增加網(wǎng)銀挨流水傲滿(mǎn)足商戶(hù)網(wǎng)銀支翱付需求百2010-3-胺29疤V1.懊5搬甘寧藹請(qǐng)求參數(shù)列表鞍支持自定義超時(shí)白可以使用時(shí)間區(qū)阿間氨2010-9-艾13襖V1.5.1芭甘寧隘增加4.3.2按的信用卡簡(jiǎn)碼捌信用卡大額支付傲也支持純網(wǎng)關(guān)啊2010-10般-26說(shuō)明：伴本接口將支付寶靶即時(shí)到帳接口用霸作純網(wǎng)關(guān)半的按功能做詳細(xì)介紹矮。凹在集成時(shí)處理機(jī)凹制和原有支付寶伴即時(shí)到帳一樣，般請(qǐng)求時(shí)必須增加艾默認(rèn)支付方式（盎paymeth敗od吧）和默認(rèn)網(wǎng)銀（背default盎bank艾）2個(gè)參數(shù)目錄TOC o 1-3 h z u HYPERLINK l _Toc275866863 1前言 PAGEREF _T

3、oc275866863 h 3 HYPERLINK l _Toc275866864 矮1.1愛(ài)礙概述澳 PAGEREF _Toc275866864 h 阿3 HYPERLINK l _Toc275866865 霸1.2邦跋術(shù)語(yǔ)百 PAGEREF _Toc275866865 h 案3 HYPERLINK l _Toc275866866 懊2骯半接口功能及參數(shù)懊介紹熬 PAGEREF _Toc275866866 h 扳3 HYPERLINK l _Toc275866867 俺2.1百班標(biāo)準(zhǔn)即時(shí)到賬接昂口（適用于純網(wǎng)按銀）疤 PAGEREF _Toc275866867 h 半3 HYPERLINK

4、l _Toc275866868 百2.1.1班按功能描述翱 PAGEREF _Toc275866868 h 柏3 HYPERLINK l _Toc275866869 安2.1.2伴矮交互流程版 PAGEREF _Toc275866869 h 愛(ài)4 HYPERLINK l _Toc275866870 辦2.1.3懊辦交互模式按 PAGEREF _Toc275866870 h 艾4 HYPERLINK l _Toc275866871 耙2.1.4哎俺接口詳細(xì)說(shuō)明半 PAGEREF _Toc275866871 h 背4 HYPERLINK l _Toc275拌866872懊 拔2.1.5疤辦接口注意

5、事項(xiàng)昂 PAGEREF _Toc275866872 h 岸11 HYPERLINK l _Toc275866873 骯2.1.6疤埃接口錯(cuò)誤代碼列爸表胺 PAGEREF _Toc275866873 h 鞍11 HYPERLINK l _Toc275866874 叭3版斑簽名通用策略澳 PAGEREF _Toc275866874 h 安13 HYPERLINK l _Toc275866875 胺3.1礙拌安全方面吧CheckLi皚st奧 PAGEREF _Toc275866875 h 背13 HYPERLINK l _Toc275866876 疤3.2背背簽名方面敖 PAGEREF _Toc27

6、5866876 h 白13 HYPERLINK l _Toc275866877 辦3.2.1皚敗簽名機(jī)制哀 PAGEREF _Toc275866877 h 案13 HYPERLINK l _Toc275866878 岸3.2.2胺安4.2.2白簽名方式奧 PAGEREF _Toc275866878 h 翱13 HYPERLINK l _Toc275866879 靶3.3隘按其他方面頒 PAGEREF _Toc275866879 h 爸14 HYPERLINK l _Toc275866880 4附錄 PAGEREF _Toc275866880 h 14 HYPERLINK l _Toc27586

7、6881 癌4.1礙背接口通用機(jī)制佰 PAGEREF _Toc275866881 h 半14 HYPERLINK l _Toc275866882 敗4.1.1笆耙系統(tǒng)調(diào)用按 PAGEREF _Toc275866882 h 懊14 HYPERLINK l _Toc275866883 唉4.1.2版暗頁(yè)面跳轉(zhuǎn)班 PAGEREF _Toc275866883 h 傲14 HYPERLINK l _Toc275866884 班4.1.3半熬支付寶主動(dòng)通知擺處理流程氨 PAGEREF _Toc275866884 h 拌16 HYPERLINK l _Toc艾2758668柏85岸 鞍4.1.4敖唉通知驗(yàn)證

8、暗 PAGEREF _Toc275866885 h 氨17 HYPERLINK l _Toc275866886 白4.2絆罷數(shù)字簽名構(gòu)造罷 PAGEREF _Toc275866886 h 傲18 HYPERLINK l _Toc275866887 澳4.2.1扳背請(qǐng)求參數(shù)構(gòu)造耙 PAGEREF _Toc275866887 h 敗18 HYPERLINK l _Toc275866888 氨4.3巴藹公用枚舉表般 PAGEREF _Toc275866888 h 頒21 HYPERLINK l _Toc275866889 敖4.3.1安盎通知返回結(jié)果枚奧舉耙 PAGEREF _Toc27586688

9、9 h 絆21 HYPERLINK l _Toc275866890 擺4.3.2班按通用交易狀態(tài)枚版舉表藹 PAGEREF _Toc275866890 h 捌21 HYPERLINK l _Toc275866891 愛(ài)4.3.1伴班銀行列表瓣 PAGEREF _Toc275866891 h 捌22 HYPERLINK l _Toc275866892 扳4.3.2敗哀信用卡大額銀行藹列表扒 PAGEREF _Toc275866892 h 八23 HYPERLINK l _Toc275866893 熬4.3.3拌澳訂單狀態(tài)列表矮 PAGEREF _Toc275866893 h 拔23 HYPERL

10、INK l _Toc275866894 皚4.4挨霸FAQ爸（常見(jiàn)問(wèn)題的的皚解答）吧 PAGEREF _Toc275866894 h 胺24前言概述斑本接口主要用在扒外部集成網(wǎng)銀直瓣連拜(純網(wǎng)關(guān))佰功能術(shù)語(yǔ)擺名稱(chēng)敖說(shuō)明懊外部商戶(hù)、按合作伙伴、商戶(hù)扳和支付寶進(jìn)行業(yè)板務(wù)合作的商戶(hù)罷通知頁(yè)哎參數(shù)名稱(chēng)拌N八otify_u板rl，所指定的襖互聯(lián)網(wǎng)HTTP頒地址，當(dāng)代扣完瓣成之后，支付寶擺發(fā)送信息到該頁(yè)擺面去，即調(diào)用該瓣頁(yè)面，該頁(yè)面中半的程序自動(dòng)運(yùn)行隘，并判斷請(qǐng)求與罷處理獲取到的信昂息稗合作伙伴ID吧簽約后，為商家佰自動(dòng)分配的唯一八編號(hào)。拔分潤(rùn)疤分潤(rùn)指將某一部跋分費(fèi)用分給其它笆的翱帳戶(hù)壩頁(yè)面跳轉(zhuǎn)氨執(zhí)行操作

11、后跳轉(zhuǎn)壩到其它頁(yè)面疤接口功能及參數(shù)半介紹阿標(biāo)準(zhǔn)版即時(shí)到賬接口擺（適用于純網(wǎng)銀斑）功能描述艾調(diào)用此接口，根敖據(jù)用戶(hù)傳過(guò)來(lái)的扳參數(shù)創(chuàng)建交易，皚買(mǎi)家再付款。目澳前該接口的交拜易全部為即時(shí)到氨帳般純網(wǎng)銀支付接口斑，即只要買(mǎi)家一氨付款，錢(qián)就會(huì)藹從買(mǎi)家銀行卡澳轉(zhuǎn)到賣(mài)家的支付壩寶賬號(hào)案。同時(shí)該接口還白支持分潤(rùn)，商家笆傳過(guò)來(lái)分潤(rùn)的賬埃號(hào)和金額，系統(tǒng)唉會(huì)自動(dòng)打款到該艾賬號(hào)上。交互流程交互模式扳請(qǐng)求懊/哀響應(yīng)交互模式，藹頁(yè)面跳轉(zhuǎn)接口詳細(xì)說(shuō)明請(qǐng)求參數(shù)列表特別注意：哎此接口只支持h俺ttps請(qǐng)求，礙支付寶是以ht哎tps進(jìn)行驗(yàn)證藹按照支付寶外部柏請(qǐng)求接口概述中癌要求的簽名方式絆，對(duì)輸入?yún)?shù)進(jìn)八行簽名，該接口隘請(qǐng)求才能

12、夠被支白付寶系統(tǒng)接收。拜本接口支持重復(fù)凹調(diào)用，但是提交般數(shù)據(jù)必須一樣才案可以。鞍在請(qǐng)求時(shí)必須增挨加默認(rèn)支付方式班和默認(rèn)網(wǎng)銀2個(gè)搬參數(shù)氨字段名霸變量名哎類(lèi)型埃說(shuō)明胺可空巴協(xié)議參數(shù)擺接口名稱(chēng)礙service斑String安create_暗direct_吧pay_by_凹user捌N爸合作伙伴ID笆partner斑String(翱16)半合作伙伴在支付瓣寶的用戶(hù)ID瓣與支付寶簽約后疤自動(dòng)生成辦N搬通知URL伴notify_叭url佰URL（Str艾ing(澳190案)）骯針對(duì)該交易的交八易狀態(tài)同步通知癌接收URL。擺N笆返回URL扳return_版u唉rl癌URL案結(jié)果返回URL扒，僅適用于立即阿返

13、回處理結(jié)果的奧接口。支付寶處暗理完請(qǐng)求后，立敗即將處理結(jié)果返班回給這個(gè)URL案。皚N柏錯(cuò)誤通知地址鞍（需要支付寶功背能人員開(kāi)通）柏error_n皚otify_u拜rl俺URL（Str柏ing(暗190岸)）哎如果在交易過(guò)程阿中出錯(cuò)（如簽名胺錯(cuò)誤等），則通暗過(guò)此URL將錯(cuò)熬誤碼返回給合作八伙伴系統(tǒng)俺Y邦簽名辦sign扒String爸見(jiàn) HYPERLINK l 簽名機(jī)制 巴簽名機(jī)制霸，靶MD5加密算法辦后得出的結(jié)果按N藹簽名方式爸sign_ty隘pe八String礙見(jiàn) HYPERLINK l 簽名方式 佰簽名方式氨，把現(xiàn)今默認(rèn)是MD阿5加密，無(wú)需更班改該參數(shù)的值八N凹參數(shù)編碼字符集靶_input_

14、澳charset暗String（澳默認(rèn)為GBK）矮合作伙伴系統(tǒng)與班支付寶系統(tǒng)之間笆交互信息時(shí)使用挨的編碼字符集。隘合作伙伴可以通氨過(guò)該參數(shù)指定使佰用何種字符集對(duì)笆傳遞參數(shù)進(jìn)行編埃碼。同時(shí)，支付佰寶系統(tǒng)也會(huì)使用胺該字符集對(duì)返回霸參數(shù)或通知參數(shù)熬進(jìn)行編碼。笆注：該參數(shù)必須板在queryS疤tring中傳哎遞，不論使用的敗是POST還是吧GET方式發(fā)送奧請(qǐng)求。如：ht愛(ài)tp:/ww跋w.alipa皚/c拔ooperat頒e/gatew哀ay.do?_耙input_c盎harset=癌utf-8扮N笆業(yè)務(wù)參數(shù)凹商品展示網(wǎng)址柏show_挨url啊String(俺400)半點(diǎn)擊商品鏈接后岸跳轉(zhuǎn)的頁(yè)面氨Y靶

15、商品名稱(chēng)澳subject凹String(捌256)拜商品的標(biāo)題扒N班商品描述哀body拌String(搬1000耙)罷商品的具體描述敖，如果是多種商埃品，請(qǐng)將商品描靶述字符串累加傳暗給body氨Y安外部交易號(hào)邦out_tra拜de_no邦String(邦64)胺合作伙伴交易號(hào)白（確保在合作伙版伴系統(tǒng)中唯一）吧N隘商品單價(jià)拜price版Number(奧13,2)壩price:單邦位為RMB Y壩uan 0.0艾1敖1000000盎00.00罷total_f搬ee:單位為R藹MB Yuan絆0.01半1000000埃00.00瓣quantit壩y:0qua把ntity 0伴Y瓣交易金額盎total

16、_f胺ee愛(ài)Number(捌13邦,2)半單位為RMB 八Yuan百0.0110把00000.0凹0矮Y案是否調(diào)整總價(jià)唉is_tota辦l_fee_a跋djust凹String(矮1)拜該交易是否調(diào)整胺過(guò)價(jià)格唉Y擺交易創(chuàng)建時(shí)間翱gmt_cre佰ate暗Timesta扒mp凹該筆交易創(chuàng)建的艾時(shí)間跋Y耙交易付款時(shí)間版gmt_pay翱ment胺Timesta伴mp矮該交易買(mǎi)家的付昂款時(shí)間伴Y斑交易關(guān)閉時(shí)間阿gmt_clo疤se扳Timesta耙mp傲交易關(guān)閉時(shí)間佰Y藹退款時(shí)間骯gmt_ref跋und頒Timesta伴mp敗賣(mài)家退款的時(shí)間氨，退款通知時(shí)會(huì)柏發(fā)送藹Y奧公用回傳參數(shù)疤extra_c鞍omm

17、on_p頒aram半String百用于商戶(hù)回傳參敖數(shù)隘,埃該值不能包含氨=&扒等氨特殊字符。如果般用戶(hù)請(qǐng)求時(shí)傳遞俺了該參礙數(shù)，則返回給商扳戶(hù)時(shí)會(huì)回傳該參岸數(shù)啊.盎Y暗網(wǎng)銀流水班號(hào)俺bank_se矮q_no背String(昂20)半開(kāi)通了純網(wǎng)關(guān)和扮偽網(wǎng)關(guān)的商戶(hù)，岸在交易叭成功后可以返回俺網(wǎng)銀流水。耙備注：需要支付奧寶技術(shù)支持人員扮開(kāi)啟拜Y叭交易狀態(tài)信息：懊交易狀態(tài)拔trade_s藹tatus絆String盎見(jiàn) HYPERLINK l _交易狀態(tài)枚舉表_1 骯交易狀態(tài)枚舉表背Y澳退款狀態(tài)白refund_捌status吧String翱見(jiàn) HYPERLINK l _交易狀態(tài)枚舉表_1 胺交易狀態(tài)枚舉表

18、案Y壩買(mǎi)家賣(mài)家信息：埃賣(mài)家Email半s版eller疤_email胺String(頒100)把賣(mài)家Email版Y巴賣(mài)家ID靶seller_爸id斑String(岸30)爸賣(mài)家ID捌Y案買(mǎi)家ID哀buyer_i靶d拔String(百30)礙買(mǎi)家Email按Y隘買(mǎi)家Email岸b捌uyer阿_email拜String(爸100)耙買(mǎi)家ID扒Y邦是否使用紅包壩use_cou吧pon捌String(跋1)爸買(mǎi)家是否在交易疤過(guò)程中使用了紅凹包拌Y柏錯(cuò)誤通知參數(shù)案信息阿（需要在傳入?yún)硵?shù)增加錯(cuò)誤通知扳地址）氨：哎錯(cuò)誤代碼啊e稗r(nóng)ror_氨code襖String(鞍說(shuō)明接口調(diào)用過(guò)伴程中的出錯(cuò)信息爸N接口注意

19、事項(xiàng)壩您需使用拜HTTPS 岸協(xié)義壩,敖 半支付寶是以癌HTTPS疤的形式進(jìn)行通知白請(qǐng)按照支付寶外安部請(qǐng)求接口概述板中要求的簽名方壩式，對(duì)輸入?yún)?shù)皚進(jìn)行簽名，該接百口請(qǐng)求才能夠被暗支付寶系統(tǒng)接收伴該接口支持重復(fù)拔調(diào)用，即：一筆拌訂單辦可以重新支付，艾但是前提是這筆頒訂單的信息和原案來(lái)信息一樣，否氨則會(huì)報(bào)訂單號(hào)重挨復(fù)拌處理支付寶的返安回信息可以異步艾處理也可以同步百處理，前提是防佰止訂單重復(fù)接收提成數(shù)據(jù)集：芭1.般 骯收款方Emai艾l半_1絆金額備注斑|鞍付款方Emai爸l收款方Em敖ail阿_2板金額備注把例如：阿gwl25笆1霸163.co襖m0.02按分潤(rùn)笆1|gwl25案1熬1矮2俺6

20、骯.comgw罷l06隘1按163.co霸m0.01哀分潤(rùn)板2擺2.懊 爸收款方Emai絆l佰_1白金額備注翱|擺收款方Emai疤l藹_2瓣金額備注邦例如：般gwl25挨1疤163.co爸m0.02瓣分潤(rùn)搬1|哀gwl06爸1阿163.co背m0.01唉分潤(rùn)癌2懊3.艾收款方Emai班l(xiāng)_1金額奧備注|收款方E扳mail_1擺收款方Emai叭l_2金額稗備注骯例如：骯gwl25埃1吧163.co板m0.02背分潤(rùn)安1|gwl25叭1辦1柏艾gwl06拌1百163.co翱m0.01八分潤(rùn)伴2巴接口錯(cuò)誤代碼列吧表頒錯(cuò)誤敖代碼（稗error_c扒ode擺）捌說(shuō)明靶ILLEGAL跋_SIGN般簽名驗(yàn)證

21、出錯(cuò)白ILLEGAL哀_ARGUME暗NT哀參數(shù)不正確氨HAS鞍_NO_PRI耙VILEGE敗沒(méi)有權(quán)限訪問(wèn)該藹服務(wù)叭ILLEGAL愛(ài)_SERVIC伴E伴Service佰參數(shù)不正確昂ILLEGAL扮_PARTNE安R唉商戶(hù)奧ID不正確安HAS_NO_拜PUBLICK拌EY拔沒(méi)有上傳公鑰般USER_NO斑T_EXIST拌會(huì)員不存在邦OUT_TRA白DE_NO_E癌XIST氨外部交易號(hào)已經(jīng)柏存在邦TRADE_N靶OT_EXIS昂T邦交易不存在耙ILLEGAL靶_PAYMEN半T_TYPE版無(wú)效支付類(lèi)型巴，需要聯(lián)系支付啊寶技術(shù)支持工程奧師處理阿BUYER_N背OT_EXIS霸T愛(ài)買(mǎi)家不存在巴SELLE

22、R_巴NOT_EXI背ST捌賣(mài)家不存在笆BUYER_S哎ELLER_E八QUAL哀買(mǎi)家、賣(mài)家是同柏一帳戶(hù)拌ILLEGAL吧_SIGN_T挨YPE按簽名類(lèi)型不正確艾COMMISI笆ON_ID_N哀OT_EXIS擺T百傭金收取帳戶(hù)不挨存在半COMMISI敗ON_SELL扮ER_DUPL頒ICATE胺收取傭金帳戶(hù)和胺賣(mài)家是同一帳戶(hù)盎COMMISI哎ON_FEE_背OUT_OF_白R(shí)ANGE巴傭金金額超出范版圍伴ILLEGAL罷_LOGIST拜ICS_FOR拔MAT疤無(wú)效物流格式礙TOTAL_F愛(ài)EE_LESS叭EQUAL_Z矮ERO拌交易總金額小于斑等于0柏TOTAL_F懊EE_OUT_半OF_RA

23、NG拌E柏交易總金額超出熬范圍擺ILLEGAL挨_FEE_PA伴RAM俺非法交易金額格胺式礙（參考單價(jià)、總胺價(jià)、數(shù)量三個(gè)組靶合規(guī)則）般DONATE_鞍GREATER岸_THAN_M耙AX芭小額捐贈(zèng)總金額哎超出最大值限制矮DIRECT_瓣P(guān)AY_AMO捌UNT_OUT鞍_OF_RAN熬GE八快速付款交易總班金額超出最大值跋限制疤DIGITAL版_FEE_GR壩EATER_T翱HAN_MAX頒虛擬物品交易總背金額超出最大值唉限制昂SELF_TI跋MEOUT_N頒OT_SUPP啊ORT艾不支持自定義超案時(shí)絆COMMISI艾ON_NOT_胺SUPPORT案不支持傭金白VIRTUAL熬_NOT_S靶UP

24、PORT頒不支持虛擬發(fā)貨瓣方式癌ILLEGAL昂_CHARSE骯T昂字符集不合法巴ROYALTY叭_SELLER捌_ENABLE百_STATUS八_FORBID拌有提成情況下，斑賣(mài)家狀態(tài)不正常百ROYALTY皚_SELLER罷_NOT_CE熬RTIFY皚有提成情況下，擺賣(mài)家未通過(guò)認(rèn)證耙ROYALTY熬_FORAMT案_ERROR笆提成信息錯(cuò)誤，把請(qǐng)檢查后重新集奧成哀ROYALTY昂_TYPE_E拜RROR壩提成類(lèi)型不支持叭，請(qǐng)檢查后重新挨集成把ROYALTY癌_PAY_EM氨AIL_NOT八_EXIST盎提成付款帳戶(hù)不八存在艾ROYALTY澳_RECEIV佰E_EMAIL澳_NOT_EX巴IS

25、T凹提成收款帳戶(hù)不笆存在拜DEFAULT襖_BANK_M笆UST_NOT阿_NULL哎默認(rèn)網(wǎng)銀不能為耙空吧LLEGAL_巴PAYMENT按_TYPE案錯(cuò)誤的Paym昂ent_typ哀e參數(shù)盎ILLEGAL班_OUTTIM柏E_ARGUM懊ENT澳自定義超時(shí)參數(shù)啊錯(cuò)誤板CANT_CR絆EDIT_PA罷Y拔不能使用信用支埃付矮TRADE_N拜OT_ALLO斑WED_PAY敗交易不允許付款皚NAVIGAT俺ION_INC般OME_OF_敖ROYALTY胺_ACCOUN礙T暗在邦提成情況下芭的多級(jí)分潤(rùn)，巴二次分潤(rùn)帳戶(hù)次熬序問(wèn)題背或者分潤(rùn)時(shí)沒(méi)有跋預(yù)留支付寶服務(wù)哀費(fèi)簽名通用策略扳安全方面Che骯ckLis

26、t半從集成后的系統(tǒng)稗健壯性考慮，收案到支付寶發(fā)出的靶通知后，合作伙笆伴系統(tǒng)須判斷接隘收到的交易狀態(tài)胺、交易金額是否案與自己系統(tǒng)中的版參數(shù)對(duì)應(yīng)，并處八理這些數(shù)據(jù)信息伴，使網(wǎng)站內(nèi)的交絆易信息與支付寶扮內(nèi)的交易信息保半持一致，可防止拔掉單情況出現(xiàn)。胺如果不判斷，存版在潛在的風(fēng)險(xiǎn)，哎合作伙伴自行承凹擔(dān)因此而產(chǎn)生的跋所有損失。簽名方面簽名機(jī)制昂沒(méi)有值的參數(shù)無(wú)隘需傳遞，也無(wú)需邦包含到待簽名數(shù)藹據(jù)中。傲簽名時(shí)將字符轉(zhuǎn)隘變成字節(jié)流時(shí)指敗定的字符集要與芭_(tái)input_絆charset挨保持一致。拔如果傳遞了_i頒nput_ch骯arset參數(shù)扒，那么這個(gè)參數(shù)頒也應(yīng)該包含在待骯簽名數(shù)據(jù)中。皚根據(jù)HTTP協(xié)哎議要求

27、，傳遞參把數(shù)的值中如果存懊在特殊字符（如背：&、等），翱那么該值需要做爸URL Enc靶oding，這疤樣請(qǐng)求接受方才柏能接受到正確的鞍參數(shù)值。這種情癌況下，做簽名時(shí)骯使用的應(yīng)該是原般生值而不是en擺coding之愛(ài)后的值。例如：把會(huì)員查詢(xún)接口示百例中待簽名數(shù)據(jù)熬是email=斑testms氨&p柏artner=稗2088006般3000000安00&serv拔ice=tes藹t，而不是em白ail=tes跋t%40msn邦.com&pa搬rtner=2鞍0880063盎0000000懊0&servi叭ce=test捌。案4.2佰.懊2板簽名方式柏按照襖sign_ty伴pe俺參數(shù)指定的簽名襖算

28、法對(duì)待簽名數(shù)瓣據(jù)進(jìn)行簽名【參壩見(jiàn)： HYPERLINK l _數(shù)字簽名構(gòu)造 靶數(shù)字簽名構(gòu)造背】其他方面罷您必需使用佰HTTPS 襖協(xié)義俺,跋 藹支付寶是以唉HTTPS癌的形式進(jìn)行通知阿請(qǐng)按照支付寶外邦部請(qǐng)求接口概述懊中要求的簽名方癌式，對(duì)輸入?yún)?shù)啊進(jìn)行簽名，該接安口請(qǐng)求才能夠被矮支付寶系統(tǒng)接收靶如果設(shè)置了no擺tify_ur安l，支付寶會(huì)發(fā)斑一條通知到no跋tify_ur擺l對(duì)應(yīng)的站點(diǎn)頒通知URL不要骯如此設(shè)置：ht岸tp:/ww板w.xxx.c拌om/alip伴ay/noti皚fy_url.拔asp耙?id=xxx奧，即不要帶自加耙的自定義參數(shù)，敖這會(huì)導(dǎo)致通知返凹回時(shí)判斷失敗。附錄接口通用機(jī)

29、制系統(tǒng)調(diào)用骯顧名思義，這類(lèi)氨接口是為合作伙鞍伴系統(tǒng)獲得支付襖寶系統(tǒng)信息提供岸服務(wù)的，是一種把系統(tǒng)間的調(diào)用接叭口。 系統(tǒng)調(diào)用示意圖頁(yè)面跳轉(zhuǎn)把顧名思義，這類(lèi)礙接口都是一些有扒頁(yè)面操柏作的接口。通常敗是用戶(hù)在合作伙皚伴頁(yè)面執(zhí)行部分爸操作，然后跳轉(zhuǎn)白到支付寶系統(tǒng)記澳錄訂單信息及時(shí)班再轉(zhuǎn)入網(wǎng)銀系統(tǒng)鞍頁(yè)面完成整個(gè)操把作。有的甚至可把能最后還要再跳巴回到合作伙伴的隘下一個(gè)頁(yè)面，繼擺續(xù)完成整個(gè)操作氨。根據(jù)處理結(jié)果佰的返回方式，又懊分為：艾立即返回處理結(jié)把果，即用戶(hù)在愛(ài)網(wǎng)銀系統(tǒng)傲頁(yè)面完成操作后啊，支付寶將處理跋結(jié)果立即返回給隘合作伙伴的下一芭步操作頁(yè)面，讓傲用戶(hù)繼續(xù)完成真捌個(gè)操作流程。所跋以，調(diào)用這類(lèi)接班口時(shí)，

30、必須傳遞擺參數(shù)敖return_安url?。春献骰锇榈膲蜗乱粋€(gè)操作頁(yè)面扳）。俺立即返回（頁(yè)面扮跳轉(zhuǎn)）示意圖瓣異步返回處理結(jié)靶果，即用戶(hù)從合巴作伙伴頁(yè)面跳轉(zhuǎn)艾到瓣網(wǎng)銀支付暗頁(yè)面后白（頒支付寶耙先做記錄）佰，在網(wǎng)銀系統(tǒng)氨完成最后操作，艾用戶(hù)不用再回到絆合作作伙伴頁(yè)面翱。這類(lèi)接口通常啊是通過(guò) HYPERLINK l _從支付寶獲取到的參數(shù)列表 頒通知接口吧異步獲得處理結(jié)白果。如果需要異罷步返回結(jié)果，那翱么必須傳遞跋notify_俺url稗參數(shù)，以指定通拌知返回的地址。敗如果不需要異步敗返回結(jié)果，那么壩可以不用傳遞跋notify_奧url癌參數(shù)。（具體流百程可以參考： HYPERLINK l _支付寶

31、主動(dòng)通知處理流程 捌支付寶主動(dòng)通知辦處理流程唉） 藹 埃 礙頁(yè)面跳轉(zhuǎn)（通過(guò)板通知接口返回結(jié)疤果）示意圖扳支付寶主動(dòng)通知礙處理流程艾半皚1.支付寶平臺(tái)捌系統(tǒng)向外部商戶(hù)佰系統(tǒng)發(fā)出通知，耙即訪問(wèn)外部商戶(hù)啊提供的通知接收半U(xiǎn)RL（參數(shù)爸notify_吧url擺）。絆2.外部商戶(hù)系岸統(tǒng)接到通知請(qǐng)求搬，通過(guò)noti皚fy_id詢(xún)問(wèn)頒支付寶平臺(tái)系統(tǒng)扮這個(gè)通知的真實(shí)案性,通知驗(yàn)證。靶3.支付寶平臺(tái)搬系統(tǒng)判斷通知是熬否是自己發(fā)送，拌如果是返回tr巴ue，否則返回捌false。艾4.商戶(hù)系統(tǒng)得安到支付寶平臺(tái)系頒統(tǒng)的確認(rèn)后，對(duì)拌通知進(jìn)行處理。襖處理完畢后，返霸回結(jié)果給支付寶叭平臺(tái)系統(tǒng)，處理吧結(jié)果的值見(jiàn)附件挨： HY

32、PERLINK l _通知返回結(jié)果枚舉 骯通知返回結(jié)果枚隘舉盎。爸5.支付寶平臺(tái)哎系統(tǒng)處理商戶(hù)系柏統(tǒng)返回的處理結(jié)傲果。通知驗(yàn)證扮從系統(tǒng)健康性角哎度考慮，在接收芭到支付寶平臺(tái)系哀統(tǒng)通知以后，驗(yàn)柏證支付寶的系統(tǒng)岸通知的正確性（哎合法性）是非常澳有必要的。強(qiáng)烈笆建議外部商戶(hù)系哎統(tǒng)加入此應(yīng)用。頒 愛(ài) 了保證藹該接口被合法利阿用，商戶(hù)系統(tǒng)只稗能查找1分鐘之按內(nèi)（目前為1分熬鐘，以后若有調(diào)壩整，恕不另行通哎知）的通知。壩 傳遞的叭參數(shù)格式：唉通知驗(yàn)證阿字段名矮變量名斑類(lèi)型骯說(shuō)明皚可空壩樣例敗接口名稱(chēng)癌service佰String巴custome捌r_unsig啊n捌N靶trade_s半tatus_s背yn

33、c啊外部商戶(hù)叭partner哀String(骯16)礙外部商戶(hù)在支付岸寶的用戶(hù)ID俺N哀通知ID癌n敖otify氨_id班String懊支付寶發(fā)送的通絆知ID邦N俺基于HTTPS藹協(xié)議的通知驗(yàn)證絆接口俺程序在使用時(shí)按捌照以下要求發(fā)起唉一個(gè)HTTPS疤請(qǐng)求，獲取該請(qǐng)敖求的結(jié)果即可，頒所有可能出現(xiàn)的般結(jié)果見(jiàn)以下的輸百出參數(shù)表，這種班驗(yàn)證通知的方式伴需要網(wǎng)站支持H拔TTPS訪問(wèn)，襖若網(wǎng)站不支持h辦ttps的訪問(wèn)耙，可以使用另外埃一種驗(yàn)證方式：翱基于HTTP協(xié)白議的通知驗(yàn)證接搬口。接入U(xiǎn)RL：澳https:/啊/www.al澳ipay.co啊m/coope班rate/ga柏teway.d爸o澳一個(gè)完整

34、的驗(yàn)證跋請(qǐng)求實(shí)例：霸https:/吧/www.al澳ipay.co爸m/coope版rate/ga敖teway.d壩o胺?servic瓣e=扮custome埃r_unsig疤n笆 &partn胺er=1234藹567890&澳notify_把id=abcd八efghijk拜lmnopqr跋st把 扳基于HTTP協(xié)艾議的通知驗(yàn)證接昂口襖程序在使用時(shí)按埃照以下要求發(fā)起癌一個(gè)HTTP請(qǐng)拔求，獲取該請(qǐng)求霸的結(jié)果即可，所瓣有可能出現(xiàn)的結(jié)襖果見(jiàn)以下的輸出罷參數(shù)表。接入U(xiǎn)RL：敗http:/般notify.把a(bǔ)lipay.愛(ài)com/tra襖de/noti藹fy_quer埃y.do罷一個(gè)完整的驗(yàn)證翱請(qǐng)求實(shí)例：

35、拔http:/拌notify.扳alipay.稗com/tra敖de/noti挨fy_quer藹y.do?扳partner隘=123456奧7890&no頒tify_id瓣=abcdef安ghijklm耙nopqrst鞍通知驗(yàn)證接口輸擺出參數(shù)：笆輸出內(nèi)容靶說(shuō)明跋可能的原因哎invalid拜傳入的參數(shù)無(wú)效巴查找參數(shù)格式絆true爸驗(yàn)證通過(guò)愛(ài)false斑驗(yàn)證失敗佰查找是否由于s癌ign和mys柏ign不相等引扮起的1分鐘內(nèi)失板效的問(wèn)題數(shù)字簽名構(gòu)造請(qǐng)求參數(shù)構(gòu)造案為了確保數(shù)據(jù)傳斑輸過(guò)程中的數(shù)據(jù)哀真實(shí)性和完整性稗，我們需要對(duì)數(shù)斑據(jù)進(jìn)行簽名校驗(yàn)隘。暗HTTP請(qǐng)求中埃傳遞的所有參數(shù)奧(傲除sign和s罷ig

36、n_typ岸e以外吧)按照參數(shù)名稱(chēng)耙字符升序的順序吧串聯(lián)起來(lái)（如：奧p1=v1&p百2=v2&p3捌=v3），構(gòu)成吧待簽名數(shù)據(jù)。按安照sign_t板ype指定的方瓣式對(duì)待簽名數(shù)據(jù)澳進(jìn)行簽名。八例如：調(diào)用某接爸口需要以下參數(shù)岸：扒service般=哎cae_cha稗r(nóng)ge_age胺nt伴partner翱=208800瓣6300000凹000骯email=t耙estmsn俺.com昂那么待簽名數(shù)據(jù)艾就是：emai頒l=test把傲&partne敖r=20880罷0630000氨0000&se邦rvice=背 cae_ch稗arge_ag昂ent板。簽名算法對(duì)比辦 笆 算法艾功能案MD5阿DSA斑R

37、SA板防篡改爸背扒靶防抵賴(lài)疤芭隘爸加密癌八襖白電子簽名法是否盎承認(rèn)敗笆敗MD5算法構(gòu)造岸定義：MD5是叭一種摘要生成算昂法，本來(lái)是不能疤用于簽名的。但礙是，通過(guò)在待簽擺名數(shù)據(jù)之后加上埃一串私密內(nèi)容（版指令發(fā)送、接收罷雙發(fā)事先規(guī)定好啊的，這里我們稱(chēng)暗其為簽名密鑰）襖，就可以用于簽叭名了。使用這種八算法簽名只能起艾到防數(shù)據(jù)篡改的拜功能，不能起到昂簽名防抵賴(lài)的功拌能，因?yàn)殡p方都?jí)沃篮灻荑€例如：哎待簽名數(shù)據(jù) +哎 securi懊tyCode值耙（支付寶為合作盎伙伴頒發(fā)的安全襖校驗(yàn)碼）的MD氨5摘要作為簽名啊。例如：藹安全校驗(yàn)碼是m藹ysecuri昂tyCode，把那么前面會(huì)員查拌詢(xún)接口示例的待藹簽

38、名數(shù)據(jù)就是：柏email=稗test耙msn.co靶m&partn澳er=2088頒0063000笆00000伴&servic瓣e=user_罷query矮mysecur昂ityCode把。DSA算法構(gòu)造扒定義：DSA是皚一種非對(duì)稱(chēng)的簽盎名算法，即簽名白密鑰（私鑰）與拔驗(yàn)簽名密鑰（公按鑰）是不一樣的藹，私鑰用于簽名矮，公鑰用于驗(yàn)簽拔名。使用這種算癌法簽名在起到防哀數(shù)據(jù)篡改功能的搬同時(shí)，還可以起叭到防抵賴(lài)的作用捌，因?yàn)樗接弥挥修k簽名者知道。例如：版合作伙伴發(fā)送請(qǐng)拔求時(shí)，使用自己擺的密鑰對(duì)待簽名柏?cái)?shù)據(jù)進(jìn)行DSA半簽名，支付寶使百用合作伙伴的公版鑰進(jìn)行校驗(yàn)；支吧付寶返回?cái)?shù)據(jù)時(shí)絆，使用支付寶的佰密鑰對(duì)

39、待簽名數(shù)盎據(jù)進(jìn)行DSA簽矮名，合作伙伴使唉用支付寶的公鑰扮進(jìn)行校驗(yàn)。吧DSA公私鑰可阿以使用Open斑SSL生成，如案下：皚1 生成DS骯A參數(shù)稗openssl敖巴 dsapar哎am -out吧 dsa_pa藹ram.pem拔 10242 生成私鑰般openssl俺氨gendsa 爸-out ds胺a_priva伴te_key.版pem dsa靶_param.傲pem3 生成公鑰背openssl熬熬 dsa -i板n dsa_p稗r(nóng)ivate_靶key.pem懊 -pubou艾t -out 翱dsa_pub邦lic_key扒.pemRSA算法構(gòu)造背定義：阿RSA也是一種隘非對(duì)稱(chēng)算法，同疤時(shí)，

40、它還是一種芭加密算法，使用搬方法跟DSA簽按名算法類(lèi)似拜1 RSA密伴鑰生成命令唉疤生成RSA私鑰奧openssl埃般 genrsa岸 -out r癌sa_priv鞍ate_key熬.pem 10稗24熬哎生成RSA公鑰白o(hù)penssl壩盎 rsa -i絆n rsa_p霸rivate_礙key.pem矮 -pubou挨t -out 骯rsa_pub芭lic_key霸.pem跋笆將RSA私鑰轉(zhuǎn)敖換成PKCS8隘格式盎openssl辦啊 pkcs8 鞍-topk8 傲-inform胺 PEM -i芭n rsa_p案rivate_爸key.pem岸 -outfo擺rm PEM 昂-nocryp艾t

41、半2 簽名/驗(yàn)盎簽名命令RSA簽名盎openssl頒哎 sha1 -吧sign rs礙a_priva敖te_key.靶pem -ou耙t rsasi昂gn.bin 辦plainte般xt.txtRSA驗(yàn)簽名礙openssl案吧 sha1 -藹verify 笆rsa_pub罷lic_key阿.pem -s跋ignatur翱e rsasi伴gn.bin 懊plainte半xt.txt公用枚舉表隘通知返回結(jié)果枚唉舉熬 鞍返回結(jié)果版結(jié)果說(shuō)明阿success笆處理成功，結(jié)束啊發(fā)送啊fail搬處理昂失敗埃，重新發(fā)送（支澳付寶平臺(tái)系統(tǒng)會(huì)跋在24小時(shí)內(nèi)分胺6-10次發(fā)送凹客戶(hù)信息，直到案接受到外部商戶(hù)巴發(fā)送的

42、succ矮ess）鞍注意：不能包含矮任何其他的HT般ML腳本語(yǔ)言，扮否則支付寶接受愛(ài)數(shù)據(jù)會(huì)收到影響壩通用昂交易狀態(tài)枚舉表班A正常交易狀翱態(tài)枚舉：愛(ài)交易狀態(tài)列表值巴（靶變量值：瓣trade_s罷tatus辦）啊說(shuō)明扒WAIT_BU叭YER_PAY叭交易創(chuàng)建盎TRADE_F白INISHED背傲支付成功，標(biāo)準(zhǔn)熬即時(shí)到賬成功狀叭態(tài)鞍TRADE_S啊UCCESS盎斑支付成功，機(jī)票背行業(yè)單筆退款成傲功（沒(méi)有全部退辦完）頒TRADE_C罷LOSED瓣交易關(guān)閉擺B板退款擺交易狀態(tài)枚舉：唉狀態(tài)代碼俺（靶變量值：隘refund_氨status案）氨狀態(tài)名稱(chēng)埃REFUND_熬SUCCESS拔 伴扳退款成功阿REFU

43、ND_隘CLOSED版退款關(guān)閉伴備注：如果在支哎付寶平臺(tái)操作退班款，交易狀態(tài)（昂trade_s埃tatus吧）會(huì)出現(xiàn)2中情笆況：板1. 不是全額耙退款，交易成功佰狀態(tài)變成暗TRADE_S昂UCCESS愛(ài)，增加一個(gè)退款搬狀態(tài)拌refund_哀status按=跋 REFUND胺_SUCCES瓣S八2. 全額退款瓣，交易成功狀態(tài)阿變成哀TRADE_C愛(ài)LOSED翱，增加一個(gè)退款啊狀態(tài)伴refund_藹status把=暗 REFUND扮_SUCCES骯S班。銀行列表捌銀行簡(jiǎn)碼案銀行胺名稱(chēng)凹ICBCBTB版中國(guó)工商銀行(哎B2B)翱ABCBTB拌中國(guó)農(nóng)業(yè)銀行(胺B2B)啊SPDBB2B背上海浦東發(fā)展銀邦

44、行(B2B)案CCBB2B鞍中國(guó)建設(shè)銀行(敗B2B)柏BOCB2C巴中國(guó)銀行隘ICBCB2C巴中國(guó)工商銀行礙CMB哀招商銀行氨CCB把中國(guó)建設(shè)銀行拜ABC柏中國(guó)農(nóng)業(yè)銀行爸SPDB伴上海浦東發(fā)展銀艾行八CIB藹興業(yè)銀行叭GDB俺廣東發(fā)展銀行礙SDB熬深圳發(fā)展銀行凹CMBC版中國(guó)民生銀行阿COMM拌交通銀行白CITIC敗中信銀行扒HZCBB2C吧杭州銀行傲CEBBANK版中國(guó)光大銀行胺SHBANK耙上海銀行搬NBBANK礙寧波銀行班SPABANK爸平安銀行拌bjbank1靶01稗北京農(nóng)村商業(yè)銀澳行熬備注：如果沒(méi)有壩需要網(wǎng)銀簡(jiǎn)碼，八可以詢(xún)問(wèn)支付寶罷技術(shù)支持工程師岸，更多網(wǎng)銀更新芭中。安純借記卡伴銀行

45、列表擺銀行簡(jiǎn)碼佰銀行芭名稱(chēng)吧CMB-DEB稗IT佰招商銀行瓣CCB-DEB般IT傲中國(guó)建設(shè)銀行白ICBC-DE昂BIT霸中國(guó)工商銀行班COMM-DE扒BIT罷交通銀行斑GDB-DEB巴IT擺廣東發(fā)展銀行哀BOC-DEB扒IT板中國(guó)銀行癌CEB-DEB邦I(lǐng)T頒中國(guó)光大銀行跋SPDB-DE吧BIT翱上海浦東發(fā)展銀稗行唉PSBC-DE伴BIT扒中國(guó)郵政儲(chǔ)蓄銀氨行骯備注：其他銀行岸陸續(xù)增加中。傲 爸信用卡搬大額背銀行列表阿銀行簡(jiǎn)碼稗銀行阿名稱(chēng)耙icbc301熬中國(guó)工商銀行八ccb301稗中國(guó)建設(shè)銀行扮cmb301佰招商銀行扒boc301背中國(guó)銀行傲comm30半1霸交通銀行癌gdb301扮廣東發(fā)展銀行

46、捌cib301哎興業(yè)半銀行巴ceb301佰中國(guó)吧光大銀行版spabank敖301暗平安銀行絆citic30伴2芭中信銀行癌s盎pdb啊301鞍浦發(fā)銀行隘shbank3翱01稗上海銀行稗備注：其他銀行霸陸續(xù)增加中。訂單狀態(tài)列表愛(ài)訂單狀態(tài)表：敖訂單狀態(tài)半值骯初始絆I按成功耙S頒失敗拔F隘沖正矮P岸被沖正阿N凹FAQ（常見(jiàn)問(wèn)凹題的的解答）案問(wèn)：我運(yùn)行程序邦后怎么一直報(bào)錯(cuò)靶誤代碼：I阿LLEGAL_熬SIGN埃？罷答：如果一直報(bào)暗ILLEGAL隘_SIGN（簽傲名錯(cuò)誤），請(qǐng)首疤先檢查程序中傳辦給支付寶的參數(shù)班有沒(méi)有存在空值八；然后再檢查s懊ubject和氨body有沒(méi)有搬特殊的字符。擺具體可以連接這霸

47、個(gè)網(wǎng)址查詢(xún)：癌http:/挨help.al案ipay.co阿m/suppo霸rt/inde瓣x.htm白問(wèn)：怎么一直報(bào)矮HAS案_NO_PRI佰VILEGE案？班答：報(bào)這個(gè)錯(cuò)誤礙，說(shuō)明您目前沒(méi)擺有使用該服務(wù)的埃權(quán)限。遇到這個(gè)佰錯(cuò)誤耙:懊a.)吧 要確定您的合拌同是在生效期內(nèi)艾并且有這個(gè)服務(wù)俺（譬如：即時(shí)支版付的服務(wù)）。艾b.)佰將出現(xiàn)錯(cuò)誤的U埃RL（地址欄的叭地址）粘貼出來(lái)愛(ài)，看看part伴ner和ser瓣vice是不是暗這個(gè)對(duì)應(yīng)的服務(wù)辦參數(shù)盎問(wèn)：我怎么接受敗不到支付寶返回佰的信息？暗答：如果沒(méi)有接邦收到支付寶返回挨的信息，哎 伴A佰）哀return_吧url疤和白notify_版url敖的路徑爸 B）檢查柏并輸出sign背、mysign版和respon疤seTxt的值翱；對(duì)于同步（暗