> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thedecard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# KYC 拒绝与补件

> KYC 申请未通过时，本页帮您从 API 返回中辨别两类拒绝：「可补件重提」（问题可修复、补传证件即重新审核）与「REFUSE 审核未通过」（系统层面作出拒绝结论），并给出对应处理路径。本页只讲拒绝这一支。

## 📄 正文

DeCard 托管模式的 KYC 状态由一个顶层 `status` 加一个 `statusDescription` 描述文案组成，并以机读补件信号 `needExtraInfo`（boolean）标识是否需要补件：`true` = 需引导用户补充资料、`false` = 已提交勿重复引导。下文的「可补件 / `REFUSE`」是业务流程层的区分，由 `needExtraInfo`、审核结论和 `statusDescription` 共同推导。理解这条岔路，您就能正确引导用户——该重传证件的别误判为已无法挽回，已 `REFUSE` 的也不必再反复提交。

### 术语说明（REFUSE / REJECTED）

同一套系统的不同层级使用了不同英文变体，此处统一澄清：

| 出现位置                         | 英文                              | 说明                                                                                          |
| ---------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------- |
| **API 响应顶层 `status` 枚举值**    | `REFUSE`                        | 代码字面量，大写；KYC 审核未通过的顶层状态（与 `UNDO` / `INIT` / `PENDING` / `PASS` 并列）                          |
| **`statusDescription` 子状态值** | `POA_REJECTED` / `POI_REJECTED` | 代码字面量，大写；仅出现在 `status=INIT` 下，表示居住证明 / 身份证明审核不通过（此时仍在 `INIT` 进行中、属于可补件范畴，**不是**顶层 `REFUSE`） |
| **本页中文叙述**                   | 「拒绝」「不通过」「审核未通过」                | 统一用中文；英文仅用于标注代码枚举                                                                           |

> 接入机构请以 API 响应字段的实际字面量为准。

***

## 一、可补件的拒绝

当 KYC 在审核过程中发现**可修复**的问题（证件过期、照片不清、地址不匹配、缺失页面等），DCS 不会立刻做出 `REFUSE` 结论，而是在 `status=INIT` 下通过 `statusDescription` 给出具体不通过的子状态。用户**无需重新走完整 KYC 流程**，只需补传对应证件即可。

### 判定信号

| 信号                                 | 来源         | 含义                                                     |
| ---------------------------------- | ---------- | ------------------------------------------------------ |
| `status = INIT`                    | KYC 顶层状态   | 用户仍在 KYC 进行中，尚未进入 `PENDING`（提交完成）或 `REFUSE`（审核结论）      |
| `statusDescription = POA_REJECTED` | KYC 子状态    | 居住证明（POA）审核不通过，需补传地址证明材料                               |
| `statusDescription = POI_REJECTED` | KYC 子状态    | 身份证明（POI）审核不通过，需补传身份证明材料                               |
| `needExtraInfo = true`             | 开卡 / 查询类响应 | **DeCard 托管原生的机读补件信号**：用户尚未提交补充资料，请引导上传                |
| `needExtraInfo = false`            | 开卡 / 查询类响应 | 用户已完成资料提交动作；即使 `status` 仍为 `PENDING`，也请等待审核，**无需重复引导** |

> `needExtraInfo` 是驱动补件流程最直接的机读字段，语义是「是否需要补」；拒绝的细分由 `status` + `statusDescription` 文案提供。

### 补件操作流程

1. **不需要重新获取 Sumsub Share Token**。POA/POI 不通过时，沿用原有申请上下文（原 `sumsubShareToken` 仍然有效），直接引导用户补传，**无需重新签发 Token**。这与从头开始一次新的 KYC 申请不同。

2. **引导用户补件**：通过 H5 引导页接口生成补件链接，把用户带回补传页面：

   ```
   POST /redirect/v2/guidance-link
   ```

   `action` 取值：

   | `action`        | 含义                                                  |
   | --------------- | --------------------------------------------------- |
   | `KYC_EXTRA_DOC` | KYC 补充信息（补传缺失/不合格证件）。**此 action 下 `applyId` 为条件必传** |

   <Warning>
     **`applyId` 条件必填**：当 `action = KYC_EXTRA_DOC` 时，guidance-link 请求**必须携带 `applyId`**，遗漏会导致调用失败。引导页其余参数（语言 / theme / mode / 回跳 URL 等）见 [H5 KYC 与开卡引导页](../integration-resources/h5-kyc-guidance)。
   </Warning>

3. **用户补传后**，申请重新进入审核（`status` 回到 `PENDING` / `INIT` 的进行中描述），您可继续轮询或等待 Webhook 通知最终结果。

4. **POA/POI 的可接受证件类型**、各国是否需要额外 POA，见 [KYC 证件说明](./kyc-documents)。

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/dcs-0bf7a937/oUoeUKtwWWK2o-Li/imgs/diagrams/va-kyc-resubmit-light.svg?fit=max&auto=format&n=oUoeUKtwWWK2o-Li&q=85&s=bb92fc44b985b193316645015d19bfba" alt="KYC 拒绝后的补件重提流程" width="561" height="444" data-path="imgs/diagrams/va-kyc-resubmit-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/dcs-0bf7a937/oUoeUKtwWWK2o-Li/imgs/diagrams/va-kyc-resubmit-dark.svg?fit=max&auto=format&n=oUoeUKtwWWK2o-Li&q=85&s=de8e5709ed2d38f7dbe22a3e437df17f" alt="KYC 拒绝后的补件重提流程" width="561" height="444" data-path="imgs/diagrams/va-kyc-resubmit-dark.svg" />
</Frame>

> **Sumsub Token 与拒绝流程的关系**：Token 共享机制的配置（数据提供方 / 数据收取方）是一次性接入事项——**上线前**完成配置后，在拒绝补件过程中**不需要重新配置**。具体步骤见 [Sumsub KYC 资料共享](./kyc-vendor)。

***

## 二、审核未通过（`REFUSE`）

当 `status` 为 **`REFUSE`** 时，表示 KYC 审核**未通过**，用户提交的资料不符合要求或未通过验证。这通常由运营团队在人工审核中作出判定（如命中 AML、制裁名单、监管区域限制、身份欺诈等业务原因）。

对 `REFUSE`：

* 与「可补件」（`statusDescription = POA_REJECTED / POI_REJECTED`，本质仍在 `INIT` 进行中）不同，`REFUSE` 是 KYC **顶层状态**层面的审核未通过结论，通常不应继续按补件流程反复引导用户重传证件。
* 是否、以及如何向终端用户展示拒绝原因，请遵循您与 DCS 约定的用户沟通要求（部分原因因合规要求不可对外披露）。
* 如对判定有异议，走人工申诉/客服上报路径，详见 [问题上报与支持路径](./escalations-and-support-paths)。

> `REFUSE` 是本次 KYC 申请的终态，不能继续沿用同一申请补件。业务允许重新发起新申请，但系统限制 24 小时最多提交 10 次（上限可配置）；超过限制后请等待窗口恢复，不要循环重试。

***

## 下一步

* 各国可接受的身份证明（POI）与地址证明（POA）白名单：[KYC 证件说明](./kyc-documents)
* Sumsub KYC 资料共享的两种接入方向与配置步骤：[Sumsub KYC 资料共享](./kyc-vendor)
* 补件引导页（guidance-link）的完整参数说明：[H5 KYC 与开卡引导页](../integration-resources/h5-kyc-guidance)
* 对 KYC 拒绝判定有异议的申诉路径：[问题上报与支持路径](./escalations-and-support-paths)