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

請求參數說明

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

參數	參數名稱	類型（字節長度）	參數說明	是否可為空	樣例
基本參數
service	接口名稱	String	接口名稱。	不可空	create_direct_pay_by_user
partner	合作者身份ID	String(16)	簽約的支付寶賬號對應的支付寶唯一用戶號。 以2088開頭的16位純數字組成。	不可空	2088101011913539
_input_charset	參數編碼字符集	String	商戶網站使用的編碼格式，如UTF-8、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)			[e-mail]
seller_account_name	賣家支付寶賬號別名	String(100)			[e-mail]
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)			[e-mail]
buyer_account_name	買家支付寶賬號別名	String(100)			[e-mail]
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或手機號碼。	可空	[e-mail]
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和手機號碼。	可空	[e-mail]
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