世聯翻譯公司完成電子系統網關接口中文翻譯

 

純網關接口

服務名稱：create_direct_pay_by_user

版本號：4.1

支付寶（中國）網絡技術有限公司 版權所有

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 2 頁

 

文檔說明

1.1

功能描述

通過支付寶的支付渠道，付款者可以直接匯款給另一個擁有支付寶賬號的收款者。

1.2

閱讀對象

支付寶純網關接口文檔是面向具有一定的網站開發能力，了解ASP、PHP、JAVA、ASP.NET等開發語言中的一種及SQL數據庫語言的網站開發、維護和管理人員。

1.3

業務術語

表1-

1 業務術語

術語

解釋

CTU

支付寶風險稽查系統。

純網關

網銀支付，無需訪問支付寶，直接跳轉到網銀進行支付，由商戶指定銀行列表，買家選擇。

返回

頁面跳轉同步通知。支付寶根據得到的數據處理完成后，當前頁面從支付寶的頁面自動跳轉回商戶的網站，同時攜帶處理完成的結果信息反饋給商戶網站。

防釣魚

“網絡釣魚”攻擊利用欺騙性的電子郵件和偽造的Web站點來進行詐騙活動，受騙者往往會泄露自己的財務數據，如銀行卡號、賬戶用戶名、口令和社保編號等內容，造成損失。防釣魚用來防止以上情況的發生。

分潤

分潤是指將交易金額中的一部分轉賬給其它賬戶。

紅包

支付寶紅包為現金紅包，可直接使用于相應范圍的交易。

卡通

支付寶卡通是將用戶的支付寶賬戶與銀行卡連通，不需要開通網上銀行，即可直接在網上付款，并且享受支付寶提供的“先驗貨，再付款”的擔保服務。

請求

通過HTTP協議把需要傳輸的數據發送給接收方的過程。

通知

服務器異步通知。支付寶根據得到的數據處理完成后，支付寶的服務器主動發起通知給商戶的網站，同時攜帶處理完成的結果信息反饋給商戶網站。

偽網關

網銀支付，需要訪問支付寶，在統一收銀臺選擇銀行，由買家選擇。

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 6 頁

2

功能演示

步驟

1： 進入充值平臺，選擇網上銀行。

(1)

選擇招商銀行，輸入充值金額：

圖2-1

充值平臺

(2)

確認網銀充值信息：

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 7 頁

圖2-2

確認充值信息

步驟

2： 生成充值訂單，跳轉銀行頁面，確認支付。

(1) 選擇網銀入口，頁面如圖2-3所示：

圖2-

3 網銀入口

(2) 進

入網銀頁面，確認支付：

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 8 頁

圖2-

4 確認支付

步驟

3： 完成支付。

(1) 支

付完成之后，網銀提示支付成功：

圖2-

5 網銀成功頁面

(2) 付

款完成后，跳回支付寶頁面，提示成功付款：

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 9 頁

圖2-

6 支付成功頁面

步驟

4： 頁面自動跳轉回商戶網站。

若在支付時，傳遞給支付寶的參數中包含return_url參數，則支付完成后，支付寶的提示支付成功頁面會停留幾秒后跳轉回return_url參數指定的商戶路徑頁面。

3 數

據交互

圖3-

1 商戶系統請求－支付寶響應交互模式

(1) 構

造請求數據

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 10 頁

商戶根據支付寶提供的接口規則，通過程序生成得到簽名結果及要傳輸給支付寶的數據集合。

(2)

發送請求數據

把構造完成的數據集合，通過頁面鏈接跳轉或表單提交的方式傳遞給支付寶。

(3)

支付寶對請求數據進行處理

支付寶得到這些集合后，會先進行安全校驗等驗證，一系列驗證通過后便會處理這次發送過來的數據請求。

(4)

返回處理的結果數據

對于處理完成的交易，支付寶會以兩種方式把數據反饋給商戶網站。

􀁺 程序

上自動進行重新構造URL地址鏈接，在用戶當前頁面上通過自動跳轉的方式跳回商戶在請求時設定好的頁面路徑地址（參數return_url，如果商戶沒有設定，則不會進行該操作）；

􀁺

支付寶服務器主動發起通知，調用商戶在請求時設定好的頁面路徑（參數notify_url，如果商戶沒有設定，則不會進行該操作）。

(

5) 對獲取的返回結果數據進行處理

商戶在同步通知處理頁面（參數return_url指定頁面文件）或服務器異步通知頁面（參數notify_url指定頁面文件）獲取支付寶返回的結果數據后，可以結合自身網站的業務邏輯進行數據處理（如：訂單更新、自動充值到會員賬號中等）。

4

請求參數說明

4.1

含義

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

4.2

列表

表4-1

請求參數說明

參數

參數名稱

類型（字節長度）

參數說明

是否可為空

樣例

基本參數

service

接口名稱

String

接口名稱。

不可空

create_direct_pay_by_user

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 11 頁

參數 參數名稱

類型（字

節長度）

參數說明

是否可

為空

樣例

partner

合作者身份ID

String(16)

簽約的支付寶賬號對應的支付寶唯一用戶號。

以2088開頭的16位純數字組成。

不可空

2088002396712354

_input_charset

參數編碼字符集

String

商戶網站使用的編碼格式，如utf-8、gbk、gb2312等。

不可空

gbk

sign_type

簽名方式

String

DSA、RSA、MD5三個值可選，必須大寫。

不可空

MD5

sign

簽名

String

請參見“8 簽名機制”。

不可空

be4an8ya8hbnbzmyi945f5c1ckbp6bbe

notify_url

服務器異步通知頁面路徑

String(190)

支付寶服務器主動通知商戶網站里指定的頁面http路徑。

可空

http://api.test.alipay.net/atinterface/receive_notify.htm

return_url

頁面跳轉同步通知頁面路徑

String(200)

支付寶處理完請求后，當前頁面自動跳轉到商戶網站里指定頁面的http路徑。

可空

http://api.test.alipay.net/atinterface/receive_return.htm

error_notify_url

請求出錯時的通知頁面路徑

String(200)

當商戶通過該接口發起請求時，如果出現提示報錯，支付寶會根據“11.10 item_orders_info出錯時的通知錯誤碼”和“11.11 請求出錯時的通知錯誤碼”通過異步的方式發送通知給商戶。

該功能需要聯系支付寶開通。

可空

http://api.test.alipay.net/atinterface/receive_return.htm

業務參數

out_trade_no

商戶網站唯一訂單號

String(64)

支付寶合作商戶網站唯一訂單號（確保在商戶系統中唯一）。

不可空

6741334835157966

subject

商品名稱

String(256)

商品的標題/交易標題/訂單標題/訂單關鍵字等。

該參數最長為128個漢字。

不可空

貝爾金護腕式

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 12 頁

類型（字 是否可

參數 參數名稱 參數說明 樣例

節長度） 為空

payment_type

支付類型

String(4)

取值范圍請參見附錄“11.5 收款類型”。

默認值為：1（商品購買）。注意：

支付類型為“47”時，公共業務擴展參數（extend_param）中必須包含憑證號（evoucheprod_evouche_id）參數名和參數值。

不可空

1

defaultbank

默認網銀

String

銀行簡碼，請參見“11.6 銀行簡碼——混合渠道”和“11.7 銀行簡碼——純借記卡渠道”。

􀀉 說明：

如果要使用純網關功能，本參數需賦值為“11.6 銀行簡碼——混合渠道”或“11.7 銀行簡碼——純借記卡渠道”中的值。

不可空

CMB

seller_email

賣家支付寶賬號

String(100)

賣家支付寶賬號。

賣家信息優先級：seller_id>seller_account_name>seller_email。

seller_id，seller_account_name和seller_email不能全部為空，至少有一項不為空。

可空

alipay-test01@alipay.com

seller_id

賣家支付寶賬戶號

String(16)

賣家支付寶賬號對應的支付寶唯一用戶號。

以2088開頭的純16位數字。

可空

2088002007018966

seller_account_name

賣家別名支付寶賬號

String(100)

賣家別名支付寶賬號。

賣家信息優先級：seller_id>seller_account_name>seller_email。

可空

tstable02@alipay.com

price

商品單價

Number

單位為：RMB Yuan。取值范圍為[0.01，100000000.00]，精確到小數點后兩位。

規則：price、quantity能代替total_fee。即存在total_fee，就不能存在price和quantity；存在price、quantity，就不能存在total_fee。

可空

10.00

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 13 頁

參數 參數名稱

類型（字

節長度）

參數說明

是否可

為空

樣例

total_fee

交易金額

Number

該筆訂單的資金總額，單位為RMB-Yuan。取值范圍為[0.01，100000000.00]，精確到小數點后兩位。

可空

100

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

paymethod

默認支付方式

String

若要使用純網關，取值必須是bankPay（網銀支付）。

如果不設置，默認為directPay（余額支付）。

􀀉 說明：

必須注意區分大小寫。

可空

bankPay

need_ctu_check

網銀支付時是否做CTU校驗

String

商戶在配置了支持CTU（支付寶風險稽查系統）校驗權限的前提下，可以選擇本次交易是否需要經過CTU校驗。

􀁺 Y：做

CTU校驗；

􀁺

N：不做CTU校驗。

可空

Y

royalty_type

提成類型

String(2)

目前只支持一種類型：10（賣家給第三方提成）。

當傳遞了參數royalty_parameters時，提成類型參數不能為空。

可空

10

royalty_parameters

分潤賬號集

String(1000)

參見“4.3 royalty_parameters參數說明”。

可空

參見“4.3 royalty_parameters參數說明”

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 14 頁

參數 參數名稱

類型（字

節長度）

參數說明

是否可

為空

樣例

anti_phishing_key

防釣魚時間戳

String

通過時間戳查詢接口獲取的加密支付寶系統時間戳。

如果已申請開通防釣魚時間戳驗證，則此字段必填。

可空

587FE3D2858E6B01E30104656E7805E2

exter_invoke_ip

客戶端IP

String(15)

用戶在創建交易時，該用戶當前所使用機器的IP。

如果商戶申請后臺開通防釣魚選項，此字段必填，校驗用。

可空

128.214.222.111

extra_common_param

公用回傳參數

String(100)

如果用戶請求時傳遞了該參數，則返回給商戶時會回傳該參數。

可空

你好，這是測試商戶的廣告。

extend_param

公用業務擴展參數

String

用于商戶的特定業務信息的傳遞，只有商戶與支付寶約定了傳遞此參數且約定了參數含義，此參數才有效。

參數格式：參數名1^參數值1|參數名2^參數值2|……

多條數據用“|”間隔。

支付類型（payment_type）為47（電子卡券）時，需要包含憑證號（evoucheprod_evouche_id）參數名和參數值。

可空

pnr^MFGXDW|start_ticket_no^123|end_ticket_no^234|b2b_login_name^abc

it_b_pay

超時時間

String

設置未付款交易的超時時間，一旦超時，該筆交易就會自動被關閉。

取值范圍：1m～15d。

m-分鐘，h-小時，d-天，1c-當天（無論交易何時創建，都在0點關閉）。

該參數數值不接受小數點，如1.5h，可轉換為90m。

該功能需要聯系支付寶配置關閉時間。

可空

1h

product_type

商戶申請的產品類型

String(50)

用于針對不同的產品，采取不同的計費策略。

如果開通了航旅垂直搜索平臺產品，請填寫CHANNEL_FAST_PAY；如果沒有，則為空。

可空

CHANNEL_FAST_PAY

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 15 頁

注意：

􀁺

此接口只支持https請求；

􀁺

參數body（商品描述）、subject（商品名稱）、extra_common_param（公用回傳參數）不能包含特殊字符（如：#、%、&、+）、敏感詞匯，也不能使用外國文字（旺旺不支持的外文，如：韓文、泰語、藏文、蒙古文、阿拉伯語）；

􀁺 請按照“8 簽名機制”中的簽名方法對輸入參數進行簽名，該接口請求才能夠被支付寶系統接收；

􀁺 此接口支持重復調用，前提是交易基本信息（買家、賣家、交易金額、超時時間等）在多次調用中保持一致，且交易尚未完成支付。

4

.3 royalty_parameters參數說明

1

. 參數格式說明

royalty_parameters參數為分潤賬號集，支持以下格式（用戶UID是一串以字母uid開頭，后面跟著以2088開頭的16位數字的字符串）：

(

1) 平級分潤

􀁺 收款方

Email1^金額1^備注1|收款方Email2^金額2^備注2

􀁺 付款

方Email^收款方Email1^金額1^備注1|付款方Email^收款方Email2^金額2^備注2

􀁺 收款

方UID1^金額1^備注1|收款方UID2^金額2^備注2

􀁺

付款方UID^收款方UID1^金額1^備注1|付款方UID^收款方UID2^金額2^備注2

(

2) 多級分潤

􀁺

收款方Email1^金額1^備注1|付款方Email1^收款方Email2^金額2^備注2|付款方Email2^收款方Email3^金額3^備注3

􀁺

收款方UID1^金額1^備注1|付款方UID1^收款方UID2^金額2^備注2|付款方UID2^收款方UID3^金額3^備注3

(3)

平級多級混合分潤

􀁺

收款方Email1^金額1^備注1|付款方Email1^收款方Email2^金額2^備注2|收款方Email3^金額3^備注3

􀁺

收款方UID1^金額1^備注1|付款方UID1^收款方UID2^金額2^備注2|收款方UID3^金額3^備注3

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 16 頁

注意：

􀁺 參數

royalty_parameters（分潤賬號集）如果有多條數據，用“|”隔開，最多不能超過10條；

􀁺

某條分潤數據沒有付款方，則默認賣家是付款方；

􀁺

各分潤賬號必須使用正確的支付寶賬號，能正常收款和付款；

􀁺

對于平級分潤，付款方Email必須與賣家Email一致；

􀁺

同一筆交易的分潤處理，必須遵循原則：分潤者要先收到錢才能再付給其他被分潤者，收到的錢一定要大于等于付出的錢，即先入后出，入要大于等于出；

􀁺

在各條分潤的“備注”中，不能出現“^”和“|”影響royalty_parameters格式的特殊字符；“備注”字段長度不能超過80個字節，即40個漢字；分潤信息中，“備注”項可以不填，但“^”不可以省略，如：收款方支付寶賬號1^金額1^。

2

. 參數樣例

􀁺

maomao1@yahoo.cn^1.00^分你的|maomao2@yahoo.cn^2.00^你也有

􀁺

uid2088123456789012^1.00^分你的|uid2088123456789013^2.00^你也有

4.4

樣例

https://mapi.alipay.com/gateway.do?_input_charset=gbk&defaultbank=CMB&notify_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_notify.htm&out_trade_no=6741334835157966&partner=2088002396712354&payment_type=1&paymethod=bankPay&return_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_return.htm&seller_email=alipay-test01@alipay.com&service=create_direct_pay_by_user&subject=%B1%B4%B6%FB%BD%F0%BB%A4%CD%F3%CA%BD&total_fee=100&sign=cbbe89815204510545cb821416ddf95d&sign_type=MD5

􀀉 說明：

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

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 17 頁

5

頁面跳轉同步通知參數說明

5

.1 含義

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

5.2

列表

表5

-1 頁面跳轉同步通知參數說明

參數

參數名稱

類型（字節長度）

參數說明

是否可為空

樣例

基本參數

is_success

成功標識

String(1)

表示接口調用是否成功，并不表明業務處理結果。

不可空

T

sign_type

簽名方式

String

DSA、RSA、MD5三個值可選，必須大寫。

不可空

MD5

sign

簽名

String(32)

請參見“8 簽名機制”。

不可空

b1af584504b8e845ebe40b8e0e733729

業務參數

out_trade_no

商戶網站唯一訂單號

String(64)

對應商戶網站的訂單系統中的唯一訂單號，非支付寶交易號。

需保證在商戶網站中的唯一性。是請求時對應的參數，原樣返回。

可空

6402757654153618

subject

商品名稱

String(256)

商品的標題/交易標題/訂單標題/訂單關鍵字等。

可空

手套

payment_type

支付類型

String(4)

對應請求時的payment_type參數，原樣返回。

可空

1

exterface

接口名稱

String

標志調用哪個接口返回的鏈接。

可空

create_direct_pay_by_user

trade_no

支付寶交易號

String(64)

該交易在支付寶系統中的交易流水號。

最短16位，最長64位。

可空

2008102303210710

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 18 頁

參數 參數名稱

類型（字

節長度）

參數說明

是否可

為空

樣例

trade_status

交易狀態

String

交易目前所處的狀態。

成功狀態的值只有兩個：

􀁺 TRAD

E_FINISHED（普通即時到賬的交易成功狀態）

􀁺 TRAD

E_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或手機號碼。

可空

tstable01@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(400)

對一筆交易的具體描述信息。如果是多種商品，請將商品描述字符串累加傳給body。

可空

Hello

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 19 頁

參數 參數名稱

類型（字

節長度）

參數說明

是否可

為空

樣例

bank_seq_no

網銀流水

String(64)

網銀流水號。

只有開通了純網關和偽網關的商戶，才返回該參數。

可空

􀁺 招行

：9220031730

􀁺

建行：20100329000000859967

extra_common_param

公用回傳參數

String

用于商戶回傳參數，該值不能包含“=”、“&”等特殊字符。

如果用戶請求時傳遞了該參數，則返回給商戶時會回傳該參數。

可空

你好，這是測試商戶的廣告。

5

.3 樣例

http://www.xxx.com/alipay/return_url.php?is_success=T&sign=b1af584504b8e845ebe40b8e0e733729&sign_type=MD5&body=Hello&buyer_email=xinjie_xj%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=2008102303210710&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&bank_seq_no=%E6%8B%9B%E8%A1%8C%E7%9A%84%E8%AE%A2%E5%8D%95%E5%8F%B7%E5%BD%A2%E5%A6%829220031730%3B%0D%0A%E5%BB%BA%E8%A1%8C%E7%9A%84%E5%BD%A2%E5%A6%8220100329000000859967

􀀉 說明：

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

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 20 頁

6

服務器異步通知參數說明

6

.1 含義

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

6.2

列表

表6

-1 服務器異步通知參數說明

參數

參數名稱

類型（字節長度）

參數說明

是否可為空

樣例

基本參數

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

請參見“8 簽名機制”。

不可空

_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

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 21 頁

參數 參數名稱

類型（字

節長度）

參數說明

是否可

為空

樣例

subject

商品名稱

String(256)

商品的標題/交易標題/訂單標題/訂單關鍵字等。

它在支付寶的交易明細中排在第一列，對于財務對賬尤為重要。是請求時對應的參數，原樣通知回來。

可空

phone手機

payment_type

支付類型

String(4)

取值范圍請參見附錄“11.5 收款類型”。

可空

1

trade_no

支付寶交易號

String(64)

該交易在支付寶系統中的交易流水號。

最短16位，最長64位。

可空

2008102203208746

trade_status

交易狀態

String

取值范圍請參見“11.4 交易狀態”。

可空

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

取值范圍請參見“11.3 退款狀態”。

可空

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或手機號碼。

可空

13758698870

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 22 頁

參數 參數名稱

類型（字

節長度）

參數說明

是否可

為空

樣例

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(400)

該筆訂單的備注、描述、明細等。

對應請求時的body參數，原樣通知回來。

可空

Hello

discount

折扣

Number

支付寶系統會把discount的值加到交易金額上，如果需要折扣，本參數為負數。

可空

-5

is_total_fee_adjust

是否調整總價

String(1)

該交易是否調整過價格。

可空

N

use_coupon

是否使用紅包買家

String(1)

是否在交易過程中使用了紅包。

可空

N

error_code

錯誤代碼

String

接口調用過程中的出錯信息，請參見“11.1 純網關業務錯誤碼”和“11.2 系統錯誤碼”。

可空

ILLEGAL_SIGN

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 23 頁

參數 參數名稱

類型（字

節長度）

參數說明

是否可

為空

樣例

bank_seq_no

網銀流水

String(64)

開通了純網關和偽網關的商戶，在交易成功后才可以返回網銀流水。

可空

􀁺 招行：

9220031730

􀁺 建行：

20100329000000859967

extra_common_param

公用回傳參數

String

用于商戶回傳參數，該值不能包含“=”、“&”等特殊字符。

如果用戶請求時傳遞了該參數，則返回給商戶時會回傳該參數。

可空

你好，這是測試商戶的廣告。

out_channel_type

支付渠道組合信息

String

該筆交易所使用的支付渠道。

格式為：渠道1|渠道2|…，如果有多個渠道，用“|”隔開。

取值范圍請參見附錄“11.8 渠道類型說明與幣種列表”。

可空

OPTIMIZED_MOTO|BALANCE

out_channel_amount

支付金額組合信息

String

該筆交易通過使用各支付渠道所支付的金額。

格式為：金額1|金額2|…，如果有多個支付渠道，各渠道所支付金額用“|”隔開。

可空

90.00|10.00

out_channel_inst

實際支付渠道

String

該交易支付時實際使用的銀行渠道。

格式為：支付渠道1|支付渠道2|…，如果有多個支付渠道，用“|”隔開。

取值范圍請參見附錄“11.9 實際支付渠道列表”。

該參數需要聯系支付寶開通。

可空

ICBC

6.3 樣

例

http://www.xxx.com/alipay/notify_url.php?trade_no=2008102203208746&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=13758698870&gmt_create=2008-10-22+20

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 24 頁

%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&bank_seq_no=%E6%8B%9B%E8%A1%8C%E7%9A%84%E8%AE%A2%E5%8D%95%E5%8F%B7%E5%BD%A2%E5%A6%829220031730%3B%0D%0A%E5%BB%BA%E8%A1%8C%E7%9A%84%E5%BD%A2%E5%A6%8220100329000000859967

􀀉 說明：

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

7

通知返回數據處理

7

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

(1) 買家

在支付成功后會看到一個支付寶提示交易成功的頁面，該頁面會停留幾秒，然后會自動跳轉回商戶指定的同步通知頁面（參數return_url）。

(2)

該頁面中獲得參數的方式，需要使用GET方式獲取，如request.QueryString("out_trade_no")、$_GET['out_trade_no']。

(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

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 25 頁

http://localhost:80/alipay/return_url.php http://www.xxx.com/alipay/return!url.do

􀁺 正確的寫法： 能夠正常訪問的域名地址：http://www.xxx.comalipay/return_url.php 能夠正常訪問的IP地址：http://121.1.1.255/alipay/return_url.php

7.2

服務器異步通知頁面特性

(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次通知（通知的間隔頻率一般是：2m,10m,10m,1h,2h,6h,15h）。

(8)

程序執行完成后，該頁面不能執行頁面跳轉。如果執行頁面跳轉，支付寶會收不到success字符，會被支付寶服務器判定為該頁面程序運行出現異常，而重發處理結果通知。

(9)

cookies、session等在此頁面會失效，即無法獲取這些數據。

(10

) 該方式的調試與運行必須在服務器上，即互聯網上能訪問。

(11

) 該方式的作用主要防止訂單丟失，即頁面跳轉同步通知沒有處理訂單更新，它則去處理。

(12

) 當商戶收到服務器異步通知并打印出success時，服務器異步通知參數notify_id才會失效。也就是說在支付寶發送同一條異步通知時（包含商戶并未成功打印出success導致支付寶重發數次通知），服務器異步通知參數notify_id是不變的。

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 26 頁

7.3

通知觸發條件

表7

-1 通知觸發條件

觸發條件名

觸發條件描述

觸發條件默認值

TRADE_FINISHED

交易成功

true（觸發通知）

TRADE_SUCCESS

支付成功

true（觸發通知）

WAIT_BUYER_PAY

交易創建

false（不觸發通知）

TRADE_CLOSED

交易關閉

false（不觸發通知）

􀀉 說明：

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

7.4

商戶業務處理注意事項

當支付寶處理完成后，支付寶會把處理結果以當前頁面跳轉同步通知和支付寶服務器主動通知商戶網站兩種形式，反饋給商戶網站。商戶可以從頁面跳轉同步通知頁面或者從服務器異步通知頁面中獲得這些信息，并且在驗證通過的判斷中增加商戶的業務邏輯處理程序。當商戶有傳遞參數notify_url（服務器異步通知頁面路徑）或return_url（頁面跳轉同步通知頁面路徑）時，商戶必須判斷商戶網站中是否已經對該次的通知結果數據做過同樣處理。如果不判斷，存在潛在的風險，商戶自行承擔因此而產生的所有損失。

(1) 交

易成功之后，商戶（高級即時到賬或機票平臺商）可調用批量退款接口，系統會發送退款通知給商戶，具體內容請參見批量退款接口文檔。

(2) 當

商戶使用站內退款時，系統會發送包含refund_status和gmt_refund字段的通知給商戶。

􀀉 說明：

更多業務處理注意事項請參見《即時到賬交易接口(create_direct_pay_by_user)接入與使用規則》文檔。

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 27 頁

8 簽

名機制

8.1

生成待簽名的字符串

8.1.

1 需要參與簽名的參數

在請求參數列表中，除去sign、sign_type兩個參數外，其他需要使用到的參數皆是要簽名的參數。（個別接口中參數sign_type也需要參與簽名。）

在通知返回參數列表中，除去sign、sign_type兩個參數外，凡是通知返回回來的參數皆是要簽名的參數。

8.1.2

生成待簽名字符串

對于如下的參數數組：

string[] parameters={

"service=create_direct_pay_by_user",

"partner=2088101568338364",

"_input_charset=gbk",

"return_url= http://www.test.com/alipay/return_url.asp",

"out_trade_no=6741334835157966",

"subject=貝爾金護腕式",

"payment_type=1 ",

"seller_email=alipay-test01@alipay.com",

"total_fee=100"

};

對數組里的每一個值從a到z的順序排序，若遇到相同首字母，則看第二個字母，以此類推。

排序完成之后，再把所有數組值以“&”字符連接起來，如：

_input_charset=gbk&out_trade_no=6741334835157966&partner=2088101568338364&payment_type=1&return_url=http://www.test.com/alipay/return_url.asp&seller_email=alipay-test01@alipay.com&service=create_direct_pay_by_user&subject=貝爾金護腕式&total_fee=100

這串字符串便是待簽名字符串。

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 28 頁

注意：

􀁺 沒有

值的參數無需傳遞，也無需包含到待簽名數據中；

􀁺 簽名

時將字符轉化成字節流時指定的字符集與_input_charset保持一致；

􀁺 如果

傳遞了_input_charset參數，這個參數也應該包含在待簽名數據中；

􀁺 根據

HTTP協議要求，傳遞參數的值中如果存在特殊字符（如：&、@等），那么該值需要做URL Encoding，這樣請求接收方才能接收到正確的參數值。這種情況下，待簽名數據應該是原生值而不是encoding之后的值。例如：調用某接口需要對請求參數email進行數字簽名，那么待簽名數據應該是email=test@msn.com，而不是email=test%40msn.com。

8.2 簽名

8.2.1

MD5簽名

在MD5簽名時，需要私鑰參與簽名。MD5的私鑰是以英文字母和數字組成的32位字符串。商戶可登錄到商戶服務中心（https://b.alipay.com），安裝數字證書，在“技術服務”欄目中點擊“交易安全校驗碼”，即可查看。

􀁺

請求時簽名

當拿到請求時的待簽名字符串后，需要把私鑰直接拼接到待簽名字符串后面，形成新的字符串，利用MD5的簽名函數對這個新的字符串進行簽名運算，從而得到32位簽名結果字符串（該字符串賦值于參數sign）。

􀁺

通知返回時驗證簽名

當獲得到通知返回時的待簽名字符串后，同理，需要把私鑰直接拼接到待簽名字符串后面，形成新的字符串，利用MD5的簽名函數對這個新的字符串進行簽名運算，從而得到32位簽名結果字符串。此時這個新的字符串需要與支付寶通知返回參數中的參數sign的值進行驗證是否相等，來判斷簽名是否驗證通過。

8

.2.2 DSA、RSA簽名

在DSA或RSA的簽名時，需要私鑰和公鑰一起參與簽名。私鑰與公鑰皆是客戶通過OPENSSL來生成得出的。客戶把生成出的公鑰與支付寶技術人員配置好的支付寶公鑰做交換。因此，在簽名時，客戶要用到的是客戶的私鑰及支付寶的公鑰。

􀁺

請求時簽名

當拿到請求時的待簽名字符串后，把待簽名字符串與客戶的私鑰一同放入DSA或RSA的簽名函數中進行簽名運算，從而得到簽名結果字符串。

􀁺 通知返回

時驗證簽名

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 29 頁

當獲得到通知返回時的待簽名字符串后，把待簽名字符串、支付寶提供的公鑰、支付寶通知返回參數中的參數sign的值三者一同放入DSA或RSA的簽名函數中進行非對稱的簽名運算，來判斷簽名是否驗證通過。

9 如何驗

證是否支付寶請求

􀁺

目的

驗證此次通知信息是否是支付寶服務器發來的信息，以幫助校驗反饋回來的數據的真假性。

􀁺

工作原理

獲取支付寶返回數據之一的通知校驗ID（notify_id），按照支付寶要求的格式拼接成要請求的鏈接，如：

https://mapi.alipay.com/gateway.do?service=notify_verify&partner=2088002396712354&notify_id=RqPnCoPT3K9%252Fvwbh3I%252BFioE227%252BPfNMl8jwyZqMIiXQWxhOCmQ5MQO%252FWd93rvCB%252BaiGg

通過訪問這個請求鏈接，利用編程方法來模擬http請求與支付寶服務器進行交互，獲得支付寶服務器上處理的結果。

如果獲得的信息是true，則校驗成功；如果獲得的信息是其他，則校驗失敗。

10 建議

與意見

如果您在閱讀技術文檔時有任何建議和意見，請點擊下面的鏈接跟帖回復，我們將根據您的反饋完善文檔內容。

http://club.alipay.com/read.php?tid=8684674&fid=703

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 30 頁

1

1 附錄

1

1.1 純網關業務錯誤碼

表1

1-1 純網關業務錯誤碼

錯誤代碼（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

抱歉，商戶網關配置出錯，請聯系您的商戶。

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 31 頁

錯誤代碼（error_code） 含義

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

抱歉，接口傳遞的分潤類型錯誤，請檢查后重新集成。

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 32 頁

錯誤代碼（error_code） 含義

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

抱歉，付款失敗! 該筆交易可能存在風險，建議您付款前<a href=\"http://bbs.taobao.com/catalog/thread/154504-5782260.htm\" target=\"_blank\">先查看防騙案例</a>。

BODY_HAS_FORBIDDENWORD

抱歉，無法付款! 請聯系商戶修改商品描述，再重新購買。

NEED_CTU_CHECK_PARAMETER_ERROR

抱歉，您傳遞的商戶可信任參數權限參數錯誤。

NEED_CTU_CHECK_NOT_ALLOWED

抱歉，商戶沒有可信任參數校驗的權限。

BUYER_NOT_EXIST

抱歉，買家賬戶經驗證不存在。

HAS_NO_PRIVILEGE

你的當前訪問記錄丟失，請返回商戶網站重新發起付款。

ILLEGAL_SIGN

簽名不正確

ILLEGAL_DYN_MD5_KEY

動態密鑰信息錯誤

ILLEGAL_ENCRYPT

加密不正確

ILLEGAL_ARGUMENT

參數不正確

ILLEGAL_SERVICE

參數不正確

ILLEGAL_PARTNER

合作伙伴ID不正確

ILLEGAL_EXTERFACE

接口配置不正確

ILLEGAL_PARTNER_EXTERFACE

合作伙伴接口信息不正確

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 33 頁

錯誤代碼（error_code） 含義

ILLEGAL_SECURITY_PROFILE

未找到匹配的密鑰配置

ILLEGAL_AGENT

代理ID不正確

ILLEGAL_SIGN_TYPE

簽名類型不正確

ILLEGAL_CHARSET

字符集不合法

ILLEGAL_CLIENT_IP

客戶端IP地址無權訪問服務

ILLEGAL_DIGEST_TYPE

摘要類型不正確

ILLEGAL_DIGEST

文件摘要不正確

ILLEGAL_FILE_FORMAT

文件格式不正確

ILLEGAL_ENCODING

不支持該編碼類型

ILLEGAL_REQUEST_REFERER

防釣魚檢查不支持該請求來源

ILLEGAL_ANTI_PHISHING_KEY

防釣魚檢查非法時間戳參數

ANTI_PHISHING_KEY_TIMEOUT

防釣魚檢查時間戳超時

ILLEGAL_EXTER_INVOKE_IP

防釣魚檢查非法調用IP

ILLEGAL_NUMBER_FORMAT

數字格式不合法

ILLEGAL_INTEGER_FORMAT

Int類型格式不合法

ILLEGAL_MONEY_FORMAT

金額格式不合法

ILLEGAL_DATA_FORMAT

日期格式錯誤

REGEXP_MATCH_FAIL

正則表達式匹配失敗

ILLEGAL_LENGTH

參數值長度不合法

PARAMTER_IS_NULL

參數值為空

EVOUCHER_ID_NOT_EXIST

抱歉，商戶傳遞的消費券交易公共業務擴展參數中憑證號不存在，請聯系您的商家。

NAVIGATION_INCOME_OF_ROYALTY_ACCOUNT

分潤賬戶入不敷出

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 34 頁

1

1.2 系統錯誤碼

注意：

當出現系統錯誤提示時，請聯系支付寶技術支持協助處理。

表

11-2 系統錯誤碼

錯誤代碼（error_code）

含義

SYSTEM_ERROR

支付寶系統錯誤

SESSION_TIMEOUT

session超時

ILLEGAL_TARGET_SERVICE

錯誤的target_service

ILLEGAL_ACCESS_SWITCH_SYSTEM

partner不允許訪問該類型的系統

ILLEGAL_SWITCH_SYSTEM

切換系統異常

EXTERFACE_IS_CLOSED

接口已關閉

11.3

退款狀態

表11

-3 退款狀態

枚舉名稱

枚舉說明

REFUND_SUCCESS

退款成功：

􀁺 全額退款

情況：trade_status= TRADE_CLOSED，而refund_status=REFUND_SUCCESS

􀁺 非全額

退款情況：trade_status= TRADE_SUCCESS，而refund_status=REFUND_SUCCESS

REFUND_CLOSED

退款關閉

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 35 頁

11.4

交易狀態

表11-

4 交易狀態

枚舉名稱

枚舉說明

WAIT_BUYER_PAY

交易創建，等待買家付款。

TRADE_CLOSED

􀁺 在指定時

間段內未支付時關閉的交易；

􀁺 在交易

完成全額退款成功時關閉的交易。

TRADE_SUCCESS

交易成功，此時可退款。

TRADE_PENDING

等待賣家收款（買家付款后，如果賣家賬號被凍結）。

TRADE_FINISHED

􀁺

當交易超過退款期限后，該筆交易成功且結束，此時不可退款；

􀁺

交易成功且不可退款。

11.5

收款類型

表11-

5 收款類型

枚舉名稱

枚舉說明

1

商品購買

4

捐贈

47

電子卡券

1

1.6 銀行簡碼——混合渠道

表

11-6 銀行簡碼——混合渠道

銀行簡碼

銀行名稱

ICBCBTB

中國工商銀行（B2B）

ABCBTB

中國農業銀行（B2B）

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 36 頁

銀行簡碼 銀行名稱

CCBBTB

中國建設銀行（B2B）

SPDBB2B

上海浦東發展銀行（B2B）

BOCBTB

中國銀行（B2B）

CMBBTB

招商銀行（B2B）

BOCB2C

中國銀行

ICBCB2C

中國工商銀行

CMB

招商銀行

CCB

中國建設銀行

ABC

中國農業銀行

SPDB

上海浦東發展銀行

CIB

興業銀行

GDB

廣發銀行

CMBC

中國民生銀行

CITIC

中信銀行

HZCBB2C

杭州銀行

CEBBANK

中國光大銀行

SHBANK

上海銀行

NBBANK

寧波銀行

SPABANK

平安銀行

BJRCB

北京農村商業銀行

FDB

富滇銀行

POSTGC

中國郵政儲蓄銀行

abc1003

visa

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 37 頁

銀行簡碼 銀行名稱

abc1004

master

備注：

1. B2B代表企業銀行。

2. 其他銀行陸續增加中。

注意：

由于深圳發展銀行與平安銀行合并，原深圳發展銀行卡視為平安銀行卡，銀行簡碼統一為SPABANK，傳入SDB（深圳發展銀行）將無法支付。

1

1.7 銀行簡碼——純借記卡渠道

表

11-7 銀行簡碼——純借記卡渠道

銀行簡碼

銀行名稱

CMB-DEBIT

招商銀行

CCB-DEBIT

中國建設銀行

ICBC-DEBIT

中國工商銀行

COMM-DEBIT

交通銀行

GDB-DEBIT

廣發銀行

BOC-DEBIT

中國銀行

CEB-DEBIT

中國光大銀行

SPDB-DEBIT

上海浦東發展銀行

PSBC-DEBIT

中國郵政儲蓄銀行

BJBANK

北京銀行

SHRCB

上海農商銀行

WZCBB2C-DEBIT

溫州銀行

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 38 頁

銀行簡碼 銀行名稱

COMM

交通銀行

備注：其他銀行陸續增加中。

􀀉 說明：

交通銀行簡碼COMM、COMM-DEBIT都代表純借記卡渠道，二者沒有區別，建議使用COMM-DEBIT。

11.8

渠道類型說明與幣種列表

表11-

8 渠道類型說明與幣種列表

渠道類型

描述

卡種

BALANCE

余額

無

CREDIT_PAY

信用支付支付方式類型

無

CASH

現金支付方式類型

無

CONSUMER_CARD

消費卡支付方式類型

無

COUPON

紅包支付方式類型

無

VOUCHER

購物券支付方式類型

無

POINT

積分支付方式類型

無

WANG_HUI_E

網匯E支付方式類型

無

PREPAID_CARD

預存卡支付方式類型

無

INTERNATIONAL_CREDIT_CARD

國際卡類型

無

PREPAY

預付卡支付方式類型

無

RT_DISCOUNT

實時優惠支付方式類型

無

CARTOON

借記卡卡通支付方式類型

借記卡

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 39 頁

渠道類型 描述 卡種

SC_DEBIT_CARTOON

結算中心借記卡卡通支付方式類型

借記卡

B2C_EBANK

借記卡B2C網銀支付方式類型

借記卡

B2B_EBANK

B2B網銀支付方式類型

借記卡

WANGDIAN_DEBIT_CARD

網點借記卡刷卡支付方式類型

借記卡

DEBIT_EXPRESS

借記卡快捷支付方式類型

借記卡

CREDIT_CARTOON

普通信用卡卡通支付方式類型

信用卡

BIGAMOUNT_CREDIT_CARTOON

大額信用卡卡通支付方式類型

信用卡

VISA

VISA網銀支付方式類型

信用卡

CREDIT_CARD_EBANK

信用卡網關支付方式類型

信用卡

MOTO_CREDIT_CARD

moto信用卡支付方式類型

信用卡

OPTIMIZED_MOTO

信用卡快捷支付類型

信用卡

CREDIT_EXPRESS_INSTALLMENT

信用卡快捷分期支付類型

信用卡

WANGDIAN_CREDIT_CARD

網點信用卡刷卡支付方式類型

信用卡

INTERNATIONAL_CREDIT_CARD_VISA

VISA支付方式類型

信用卡

INTERNATIONAL_CREDIT_CARD_MASTER

MASTER支付方式類型

信用卡

INTERNATIONAL_CREDIT_CARD_JCB

JCB支付方式類型

信用卡

MIXED_B2C_EBANK

混合卡B2C網銀支付方式類型

混合卡

11.9

實際支付渠道列表

表11-

9 實際支付渠道列表

INST_ID

INST_NAME

ICBC

中國工商銀行

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 40 頁

INST_ID INST_NAME

ABC

中國農業銀行

CCB

中國建設銀行

SPDB

上海浦東發展銀行

BOC

中國銀行

CMB

招商銀行

CIB

興業銀行

GDB

廣發銀行

CMBC

中國民生銀行

CITIC

中信銀行

HZCB

杭州銀行

CEB

中國光大銀行

SHBANK

上海銀行

NBBANK

寧波銀行

SPABANK

平安銀行

BJRCB

北京農村商業銀行

FDB

富滇銀行

PSBC

中國郵政儲蓄銀行

COMM

交通銀行

BJBANK

北京銀行

SHRCB

上海農商銀行

WZCB

溫州市商業銀行

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 41 頁

11.10 i

tem_orders_info出錯時的通知錯誤碼

表11-

10 item_orders_info出錯時的通知錯誤碼

錯誤代碼（error_code）

含義

ERR_ITEM_ORDERS_INFO_IS_NULL

商戶回傳業務信息為空。

ERR_ITEM_ORDERS_INFO_IS_TOO_LONG

商戶回傳業務信息太長。

ERR_ITEM_ORDERS_INFO_SPLIT

商戶回傳業務信息校驗失敗,解析整個業務信息異常。

ERR_ITEM_ORDERS_INFO_SPLIT_IS_NULL

商戶回傳業務信息解析后為空。

ERR_ITEM_ORDERS_INFO_SPLIT_PARAM_NUM_IS_NOT_LIMIT

商戶回傳業務信息解析后參數個數與接口定義個數不符。

ERR_ITEM_ORDERS_INFO_SPLIT_PARAM_NAME

商戶回傳業務信息解析后參數名稱錯誤。

ERR_ITEM_ORDERS_INFO_SPLIT_PARAM_NAME_OR_SET_DATA

商戶回傳業務信息解析錯誤或賦值錯誤。

ERR_ITEM_ORDERS_INFO_CHECK_SYSTEM_ERROR

商戶回傳業務信息校驗異常。

ERROR_GOODS_OUT_IIDS_IS_NULL

商品站外ID不能為空。

ERROR_GOODS_OUT_IIDS_IS_NOT_LIMIT

商品列表總數不能超過30。

ERROR_GOODS_OUT_IIDS_PART_IS_NULL

商品站外ID部分為空。

ERROR_GOODS_OUT_IIDS_PART_IS_TOO_LONG

商品站外ID太長。

ERROR_GOODS_NUMS_IS_NULL

商品數量不能為空。

ERROR_GOODS_NUMS_IS_NOT_LIMIT

商品數量列表總數不能超過30。

ERROR_GOODS_NUMS_PART_IS_NULL

商品數量部分為空。

ERROR_GOODS_NUMS_PART_IS_POSITIVE_INTEGER

商品數量非正整數。

ERROR_GOODS_NUMS_PART_IS_TOO_LONG

商品數量太大或格式非法。

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 42 頁

錯誤代碼（error_code） 含義

ERROR_GOODS_PRICES_IS_NULL

商品價格不能為空。

ERROR_GOODS_PRICES_IS_NOT_LIMIT

商品價格列表總數不能超過30。

ERROR_GOODS_PRICES_PART_IS_NULL

商品價格部分為空。

ERROR_GOODS_PRICES_IS_NOT_NUMBERS

商品價格不正確。

ERROR_GOODS_PRICES_IS_TOO_LONG

商品價格太大或格式非法。

ERROR_GOODS_SKUS_IS_NULL

商品詳細信息不能為空。

ERROR_GOODS_SKUS_IS_NOT_LIMIT

商品詳細信息列表總數不能超過30。

ERROR_GOODS_SKUS_PART_IS_NULL

商品詳細信息部分為空。

ERROR_GOODS_SKUS_PART_IS_TOO_LONG

商品詳細信息太長。

ERROR_GOODS_TITLES_IS_NULL

商品標題不能為空。

ERROR_GOODS_TITLES_IS_NOT_LIMIT

商品標題列表總數不能超過30。

ERROR_GOODS_TITLES_PART_IS_NULL

商品標題部分為空。

ERROR_GOODS_TITLES_PART_IS_TOO_LONG

商品標題太長。

ERROR_GOODS_DETAIL_URLS_IS_NULL

商品頁面展示地址不能為空。

ERROR_GOODS_DETAIL_URLS_IS_NOT_LIMIT

商品頁面展示地址列表總數不能超過30。

ERROR_GOODS_DETAIL_URLS_PART_IS_NULL

商品頁面展示地址部分為空。

ERROR_GOODS_DETAIL_URLS_PATTERN_IS_WRONG

商品頁面展示地址格式不正確。

ERROR_GOODS_DETAIL_URLS_PATTERN_IS_TOO_LONG

商品頁面展示地址太長。

ERROR_GOODS_PIC_URLS_IS_NULL

商品圖片地址不能為空。

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 43 頁

錯誤代碼（error_code） 含義

ERROR_GOODS_PIC_URLS_IS_NOT_LIMIT

商品圖片地址列表總數超過30。

ERROR_GOODS_PIC_URLS_PART_IS_NULL

商品圖片地址部分為空。

ERROR_GOODS_PIC_URLS_PATTERN_IS_WRONG

商品圖片地址格式錯誤。

ERROR_GOODS_PIC_URLS_PATTERN_IS_TOO_LONG

商品圖片地址太長。

ERROR_GOODS_LIST_IS_NOT_LIMIT

商品明細數量不匹配。

ERROR_ORDER_LOGISTICS_TYPE_IS_NOT_LIMIT

運輸方式不正確。

ERROR_ORDER_POST_FEE_IS_NULL

物流費用不能為空。

ERROR_ORDER_POST_FEE_IS_NOT_NUMBERS

物流費用不正確。

ERROR_ORDER_POST_FEE_IS_TOO_LONG

物流費用太大或格式非法。

ERROR_ORDER_PROMOTION_DESC_IS_NOT_LIMIT

優惠信息太長。

ERROR_ORDER_RECEIVER_NAME_IS_NULL

收貨人姓名不能為空。

ERROR_ORDER_RECEIVER_NAME_IS_TOO_LONG

收貨人姓名太長。

ERROR_ORDER_RECEIVER_ADDRESS_PROV_IS_NULL

收貨地址省份不能為空。

ERROR_ORDER_RECEIVER_ADDRESS_PROV_IS_NOT_LIMIT

收貨地址省份長度不正確。

ERROR_ORDER_RECEIVER_ADDRESS_CITY_IS_NULL

收貨地址省會或地級市不能為空。

ERROR_ORDER_RECEIVER_ADDRESS_CITY_IS_NOT_LIMIT

收貨地址省會或地級市長度不正確。

ERROR_ORDER_RECEIVER_ADDRESS_AREA_IS_NULL

收貨地址區縣不能為空。

ERROR_ORDER_RECEIVER_ADDRESS_AREA_IS_NOT_LIMIT

收貨地址區縣長度不正確。

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 44 頁

錯誤代碼（error_code） 含義

ERROR_ORDER_RECEIVER_ADDRESS_IS_NULL

收貨地址不能為空。

ERROR_ORDER_RECEIVER_ADDRESS_IS_NOT_LIMIT

收貨地址長度不正確。

ERROR_ORDER_RECEIVER_ADDRESS_IS_ALL_NUMERIC

收貨地址不能全為數字。

ERROR_ORDER_RECEIVER_ADDRESS_IS_ALL_CHARACTAR

收貨地址不能全為字母。

ERROR_ORDER_RECEIVER_ADDRESS_IS_TOO_LONG

收貨地址（省市區街道）太長。

ERROR_ORDER_RECEIVER_MOBILE_AND_RECEIVER_PHONE_ALL_IS_NULL

收貨人手機號和聯系電話不能同時為空。

ERROR_ORDER_RECEIVER_MOBILE_IS_NOT_LIMIT

收貨人手機號格式錯誤。

ERROR_ORDER_RECEIVER_PHONE_IS_NOT_LIMIT

收貨人聯系電話格式錯誤。

SYSTEM_ERROR

商戶回傳業務信息校驗系統異常。

11.11 請

求出錯時的通知錯誤碼

表11-

11 請求出錯時的通知錯誤碼

錯誤代碼（error_code）

含義

SELLER_NOT_IN_SPECIFIED_SELLERS

傳入的收款賬戶不是指定的收款賬戶

TRADE_SELLER_NOT_MATCH

賣家賬戶與交易中不一致

ILLEGAL_FEE_PARAM

金額傳遞混亂

SUBJECT_MUST_NOT_BE_NULL

商品名不能為空

TRADE_PRICE_NOT_MATCH

單價與交易中不一致

TRADE_QUANTITY_NOT_MATCH

購買數量與交易中不一致

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 45 頁

錯誤代碼（error_code） 含義

TRADE_TOTALFEE_NOT_MATCH

交易金額與交易中不一致

ILLEGAL_EXTRA_COMMON_PARAM

非法的接口通用回傳參數

ILLEGAL_PAYMENT_TYPE

錯誤的Payment_type參數

NOT_SUPPORT_GATEWAY

錯誤的supportGateway參數

SELLER_NOT_EXIST

賣家不存在

ILLEGAL_ARGUMENT

參數不正確

BUYER_EMAIL_ID_MUST_NULL

買家email必須為空

PRODUCT_NOT_ALLOWED

產品不允許訪問

ROYALTY_RECEIVER_NOT_IN_SPECIFIED_ACCOUNTS

提成賬號不在預先設置的賬號中

ROYALTY_LENGTH_ERROR

提成信息說明長度不能超過1000個字符，請檢查后重新集成

ILLEGAL_EXTER_INVOKE_IP

防釣魚檢查非法調用IP

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

分潤方狀態不正常

純網關接口

支付寶（中國）網絡技術有限公司 版權所有| 版本：4.1 第 46 頁

錯誤代碼（error_code） 含義

ROYALTY_SELLER_NOT_CERTIFY

有提成情況下，賣家未通過認證

ROYALTY_FORAMT_ERROR

提成信息錯誤，請檢查后重新集成

ROYALTY_TYPE_ERROR

提成類型不支持，請檢查后重新集成

ROYALTY_RECEIVE_EMAIL_NOT_EXIST

提成收款帳戶不存在

ROYALTY_PAY_EMAIL_NOT_EXIST

提成付款帳戶不存在

SUBJECT_HAS_FORBIDDENWORD

商品名稱包含違禁詞

BODY_HAS_FORBIDDENWORD

商品描述包含違禁詞

MOTO_EXPRESS_TOTAL_AMOUNT_EXCEED

交易金額超過快捷支付前置限額

MOTO_EXPRESS_PARTNER_NOT_SIGN_PROTOCOL

商戶未開通快捷支付

EBANK_VISA_GW_RULE_NOT_OPEN

商戶未簽約外卡收單產品（或者簽約到期）或者本次交易金額小于1元

ROYALTY_RECEIVE_EMAIL_NOT_CERTIFY

提成收款帳戶不存在

NEED_CTU_CHECK_PARAMETER_ERROR

商戶可信任參數權限參數校驗失敗

NEED_CTU_CHECK_NOT_ALLOWED

商戶沒有可信任參數校驗的權限

UNKNOWN_PRODUCT_NAME

系統異常，無法獲取產品線信息，請稍后再試

TOKEN_LEN_TOO_LONG

TOKEN長度超過限制，最多40位