errorCode 判断是否可以重试、用户需要采取什么操作以及能否补件，并据此提供清晰的用户提示。DCS 将底层 KYC 服务商的拒绝原因转换为一套稳定的错误码，供接入机构在自己的产品中使用。
拒绝码出现在哪里
当 KYC 工单的status 流转为 REJECTED 时，响应里会带上一对字段，描述本次拒绝的原因：
这对字段会在以下两处出现，取值一致，接入机构按任一渠道解析即可：
- 查询 KYC 状态（主动获取）：见 查询 KYC 状态，当
status=REJECTED时响应携带errorCode/errorMessage。 - KYC_TICKET Webhook（被动接收）：DCS 在 Ticket 状态变化时推送通知，通知体携带同名的
errorCode/errorMessage字段（仅REJECTED状态返回），结构见 Webhook 数据结构。
DCS 负责转换错误码：您无需处理底层服务商（如 Sumsub）的原始拒绝码，只需使用下表中的 errorCode。如新增取值，DCS 会提前通知接入机构。
怎么用这套码
拿到errorCode 后，按下面三步处理，对应表格的「可否重试 / 用户怎么办 / 能否补件」三列：
- 判可否重试：先看该码是「可修复（重试）」还是「终态（不可重试）」。终态码不要引导用户重复提交，否则只会反复被拒。
- 给用户怎么办：可修复码把
errorMessage或本表「用户怎么办」转成产品内提示（如「请在更好的光线下重拍证件」）。终态码统一给一句中性提示（如「很抱歉，本次申请无法继续，请联系客服」），不要回显具体合规原因（命中制裁/PEP 等属敏感信息）。 - 判能否补件：「能补件」的码走补充材料流程（不必重新获取 Sumsub Token，直接走补证接口）；「不能补件」的码走重新发起或终止流程。
拒绝码总表
下表将全部 KYC 拒绝码按业务类别整理，并补充是否可重试、用户处理方式和能否补件等建议。errorCode 及其描述以接口实际返回为准，最终处理方式以 DCS 合规要求为准。
可否重试：✅ 可修复后重试 / ❌ 终态、不应重试 / ⚠️ 视情况（多为系统侧问题，稍后重试或转人工）。
类别 1 · 证件影像质量（可修复）
用户上传的图片本身有问题（模糊、损坏、缺页、格式不对），引导重拍/重传即可。类别 2 · 证件有效性 / 类型（部分可修复）
证件本身过期、类型/模板不受支持，或语言不受支持。类别 3 · 补充材料 / 信息不完整（可修复，走补件）
缺材料或信息没填全，引导补充即可，通常无需重新获取 Sumsub Token。类别 4 · 信息不匹配（可修复，核对资料）
用户填写的资料与证件/数据库不一致，引导核对修正。类别 5 · 人脸 / 活体验证（部分可修复）
人脸比对或活体检测未通过。质量类可重拍；疑似第三方协助/多人/欺骗类偏终态。类别 6 · 合规 / 风控终态（不可重试，给中性提示）
命中制裁/筛查/EDD/可疑行为等合规红线，属终态。统一给中性提示，不回显具体原因，不引导重提交。类别 7 · 资格 / 地区限制（终态，因合作配置而异）
不在支持国家/地区，或不符合合作方/年龄等准入要求。多为终态，对该用户不可通过重试解决。类别 8 · 重复 / 欺诈嫌疑（终态）
重复申请或伪造/篡改嫌疑。类别 9 · 数据校验无法完成 / 数据源问题（视情况）
申请数据无法完成校验，或外部数据源/数据库暂时不可用。区分「用户侧需核对」与「系统侧稍后重试」。类别 10 · Share Token / 复用 KYC（多为可重试）
走 Sumsub Share Token 或复用（Reusable）KYC 时的专属拒绝原因。多数是令牌或会话问题，重新取一次即可；渠道能力类则属终态。类别 11 · 未在时间窗口内完成提交（TIMEOUT_*）
TIMEOUT_ 前缀表示同一件事：用户未能在规定时间窗口内向 Sumsub 完成提交，请求因超时终止。后缀只说明超时发生时停留在哪一步，不代表该项校验真的失败了。
类别 12 · 其他
接入建议
- 以
errorCode为准，不要硬编码errorMessage文案：errorMessage可能随版本调整或多语言化；程序判断分支请基于errorCode，展示文案可用errorMessage或本表自定义。 errorMessage多语言：请勿假定errorMessage的返回语言，程序分支一律按errorCode走；展示文案以本表自定义或对errorMessage做本地化默认文案。- 未知码处理：本表会随合规策略增删取值。请为「未在已知列表中的
errorCode」预留默认分支（按OTHERS处理 + 上报告警），避免新增码导致前端崩溃。 - 终态码不要循环重试：类别 6/7/8 属于终态，重复提交无意义且可能触发风控；请统一使用中性提示并引导用户联系客服。
- 补件无需重取 Token：地址证明（POA）等可补件场景，按 申请 KYC 的补件路径直接补充材料，通常不必重新获取 Sumsub Share Token。
下一步
- 拿到拒绝码后如何引导用户补件或重提交：回看 申请 KYC。
- 主动轮询 Ticket 状态、解析
errorCode：见 查询 KYC 状态。 - 用托管页让用户自助完成补证：见 H5 KYC 引导页。