支付寶即時到賬接口說明詳細文檔

請求參數說明

請求參數是商戶在與支付寶進行數據交互時，提供給支付寶的請求數據，以便支付寶根據這些數據進一步處理。

參數	參數名稱	類型（字節長度）	參數說明	是否可爲空	樣例
基本參數
service	接口名稱	String	接口名稱。	不可空	create_direct_pay_by_user
partner	合做者身份ID	String(16)	簽約的支付寶帳號對應的支付寶惟一用戶號。 以2088開頭的16位純數字組成。	不可空	2088101011913539
_input_charset	參數編碼字符集	String	商戶網站使用的編碼格式，如UTF-八、GBK、GB2312等。	不可空	GBK
sign_type	簽名方式	String	DSA、RSA、MD5三個值可選，必須大寫。	不可空	MD5
sign	簽名	String	請參見本文檔「附錄：簽名與驗籤」。	不可空	7d314d22efba4f336fb187697793b9d2
notify_url	服務器異步通知頁面路徑	String(190)	支付寶服務器主動通知商戶網站裏指定的頁面http路徑。	可空	http://api.test.alipay.net/atinterface/receive_return.htm
return_url	頁面跳轉同步通知頁面路徑	String(200)	支付寶處理完請求後，當前頁面自動跳轉到商戶網站裏指定頁面的http路徑。	可空	http://api.test.alipay.net/atinterface/receive_return.htm
業務參數
out_trade_no	商戶網站惟一訂單號	String(64)	支付寶合做商戶網站惟一訂單號。	不可空	6843192280647118
subject	商品名稱	String(256)	商品的標題/交易標題/訂單標題/訂單關鍵字等。 該參數最長爲128個漢字。	不可空	貝爾金護腕式
payment_type	支付類型	String(4)	只支持取值爲1（商品購買）。	不可空	1
total_fee	交易金額	Number	該筆訂單的資金總額，單位爲RMB-Yuan。取值範圍爲[0.01，100000000.00]，精確到小數點後兩位。	不可空	100
seller_id	賣家支付寶用戶號	String(16)	seller_id是以2088開頭的純16位數字。 seller_email是支付寶登陸帳號，格式通常是郵箱或手機號。 seller_account_name是賣家支付寶帳號別名。 三個參數至少必須傳遞一個。 即時到帳僅支持簽約帳號收款，所以建議使用seller_id，並設置seller_id的值與partner的值相同。 三個參數的優先級別是：seller_id>seller_account_name>seller_email。	不可空	2088002007018966
seller_email	賣家支付寶帳號	String(100)			alipay-test01@alipay.com
seller_account_name	賣家支付寶帳號別名	String(100)			tstable02@alipay.com
buyer_id	買家支付寶用戶號	String(16)	buyer_id是以2088開頭的純16位數字。 buyer_email是支付寶登陸帳號，格式通常是郵箱或手機號。 buyer_account_name是買家支付寶帳號別名。 三個參數的優先級別是：buyer_id>buyer_account_name>buyer_email。	可空	2088002007018955
buyer_email	買家支付寶帳號	String(100)			tstable01@alipay.com
buyer_account_name	買家支付寶帳號別名	String(100)			tstable03@alipay.com
price	商品單價	Number	單位爲：RMB Yuan。取值範圍爲[0.01，100000000.00]，精確到小數點後兩位。此參數爲單價 規則：price、quantity能代替total_fee。即存在total_fee，就不能存在price和quantity；存在price、quantity，就不能存在total_fee。	可空	10.00
quantity	購買數量	Number	price、quantity能代替total_fee。即存在total_fee，就不能存在price和quantity；存在price、quantity，就不能存在total_fee。	可空	1
body	商品描述	String(1000)	對一筆交易的具體描述信息。若是是多種商品，請將商品描述字符串累加傳給body。	可空	美國專業護腕鼠標墊，舒緩式凝膠軟墊模擬手腕的天然曲線和運動，創造和緩的GelFlex溫馨地帶！
show_url	商品展現網址	String(400)	收銀臺頁面上，商品展現的超連接。	可空	http://www.360buy.com/product/113714.html
enable_paymethod	可用渠道	String	可用的支付渠道，用戶只能在指定渠道範圍內支付。 當有多個渠道時，以「^」分隔。 與disable_paymethod互斥。	可空	directPay^bankPay^cartoon^cash
disable_paymethod	禁用渠道	String	被禁用的支付渠道，用戶不可用指定渠道支付。 當有多個渠道時，以「^」分隔。 與nable_paymethod互斥。	可空	directPay^bankPay^cartoon
anti_phishing_key	防釣魚時間戳	String	經過時間戳查詢接口獲取的加密支付寶系統時間戳。 若是已申請開通防釣魚時間戳驗證，則此字段必填。	可空	587FE3D2858E6B01E30104656E7805E2
exter_invoke_ip	客戶端IP	String(15)	用戶在建立交易時，該用戶當前所使用機器的IP。 若是商戶申請後臺開通防釣魚IP地址檢查選項，此字段必填，校驗用。	可空	128.214.222.111
extra_common_param	公用回傳參數	String(100)	若是用戶請求時傳遞了該參數，則返回給商戶時會回傳該參數。	可空	你好，這是測試商戶的廣告。
it_b_pay	超時時間	String	該筆訂單容許的最晚付款時間，逾期將關閉交易。 取值範圍：1m～15d。 m-分鐘，h-小時，d-天，1c-當天（1c-當天的狀況下，不管交易什麼時候建立，都在0點關閉）。 該參數數值不接受小數點，如1.5h，可轉換爲90m。 該參數在請求到支付寶時開始計時。	可空	1h
token	快捷登陸受權令牌	String(40)	若是開通了快捷登陸產品，則須要填寫；若是沒有開通，則爲空。	可空	201103290c9f9f2c03db4267a4c8e1bfe3adfd52
qr_pay_mode	掃碼支付方式	String(1)	掃碼支付的方式，支持前置模式和跳轉模式。 前置模式是將二維碼前置到商戶的訂單確認頁的模式。須要商戶在本身的頁面中以iframe方式請求支付寶頁面。具體分爲如下4種： 0：訂單碼-簡約前置模式，對應iframe寬度不能小於600px，高度不能小於300px； 1：訂單碼-前置模式，對應iframe寬度不能小於300px，高度不能小於600px； 3：訂單碼-迷你前置模式，對應iframe寬度不能小於75px，高度不能小於75px。 4：訂單碼-可定義寬度的嵌入式二維碼，商戶可根據須要設定二維碼的大小。 跳轉模式下，用戶的掃碼界面是由支付寶生成的，不在商戶的域名下。 2：訂單碼-跳轉模式	可空	1
qrcode_width	商戶自定二維碼寬度	Integer	商戶自定義的二維碼寬度。 當qr_pay_mode=4時，該參數生效。	可空	200
need_buyer_realnamed	是否須要買家實名認證	String(2)	是否須要買家實名認證。 T表示須要買家實名認證； 不傳或者傳其它值表示不須要買家實名認證。	可空	T
hb_fq_param	花唄分期參數	String	參數格式：hb_fq_seller_percent ^賣家承擔付費比例|hb_fq_num ^期數。 hb_fq_num：花唄分期數，好比分3期支付； hb_fq_seller_percent：賣家承擔收費比例，好比100表明賣家承擔100%。 兩個參數必須一塊兒傳入。 兩個參數用「|」間隔。Key和value之間用「^」間隔。 具體花唄分期期數和賣家承擔收費比例可傳入的數值請諮詢支付寶。	可空	hb_fq_seller_percent^100|hb_fq_num^3
goods_type	商品類型	String(2)	商品類型： 1表示實物類商品 0表示虛擬類商品 若是不傳，默認爲實物類商品。	可空	1
extend_param	業務擴展參數	String	參數格式：參數名1^參數值1|參數名2^參數值2|…… 多條數據用「|」間隔。 詳見下面的「業務擴展參數說明」。	可空	TRANS_MEMO^促銷|ISV^sd22

業務擴展參數說明

參數	參數名稱	類型（字節長度）	參數說明	是否可爲空	樣例
ISV	系統商編號	String(64)	系統商編號，該參數做爲系統商返傭數據提取的依據。	可空	sd22
TRANS_MEMO	帳務備註	String(128)	帳務備註。 注：該字段顯示在離線帳單的帳務備註中。	可空	促銷

1

https: //mapi.alipay.com/gateway.do?body=%C3%C0%B9%FA%D7%A8%D2%B5%BB%A4%CD%F3%CA%F3%B1%EA%B5%E6%2C%CA%E6%BB%BA%CA%BD%C4%FD%BD%BA%C8%ED%B5%E6%C4%A3%C4%E2%CA%D6%CD%F3%B5%C4%D7%D4%C8%BB%C7%FA%CF%DF%BA%CD%D4%CB%B6%AF%A3%AC%B4%B4%D4%EC%BA%CD%BB%BA%B5%C4GelFlex%CA%E6%CA%CA%B5%D8%B4%F8%21&subject=%B1%B4%B6%FB%BD%F0%BB%A4%CD%F3%CA%BD&sign_type=MD5&notify_url=http%3A%2F%2Fapi.test.alipay.net&out_trade_no=6741334835157966&return_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_return.htm&sign=dc3d42f405d7e738ab35344449e2d9f7&buyer_id=2088002007018955&total_fee=100&service=create_direct_pay_by_user&partner=2088101568338364&seller_id=2088002007018966&payment_type=1&qr_pay_mode=1&_input_charset=gbk

說明：
本樣例僅供參考，支付寶網關爲https://mapi.alipay.com/gateway.do。 

注意：

• 此接口只支持https請求；
• 參數body（商品描述）、subject（商品名稱）、extra_common_param（公用回傳參數）不能包含特殊字符（如：#、%、&、+）、敏感詞彙，也不能使用外國文字（旺旺不支持的外文，如：韓文、泰語、藏文、蒙古文、阿拉伯語）；
• 請按照本文檔「附錄：簽名與驗籤」中的簽名方法對輸入參數進行簽名，該接口請求才可以被支付寶系統接收；
• 此接口支持重複調用，前提是交易基本信息（買家、賣家、交易金額、超時時間等）在屢次調用中保持一致，且交易還沒有完成支付；
• 配置qr_pay_mode爲0或1或3或4的狀況下，同步通知地址return_url須要傳入商戶中間跳轉頁面，即該頁面須要實現讓父頁面自行跳轉的功能，中間頁面javascript代碼：<script>window.parent.location.href='父頁面調整的URL';</script>

頁面跳轉同步參數說明

支付寶對商戶的請求數據處理完成後，會將處理的結果數據經過系統程序控制客戶端頁面自動跳轉的方式通知給商戶網站。這些處理結果數據就是頁面跳轉同步通知參數。

參數	參數名稱	類型（字節長度）	參數說明	是否可爲空	樣例
is_success	成功標識	String(1)	表示接口調用是否成功，並不代表業務處理結果。	不可空	T
sign_type	簽名方式	String	DSA、RSA、MD5三個值可選，必須大寫。	不可空	MD5
sign	簽名	String(32)	請參見本文檔「附錄：簽名與驗籤」。	不可空	b1af584504b8e845ebe40b8e0e733729
out_trade_no	商戶網站惟一訂單號	String(64)	對應商戶網站的訂單系統中的惟一訂單號，非支付寶交易號。需保證在商戶網站中的惟一性。是請求時對應的參數，原樣返回。	可空	6402757654153618
subject	商品名稱	String(256)	商品的標題/交易標題/訂單標題/訂單關鍵字等。	可空	手套
payment_type	支付類型	String(4)	只支持取值爲1（商品購買）。	可空	1
exterface	接口名稱	String	標誌調用哪一個接口返回的連接。	可空	create_direct_pay_by_user
trade_no	支付寶交易號	String(64)	該交易在支付寶系統中的交易流水號。最長64位。	可空	2014040311001004370000361525
trade_status	交易狀態	String	交易目前所處的狀態。成功狀態的值只有兩個： TRADE_FINISHED（普通即時到帳的交易成功狀態）； TRADE_SUCCESS（開通了高級即時到帳或機票分銷產品後的交易成功狀態）	可空	TRADE_FINISHED
notify_id	通知校驗ID	String	支付寶通知校驗ID，商戶能夠用這個流水號詢問支付寶該條通知的合法性。	可空	RqPnCoPT3K9%2Fvwbh3I%2BODmZS9o4qChHwPWbaS7UMBJpUnBJlzg42y9A8gQlzU6m3fOhG
notify_time	通知時間	Date	通知時間（支付寶時間）。格式爲yyyy-MM-dd HH:mm:ss。	可空	2008-10-23 13:17:39
notify_type	通知類型	String	返回通知類型。	可空	trade_status_sync
seller_email	賣家支付寶帳號	String(100)	賣家支付寶帳號，能夠是Email或手機號碼。	可空	chao.chenc1@alipay.com
buyer_email	買家支付寶帳號	String(100)	買家支付寶帳號，能夠是Email或手機號碼。	可空	tst***@alipay.com
seller_id	賣家支付寶帳戶號	String(30)	賣家支付寶帳號對應的支付寶惟一用戶號。以2088開頭的純16位數字。	可空	2088002007018916
buyer_id	買家支付寶帳戶號	String(30)	買家支付寶帳號對應的支付寶惟一用戶號。以2088開頭的純16位數字。	可空	2088101000082594
total_fee	交易金額	Number	該筆訂單的資金總額，單位爲RMB-Yuan。取值範圍爲[0.01,100000000.00]，精確到小數點後兩位。	可空	10.00
body	商品描述	String(1000)	對一筆交易的具體描述信息。若是是多種商品，請將商品描述字符串累加傳給body。	可空	Hello
extra_common_param	公用回傳參數	String	用於商戶回傳參數，該值不能包含「=」、「&」等特殊字符。若是用戶請求時傳遞了該參數，則返回給商戶時會回傳該參數。	可空	你好，這是測試商戶的廣告。

 

1

http: //商戶自定義地址/return_url.php?is_success=T&sign=b1af584504b8e845ebe40b8e0e733729&sign_type=MD5&body=Hello&buyer_email=xin***%40163.com&buyer_id=2088101000082594&exterface=create_direct_pay_by_user&out_trade_no=6402757654153618&payment_type=1&seller_email=chao.chenc1%40alipay.com&seller_id=2088002007018916&subject=%E5%A4%96%E9%83%A8FP&total_fee=10.00&trade_no=2014040311001004370000361525&trade_status=TRADE_FINISHED&notify_id=RqPnCoPT3K9%252Fvwbh3I%252BODmZS9o4qChHwPWbaS7UMBJpUnBJlzg42y9A8gQlzU6m3fOhG&notify_time=2008-10-23+13%3A17%3A39&notify_type=trade_status_sync&extra_common_param=%E4%BD%A0%E5%A5%BD%EF%BC%8C%E8%BF%99%E6%98%AF%E6%B5%8B%E8%AF%95%E5%95%86%E6%88%B7%E7%9A%84%E5%B9%BF%E5%91%8A%E3%80%82

說明：

本樣例僅供參考，實際網關爲商戶域名。

頁面跳轉同步通知頁面特性

1. 用戶在登陸成功後會看到一個支付寶提示登陸的頁面，該頁面會停留幾秒，而後會自動跳轉回商戶指定的同步通知頁面（參數return_url）。

2. 該頁面中得到參數的方式，須要使用GET方式獲取，如request.QueryString(「out_trade_no」)、$_GET[‘out_trade_no’]。後續商戶可根據獲取的信息做處理，譬如，能夠把獲取到的token放入session中，以便於後續須要使用到token訪問支付寶相應服務時，能夠便捷地重用。

3. 該方式僅僅在用戶登陸完成之後進行自動跳轉，所以只會進行一次。

4. 該方式不是支付寶主動去調用商戶頁面，而是支付寶的程序利用頁面自動跳轉的函數，使用戶的當前頁面自動跳轉。

5. 該方式可在本機而不是隻能在服務器上進行調試。

6. 返回URL只有一分鐘的有效期，超過一分鐘該連接地址會失效，驗證則會失敗。

7. 設置頁面跳轉同步通知頁面（return_url）的路徑時，不要在頁面文件的後面再加上自定義參數。例如：

• 錯誤的寫法：http://www.alipay.com/alipay/return_url.php?xx=11
• 正確的寫法：http://www.alipay.com/alipay/return_url.php

8. 因爲支付寶會對頁面跳轉同步通知頁面（return_url）的域名進行合法有效性校驗，所以設置頁面跳轉同步通知頁面（return_url）的路徑時，不要設置成本機域名，也不能帶有特殊字符（如「!」），如：

• 錯誤的寫法：
  http://localhost/alipay/return_url.php
  http://localhost:80/alipay/return_url.php
  http://商戶自定義地址/alipay/return!url.do
• 正確的寫法：
  可以正常訪問的域名地址：http://商戶自定義地址/alipay/return_url.php
可以正常訪問的IP地址：http://121.1.1.255/alipay/return_url.php

服務器異步通知參數說明

支付寶對商戶的請求數據處理完成後，會將處理的結果數據經過服務器主動通知的方式通知給商戶網站。這些處理結果數據就是服務器異步通知參數。

參數	參數名稱	類型（字節長度）	參數說明	是否可爲空	樣例
基本參數
notify_time	通知時間	Date	通知的發送時間。 格式爲yyyy-MM-dd HH:mm:ss。	不可空	2009-08-12 11:08:32
notify_type	通知類型	String	通知的類型。	不可空	trade_status_sync
notify_id	通知校驗ID	String	通知校驗ID。	不可空	70fec0c2730b27528665af4517c27b95
sign_type	簽名方式	String	DSA、RSA、MD5三個值可選，必須大寫。	不可空	DSA
sign	簽名	String	請參見本文檔「附錄：簽名與驗籤」。	不可空	_p_w_l_h_j0b_gd_aejia7n_ko4_m%2Fu_w_jd3_nx_s_k_mxus9_hoxg_y_r_lunli_pmma29_t_q%3D% 3D
業務參數
out_trade_no	商戶網站惟一訂單號	String(64)	對應商戶網站的訂單系統中的惟一訂單號，非支付寶交易號。 需保證在商戶網站中的惟一性。是請求時對應的參數，原樣返回。	可空	3618810634349901
subject	商品名稱	String(256)	商品的標題/交易標題/訂單標題/訂單關鍵字等。 它在支付寶的交易明細中排在第一列，對於財務對帳尤其重要。是請求時對應的參數，原樣通知回來。	可空	phone手機
payment_type	支付類型	String(4)	只支持取值爲1（商品購買）。	可空	1
trade_no	支付寶交易號	String(64)	該交易在支付寶系統中的交易流水號。最長64位。	可空	2014040311001004370000361525
trade_status	交易狀態	String	取值範圍請參見交易狀態。	可空	TRADE_FINISHED
gmt_create	交易建立時間	Date	該筆交易建立的時間。 格式爲yyyy-MM-dd HH:mm:ss。	可空	2008-10-22 20:49:31
gmt_payment	交易付款時間	Date	該筆交易的買家付款時間。 格式爲yyyy-MM-dd HH:mm:ss。	可空	2008-10-22 20:49:50
gmt_close	交易關閉時間	Date	交易關閉時間。 格式爲yyyy-MM-dd HH:mm:ss。	可空	2008-10-22 20:49:46
refund_status	退款狀態	String	取值範圍請參見退款狀態。	可空	REFUND_SUCCESS
gmt_refund	退款時間	Date	賣家退款的時間，退款通知時會發送。 格式爲yyyy-MM-dd HH:mm:ss。	可空	2008-10-29 19:38:25
seller_email	賣家支付寶帳號	String(100)	賣家支付寶帳號，能夠是email和手機號碼。	可空	chao.chenc1@alipay.com
buyer_email	買家支付寶帳號	String(100)	買家支付寶帳號，能夠是Email或手機號碼。	可空	137******70
seller_id	賣家支付寶帳戶號	String(30)	賣家支付寶帳號對應的支付寶惟一用戶號。 以2088開頭的純16位數字。	可空	2088002007018916
buyer_id	買家支付寶帳戶號	String(30)	買家支付寶帳號對應的支付寶惟一用戶號。 以2088開頭的純16位數字。	可空	2088002007013600
price	商品單價	Number	若是請求時使用的是total_fee，那麼price等於total_fee；若是請求時使用的是price，那麼對應請求時的price參數，原樣通知回來。	可空	10.00
total_fee	交易金額	Number	該筆訂單的總金額。 請求時對應的參數，原樣通知回來。	可空	10.00
quantity	購買數量	Number	若是請求時使用的是total_fee，那麼quantity等於1；若是請求時使用的是quantity，那麼對應請求時的quantity參數，原樣通知回來。	可空	1
body	商品描述	String(1000)	該筆訂單的備註、描述、明細等。 對應請求時的body參數，原樣通知回來。	可空	Hello
discount	折扣	Number	支付寶系統會把discount的值加到交易金額上，若是須要折扣，本參數爲負數。	可空	-5
is_total_fee_adjust	是否調整總價	String(1)	該交易是否調整過價格。	可空	N
use_coupon	是否使用紅包買家	String(1)	是否在交易過程當中使用了紅包。	可空	N
extra_common_param	公用回傳參數	String	用於商戶回傳參數，該值不能包含「=」、「&」等特殊字符。 若是用戶請求時傳遞了該參數，則返回給商戶時會回傳該參數。	可空	你好，這是測試商戶的廣告。

1

http: //商戶自定義地址/notify_url.php?trade_no=2014040311001004370000361525&out_trade_no=3618810634349901&discount=-5&payment_type=1&subject=iphone%E6%89%8B%E6%9C%BA&body=Hello&price=10.00&quantity=1&total_fee=10.00&trade_status=TRADE_FINISHED&refund_status=REFUND_SUCCESS&seller_email=chao.chenc1%40alipay.com&seller_id=2088002007018916&buyer_id=2088002007013600&buyer_email=137******70&gmt_create=2008-10-22+20%3A49%3A31&is_total_fee_adjust=N&gmt_payment=2008-10-22+20%3A49%3A50&gmt_close=2008-10-22+20%3A49%3A46&gmt_refund=2008-10-29+19%3A38%3A25&use_coupon=N&notify_time=2009-08-12+11%3A08%3A32&notify_type=trade_status_sync&notify_id=70fec0c2730b27528665af4517c27b95&sign_type=DSA&sign=_p_w_l_h_j0b_gd_aejia7n_ko4_m%252Fu_w_jd3_nx_s_k_mxus9_hoxg_y_r_lunli_pmma29_t_q%253D%253D&extra_common_param=%E4%BD%A0%E5%A5%BD%EF%BC%8C%E8%BF%99%E6%98%AF%E6%B5%8B%E8%AF%95%E5%95%86%E6%88%B7%E7%9A%84%E5%B9%BF%E5%91%8A%E3%80%82

說明：

本樣例僅供參考，實際網關爲商戶域名。

服務器異步通知頁面特性

1. 必須保證服務器異步通知頁面（notify_url）上無任何字符，如空格、HTML標籤、開發系統自帶拋出的異常提示信息等；
2. 支付寶是用POST方式發送通知信息，所以該頁面中獲取參數的方式，如：
   request.Form("out_trade_no")、$_POST['out_trade_no']；
3. 支付寶主動發起通知，該方式纔會被啓用；
4. 只有在支付寶的交易管理中存在該筆交易，且發生了交易狀態的改變，支付寶纔會經過該方式發起服務器通知（即時到帳中交易狀態爲「等待買家付款」的狀態默認是不會發送通知的）；
5. 服務器間的交互，不像頁面跳轉同步通知能夠在頁面上顯示出來，這種交互方式是不可見的；
6. 第一次交易狀態改變（即時到帳中此時交易狀態是交易完成）時，不只頁面跳轉同步通知頁面會啓用，並且服務器異步通知頁面也會收到支付寶發來的處理結果通知；
7. 程序執行完後必須打印輸出「success」（不包含引號）。若是商戶反饋給支付寶的字符不是success這7個字符，支付寶服務器會不斷重發通知，直到超過24小時22分鐘。
   通常狀況下，25小時之內完成8次通知（通知的間隔頻率通常是：4m,10m,10m,1h,2h,6h,15h）；
8. 程序執行完成後，該頁面不能執行頁面跳轉。若是執行頁面跳轉，支付寶會收不到success字符，會被支付寶服務器斷定爲該頁面程序運行出現異常，而重發處理結果通知；
9. cookies、session等在此頁面會失效，即沒法獲取這些數據；
10. 該方式的調試與運行必須在服務器上，即互聯網上能訪問；
11. 該方式的做用主要防止訂單丟失，即頁面跳轉同步通知沒有處理訂單更新，它則去處理；
12. 當商戶收到服務器異步通知並打印出success時，服務器異步通知參數notify_id纔會失效。也就是說在支付寶發送同一條異步通知時（包含商戶並未成功打印出success致使支付寶重發數次通知），服務器異步通知參數notify_id是不變的。

通知觸發條件

觸發條件名	觸發條件描述	觸發條件默認值
TRADE_FINISHED	交易完成	true（觸發通知）
TRADE_SUCCESS	支付成功	true（觸發通知）
WAIT_BUYER_PAY	交易建立	false（不觸發通知）
TRADE_CLOSED	交易關閉	false（不觸發通知）

說明：

商戶能夠向支付寶申請配置，是否觸發各交易狀態下的異步通知。

支付渠道

枚舉名稱	枚舉說明
directPay	支付寶帳戶餘額
moneyFund	餘額寶
cartoon	卡通
bankPay	網銀
cash	現金
creditCardExpress	信用卡快捷
debitCardExpress	借記卡快捷
coupon	紅包
point	積分
voucher	購物券

交易狀態

枚舉名稱	枚舉說明
WAIT_BUYER_PAY	交易建立，等待買家付款。
TRADE_CLOSED	在指定時間段內未支付時關閉的交易； 在交易完成全額退款成功時關閉的交易。
TRADE_SUCCESS	交易成功，且可對該交易作操做，如：多級分潤、退款等。
TRADE_PENDING	等待賣家收款（買家付款後，若是賣家帳號被凍結）。
TRADE_FINISHED	交易成功且結束，即不可再作任何操做

退款狀態

枚舉名稱	枚舉說明
REFUND_SUCCESS	退款成功： 全額退款狀況：trade_status= TRADE_CLOSED，而refund_status=REFUND_SUCCESS 非全額退款狀況：trade_status= TRADE_SUCCESS，而refund_status=REFUND_SUCCESS
REFUND_CLOSED	退款關閉

業務錯誤碼

錯誤代碼（error_code）	含義
SELLER_NOT_IN_SPECIFIED_SELLERS	抱歉，該收款帳戶不是指定的收款帳戶，請確認參數是否正確或諮詢您的客戶經理。
TRADE_SELLER_NOT_MATCH	抱歉，該筆交易的賣家已不存在，請聯繫正確的賣家從新建立交易進行付款。
TRADE_BUYER_NOT_MATCH	抱歉，您本次支付使用的帳戶與原先的不一致，請使用原來的帳戶，或從新建立交易付款。
ILLEGAL_FEE_PARAM	抱歉，金額傳遞錯誤，請確認參數是否正確或諮詢您的客戶經理。
SUBJECT_MUST_NOT_BE_NULL	商品名不能爲空。
TRADE_PRICE_NOT_MATCH	抱歉，該商品的交易單價與原先的不一致，請從新建立交易付款。
TRADE_QUANTITY_NOT_MATCH	抱歉，該商品的購買數量與原先的不一致，請從新建立交易付款。
TRADE_TOTALFEE_NOT_MATCH	抱歉，該商品的交易金額與原先的不一致，請從新建立交易付款。
TRADE_NOT_ALLOWED_PAY	抱歉，您不能進行本次支付，請查看該交易是否已超時或已被關閉等。
DIRECT_PAY_WITHOUT_CERT_CLOSE	未開通非證書餘額支付，沒法完成支付。
FAIL_CREATE_CASHIER_PAY_ORDER	抱歉，系統異常，沒法建立本次收銀臺支付訂單，請稍後再試。
ILLEGAL_EXTRA_COMMON_PARAM	抱歉，接口通用回傳參數格式不正確，請聯繫您的商戶。
ILLEGAL_PAYMENT_TYPE	抱歉，接口傳遞的Payment_type參數錯誤，請聯繫您的商戶。
NOT_SUPPORT_GATEWAY	抱歉，商戶網關配置出錯，請聯繫您的商戶。
BUYER_SELLER_EQUAL	抱歉，買家和賣家不能是同一個帳戶。
SELLER_NOT_EXIST	抱歉，賣家帳戶經驗證不存在，請聯繫您的商戶。
ILLEGAL_ARGUMENT	抱歉，商戶傳遞的接口參數錯誤，請聯繫您的商戶。
TRADE_NOT_FOUND	根據交易號沒法找到交易。
TRADE_GOOD_INFO_NOT_FOUND	根據交易號沒法找到交易詳情。
BUYER_EMAIL_ID_MUST_NULL	抱歉，該筆交易的買家帳戶必須爲空，請聯繫您的商戶。
PRODUCT_NOT_ALLOWED	您未開通此產品，暫時沒法使用本服務。
ROYALTY_RECEIVER_NOT_IN_SPECIFIED_ACCOUNTS	抱歉，分潤帳號不是指定的分潤帳戶，請確保該分潤帳戶已簽署分潤協議。
ROYALTY_LENGTH_ERROR	抱歉，分潤信息過長，不能超過1000個字符，請檢查後從新集成。
DEFAULT_BANK_INVALID	您傳遞的默認網銀參數不在規定的範圍內。
DIS_NOT_SIGN_PROTOCOL	抱歉，您的分銷商沒有與支付寶簽約，請聯繫您的商戶。
SELF_TIMEOUT_NOT_SUPPORT	抱歉，商戶沒有開通自定義超時權限，請聯繫您的商戶。
ILLEGAL_OUTTIME_ARGUMENT	抱歉，自定義超時時間設置錯誤，請聯繫您的商戶。
EBANK_CERDIT_GW_RULE_NOT_OPEN	信用卡未簽約（簽約到期）或者接口參數未指定開通訊用卡支付。
DIRECTIONAL_PAY_FORBIDDEN	付款受限，請確保收款方有權進行收款。
SELLER_ENABLE_STATUS_FORBID	賣家狀態不正常。
ROYALTY_SELLER_ENABLE_STATUS_FORBID	抱歉，賣家暫時沒法進行收款操做，請聯繫您的商戶。
ROYALTY_SELLER_NOT_CERTIFY	抱歉，賣家還沒有經過認證，不能進行收款，請聯繫您的商戶。
ROYALTY_FORAMT_ERROR	抱歉，接口傳遞的分潤參數格式錯誤，請檢查後從新集成。
ROYALTY_TYPE_ERROR	抱歉，接口傳遞的分潤類型錯誤，請檢查後從新集成。
ROYALTY_RECEIVE_EMAIL_NOT_EXIST	抱歉，分潤帳戶經驗證不存在，請聯繫您的商戶。
ROYALTY_RECEIVE_EMAIL_NOT_CERTIFY	抱歉，分潤帳戶經驗證未經過人行驗證，請聯繫您的商戶。
ROYALTY_PAY_EMAIL_NOT_EXIST	抱歉，分潤付款帳戶經驗證不存在，請聯繫您的商戶。
TAOBAO_ANTI_PHISHING_CHECK_FAIL	抱歉，沒法付款! 該筆交易可能存在風險，若是您肯定本次交易沒有問題，請1個小時後再付款。
SUBJECT_HAS_FORBIDDENWORD	抱歉，沒法付款! 請聯繫商戶修改商品名稱，再從新購買。
PAY_CHECK_FAIL	抱歉，付款失敗! 該筆交易可能存在風險。
BODY_HAS_FORBIDDENWORD	抱歉，沒法付款! 請聯繫商戶修改商品描述，再從新購買。
NEED_CTU_CHECK_PARAMETER_ERROR	抱歉，您傳遞的商戶可信任參數權限參數錯誤。
NEED_CTU_CHECK_NOT_ALLOWED	抱歉，商戶沒有可信任參數校驗的權限。
BUYER_NOT_EXIST	抱歉，買家帳戶經驗證不存在。
HAS_NO_PRIVILEGE	無權訪問
TOTAL_FEE_EXCEED	訂單金額超過限額，或付款金額爲0
INVALID_PARAMETER	參數無效
ILLEGAL_PARTNER_EXTERFACE	合做夥伴信息不正確

 

https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.HhH88f&treeId=62&articleId=104743&docType=1