tencent cloud

腾讯云公告 > 公告详情
【eKYC】App SDK 核身接口错误码返回变更通知
为提升核身流程异常场景的可定位性,帮助客户更快速地识别和处理集成问题,我们将对以下接口的错误码返回规则进行变更:
Selfie Verification (App SDK) 服务的 GetFaceIdResultIntl 接口
Identity Verification (App SDK) 服务的 GetSdkVerificationResult 接口
Other APIs:GetLivenessResult
变更内容:
上述接口对于原本统一返回 -999 的「流程未完成」场景,当终端 SDK 上报了可识别的错误码时,将改为返回具体的错误码;若终端未上报、上报时间晚于拉取结果,或上报内容无法识别,则仍返回 -999,原有逻辑不受影响。
变更后可能返回的新增错误码及含义如下:
错误码
含义
100100
参数异常
100102
网络异常
100103
摄像头权限异常
100201
Token 失效或非法
100202
未初始化 SDK 即调用
100203
非法 context
100204
重复启动核身
100205
光线数据 / 光线序列参数异常
100206
未获取设备配置即设置光线参数
100207
SDK 所需权限不足
100208
后置摄像头不支持反光活体
200101
用户主动取消
200201
核身过程中切换应用
200202
集成方主动终止核身
200203
核身过程中开启录屏
200204
核身过程中截屏
200205
核身过程中展开或闭合折叠屏
200206
三折叠屏处于不支持的折叠状态
300101
模型 / SDK 初始化异常
300102
服务解析异常(服务端异常)
300103
签名失败
300104
摄像头异常
300105
初始化配置失败
300106
图片为空
300107
License 授权失败
300108
系统版本过低
300109
自动模式超时
300110
SDK 内部错误
300111
图片裁剪异常
300112
卡证类型不匹配
300113
告警触发次数过多
300201
风控模块初始化 / 授权失败
300202
风控模块配置不匹配
300203
远端配置获取失败
300204
核身结果获取失败
300205
本地人脸检测失败
300206
SDK 资源包体超过限制
300207
视频裁剪失败
300208
动作检测超时
300209
准备阶段超时(未检测到人脸)
300210
人脸检测 / 耗时检测超时
300212
核身全流程失败
300213
引擎错误
400100
触发指定拦截的告警码
400101
证件类型不匹配
400102
证件正反面不符
400103
证件占比过小
400104
检测到多张证件
400105
OCR 识别失败
400106
证件信息校验失败
400107
入参存在错误
400108
服务错误
400109
服务未开通 / 账号欠费 / 资源包耗尽
400110
请求频率超限(触发限流)
400111
图片尺寸或文件大小无效
400112
文件解析失败
400113
Token 过期
400114
使用次数超限
400901
卡证识别失败(本地卡证检测失败)
400902
卡证鉴伪失败
生效时间:本次变更自您收到本通知起 7 个自然日后正式生效。
本次变更仅细化 -999 场景下的错误码返回,不影响核身主流程及正常返回结果。
感谢您一直以来对我们的支持与信任!如有任何疑问,请 提交工单 反馈给我们,我们将尽快为您核实处理。