错误码和返回码

更新时间 2024-07-24 02:58:49
收藏
我的收藏

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

商家账户升级中,请稍后

一般晚一点重试一下就好了