Entités KYC : utilisateurs et entreprises avec Didit

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 :

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.

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.

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.

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

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. En savoir plus dans le guide de liaison vendor_data.

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 et Entreprises.

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.

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é pour les transitions et les événements webhook.

Étapes suivantes

Cycle de vie

États, transitions et événements de cycle de vie pour chaque entité.

Liaison par vendor_data

Comment vendor_data lie les sessions, les transactions et les entités.

Utilisateurs

Présentation détaillée des entités Utilisateur, des opérations et des workflows de la console.

Entreprises

Présentation détaillée des entités Entreprise, des opérations et des workflows de la console.

Webhooks d'entité

Événements en temps réel pour chaque modification d’entité.

Liste de blocage

Interaction des entrées de liste de blocage avec les entités Utilisateur et Entreprise.

Présentation

Tarifs

Workflows et vérification

Examen et opérations

Entités (utilisateurs et entreprises)

Paramètres et personnalisation

Sécurité et conformité

Didit Academy

Ressources

Entités KYC : utilisateurs et entreprises avec Didit

Entité et session

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

Comment les entités relient tout

Ce que vous pouvez faire avec une entité

Relations entre utilisateurs et entreprises

Cycle de vie et statuts

Étapes suivantes

Cycle de vie

Liaison par vendor_data

Utilisateurs

Entreprises

Webhooks d'entité

Liste de blocage

​Entité et session

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

​Comment les entités relient tout

​Ce que vous pouvez faire avec une entité

​Relations entre utilisateurs et entreprises

​Cycle de vie et statuts

​Étapes suivantes

Cycle de vie

Liaison par vendor_data

Utilisateurs

Entreprises

Webhooks d'entité

Liste de blocage

Entité et session

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

Comment les entités relient tout

Ce que vous pouvez faire avec une entité

Relations entre utilisateurs et entreprises

Cycle de vie et statuts

Étapes suivantes