公共错误码

支付宝网关会对开发者的接口非业务调用错误做统一处理,返回码如下:


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://docs.open.alipay.com/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 文档。





onlineServer