> ## 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 레코드: Vendor Users

> Didit의 Vendor Users는 KYC 이력, 생체 인증, 문서, 거래, 차단 목록 상태를 하나의 프로필에 담는 영구 신원 레코드입니다.

**User 엔티티**는 Didit 플랫폼에서 고객, 최종 사용자 또는 신청자가 수행하는 모든 인증, 거래 및 컴플라이언스 상호작용을 하나로 묶어 나타내는 개별 사람을 의미합니다.

User가 생성되면 같은 `vendor_data`와 연결된 모든 활동이 동일한 프로필로 모입니다. 따라서 각 사람의 신원, 위험, 컴플라이언스 정보를 한 화면에서 확인할 수 있습니다.

## User에 저장되는 정보

| 범주 | 필드 / 객체 |
| - | - |
| **신원** | `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` |
| **생체 인식** | 연결된 얼굴 레코드 (검색, 중복 감지, 차단 목록용) |
| **문서** | 세션에서 수집된 신분증 문서, 주소 증명, 셀피 |
| **관계** | 연결된 Business 엔티티 (사용자가 귀사 앱에서 검증된 기업의 이사 또는 UBO인 경우) |
| **메타데이터** | 귀사 데이터를 위한 임의의 JSON |

유형, 인덱스, 예외 상황에 대한 자세한 내용은 [User 데이터 모델](https://docs.didit.me/ko/entities/users/data-model.md)을 참고하십시오.

## User가 생성되는 시점

**1. 자동 생성: 새 vendor\_data로 첫 세션이 시작될 때**

일반적인 경우입니다. Didit이 아직 알지 못하는 `vendor_data` 값으로 `POST /v3/session/`을 호출하면 `ACTIVE` 상태의 User 엔티티가 생성되고 해당 세션에 연결됩니다.

**2. 명시적 생성: POST /v3/users/create/ 사용**

세션이 실행되기 전에 User를 미리 생성합니다. 메타데이터를 입력하거나, 초기 상태를 설정하거나, 기존 데이터베이스의 고객을 일괄적으로 온보딩할 때 유용합니다.

**3. 콘솔에서 생성**

컴플라이언스 담당자가 Users 페이지에서 User를 생성합니다. 예를 들어 수동으로 검증된 고객을 온보딩할 때 사용합니다.

## 할 수 있는 작업

| 작업 | 방법 |
| - | - |
| [사용자 목록 조회](https://docs.didit.me/ko/entities/users/operations.md#사용자-목록-조회) | 필터(상태, 날짜, 국가)를 적용하여 `GET /v3/users/` 호출 |
| [사용자 조회](https://docs.didit.me/ko/entities/users/operations.md#사용자-조회) | `GET /v3/users/{vendor_data}/` |
| [사용자 생성](https://docs.didit.me/ko/entities/users/operations.md#사용자-생성) | `POST /v3/users/create/` |
| [프로필 업데이트](https://docs.didit.me/ko/entities/users/operations.md#사용자-업데이트) | `PATCH /v3/users/{vendor_data}/` |
| [상태 변경](https://docs.didit.me/ko/entities/users/operations.md#상태-변경) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [사용자 삭제](https://docs.didit.me/ko/entities/users/operations.md#사용자-삭제-일괄) | `POST /v3/users/delete/` (일괄) |
| [얼굴 첨부 / 검색](https://docs.didit.me/ko/entities/users/faces-and-biometrics.md) | 콘솔 및 차단 목록용 Lists API |
| [문서 보기](https://docs.didit.me/ko/entities/users/documents.md) | 세션 결정을 통해 |
| [차단 목록에 추가](https://docs.didit.me/ko/entities/users/blocklist.md) | 콘솔 및 Lists API |
| [KYC 이력 검토](https://docs.didit.me/ko/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [거래 검토](https://docs.didit.me/ko/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [가져오기 / 내보내기](https://docs.didit.me/ko/entities/users/import-export.md) | 콘솔에서만 가능 (CSV) |
| [콘솔에서 관리](https://docs.didit.me/ko/entities/users/console.md) | 전체 UI 둘러보기 |

## 사용자와 기업

한 명의 User는 하나 이상의 Business에 연결될 수 있습니다. 예를 들어 같은 사람이 한 회사의 이사이면서 다른 회사의 UBO인 경우가 이에 해당합니다. Didit은 법인 등기부에서 사람을 식별할 때 [KYB](https://docs.didit.me/ko/business-verification/overview.md) 과정에서 이러한 연결을 자동으로 보존합니다.

## User ↔ 세션 관계

```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
```

User는 모든 세션에 걸쳐 각 기능의 **최신** 상태를 집계합니다. 가장 최근 세션에서 `aml` 검사가 실패하면, 이전 세션들이 승인되었더라도 해당 내용이 User의 `features.aml` 필드에 표시됩니다.

## 다음 단계

> [card] [데이터 모델](https://docs.didit.me/ko/entities/users/data-model.md)
>
> 모든 필드, 유형, 인덱스.

> [card] [작업](https://docs.didit.me/ko/entities/users/operations.md)
>
> 생성, 업데이트, 상태 변경, 삭제.

> [card] [얼굴 및 생체 인식](https://docs.didit.me/ko/entities/users/faces-and-biometrics.md)
>
> 검색 및 차단 목록 등록을 위해 얼굴을 첨부합니다.

> [card] [차단 목록](https://docs.didit.me/ko/entities/users/blocklist.md)
>
> 사용자에 대한 차단 목록 등록 방식.

> [card] [KYC 이력](https://docs.didit.me/ko/entities/users/kyc-history.md)
>
> 사용자와 연결된 모든 세션.

> [card] [콘솔](https://docs.didit.me/ko/entities/users/console.md)
>
> Users 화면 전체 안내.


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