支付宝网关会对开发者的接口非业务调用错误做统一处理，返回码如下：
<a name="aorIt"></a>
# API 公共错误码
**注意**：

- 下表为公共错误码。开发者在接入过程中遇到其他报错信息，可以参考所调用接口的 API 文档的 **业务错误码** 部分。
- 服务商权限不足问题请参考[ ISV 权限不足常见问题及解决办法](https://opendocs.alipay.com/open/common/isverror)。
| **code**<br />**（返回码）** | **msg**<br />**（返回码描述）** | **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 | 商家未签约任何产品 | 服务商代理调用的场景，请上线商家的服务窗 |
| 40001 | 缺少必选参数 | isv.missing-method | 缺少方法名参数 | 请求参数里面必须要有 method 参数 |
|  |  | isv.missing-signature | 缺少签名参数 | 检查请求参数，缺少 sign 参数 |
|  |  | isv.missing-signature-type | 缺少签名类型参数 | 检查请求参数，缺少 sign_type 参数 |
|  |  | isv.missing-signature-key | 缺少签名配置 | 未上传公钥配置 |
|  |  | isv.missing-app-id | 缺少appId参数 | 检查请求参数，缺少 appId 参数 |
|  |  | 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 | 无效签名 | <br />- 公私钥是否是一对<br />- 检查公钥上传是否与私钥匹配<br />- 存在中文需要做 urlencode<br />- 签名算法是否无误<br /> |
|  |  | 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/204/01dcc0#%E9%99%84%E5%BD%95%EF%BC%9A%E8%87%AA%E5%AE%9A%E4%B9%89%E5%8F%82%E6%95%B0%E8%AF%B4%E6%98%8E)，商家的请求参数中，所有的 key（支付宝关键 key 或者商家自己的 key），其对应的 value 中都不应该出现支付宝关键key，如 body、subject、service、out_trade_no、seller_id、total_fee 等，否则该类请求将可能被支付宝拦截，请更换相应参数名称。 |
|  |  | isv.forbidden-api | 接口被禁用 | 接口已被禁用，请查看接口说明 |
|  |  | app-cert-expired | 应用公钥证书已经不在有效期内 | 可查看 [证书到期更新指南](https://opendocs.alipay.com/common/02kdnh) 进行处理。 |
|  |  | not-online-app | 应用未上线 | 应用未上线，请在控制台上线应用后调用。 |
|  |  | app-openid-not-match | appid 和 openid 不匹配 | 应用 id 和 openid 不匹配，请确认 openid 是否归属该应用。 |
|  |  | openid-uid-not-match | openid 和 uid 不匹配 | 用户 uid 和 openid 不匹配，请确认 openid 和 uid 关联是否正确。 |
|  |  | invalid-openid | openid 参数值非法 | openid 非法，请确认 openid 是从支付宝获取。 |
|  |  | isv.illegal-json | 不正确的 JSON 格式 | JSON格式非法，请检查参数内容。 |
| 40003 | Insufficient Conditions（条件异常） | invalid-auth-relations | 无效的授权关系 | 用户授权校验失败，请确认用户是否已经授权给相关接口和 scope。 |
|  |  | isv.missing-signature-config | 验签出错，未配置对应签名算法的公钥或者证书。 | 可查看 [验签出错，应用未配置对应签名算法的公钥或者证书](https://opendocs.alipay.com/support/01ravq) 进行处理。 |
| 40004 | 业务处理失败 | 对应业务错误码，明细错误码和解决方案请参见具体的 API 说明。 |  |  |
|  | 非法的参数 | unsupported-sdk-version | 不支持的 SDK 版本。 | SDK 版本不支持，请升级到最新版本 SDK，参考 [SDK说明](https://opendocs.alipay.com/common/02mvn0?pathHash=473d19a0)。 |
| 40005  | Call Limited（调用频次超限） | isv.app-call-limited | 应用调用次数超限，包含调用频率超限 | 降低请求并发量 |
|  | Call Limited（调用频次超限） | isv.method-call-limited | API调用次数超限，包含调用频率超限 | 降低请求并发量 |
| 40006 | 权限不足 | isv.insufficient-isv-permissions | ISV 权限不足 | 请检查配置的账户是否有当前接口权限。<br />请在 [开放平台控制台](https://openhome.alipay.com/platform/developerIndex.htm) 找到对应的应用，在其 **产品列表** 中添加缺少的功能包、签约或申请必须的信息。详情可查看 [产品绑定](https://opendocs.alipay.com/open/200/105310/#%E4%BA%A7%E5%93%81%E7%BB%91%E5%AE%9A)。 |
|  |  | isv.insufficient-user-permissions | 用户权限不足 | 代理的商家没有当前接口权限，服务商可以选择让商家的应用自主添加功能后签约；或选择 [协助商家](https://opendocs.alipay.com/mini/isv/zdfy7u)开通产品。 |
|  | Insufficient Permissions | isv.self-invoke-forbidden | 此用户不允许自调用 | 可点击查看 [解决方案](https://opendocs.alipay.com/support/01rax7)。 |

<a name="BmrMg"></a>
# SPI 错误码
在调用 SPI 时，外部商户响应报文中的统一错误码只有两种：10000 和 40004，具体信息如下图所示：

| **code（返回码）** | **msg（返回码描述）** | **sub_code（明细返回码）** | **sub_msg（明细返回码描述）** | **解决方案** |
| --- | --- | --- | --- | --- |
| 10000 | Success（接口调用成功，调用结果请参考具体的 SPI 文档所对应的业务返回参数） | - | - | - |
| 40004 | Business Failed（业务处理失败） | 对应业务错误码，明细错误码和解决方案请参见具体的 SPI 文档。 | - | - |