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

# Utilisateurs vendeurs : dossier KYC persistant

> Didit : un dossier d'identité persistant par utilisateur vendeur (KYC, biométrie, documents, transactions, blocage) sur un seul profil.

Une **entité Utilisateur** représente une personne physique unique (votre client, utilisateur final ou candidat) dans toutes les interactions de vérification, de transaction et de conformité qu'elle a avec votre plateforme sur Didit.

Une fois qu'un Utilisateur existe, toute l'activité liée au même `vendor_data` alimente le même profil : vous disposez d'une vue unifiée de l'identité, du risque et de la conformité de chaque personne.

## Ce qu'une entité Utilisateur contient

| Catégorie | Champs / objets |
| - | - |
| **Identité** | `vendor_data`, `uuid`, `display_name`, `full_name`, `date_of_birth`, `portrait_image` |
| **Statut** | `ACTIVE`, `FLAGGED`, `BLOCKED` |
| **Agrégats de sessions** | `session_count`, `approved_count`, `declined_count`, `in_review_count`, map des fonctionnalités `features` |
| **Contact vérifié** | `approved_emails[]`, `approved_phones[]` |
| **Géographie** | `issuing_states[]` (issus des documents d'identité vérifiés) |
| **Activité** | `first_session_at`, `last_session_at`, `last_activity_at` |
| **Biométrie** | Enregistrements faciaux associés (pour la recherche, la détection de doublons et la liste de blocage) |
| **Documents** | Documents d'identité, justificatifs de domicile et selfies issus des sessions |
| **Relations** | Entités d’entreprise liées (si l'utilisateur est dirigeant ou bénéficiaire effectif d'entreprises vérifiées sur votre application) |
| **Métadonnées** | JSON libre pour vos propres données |

Consultez le [modèle de données Utilisateur](https://docs.didit.me/fr/entities/users/data-model.md) pour les types, les index et les cas particuliers.

## Quand un Utilisateur est créé

**1. Automatiquement : à la première session avec un nouveau vendor\_data**

Le cas le plus courant. Vous appelez `POST /v3/session/` avec une valeur `vendor_data` que Didit n'a encore jamais vue. Une entité Utilisateur est créée avec le statut `ACTIVE` et liée à cette session.

**2. Explicitement, via POST /v3/users/create/**

Vous créez l'Utilisateur à l'avance, avant toute session. Utile pour préremplir des métadonnées, définir un statut initial ou intégrer en masse des clients depuis une base de données existante.

**3. Depuis la console**

Un opérateur de conformité crée l'Utilisateur depuis la page Utilisateurs, par exemple lors de l'onboarding d'un client vérifié manuellement.

## Ce que vous pouvez faire

| Opération | Comment |
| - | - |
| [Lister les utilisateurs](https://docs.didit.me/fr/entities/users/operations.md#lister-les-utilisateurs) | `GET /v3/users/` avec des filtres (statut, date, pays) |
| [Obtenir un utilisateur](https://docs.didit.me/fr/entities/users/operations.md#récupérer-un-utilisateur) | `GET /v3/users/{vendor_data}/` |
| [Créer un utilisateur](https://docs.didit.me/fr/entities/users/operations.md#créer-un-utilisateur) | `POST /v3/users/create/` |
| [Mettre à jour le profil](https://docs.didit.me/fr/entities/users/operations.md#mettre-à-jour-un-utilisateur) | `PATCH /v3/users/{vendor_data}/` |
| [Modifier le statut](https://docs.didit.me/fr/entities/users/operations.md#modifier-le-statut) | `PATCH /v3/users/{vendor_data}/update-status/` |
| [Supprimer des utilisateurs](https://docs.didit.me/fr/entities/users/operations.md#supprimer-des-utilisateurs-par-lots) | `POST /v3/users/delete/` (par lot) |
| [Associer / rechercher des visages](https://docs.didit.me/fr/entities/users/faces-and-biometrics.md) | Console + Lists API pour les listes de blocage |
| [Consulter les documents](https://docs.didit.me/fr/entities/users/documents.md) | Via les décisions de session |
| [Ajouter à la liste de blocage](https://docs.didit.me/fr/entities/users/blocklist.md) | Console + Lists API |
| [Consulter l'historique KYC](https://docs.didit.me/fr/entities/users/kyc-history.md) | `GET /v3/sessions?vendor_data=...` |
| [Consulter les transactions](https://docs.didit.me/fr/entities/users/transactions.md) | `GET /v3/transactions/?vendor_data=...` |
| [Importer / exporter](https://docs.didit.me/fr/entities/users/import-export.md) | Console uniquement (CSV) |
| [Gérer dans la console](https://docs.didit.me/fr/entities/users/console.md) | Parcours complet de l'interface |

## Utilisateurs et entreprises

Un même Utilisateur peut être lié à une ou plusieurs entreprises, par exemple lorsqu'une personne est dirigeante d'une société et bénéficiaire effectif d'une autre. Didit conserve ces liens automatiquement lorsque la [KYB](https://docs.didit.me/fr/business-verification/overview.md) identifie des personnes à partir des registres des sociétés.

## Relation Utilisateur ↔ session

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

L'Utilisateur agrège l'état **le plus récent** de chaque fonctionnalité sur l'ensemble des sessions. Un contrôle `aml` ayant échoué sur la session la plus récente apparaîtra dans le champ `features.aml` de l'Utilisateur, même si des sessions plus anciennes ont été approuvées.

## Prochaines étapes

> [card] [Modèle de données](https://docs.didit.me/fr/entities/users/data-model.md)
>
> Chaque champ, type et index.

> [card] [Opérations](https://docs.didit.me/fr/entities/users/operations.md)
>
> Créer, mettre à jour, modifier le statut, supprimer.

> [card] [Visages et biométrie](https://docs.didit.me/fr/entities/users/faces-and-biometrics.md)
>
> Associer un visage pour la recherche et la mise sur liste de blocage.

> [card] [Liste de blocage](https://docs.didit.me/fr/entities/users/blocklist.md)
>
> Fonctionnement de la mise sur liste de blocage pour les utilisateurs.

> [card] [Historique KYC](https://docs.didit.me/fr/entities/users/kyc-history.md)
>
> Chaque session liée à l'utilisateur.

> [card] [Console](https://docs.didit.me/fr/entities/users/console.md)
>
> Parcours complet de l'interface Utilisateurs.


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