开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
开发文档(v3版) 
规则说明
密钥与签名
应用开发配置
常见问题
接口规则 >  > 错误码
收藏
订阅更新
我的文档
设置
api 公共错误码
注意
下表为公共错误码。开发者在接入过程中遇到其他报错信息,可以参考所调用接口的 api 文档的 业务错误码 部分。
服务商权限不足问题请参考
http 状态码
状态说明
code(错误码)
msg(错误描述)
凯发app官方网站的解决方案
200
接口调用成功,调用结果请参考具体的 api 所对应的业务返回参数。
-
-
-
400
服务不可用
unknow-error
业务异常,服务暂不可用
稍后重试
500
服务不可用
unknow-error
系统异常,服务暂不可用
稍后重试
401
授权权限不足
invalid-auth-token
无效的访问令牌
请刷新授权令牌或重新授权获取新的令牌
auth-token-time-out
访问令牌已过期
请刷新授权令牌或重新授权获取新的令牌
invalid-app-auth-token
无效的应用授权令牌
请刷新应用授权令牌或重新授权获取新的令牌
invalid-app-auth-token-no-api
商户未授权当前接口
请重新授权获取新的应用授权令牌
app-auth-token-time-out
应用授权令牌已过期
请刷新应用授权令牌或重新授权获取新的令牌
no-product-reg-by-partner
商家未签约任何产品
服务商代理调用的场景,请上线商家的服务窗
401
权限不足
insufficient-isv-permissions
isv 权限不足
请检查配置的账户是否有当前接口权限。
请在 找到对应的应用,在其 产品列表 中添加缺少的功能包、签约或申请必须的信息。详情可查看
insufficient-user-permissions
用户权限不足
代理的商家没有当前接口权限,服务商可以选择让商家的应用自主添加功能后签约;或选择 协助商家 开通产品。
self-invoke-forbidden
此用户不允许自调用
应用类型为第三方应用时,不允许直接调用该接口,必须通过授权方式代理其他应用调用。需要更换应用类型或者使用代调用方式。
400
缺少必选参数
missing-method
缺少方法名参数
请求参数里面必须要有 method 参数
missing-signature
缺少签名参数
检查请求参数,缺少 sign 参数
missing-signature-type
缺少签名类型参数
检查请求参数,缺少 sign_type 参数
missing-signature-key
缺少签名配置
未上传公钥配置
missing-app-id
缺少appid参数
检查请求参数,缺少 appid 参数
missing-timestamp
缺少时间戳参数
检查请求参数,缺少 timestamp 参数
missing-version
缺少版本参数
检查请求参数,缺少 version 参数
decryption-error-missing-encrypt-type
解密出错,未指定加密算法
检查参数,缺少 encrypt_type 参数
400
非法的参数
invalid-parameter
参数无效
检查参数,格式不对、非法值、越界等
upload-fail
文件上传失败
文件写入失败,重试
invalid-file-extension
文件扩展名无效
检查传入的文件扩展名称,目前支持格式:csv、txt、zip、rar、gz、doc、docx、xls、xlsx、pdf、bmp、gif、jpg、jpeg、png
invalid-file-size
文件大小无效
检查文件大小,目前支持最大为:50mb
invalid-method
不存在的方法名
检查入参 method 是否正确
invalid-format
无效的数据格式
检查入参 format,目前只支持 json 和 xml 2种格式
invalid-signature-type
无效的签名类型
检查入参 sign_type,目前只支持 rsa、rsa2、hmac_sha1。
invalid-signature
无效签名
公私钥是否是一对
检查公钥上传是否与私钥匹配
存在中文需要做 urlencode
签名算法是否无误
invalid-token
无效令牌
auth_token 为无效的令牌,请确认令牌有效。
invalid-encrypt-type
无效的加密类型
检查入参 encrypt_type,目前只支持 aes。
invalid-encrypt
解密异常
重试
invalid-app-id
无效的appid参数
检查入参 app_id,app_id 不存在,或者未上线。
invalid-timestamp
非法的时间戳参数
时间戳参数 timestamp 非法,请检查格式需要为"yyyy-mm-dd hh:mm:ss"
invalid-charset
字符集错误
请求参数 charset 错误,目前支持格式:gbk、utf-8。
invalid-digest
摘要错误
检查请求参数,文件摘要参数必填
decryption-error-not-valid-encrypt-type
解密出错,不支持的加密算法
检查入参 encrypt_type,目前只支持 aes。
decryption-error-not-valid-encrypt-key
解密出错,未配置加密密钥或加密密钥格式错误
没有配置加密密钥
decryption-error-unknown
解密出错,未知异常
重试
missing-signature-config
验签出错, 未配置对应签名算法的公钥或者证书
没有配置应用公钥
not-support-app-auth
本接口不支持第三方代理调用
本接口不支持第三方代理调用
suspected-attack
可疑的攻击请求
可查看 ,商家的请求参数中,所有的 key(支付宝关键 key 或者商家自己的 key),其对应的 value 中都不应该出现支付宝关键key,如 body、subject、service、out_trade_no、seller_id、total_fee 等,否则该类请求将可能被支付宝拦截,请更换相应参数名称。
forbidden-api
接口被禁用
接口已被禁用,请查看接口说明
app-cert-expired
应用公钥证书已经不在有效期内
可查看 进行处理。
invalid-content-type
contenttype 错误
http 请求的 contenttype 非法,请检查 http contenttype,可参考
not-online-app
应用未上线
应用未上线,请在控制台上线应用后调用。
unsupported-sdk-version
不支持的 sdk 版本
sdk 版本不支持,请升级到最新版本 sdk,参考 sdk说明
app-openid-not-match
appid 和 openid 不匹配
应用 id 和 openid 不匹配,请确认 openid 是否归属该应用。
openid-uid-not-match
openid 和 uid 不匹配
用户 uid 和 openid 不匹配,请确认 openid 和 uid 关联是否正确。
invalid-openid
openid 参数值非法
openid 非法,请确认 openid 是从支付宝获取。
illegal-json
不正确的 json 格式
json 格式非法,请检查参数内容。
invalid-http-method
http 方法错误
请检查 http 请求方法,应和接口文档中要求的 http 方法一致,一般为 post 或 get。
400
条件异常
invalid-auth-relations
无效的授权关系
用户授权校验失败,请确认用户是否已经授权给相关接口和 scope。
missing-signature-config
验签出错,未配置对应签名算法的公钥或者证书。
400
业务处理失败
对应业务错误码,明细错误码和凯发app官方网站的解决方案请参见具体的 api 说明。
-
-
429
call limited(调用频次超限)
app-call-limited
应用调用次数超限,包含调用频率超限
降低请求并发量
method-call-limited
api 调用次数超限,包含调用频率超限
降低请求并发量
http 状态码
常见的 http 状态码见下表。
http 状态码
错误类型
一般的凯发app官方网站的解决方案
200 - ok
处理成功
-
202 - accepted
服务器已接受请求,但尚未处理
请使用原参数重复请求一遍。
204 - no content
处理成功,无返回body
-
400 - bad request
协议或者参数非法
请根据接口返回的错误码及描述处理。
401 - unauthorized
调用未授权
请检查签名参数和方法是否都符合签名算法要求。
403 - forbidden
无权限调用
请检查产品权限开通情况,可联系产品或商务申请。
404 - not found
请求的资源不存在
请检查需要查询的 id 或者请求 url 是否正确。
429 - too many requests
请求超过频率限制
请求未受理,请降低频率后重试。
500 - server error
系统错误
按具体接口的错误指引进行重试。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图