开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
开放平台 
技术接入指南 > 应用开发 > 公共错误码
收藏
订阅更新
我的文档
设置
支付宝网关会对开发者的接口非业务调用错误做统一处理,返回码如下:
api 公共错误码
注意
下表为公共错误码。开发者在接入过程中遇到其他报错信息,可以参考所调用接口的 api 文档的 业务错误码 部分。
服务商权限不足问题请参考
code
(返回码)
msg
(返回码描述)
sub_code(明细返回码)
sub_msg(明细返回码描述)
凯发app官方网站的解决方案
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
无效签名
公私钥是否是一对
检查公钥上传是否与私钥匹配
存在中文需要做 urlencode
签名算法是否无误
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
可疑的攻击请求
可查看 ,商家的请求参数中,所有的 key(支付宝关键 key 或者商家自己的 key),其对应的 value 中都不应该出现支付宝关键key,如 body、subject、service、out_trade_no、seller_id、total_fee 等,否则该类请求将可能被支付宝拦截,请更换相应参数名称。
isv.forbidden-api
接口被禁用
接口已被禁用,请查看接口说明
app-cert-expired
应用公钥证书已经不在有效期内
可查看 证书到期更新指南 进行处理。
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 格式