网关会对开发者的接口非业务调用错误做统一处理
统一收单交易创建接口 - 支付宝开放平台 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.公私钥是否是一对 |
||
|
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.公私钥是否是一对 |
||
|
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 文档。 |
|
|
