开放平台

- ## 文档专区

- 公共错误码

公共错误码

网关会对开发者的接口非业务调用错误做统一处理，返回码如下：

code（返回码） | msg（返回码描述） | sub_code（明细返回码） | sub_msg（明细返回码描述） | 解决方案
10000 | Success（接口调用成功） |  |  |
20000 | 服务不可用 | isp.unknown-error | 服务暂不可用（业务系统不可用） | 稍后重试
aop.unknow-error | 服务暂不可用（网关自身的未知错误） | 稍后重试
isp.service-not-available | 服务暂不可用 | 稍后重试
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-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 | 可疑的攻击请求 |
40004 | 业务处理失败 | 对应业务错误码，明细错误码和解决方案请参见具体的API接口文档
40006 | 权限不足 | isv.insufficient-isv-permissions | ISV权限不足 | 请检查配置的账户是否有当前接口权限
isv.insufficient-user-permissions | 用户权限不足 | 代理的商户没有当前接口权限
isv.route-no-permissions | 用户权限不足 | 没有当前接口权限
isv.access-forbidden | 用户权限不足 | 无权访问（接口被禁用）