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

# 供应商用户：持久化 KYC 记录

> 供应商用户是 Didit 的持久身份记录，把 KYC 历史、生物识别、证件、交易和黑名单状态全部集中在同一个用户档案中。

**用户实体**表示您的客户、终端用户或申请人在 Didit 平台上进行的所有验证、交易和合规交互中的同一个人。

用户一旦存在，所有与同一 `vendor_data` 关联的活动都会汇入同一份档案。您可以在一个视图中查看每个人的身份、风险和合规信息。

## 用户包含哪些内容

| 类别 | 字段 / 对象 |
| - | - |
| **身份** | `vendor_data`、`uuid`、`display_name`、`full_name`、`date_of_birth`、`portrait_image` |
| **状态** | `ACTIVE`、`FLAGGED`、`BLOCKED` |
| **会话汇总** | `session_count`、`approved_count`、`declined_count`、`in_review_count`、`features` 映射 |
| **已验证联系方式** | `approved_emails[]`、`approved_phones[]` |
| **地理分布** | 来自已验证证件的 `issuing_states[]` |
| **活动** | `first_session_at`、`last_session_at`、`last_activity_at` |
| **生物识别** | 已关联的人脸记录（用于搜索、重复检测和黑名单） |
| **证件** | 来自会话的身份证件、地址证明和自拍照 |
| **关联关系** | 已关联的企业实体（若该用户是您应用中已验证企业的董事或 UBO） |
| **元数据** | 您自有数据的任意 JSON |

有关类型、索引和特殊情况的完整说明，请参阅[用户数据模型](https://docs.didit.me/zh/entities/users/data-model.md)。

## 何时创建用户

**1. 首次使用新的 vendor\_data 发起会话时自动创建**

这是常见情况。您调用 `POST /v3/session/`，并传入 Didit 从未见过的 `vendor_data` 值。系统会以 `ACTIVE` 状态创建一个用户实体，并将其关联到该会话。

**2. 显式创建，通过 POST /v3/users/create/**

您可以在任何会话运行前预先创建用户。适用于预先填充元数据、设置初始状态，或从现有数据库为客户批量办理入驻。

**3. 从控制台创建**

合规操作员在用户页面创建用户，例如为人工验证过的客户办理入驻时。

## 您可以执行的操作

| 操作 | 方式 |
| - | - |
| [列出用户](https://docs.didit.me/zh/entities/users/operations.md#列出用户) | `GET /v3/users/`，支持筛选（状态、日期、国家/地区） |
| [获取用户](https://docs.didit.me/zh/entities/users/operations.md#获取用户) | `GET /v3/users/{vendor_data}/` |
| [创建用户](https://docs.didit.me/zh/entities/users/operations.md#创建用户) | `POST /v3/users/create/` |
| [更新资料](https://docs.didit.me/zh/entities/users/operations.md#更新用户) | `PATCH /v3/users/{vendor_data}/` |
| [变更状态](https://docs.didit.me/zh/entities/users/operations.md#变更状态) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [删除用户](https://docs.didit.me/zh/entities/users/operations.md#批量删除用户) | `POST /v3/users/delete/`（批量） |
| [关联 / 搜索人脸](https://docs.didit.me/zh/entities/users/faces-and-biometrics.md) | 控制台，以及用于黑名单的 Lists API |
| [查看证件](https://docs.didit.me/zh/entities/users/documents.md) | 通过会话决策查看 |
| [添加到黑名单](https://docs.didit.me/zh/entities/users/blocklist.md) | 控制台，以及 Lists API |
| [查看 KYC 历史记录](https://docs.didit.me/zh/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [查看交易](https://docs.didit.me/zh/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [导入 / 导出](https://docs.didit.me/zh/entities/users/import-export.md) | 仅限控制台（CSV） |
| [在控制台中管理](https://docs.didit.me/zh/entities/users/console.md) | 完整界面操作指南 |

## 用户与企业

一个用户可以关联一个或多个企业，例如同一人既是一家公司的董事，又是另一家公司的 UBO。当 [KYB](https://docs.didit.me/zh/business-verification/overview.md) 从公司登记中识别出相关人员时，Didit 会自动保留这些关联。

## 用户与会话的关系

```mermaid theme={null}
flowchart LR
    U[User entity<br/>vendor_data = user-42]
    S1["User Verification (KYC) session #1<br/>(approved 2025-01)"]
    S2["User Verification (KYC) session #2<br/>(resubmit, in review)"]
    S3["User Verification (KYC) session #3<br/>(re-verification 2026-01)"]
    S1 --> U
    S2 --> U
    S3 --> U
```

用户汇总所有会话中每项功能的**最新**状态。即使较早的会话已通过，最近一次会话中失败的 `aml` 检查也会显示在用户的 `features.aml` 字段中。

## 后续步骤

> [card] [数据模型](https://docs.didit.me/zh/entities/users/data-model.md)
>
> 每个字段、类型和索引。

> [card] [操作](https://docs.didit.me/zh/entities/users/operations.md)
>
> 创建、更新、变更状态、删除。

> [card] [人脸与生物识别](https://docs.didit.me/zh/entities/users/faces-and-biometrics.md)
>
> 关联人脸，用于搜索和加入黑名单。

> [card] [黑名单](https://docs.didit.me/zh/entities/users/blocklist.md)
>
> 用户加入黑名单的运作方式。

> [card] [KYC 历史记录](https://docs.didit.me/zh/entities/users/kyc-history.md)
>
> 与该用户关联的每个会话。

> [card] [控制台](https://docs.didit.me/zh/entities/users/console.md)
>
> 用户界面完整操作指南。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.