> ## 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履歴、生体認証、書類、取引、ブロックリストの状態を1つのプロフィールにまとめて管理します。

**ユーザーエンティティ**は、1人の個人(顧客、エンドユーザー、申請者)を表します。その個人が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/ja/entities/users/data-model.md)の全体をご覧ください。

## ユーザーが作成されるタイミング

**1. 自動作成: 新しいvendor\_dataでの初回セッション時**

最も一般的なケースです。Diditがまだ受け取ったことのない`vendor_data`の値を指定して`POST /v3/session/`を呼び出すと、ユーザーエンティティが`ACTIVE`ステータスで作成され、そのセッションに紐づけられます。

**2. 明示的な作成: POST /v3/users/create/を使用**

セッションを実行する前にユーザーを事前作成します。メタデータの初期登録、初期ステータスの設定、既存データベースからの顧客の一括オンボーディングに便利です。

**3. コンソールから作成**

コンプライアンス担当者がユーザーページからユーザーを作成します。たとえば、手動で検証された顧客をオンボーディングする場合です。

## できること

| 操作 | 方法 |
| - | - |
| [ユーザーの一覧表示](https://docs.didit.me/ja/entities/users/operations.md#ユーザーの一覧取得) | フィルター(ステータス、日付、国)を指定して`GET /v3/users/` |
| [ユーザーの取得](https://docs.didit.me/ja/entities/users/operations.md#ユーザーの取得) | `GET /v3/users/{vendor_data}/` |
| [ユーザーの作成](https://docs.didit.me/ja/entities/users/operations.md#ユーザーの作成) | `POST /v3/users/create/` |
| [プロファイルの更新](https://docs.didit.me/ja/entities/users/operations.md#ユーザーの更新) | `PATCH /v3/users/{vendor_data}/` |
| [ステータスの変更](https://docs.didit.me/ja/entities/users/operations.md#ステータスの変更) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [ユーザーの削除](https://docs.didit.me/ja/entities/users/operations.md#ユーザーの削除-一括) | `POST /v3/users/delete/`(一括) |
| [顔の紐づけ / 検索](https://docs.didit.me/ja/entities/users/faces-and-biometrics.md) | コンソール + ブロックリスト用のLists API |
| [書類の表示](https://docs.didit.me/ja/entities/users/documents.md) | セッションの判定を通じて確認 |
| [ブロックリストへの追加](https://docs.didit.me/ja/entities/users/blocklist.md) | コンソール + Lists API |
| [KYC履歴の確認](https://docs.didit.me/ja/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [取引の確認](https://docs.didit.me/ja/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [インポート / エクスポート](https://docs.didit.me/ja/entities/users/import-export.md) | コンソールのみ(CSV) |
| [コンソールでの管理](https://docs.didit.me/ja/entities/users/console.md) | UI全体の操作手順 |

## ユーザーと企業

1人のユーザーを1つ以上の企業に紐づけることができます。たとえば、同じ人物がある会社の取締役であり、別の会社のUBOでもある場合です。[KYB](https://docs.didit.me/ja/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/ja/entities/users/data-model.md)
>
> すべてのフィールド、型、インデックス。

> [card] [操作](https://docs.didit.me/ja/entities/users/operations.md)
>
> 作成、更新、ステータス変更、削除。

> [card] [顔と生体認証](https://docs.didit.me/ja/entities/users/faces-and-biometrics.md)
>
> 検索とブロックリスト登録のために顔を紐づけます。

> [card] [ブロックリスト](https://docs.didit.me/ja/entities/users/blocklist.md)
>
> ユーザーに対するブロックリストの仕組み。

> [card] [KYC履歴](https://docs.didit.me/ja/entities/users/kyc-history.md)
>
> ユーザーに紐づくすべてのセッション。

> [card] [コンソール](https://docs.didit.me/ja/entities/users/console.md)
>
> ユーザーUI全体の操作ガイド。


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