抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

错误码和返回码

收藏
我的收藏

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
商家账户升级中,请稍后
稍后重试
​