Modèle de données utilisateur : schéma fournisseur

Cette page documente chaque champ d’une entité User. Les champs sont répartis en cinq groupes : identité, statut, agrégats de session, horodatages d’activité et métadonnées.

Champs d’identité

Champ	Type	Description
`uuid`	UUID	Clé primaire attribuée par Didit. Stable et unique.
`didit_internal_id`	chaîne	Identifiant interne lisible par un humain (affiché dans les réponses de l’API).
`vendor_data`	chaîne	Votre identifiant pour l’utilisateur. Unique par application. En savoir plus.
`display_name`	chaîne	Nom de remplacement affiché dans la console. Par défaut, `full_name` ou `vendor_data` lorsqu’il n’est pas défini.
`full_name`	chaîne	Nom légal complet repris du document d’identité de la dernière session de Vérification des utilisateurs (KYC) approuvée.
`date_of_birth`	date (ISO 8601)	Repris de la dernière session de Vérification des utilisateurs (KYC) approuvée.
`portrait_image`	URL	URL S3 signée du selfie issu du dernier contrôle de détection du vivant approuvé.

full_name, date_of_birth et portrait_image sont en lecture seule lorsqu’ils proviennent d’une session vérifiée. Vous pouvez les remplacer depuis la console ou via PATCH /v3/users/{vendor_data}/, mais les remplacements manuels sont signalés dans le journal d’audit.

Statut

Champ	Type	Valeurs	Description
`status`	énumération	`ACTIVE`, `FLAGGED`, `BLOCKED`	Détermine l’application des règles pour les sessions et transactions à venir. Voir cycle de vie.

Champs d’agrégats de session

Ces champs sont calculés par Didit et se mettent à jour en temps réel à mesure que les sessions se terminent.

Champ	Type	Description
`session_count`	entier	Nombre total de sessions créées pour cet utilisateur
`approved_count`	entier	Sessions terminées avec `APPROVED`
`declined_count`	entier	Sessions terminées avec `DECLINED`
`in_review_count`	entier	Sessions actuellement `IN_REVIEW`
`issuing_states[]`	tableau de codes pays ISO	Pays de délivrance de tous les documents d’identité vérifiés dans l’ensemble des sessions
`approved_emails[]`	tableau de chaînes	E-mails vérifiés via Vérification de l’e-mail
`approved_phones[]`	tableau de chaînes	Téléphones vérifiés via Vérification du téléphone
`features`	objet	Dernier statut de chaque fonctionnalité dans l’ensemble des sessions

Le dictionnaire `features`

Chaque session exécute une ou plusieurs fonctionnalités (vérification d’identité, détection du vivant, correspondance faciale, AML, POA, NFC, etc.). Le dictionnaire features contient le dernier statut de chaque fonctionnalité pour cet utilisateur :

{
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW",
  "proof_of_address": "APPROVED",
  "nfc_verification": "NOT_FINISHED"
}

Statuts des fonctionnalités : NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, EXPIRED, ABANDONED, RESUB_REQUESTED. Utilisez le dictionnaire features pour répondre rapidement à la question « cet utilisateur est-il entièrement vérifié à cet instant ? » sans parcourir toutes les sessions.

Horodatages d’activité

Champ	Type	Mis à jour lorsque
`first_session_at`	horodatage ISO	La première session a été créée
`last_session_at`	horodatage ISO	La session la plus récente a été créée ou mise à jour
`last_activity_at`	horodatage ISO	Toute modification : session, transaction, statut, profil, notes, tags
`created_at`	horodatage ISO	La ligne de l’entité a été créée
`updated_at`	horodatage ISO	La ligne de l’entité a été mise à jour pour la dernière fois

Métadonnées

Champ	Type	Description
`metadata`	objet (JSON)	JSON libre que vous contrôlez. À utiliser pour les tags internes, le niveau, la source d’inscription, etc.
`tags[]`	tableau	Tags gérés depuis la console ou l’API, pour filtrer et regrouper

Les métadonnées n’ont pas de schéma : Didit conserve tout ce que vous écrivez.

Relations (non stockées dans la ligne de l’utilisateur)

Relation	Accès
Sessions	`GET /v3/sessions?vendor_data=<value>`
Transactions (en tant que demandeur)	`GET /v3/transactions/?vendor_data=<value>`
Transactions (en tant que contrepartie)	Filtrer la liste des transactions par vendor_data de la contrepartie dans la console
Entreprises liées (dirigeant / UBO)	Affichées sur la page de détail de l’utilisateur dans la console
Données biométriques faciales	Console + Lists API
Entrées de liste de blocage	Lists API, filtrer les entrées selon les identifiants de l’utilisateur

Exemple de réponse

{
  "uuid": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "didit_internal_id": "U-2026-00042",
  "vendor_data": "user-42",
  "display_name": "Jane Doe",
  "full_name": "John Doe",
  "date_of_birth": "1990-01-01",
  "portrait_image": "https://<media-host>/...",
  "status": "ACTIVE",
  "session_count": 3,
  "approved_count": 2,
  "declined_count": 0,
  "in_review_count": 1,
  "issuing_states": ["US", "ES"],
  "approved_emails": ["jane@example.com"],
  "approved_phones": ["+14155550123"],
  "features": {
    "id_verification": "APPROVED",
    "liveness": "APPROVED",
    "face_match": "APPROVED",
    "aml": "IN_REVIEW"
  },
  "first_session_at": "2025-03-01T12:00:00Z",
  "last_session_at": "2026-04-10T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "tier": "premium" }
}

Prochaines étapes

Opérations

Créer, mettre à jour, modifier le statut, supprimer.

Historique KYC

Récupérer toutes les sessions liées à l’utilisateur.

Référence de l'API

Schéma de l’endpoint GET /v3/users//.

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

Modèle de données utilisateur : schéma fournisseur

Champs d’identité

Statut

Champs d’agrégats de session

Le dictionnaire `features`

Horodatages d’activité

Métadonnées

Relations (non stockées dans la ligne de l’utilisateur)

Exemple de réponse

Prochaines étapes

Opérations

Historique KYC

Référence de l'API

​Champs d’identité

​Statut

​Champs d’agrégats de session

​Le dictionnaire features

​Horodatages d’activité

​Métadonnées

​Relations (non stockées dans la ligne de l’utilisateur)

​Exemple de réponse

​Prochaines étapes

Opérations

Historique KYC

Référence de l'API

Champs d’identité

Statut

Champs d’agrégats de session

Le dictionnaire `features`

Horodatages d’activité

Métadonnées

Relations (non stockées dans la ligne de l’utilisateur)

Exemple de réponse

Prochaines étapes