Passer au contenu principal
Chaque entité User et Business dans Didit suit un cycle de vie prévisible. Comprendre ce cycle est essentiel pour concevoir vos flux d’onboarding, de surveillance continue et de remédiation.

​
Schéma du cycle de vie

​
Détail des statuts

La modification du statut via PATCH /v3/users/{vendor_data}/update-status/ ou PATCH /v3/businesses/{vendor_data}/update-status/ émet un webhook (user.status.updated / business.status.updated) afin que vos systèmes en aval puissent réagir en temps réel.

​
Phases du cycle de vie

Création

Une entité est créée de l’une des trois façons suivantes :
  • Créée automatiquement lorsque vous démarrez une session avec un nouveau vendor_data. L’entité est créée au statut ACTIVE.
  • Précréée via l’API à l’aide de POST /v3/users/create/ ou POST /v3/businesses/create/. Le statut est ACTIVE par défaut.
  • Créée dans la console par un responsable de la conformité : le statut est initialement ACTIVE, sauf si l’opérateur en décide autrement.
Chaque entité reçoit un uuid généré par Didit et un identifiant vendor_data appartenant au client.

Vérification

Les sessions sont rattachées à l’entité via vendor_data. Chaque session passe par votre workflow configuré : vérification d’identité, détection du vivant, correspondance faciale, filtrage AML, documents, recherche dans le registre pour les KYB, et ainsi de suite.Les sessions terminées mettent à jour les compteurs agrégés de l’entité :
  • session_count, approved_count, declined_count, in_review_count
  • la map features : le dernier statut de chaque fonctionnalité sur l’ensemble des sessions (par exemple { "id_verification": "APPROVED", "aml": "IN_REVIEW" })
  • les champs de profil sont repris de la dernière session approuvée (par exemple full_name, date_of_birth, portrait_image).

Utilisation active

Une fois qu’une entité compte une ou plusieurs sessions approuvées, vous pouvez :
  • Soumettre des transactions faisant référence à l’entité via vendor_data dans le payload de la transaction
  • Lancer une surveillance AML continue : analyses périodiques des listes de sanctions, de PPE et de presse négative
  • Procéder à une revérification selon un calendrier : créer de nouvelles sessions pour le même vendor_data à intervalles réguliers
  • Agréger les signaux de risque entre les sessions et les transactions

Transitions de statut

Le statut d’une entité change automatiquement ou manuellement.Transitions automatiques
  • ACTIVE → FLAGGED lorsqu’une transaction dépasse le seuil d’examen ou qu’une règle ajoute l’entité à une liste de surveillance.
  • ACTIVE → BLOCKED lorsqu’une biométrie faciale correspond à une entrée de la liste de blocage.
Une session refusée n’ajoute pas l’entité à la liste de blocage et ne modifie donc pas son statut. Le blocage d’un sujet refusé est une étape manuelle : ajoutez l’entrée depuis la page Liste de blocage ou via l’API Lists. Une entrée de type USER (le vendor_data) fait passer le statut à BLOCKED.Transitions manuelles : elles se produisent lorsqu’un analyste modifie le statut depuis la console, ou lorsque vous appelez l’endpoint update-status.Chaque transition émet un webhook user.status.updated ou business.status.updated.

Suppression

Les entités sont supprimées via POST /v3/users/delete/ ou POST /v3/businesses/delete/ (en lot). L’enregistrement de l’entité est supprimé définitivement. La suppression d’un User purge également chaque gabarit biométrique conservé pour lui après la suppression de ses sessions, de sorte que la personne ne correspond plus lors de la détection de doublons ni dans la Recherche faciale.Les sessions de vérification ne sont pas couvertes par ces endpoints, pas plus que les transactions. Supprimez les sessions avec Supprimer une session ou Supprimer des sessions en lot ; les transactions se suppriment depuis la console.

​
Horodatages d’activité

Les entités enregistrent leur activité afin de vous aider à repérer les profils inactifs ou actifs : Utilisez ces horodatages pour filtrer les entités inactives, planifier les revérifications ou déclencher la surveillance continue.

​
Événements émis pendant le cycle de vie

Consultez les webhooks d’entité pour la structure des payloads et les modalités de livraison.

​
Étapes suivantes

Liaison avec vendor_data

Comment vendor_data relie les sessions, les transactions et les entités entre elles.

Opérations sur les Users

Créer, mettre à jour, modifier le statut et supprimer les entités User.

Opérations sur les Business

Créer, mettre à jour, modifier le statut et supprimer les entités Business.
Dernière modification le 7 novembre 2026