支付宝网关api 调用状态返回的公共参数－明生-k8凯发旗舰

code（返回码）

msg（返回码描述）

sub_code（明细返回码）

sub_msg（明细返回码描述）

k8凯发旗舰的解决方案

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

应用公钥证书已经不在有效期内

可查看 证书到期更新指南 进行处理。

40003

insufficient conditions（条件异常）

invalid-auth-relations

无效的授权关系

用户授权校验失败，请确认用户是否已经授权给相关接口和 scope。

isv.missing-signature-config

验签出错，未配置对应签名算法的公钥或者证书。

可查看 验签出错，应用未配置对应签名算法的公钥或者证书 进行处理。

40004

业务处理失败

对应业务错误码，明细错误码和k8凯发旗舰的解决方案请参见具体的 api 说明。

40005

call limited（调用频次超限）

isv.app-call-limited

应用调用次数超限，包含调用频率超限

降低请求并发量

call limited（调用频次超限）

isv.method-call-limited

api调用次数超限，包含调用频率超限

降低请求并发量

40006

权限不足

isv.insufficient-isv-permissions

isv 权限不足

请检查配置的账户是否有当前接口权限。

请在 开放平台控制台 找到对应的应用，在其 产品列表 中添加缺少的功能包、签约或申请必须的信息。详情可查看 产品绑定。

isv.insufficient-user-permissions

用户权限不足

代理的商家没有当前接口权限，服务商可以选择让商家的应用自主添加功能后签约；或选择 协助商家开通产品。

code（返回码）

msg（返回码描述）

sub_code（明细返回码）

sub_msg（明细返回码描述）

k8凯发旗舰的解决方案

10000

success（接口调用成功，调用结果请参考具体的 spi 文档所对应的业务返回参数）

-

-

-

40004

business failed（业务处理失败）

对应业务错误码，明细错误码和k8凯发旗舰的解决方案请参见具体的 spi 文档。

-

-