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

# Entités KYC : utilisateurs et entreprises avec Didit

> Utilisateurs et entreprises, deux entités clés de Didit. Chacune regroupe KYC, transactions, documents, biométrie et risques.

Didit organise tout ce qui se passe dans votre application autour de deux types d'entités de premier niveau :

| Entité | Représente | Lié à |
| - | - | - |
| **Utilisateur** | Une personne physique | Sessions de vérification des utilisateurs (KYC), biométrie faciale, transactions (en tant que demandeur ou contrepartie), listes de blocage |
| **Entreprise** | Une personne morale (société, LLC, entreprise individuelle, fonds) | Sessions de vérification d'entreprise (KYB), dirigeants, UBO, transactions (en tant que demandeur ou contrepartie), listes de blocage |

Chaque session de vérification, chaque transaction et chaque entrée de liste de blocage peut être liée à une entité. Une fois liée, l'entité devient un profil durable qui agrège l'historique, les signaux de risque et l'état de conformité dans le temps.

## Entité et session

Une **entité** et une **session** sont deux choses différentes.

| Concept | Portée | Durée de vie | Exemple |
| - | - | - | - |
| **Session** | Un événement de vérification | Un seul flux (de quelques minutes à quelques jours pendant l'examen) | Une tentative KYC unique |
| **Entité** | Un profil durable | Existe tant que l'utilisateur ou l'entreprise existe sur votre plateforme | Le client « Jane Doe » avec 3 sessions de vérification des utilisateurs (KYC) sur 2 ans |

Une même entité peut avoir de nombreuses sessions : nouvelles vérifications, nouvelles soumissions, contrôles complémentaires, surveillance continue périodique. L'entité agrège les résultats.

## Création automatique ou pré-création manuelle

Les entités sont créées de trois façons :

**1. Créée automatiquement à partir d'une session**

Lorsque vous créez une session avec un identifiant `vendor_data` et qu'aucune entité correspondante n'existe, Didit crée automatiquement l'entité. C'est le chemin le plus courant.

```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" }'
```

Une entité Utilisateur pour `user-42` est créée dès le démarrage de la session.

**2. Pré-créée via la Management API**

Créez d'abord l'entité, puis démarrez les sessions sur celle-ci. Utile lorsque vous souhaitez renseigner à l'avance des signaux de risque (statut, étiquettes, métadonnées personnalisées) avant la première vérification.

```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. Créée dans la console**

Votre équipe conformité peut créer des utilisateurs ou des entreprises directement depuis la Business Console, ce qui est utile pour l'onboarding manuel, les imports ou les workflows de régularisation.

## Comment les entités relient tout

Le champ `vendor_data` est la clé de liaison. Lorsque vous transmettez `vendor_data` sur une session ou une transaction, Didit l'achemine vers l'entité correspondante.

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

En savoir plus dans le [guide de liaison `vendor_data`](https://docs.didit.me/fr/entities/vendor-data-linking).

## Ce que vous pouvez faire avec une entité

Pour chaque entité Utilisateur ou Entreprise, vous pouvez :

| Opération | Finalité |
| - | - |
| **Créer / mettre à jour** | Définir ou modifier les données de profil de l'entité (nom, pays, métadonnées personnalisées) |
| **Changer le statut** | Marquer comme `ACTIVE`, `FLAGGED` ou `BLOCKED` : l'application du statut s'étend aux sessions et transactions futures |
| **Associer la biométrie** | Téléverser une image de référence du visage pour la recherche 1:N, la détection de doublons ou l'ajout à une liste de blocage |
| **Consulter l'historique KYC/KYB** | Récupérer toutes les sessions liées à l'entité, avec les résultats par fonctionnalité |
| **Consulter l'historique des transactions** | Récupérer toutes les transactions dans lesquelles l'entité est le demandeur ou la contrepartie |
| **Ajouter à une liste de blocage** | Bloquer les futures sessions ou transactions impliquant cette entité |
| **Importer / exporter** | Importer en masse des entités depuis un CSV ou exporter pour des outils de conformité externes |
| **Supprimer** | Supprimer l'entité (l'historique est conservé pour l'audit) |

Les guides détaillés se trouvent dans [Utilisateurs](https://docs.didit.me/fr/entities/users/overview.md) et [Entreprises](https://docs.didit.me/fr/entities/businesses/overview.md).

## Relations entre utilisateurs et entreprises

Un même utilisateur peut être lié à une ou plusieurs entreprises. Cela se produit naturellement lors de la vérification d'entreprise (KYB) :

* Un utilisateur peut être **dirigeant** d'une entreprise et **UBO** d'une autre.
* La session de vérification des utilisateurs (KYC) d'un utilisateur peut être liée à la session de vérification d'entreprise (KYB) d'une entreprise via le flux [Personnes clés](https://docs.didit.me/fr/business-verification/key-people.md).

Didit conserve ces relations : lorsque vous consultez une entité Entreprise, vous voyez chaque utilisateur lié, et lorsque vous consultez une entité Utilisateur, vous voyez chaque entreprise à laquelle l'utilisateur est associé.

## Cycle de vie et statuts

Chaque entité possède un statut qui détermine si Didit applique des blocages sur les nouvelles activités :

| Statut | Effet |
| - | - |
| `ACTIVE` | Normal : les sessions et transactions se déroulent selon la configuration des workflows et des règles |
| `FLAGGED` | Les sessions et transactions sont autorisées, mais automatiquement acheminées vers un examen manuel |
| `BLOCKED` | Les sessions et transactions sont automatiquement refusées, et aucune nouvelle session ne peut être créée |

Consultez le [cycle de vie complet de l'entité](https://docs.didit.me/fr/entities/lifecycle.md) pour les transitions et les événements webhook.

## Étapes suivantes

> [card] [Cycle de vie](https://docs.didit.me/fr/entities/lifecycle.md)
>
> États, transitions et événements de cycle de vie pour chaque entité.

> [card] [Liaison par vendor\_data](https://docs.didit.me/fr/entities/vendor-data-linking.md)
>
> Comment `vendor_data` lie les sessions, les transactions et les entités.

> [card] [Utilisateurs](https://docs.didit.me/fr/entities/users/overview.md)
>
> Présentation détaillée des entités Utilisateur, des opérations et des workflows de la console.

> [card] [Entreprises](https://docs.didit.me/fr/entities/businesses/overview.md)
>
> Présentation détaillée des entités Entreprise, des opérations et des workflows de la console.

> [card] [Webhooks d'entité](https://docs.didit.me/fr/entities/webhooks.md)
>
> Événements en temps réel pour chaque modification d'entité.

> [card] [Liste de blocage](https://docs.didit.me/fr/console/blocklist-users.md)
>
> Interaction des entrées de liste de blocage avec les entités Utilisateur et Entreprise.


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