错误码和返回码
收藏
OpenAPI 父错误码 error_code
error_code | description | 常见原因和解决办法 |
|---|---|---|
0 | success | 成功 |
2100004 | 系统繁忙，此时请开发者稍候再试 | 检查参数类型是否与文档要求一致。如果参数类型不一致，一般会报此错误 |
2100005 | 参数不合法 | 检查是否必填等 |
2100007 | 无权限操作 | |
2190002 | access_token无效 | 检查access_token |
2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 检查scope权限 |
2190008 | access_token过期,请刷新或重新授权 | |
2191000 | 内部错误 | |
2191001 | 风控类错误 | |
2191002 | 通用交易类错误 | |
2191003 | 正向交易类错误 | |
2191004 | 核销类错误 | |
2191005 | 逆向交易类错误 | |
2191006 | 资金类错误 | |
2191007 | 外部扩展相关错误 | |
2191008 | 营销优惠相关错误 | |
2191009 | 分账类错误 |
OpenAPI 子错误码 sub_error_code
sub_error_code | 含义 | 常见原因和解决办法 |
|---|---|---|
10000 | 参数错误 | 传入了非法参数，一般返回的错误说明中会有明确指示哪里出错了 |
13000 | 内部服务错误 | 一般是平台内部系统出错了，大部分是超时，这个超时可能是由调用开发者的系统间接导致的，如果重试无法解决请提供logid走oncall流程 |
10002 | 参数解析错误 | 开发者参数的格式错误，请对照api文档自查格式是否正确 |
11001 | 访问未授权 | 访问的数据不属于当前用户或者小程序，属于非法访问 |
11002 | AccessToken非法 | 一般是AccessToken过期了，请刷新AccessToken |
11003 | Session非法 | 一般是用户session过期了，请尝试重新登录一下 |
11004 | 签名校验失败 | |
11005 | 用户未登录 | |
11006 | 商服关系未授权 | 检查服务商和商家的商服关系是否建立与授权 |
12001 | 访问过于频繁 | 风控类错误，用户访问过于频繁，系统会进行拦截，请等一会重试 |
12002 | 用户账号异常 | 系统风控判断用户账号存在风险行为，请等一会重试，如果无法解决请提供logid走oncall流程 |
20000 | 订单不存在 | 系统未查询到对应的订单信息，请检查订单的id是否真实存在 |
20001 | 订单状态不正确 | 一般是当前订单所处的状态无法执行当前的操作，如对未支付的订单执行核销操作就会报这种错误 |
20002 | 商品不存在 | 交易中使用的商品不存在于商品库中 |
20003 | POI不存在 | 交易中传入的poiid不存在 |
20004 | 订单没有cps相关信息 | |
20005 | 查询订单信息失败 | |
21000 | 商品单与商户单不匹配 | 请求参数非法，存在非此商户单的 商品单，请检查请求参数 |
21001 | 商品单状态不支持核销 | 该商品单不是待使用状态，或已经退款，请检查请求参数 |
21003 | 该应用不在灰度白名单 | 一般是该应用没有申请对应功能的白名单 |
21004 | 营销算价结果信息不一致 | 请求参数中各个纬度的营销算价结果不一致，请检查请求参数 |
21006 | 未找到回调设置 | 一般是没有设置对应的回调地址 |
21007 | 无法查到商品关键信息 | 下单的商品在商品库里查不到，请检查请求参数 |
21012 | 创建订单失败，请稍后重试 | 内部系统错误，请重试一下 |
21013 | 开发者拒绝交易 | 一般是开发者拒绝了下单请求 |
21015 | 开发者返回的参数非法 | 开发者预下单回调返回的参数非法，请检查请求参数 |
21016 | 外部单号已存在 | 开发者传入的外部单号重复，请检查请求参数 |
21017 | 外部单号格式不正确 | 开发者传入的外部单号格式非法，请检查请求参数 |
21018 | 非法的核销poi_id | 开发者核销的时候传入的poi_id非法，请检查请求参数 |
21019 | 商品价格有变动 | 商品价格有变更，需要重新下单 |
21020 | 商品不支持一次购买多份 | 当前商品限购1份 |
21021 | 用户购买超出限制 | 一般是商品有限购，用户累计购买的数量过多 |
21022 | 单次购买超出上限 | 一般是商品有限购，用户单次购买的数量过多 |
21023 | 商品已过期 | 商品信息已过期，请检查商品信息 |
21024 | 商品已下线 | 商品下线，请检查商品信息 |
21025 | 商品已售罄 | 商品已售罄，请检查商品信息 |
21026 | 下单次数超限制 | 下单商品的总次数超出限制 |
21032 | 开发者商品id重复 | 请求里有重复的商品id，请检查请求参数 |
21042 | 商品状态无效 | 商品状态错误，请检查商品信息 |
21043 | 商品库存不足 | 商品库存错误，请检查商品信息 |
21045 | 订单已超时，无法继续支付 | 订单已经过了支付有效期，无法继续支付 |
21046 | 订单收款商户号不合法 | 订单的收款商户没有加入白名单 |
21047 | 商品单id不合法 | 商品单id为空，或不是抖音的商品单id，请检查请求参数 |
21048 | 下单失败，不允许非商品库商品下单 | 该应用不支持非商品库商品下单，有需要的话，请申请白名单 |
22000 | 订单不允许退款 | |
22001 | 订单item子单不允许退款 | |
22002 | 没有可以退款的item订单 | |
22004 | 外部退款单号重复了 | 开发者生成的外部退款单号以前已经用过了，请重新生成 |
22005 | 因cps限制订单不允许退款 | cps有订单对退款有一些程序处理过程中的限制 |
22006 | 退款审核状态前置步骤未完成 | |
22007 | 超出单次最大可退款的商品数量 | 一般是单次退款item订单的数量超过了100 |
22008 | 超出可退款的商品数量 | 用户可以发起退款的订单数小于请求数 |
22009 | 发起退款的订单同时存在分账前和分账后状态 | |
24000 | 扩展点服务配置不存在，请配置对应的扩展点 | 没有配置扩展点的回调地址，请参考 行业模版使用指南 |
24001 | 调用扩展点出错 | 调用扩展点，请参考具体的提示，一般是开发者的服务有问题，导致调用失败 |
25000 | 活动信息无效 | |
25001 | 活动已结束 | |
25002 | 活动未开始 | |
25003 | 商品总价太低，无法使用优惠 | |
25004 | 当前商品无法使用优惠 | |
25005 | 用户不满足活动条件 | |
26001 | 当前订单状态不可支付 | 一般是订单已经过期了或者是已经支付了 |
26002 | 订单支付 token 无效 | |
26003 | 小程序违规，支付能力被封禁 | |
26004 | 商家账户升级中，请稍后 | 一般晚一点重试一下就好了 |
