統一收單交易建立接口 - 支付寶開放平台 https://opendocs.alipay.com/apis/api_1/alipay.trade.create
公共響應參數
| 參數 | 類型 | 是否必填 | 最大長度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | String | 是 | - | 網關傳回碼,詳見文檔 | 40004 |
| msg | String | 是 | - | 網關傳回碼描述,詳見文檔 | Business Failed |
| sub_code | String | 否 | - | 業務傳回碼，參見具體的API接口文檔 | ACQ.TRADE_HAS_SUCCESS |
| sub_msg | String | 否 | - | 業務傳回碼描述，參見具體的API接口文檔 | 交易已被支付 |
| sign | String | 是 | - | 簽名,詳見文檔 | DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo= |
公共錯誤碼 - 支付寶開放平台 https://opendocs.alipay.com/open/common/105806
公共錯誤碼
公共錯誤碼
更新時間：2020-02-06 22:17:51
支付寶網關會對開發者的接口非業務調用錯誤做統一處理，傳回碼如下：
API 公共錯誤碼
| code（傳回碼） | msg（傳回碼描述） | sub_code（明細傳回碼） | sub_msg（明細傳回碼描述） | 解決方案 |
| 10000 | 接口調用成功，調用結果請參考具體的 API 文檔所對應的業務傳回參數。 | |||
| 20000 | 服務不可用 | isp.unknow-error | 服務暫不可用（業務系統不可用） | 稍後重試 |
| aop.unknow-error | 服務暫不可用（網關自身的未知錯誤） | 稍後重試 | ||
| 20001 | 授權權限不足 | aop.invalid-auth-token | 無效的通路令牌 | 請重新整理授權令牌或重新授權擷取新的令牌 |
| aop.auth-token-time-out | 通路令牌已過期 | 請重新整理授權令牌或重新授權擷取新的令牌 | ||
| aop.invalid-app-auth-token | 無效的應用授權令牌 | 請重新整理應用授權令牌或重新授權擷取新的令牌 | ||
| aop.invalid-app-auth-token-no-api | 商戶未授權目前接口 | 請重新授權擷取新的應用授權令牌 | ||
| aop.app-auth-token-time-out | 應用授權令牌已過期 | 請重新整理應用授權令牌或重新授權擷取新的令牌 | ||
| aop.no-product-reg-by-partner | 商戶未簽約任何産品 | ISV代理調用的場景，請上線商戶的服務窗 | ||
| 40001 | 缺少必選參數 | isv.missing-method | 缺少方法名參數 | 請求參數裡面必須要有method參數 |
| isv.missing-signature | 缺少簽名參數 | 檢查請求參數，缺少sign參數 | ||
| isv.missing-signature-type | 缺少簽名類型參數 | 檢查請求參數，缺少sign_type參數 | ||
| isv.missing-signature-key | 缺少簽名配置 | 未上傳公鑰配置 | ||
| isv.missing-app-id | 缺少appId參數 | 檢查請求參數，缺少app_id參數 | ||
| isv.missing-timestamp | 缺少時間戳參數 | 檢查請求參數，缺少timestamp參數 | ||
| isv.missing-version | 缺少版本參數 | 檢查請求參數，缺少version參數 | ||
| isv.decryption-error-missing-encrypt-type | 解密出錯, 未指定加密算法 | 檢查參數，缺少encrypt_type參數 | ||
| 40002 | 非法的參數 | isv.invalid-parameter | 參數無效 | 檢查參數，格式不對、非法值、越界等 |
| isv.upload-fail | 檔案上傳失敗 | 檔案寫入失敗，重試 | ||
| isv.invalid-file-extension | 檔案擴充名無效 | 檢查傳入的檔案擴充名稱，目前支援格式：csv,txt,zip,rar,gz,doc,docx,xls,xlsx,pdf,bmp,gif,jpg,jpeg,png | ||
| isv.invalid-file-size | 檔案大小無效 | 檢查檔案大小，目前支援最大為：50MB | ||
| isv.invalid-method | 不存在的方法名 | 檢查入參method是否正确 | ||
| isv.invalid-format | 無效的資料格式 | 檢查入參format，目前隻支援json和xml 2種格式 | ||
| isv.invalid-signature-type | 無效的簽名類型 | 檢查入參sign_type,目前隻支援RSA,RSA2,HMAC_SHA1 | ||
| isv.invalid-signature | 無效簽名 | 1.公私鑰是否是一對 2.檢查公鑰上傳是否與私鑰比對 3.存在中文需要做urlencode 4.簽名算法是否無誤 | ||
| isv.invalid-token | 無效令牌 | auth_token 為無效的令牌，請确認令牌有效 | ||
| isv.invalid-encrypt-type | 無效的加密類型 | 檢查入參encrypt_type，目前隻支援AES | ||
| isv.invalid-encrypt | 解密異常 | 重試 | ||
| isv.invalid-app-id | 無效的appId參數 | 檢查入參app_id，app_id不存在，或者未上線 | ||
| isv.invalid-timestamp | 非法的時間戳參數 | 時間戳參數timestamp非法，請檢查格式需要為"yyyy-MM-dd HH:mm:ss" | ||
| isv.invalid-charset | 字元集錯誤 | 請求參數charset錯誤，目前支援格式：GBK,UTF-8 | ||
| isv.invalid-digest | 摘要錯誤 | 檢查請求參數，檔案摘要參數必填 | ||
| isv.decryption-error-not-valid-encrypt-type | 解密出錯，不支援的加密算法 | 檢查入參encrypt_type，目前隻支援AES | ||
| isv.decryption-error-not-valid-encrypt-key | 解密出錯, 未配置加密密鑰或加密密鑰格式錯誤 | 沒有配置加密密鑰 | ||
| isv.decryption-error-unknown | 解密出錯，未知異常 | 重試 | ||
| isv.missing-signature-config | 驗簽出錯, 未配置對應簽名算法的公鑰或者證書 | 沒有配置應用公鑰 | ||
| isv.not-support-app-auth | 本接口不支援第三方代理調用 | 本接口不支援第三方代理調用 | ||
| isv.suspected-attack | 可疑的攻擊請求 | 參考 https://opendocs.alipay.com/open/59/103663 特殊說明第3點，商戶的請求參數中，所有的 key（支付寶關鍵 key 或者商戶自己的 key），其對應的 value 中都不應該出現支付寶關鍵key，如 body、subject、service、out_trade_no、seller_id、total_fee 等，否則該類請求将可能被支付寶攔截，請更換相應參數名稱。 | ||
| 40004 | 業務處理失敗 | 對應業務錯誤碼，明細錯誤碼和解決方案請參見具體的 API 接口文檔。 | ||
| 40006 | 權限不足 | isv.insufficient-isv-permissions | ISV 權限不足 | 請檢查配置的賬戶是否有目前接口權限。 請在 開發者中心 ->我的應用找到對應的應用，在其 功能清單 中添加缺少的功能包、簽約或申請必須的資訊。詳見 添加功能。 |
| isv.insufficient-user-permissions | 使用者權限不足 | 代理的商戶沒有目前接口權限，ISV 可以選擇讓商戶的應用自主添加功能後簽約；或選擇 代商戶簽約。 |
注意：
上表中為公共錯誤碼。開發者在接入過程中遇到其他報錯資訊，可以參考所調用接口的 API 文檔的“業務錯誤碼”部分。
ISV 權限不足問題請參考 ISV 權限不足常見問題及解決辦法。
SPI 錯誤碼
在調用 SPI 時，外部商戶響應封包中的統一錯誤碼隻有兩種：10000 和 40004，具體資訊如下圖所示：
| code（傳回碼） | msg（傳回碼描述） | sub_code（明細傳回碼） | sub_msg（明細傳回碼描述） | 解決方案 |
| 10000 | Success（接口調用成功，調用結果請參考具體的SPI文檔所對應的業務傳回參數） | |||
| 40004 | Business Failed（業務處理失敗） | 對應業務錯誤碼，明細錯誤碼和解決方案請參見具體的 SPI 文檔。 |
公共錯誤碼
公共錯誤碼
更新時間：2020-02-06 22:17:51
支付寶網關會對開發者的接口非業務調用錯誤做統一處理，傳回碼如下：
API 公共錯誤碼
| code（傳回碼） | msg（傳回碼描述） | sub_code（明細傳回碼） | sub_msg（明細傳回碼描述） | 解決方案 |
| 10000 | 接口調用成功，調用結果請參考具體的 API 文檔所對應的業務傳回參數。 | |||
| 20000 | 服務不可用 | isp.unknow-error | 服務暫不可用（業務系統不可用） | 稍後重試 |
| aop.unknow-error | 服務暫不可用（網關自身的未知錯誤） | 稍後重試 | ||
| 20001 | 授權權限不足 | aop.invalid-auth-token | 無效的通路令牌 | 請重新整理授權令牌或重新授權擷取新的令牌 |
| aop.auth-token-time-out | 通路令牌已過期 | 請重新整理授權令牌或重新授權擷取新的令牌 | ||
| aop.invalid-app-auth-token | 無效的應用授權令牌 | 請重新整理應用授權令牌或重新授權擷取新的令牌 | ||
| aop.invalid-app-auth-token-no-api | 商戶未授權目前接口 | 請重新授權擷取新的應用授權令牌 | ||
| aop.app-auth-token-time-out | 應用授權令牌已過期 | 請重新整理應用授權令牌或重新授權擷取新的令牌 | ||
| aop.no-product-reg-by-partner | 商戶未簽約任何産品 | ISV代理調用的場景，請上線商戶的服務窗 | ||
| 40001 | 缺少必選參數 | isv.missing-method | 缺少方法名參數 | 請求參數裡面必須要有method參數 |
| isv.missing-signature | 缺少簽名參數 | 檢查請求參數，缺少sign參數 | ||
| isv.missing-signature-type | 缺少簽名類型參數 | 檢查請求參數，缺少sign_type參數 | ||
| isv.missing-signature-key | 缺少簽名配置 | 未上傳公鑰配置 | ||
| isv.missing-app-id | 缺少appId參數 | 檢查請求參數，缺少app_id參數 | ||
| isv.missing-timestamp | 缺少時間戳參數 | 檢查請求參數，缺少timestamp參數 | ||
| isv.missing-version | 缺少版本參數 | 檢查請求參數，缺少version參數 | ||
| isv.decryption-error-missing-encrypt-type | 解密出錯, 未指定加密算法 | 檢查參數，缺少encrypt_type參數 | ||
| 40002 | 非法的參數 | isv.invalid-parameter | 參數無效 | 檢查參數，格式不對、非法值、越界等 |
| isv.upload-fail | 檔案上傳失敗 | 檔案寫入失敗，重試 | ||
| isv.invalid-file-extension | 檔案擴充名無效 | 檢查傳入的檔案擴充名稱，目前支援格式：csv,txt,zip,rar,gz,doc,docx,xls,xlsx,pdf,bmp,gif,jpg,jpeg,png | ||
| isv.invalid-file-size | 檔案大小無效 | 檢查檔案大小，目前支援最大為：50MB | ||
| isv.invalid-method | 不存在的方法名 | 檢查入參method是否正确 | ||
| isv.invalid-format | 無效的資料格式 | 檢查入參format，目前隻支援json和xml 2種格式 | ||
| isv.invalid-signature-type | 無效的簽名類型 | 檢查入參sign_type,目前隻支援RSA,RSA2,HMAC_SHA1 | ||
| isv.invalid-signature | 無效簽名 | 1.公私鑰是否是一對 2.檢查公鑰上傳是否與私鑰比對 3.存在中文需要做urlencode 4.簽名算法是否無誤 | ||
| isv.invalid-token | 無效令牌 | auth_token 為無效的令牌，請确認令牌有效 | ||
| isv.invalid-encrypt-type | 無效的加密類型 | 檢查入參encrypt_type，目前隻支援AES | ||
| isv.invalid-encrypt | 解密異常 | 重試 | ||
| isv.invalid-app-id | 無效的appId參數 | 檢查入參app_id，app_id不存在，或者未上線 | ||
| isv.invalid-timestamp | 非法的時間戳參數 | 時間戳參數timestamp非法，請檢查格式需要為"yyyy-MM-dd HH:mm:ss" | ||
| isv.invalid-charset | 字元集錯誤 | 請求參數charset錯誤，目前支援格式：GBK,UTF-8 | ||
| isv.invalid-digest | 摘要錯誤 | 檢查請求參數，檔案摘要參數必填 | ||
| isv.decryption-error-not-valid-encrypt-type | 解密出錯，不支援的加密算法 | 檢查入參encrypt_type，目前隻支援AES | ||
| isv.decryption-error-not-valid-encrypt-key | 解密出錯, 未配置加密密鑰或加密密鑰格式錯誤 | 沒有配置加密密鑰 | ||
| isv.decryption-error-unknown | 解密出錯，未知異常 | 重試 | ||
| isv.missing-signature-config | 驗簽出錯, 未配置對應簽名算法的公鑰或者證書 | 沒有配置應用公鑰 | ||
| isv.not-support-app-auth | 本接口不支援第三方代理調用 | 本接口不支援第三方代理調用 | ||
| isv.suspected-attack | 可疑的攻擊請求 | 參考 https://opendocs.alipay.com/open/59/103663 特殊說明第3點，商戶的請求參數中，所有的 key（支付寶關鍵 key 或者商戶自己的 key），其對應的 value 中都不應該出現支付寶關鍵key，如 body、subject、service、out_trade_no、seller_id、total_fee 等，否則該類請求将可能被支付寶攔截，請更換相應參數名稱。 | ||
| 40004 | 業務處理失敗 | 對應業務錯誤碼，明細錯誤碼和解決方案請參見具體的 API 接口文檔。 | ||
| 40006 | 權限不足 | isv.insufficient-isv-permissions | ISV 權限不足 | 請檢查配置的賬戶是否有目前接口權限。 請在 開發者中心 ->我的應用找到對應的應用，在其 功能清單 中添加缺少的功能包、簽約或申請必須的資訊。詳見 添加功能。 |
| isv.insufficient-user-permissions | 使用者權限不足 | 代理的商戶沒有目前接口權限，ISV 可以選擇讓商戶的應用自主添加功能後簽約；或選擇 代商戶簽約。 |
注意：
上表中為公共錯誤碼。開發者在接入過程中遇到其他報錯資訊，可以參考所調用接口的 API 文檔的“業務錯誤碼”部分。
ISV 權限不足問題請參考 ISV 權限不足常見問題及解決辦法。
SPI 錯誤碼
在調用 SPI 時，外部商戶響應封包中的統一錯誤碼隻有兩種：10000 和 40004，具體資訊如下圖所示：
| code（傳回碼） | msg（傳回碼描述） | sub_code（明細傳回碼） | sub_msg（明細傳回碼描述） | 解決方案 |
| 10000 | Success（接口調用成功，調用結果請參考具體的SPI文檔所對應的業務傳回參數） | |||
| 40004 | Business Failed（業務處理失敗） | 對應業務錯誤碼，明細錯誤碼和解決方案請參見具體的 SPI 文檔。 |
