> ## 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.

# 사용자 및 기업 엔티티: Didit 엔티티 모델

> Didit의 두 가지 핵심 엔티티는 사용자와 기업입니다. 각 엔티티는 KYC 세션, 거래, 문서, 생체 인증, 위험 정보를 하나의 프로필로 통합합니다.

Didit는 애플리케이션에서 일어나는 모든 일을 두 가지 주요 엔터티 유형을 중심으로 구성합니다.

| 엔터티 | 나타내는 대상 | 연결 대상 |
| - | - | - |
| **사용자** | 개인 한 명 | 사용자 인증(KYC) 세션, 얼굴 생체 정보, 거래(신청자 또는 거래 상대방), 차단 목록 |
| **기업** | 법적 주체(회사, LLC, 개인사업자, 펀드) | 기업 확인(KYB) 세션, 임원, UBO, 거래(신청자 또는 거래 상대방), 차단 목록 |

모든 인증 세션, 거래, 차단 목록 항목은 엔터티에 연결할 수 있습니다. 연결되면 엔터티는 시간에 걸쳐 이력, 위험 신호, 규정 준수 상태를 집계하는 지속적인 프로필이 됩니다.

## 엔터티와 세션의 차이

**엔터티**와 **세션**은 서로 다른 개념입니다.

| 개념 | 범위 | 유효 기간 | 예시 |
| - | - | - | - |
| **세션** | 한 번의 인증 이벤트 | 단일 흐름(검토 중일 때는 몇 분에서 며칠) | 단일 KYC 시도 |
| **엔터티** | 지속적인 프로필 | 사용자 또는 기업이 플랫폼에 존재하는 동안 유지됨 | 2년에 걸쳐 사용자 인증(KYC) 세션 3건을 가진 고객 "Jane Doe" |

하나의 엔터티는 여러 세션을 가질 수 있습니다. 재인증, 재제출, 추가 검사, 주기적인 지속적 모니터링이 여기에 해당합니다. 엔터티는 이러한 결과를 집계합니다.

## 자동 생성과 수동 사전 생성

엔터티는 다음 세 가지 방법 중 하나로 생성됩니다:

**1. 세션에서 자동 생성**

`vendor_data` 식별자를 넣어 세션을 만들었는데 일치하는 엔터티가 없으면 Didit가 엔터티를 자동으로 생성합니다. 가장 일반적인 방법입니다.

```bash theme={null}
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "workflow_id": "wf_kyc_standard", "vendor_data": "user-42" }'
```

세션이 시작되는 즉시 `user-42`에 대한 사용자 엔터티가 생성됩니다.

**2. Management API로 사전 생성**

먼저 엔터티를 생성한 다음 그 엔터티에 대해 세션을 시작합니다. 첫 인증 전에 위험 신호(상태, 태그, 사용자 정의 메타데이터)를 미리 설정하려는 경우에 유용합니다.

```bash theme={null}
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "vendor_data": "user-42", "display_name": "Jane Doe" }'
```

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

규정 준수 담당자는 Business Console에서 사용자나 기업을 직접 생성할 수 있습니다. 수동 온보딩, 가져오기, 시정 워크플로에 유용합니다.

## 엔터티가 모든 것을 연결하는 방법

`vendor_data` 필드가 연결 키입니다. 세션이나 거래에 `vendor_data`를 전달하면 Didit가 이를 일치하는 엔터티로 라우팅합니다.

```mermaid theme={null}
flowchart LR
    VD["vendor_data:<br/>user-42"] --> U[User entity]
    S1[User Verification (KYC) session #1] --> VD
    S2[User Verification (KYC) session #2] --> VD
    T1[Transaction #1] --> VD
    T2[Transaction #2] --> VD
    F[Face biometric] --> VD
    D[Documents] --> VD
    BL[Blocklist entry] --> VD
```

자세한 내용은 [`vendor_data` 연결 가이드](https://docs.didit.me/ko/entities/vendor-data-linking)를 참조하십시오.

## 엔터티로 할 수 있는 작업

각 사용자 또는 기업 엔터티에 대해 다음 작업을 수행할 수 있습니다.

| 작업 | 용도 |
| - | - |
| **생성 / 수정** | 엔터티의 프로필 데이터(이름, 국가, 사용자 정의 메타데이터)를 설정하거나 변경 |
| **상태 변경** | `ACTIVE`, `FLAGGED`, `BLOCKED`로 표시합니다. 차단 적용은 이후 세션과 거래에 전파됩니다 |
| **생체 정보 첨부** | 1:N 검색, 중복 탐지, 차단 목록 등록을 위해 얼굴 참조 이미지를 업로드합니다 |
| **KYC/KYB 이력 검토** | 엔터티와 연결된 모든 세션을 기능별 결과와 함께 조회합니다 |
| **거래 이력 검토** | 엔터티가 신청자 또는 거래 상대방인 모든 거래를 조회합니다 |
| **차단 목록에 추가** | 이 엔터티가 관련된 이후 세션이나 거래를 차단합니다 |
| **가져오기 / 내보내기** | CSV에서 엔터티를 대량으로 업로드하거나 외부 규정 준수 도구용으로 내보냅니다 |
| **삭제** | 엔터티를 삭제합니다(이력은 감사를 위해 보존됩니다) |

자세한 안내는 [사용자](https://docs.didit.me/ko/entities/users/overview.md)와 [기업](https://docs.didit.me/ko/entities/businesses/overview.md) 아래에 있습니다.

## 사용자와 기업의 관계

하나의 사용자는 한 개 또는 여러 개의 기업에 연결될 수 있습니다. 이는 KYB 과정에서 자연스럽게 발생합니다.

* 사용자는 한 기업의 **이사**이면서 다른 기업의 **UBO**일 수 있습니다.
* 사용자의 사용자 인증(KYC) 세션은 [주요 인물](https://docs.didit.me/ko/business-verification/key-people.md) 흐름을 통해 기업의 기업 확인(KYB) 세션과 연결될 수 있습니다.

Didit는 이러한 관계를 보존합니다. 기업 엔터티를 조회하면 연결된 모든 사용자를 확인할 수 있고, 사용자 엔터티를 조회하면 해당 사용자가 연관된 모든 기업을 확인할 수 있습니다.

## 수명 주기와 상태

모든 엔터티에는 Didit가 새 활동에 차단을 적용할지 결정하는 상태가 있습니다.

| 상태 | 효과 |
| - | - |
| `ACTIVE` | 정상 상태입니다. 세션과 거래는 워크플로와 규칙에 따라 진행됩니다 |
| `FLAGGED` | 세션과 거래는 허용되지만 자동으로 수동 검토에 라우팅됩니다 |
| `BLOCKED` | 세션과 거래는 자동으로 거부되며, 새 세션은 생성할 수 없습니다 |

상태 전환과 webhook 이벤트에 대한 자세한 내용은 [엔터티 수명 주기](https://docs.didit.me/ko/entities/lifecycle.md)를 참조하십시오.

## 다음 단계

> [card] [수명 주기](https://docs.didit.me/ko/entities/lifecycle.md)
>
> 모든 엔터티의 상태, 전환, 수명 주기 이벤트.

> [card] [vendor\_data 연결](https://docs.didit.me/ko/entities/vendor-data-linking.md)
>
> `vendor_data`가 세션, 거래, 엔터티를 연결하는 방법.

> [card] [사용자](https://docs.didit.me/ko/entities/users/overview.md)
>
> 사용자 엔터티, 작업, 콘솔 워크플로에 대한 심층 설명.

> [card] [기업](https://docs.didit.me/ko/entities/businesses/overview.md)
>
> 기업 엔터티, 작업, 콘솔 워크플로에 대한 심층 설명.

> [card] [엔터티 webhook](https://docs.didit.me/ko/entities/webhooks.md)
>
> 모든 엔터티 변경에 대한 실시간 이벤트.

> [card] [차단 목록](https://docs.didit.me/ko/console/blocklist-users.md)
>
> 차단 목록 항목이 사용자 및 기업 엔터티와 상호작용하는 방식.


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