错误码和返回码

收藏
我的收藏

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
访问未授权
    1.如果是查询接口,访问的数据不属于当前用户或者小程序,属于非法访问
    2.如果是前端JS API接口,没有使用JS API的权限,需要联系相关对接人添加权限​
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
下单次数超限制
下单商品的总次数超出限制
21030​
订单状态不支持关单​
订单已支付,无法关闭订单​
21032
开发者商品id重复
请求里有重复的商品id,请检查请求参数
21042
商品状态无效
商品状态错误,请检查商品信息
21043
商品库存不足
商品库存错误,请检查商品信息
21045
订单已超时,无法继续支付
订单已经过了支付有效期,无法继续支付
21046
订单收款商户号不合法
订单的收款商户没有加入白名单
21047
商品单id不合法
商品单id为空,或不是抖音的商品单id,请检查请求参数
21048
下单失败,不允许非商品库商品下单
该应用不支持非商品库商品下单,有需要的话,请申请白名单
21110​
生成核销码失败​
21111​
订单不运营推送核销状态,请使用抖音码(闭环核销)方案核销​
21112​
此外部订单不是交易系统订单​
21113​
三方码参数校验未通过​
21114​
当前订单非抖音码订单,无法使用核销组件展示​
21116​
预约商品不允许推送 核销状态​
21117​
加价单不允许推送核销状态​
22000
订单不允许退款
22001
订单item子单不允许退款
22002
没有可以退款的item订单
22004
外部退款单号重复了
开发者生成的外部退款单号以前已经用过了,请重新生成
22005
因cps限制订单不允许退款
cps有订单对退款有一些程序处理过程中的限制
22006
退款审核状态前置步骤未完成
22007
超出单次最大可退款的商品数量
一般是单次退款item订单的数量超过了100
22008
超出可退款的商品数量
用户可以发起退款的订单数小于请求数
22009
发起退款的订单同时存在分账前和分账后状态
23001​
分账参数错误​
23101​
订单不存在,无法分账​
23102​
订单未支付,无法分账​
23103​
小程序在禁止分账名单中,无法分账​
23104​
服务商在禁止分账名单中,无法分账​
23105​
支付后不满N天,无法分账​
23106​
核销后不满N天,无法分账​
23107​
订单未完成,无法分账​
23108​
单笔订单分账次数过多​
23109​
分账金额超过授权比例​
23110​
服务商无对应小程序分账授权​
23111​
out_settle_no已存在,请用查询接口查询分账结果​
23112​
订单已无可分账金额​
23113​
该订单不允许分账​
23114​
消息版本号<已存在的版本号, 跳过本次更新​
23115​
新poi未关联商户号​
23116​
开发者未认领poi​
23117​
该订单属于自动结算订单, 无需请求分账​
23118​
不允许发起整单结算​
23119​
不允许发起券结算​
23120​
券未核销,无法分账​
23121​
券结算功能灰度中,请联系客服或已对接的运营开通​
24000​
扩展点服务配置不存在,请配置对应的扩展点​
没有配置扩展点的回调地址,请参考 行业模版使用指南
24001​
调用扩展点出错​
调用扩展点,请参考具体的提示,一般是开发者的服务有问题,导致调用失败​
25000
活动信息无效
25001
活动已结束
25002
活动未开始
25003
商品总价太低,无法使用优惠
25004
当前商品无法使用优惠
25005
用户不满足活动条件
26001
当前订单状态不可支付
一般是订单已经过期了或者是已经支付了
26002
订单支付 token 无效
26003
小程序违规,支付能力被封禁
26004
商家账户升级中,请稍后
一般晚一点重试一下就好了