Modèle de données KYB des entreprises : schéma Didit

Cette page documente chaque champ d’une entité d’entreprise et indique comment Didit renseigne chacun d’eux.

Identifiants

Champ	Type	Description
`uuid`	UUID	Clé primaire attribuée par Didit. Stable et unique.
`didit_internal_id`	string	Identifiant interne lisible par un humain.
`vendor_data`	string	Votre identifiant de l’entreprise. Unique par application. En savoir plus.
`display_name`	string	Nom affiché dans la console, qui remplace le nom par défaut. Par défaut, `legal_name` ou `vendor_data`.
`legal_name`	string	Raison sociale telle qu’enregistrée, reprise depuis la recherche dans le registre de la dernière session de Vérification d’entreprise (KYB) approuvée.
`registration_number`	string	Numéro d’immatriculation officiel de la société, repris depuis le registre.
`country_code`	string (ISO 3166-1 alpha-3)	Pays de constitution.

legal_name, registration_number et country_code sont en lecture seule lorsqu’ils proviennent d’une recherche vérifiée dans le registre. Vous pouvez les remplacer manuellement dans la console ou via PATCH /v3/businesses/{vendor_data}/, mais chaque remplacement est signalé dans le journal d’audit.

Statut

Champ	Type	Valeurs	Description
`status`	enum	`ACTIVE`, `FLAGGED`, `BLOCKED`	Contrôle l’application des règles pour les futures sessions et transactions. Voir cycle de vie.

Champs agrégés des sessions

Champ	Type	Description
`session_count`	int	Nombre total de sessions de Vérification d’entreprise (KYB) créées pour cette entreprise
`approved_count`	int	Sessions terminées avec `Approved`
`declined_count`	int	Sessions terminées avec `Declined`
`in_review_count`	int	Sessions actuellement `In Review`
`features`	object	Statut de la dernière vérification de l’entreprise, sous la clé `KYB`

L’objet `features`

{
  "KYB": "Approved"
}

L’objet contient une seule clé, KYB, avec le statut de la dernière vérification de l’entreprise : "Not Finished", "Approved", "Declined", "In Review" ou "Resub Requested". Pour connaître le statut de chaque fonctionnalité KYB, consultez la décision de la session. Utilisez l’objet features comme moyen rapide de vérifier si une entreprise est entièrement vérifiée à l’instant présent, sans parcourir toutes les sessions.

Horodatages d’activité

Champ	Type	Mis à jour lorsque
`first_session_at`	horodatage ISO	Première session de Vérification d’entreprise (KYB) créée
`last_session_at`	horodatage ISO	Dernière session créée ou mise à jour
`last_activity_at`	horodatage ISO	Toute modification : session, transaction, statut, profil, notes
`created_at`	horodatage ISO	Création de la ligne de l’entité
`updated_at`	horodatage ISO	Dernière mise à jour de la ligne de l’entité

Métadonnées

Champ	Type	Description
`metadata`	object (JSON)	JSON de forme libre que vous contrôlez
`tags[]`	array	Étiquettes gérées depuis la console ou l’API

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

Relation	Comment y accéder
Sessions de Vérification d’entreprise (KYB)	`GET /v3/sessions?vendor_data=<value>`
Utilisateurs liés (dirigeants, bénéficiaires effectifs, administrateurs)	Affichés sur la page de détail de l’entreprise dans la console ; issus de la dernière session de Vérification d’entreprise (KYB) approuvée
Transactions (en tant que demandeur ou contrepartie)	Filtrez les transactions par `vendor_data` de l’entreprise
Documents	Via les décisions des sessions de Vérification d’entreprise (KYB)
Correspondances AML	Via les décisions des sessions de Vérification d’entreprise (KYB)

Exemple de réponse

{
  "uuid": "f7a9c1b2-4e6d-4f8a-9c5d-2a1b3c4d5e6f",
  "didit_internal_id": "B-2026-00018",
  "vendor_data": "biz-acme",
  "display_name": "Acme Corp",
  "legal_name": "Acme Corporation Limited",
  "registration_number": "12345678",
  "country_code": "GBR",
  "status": "ACTIVE",
  "session_count": 2,
  "approved_count": 1,
  "declined_count": 0,
  "in_review_count": 1,
  "features": {
    "KYB": "Approved"
  },
  "first_session_at": "2025-09-01T12:00:00Z",
  "last_session_at": "2026-04-01T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "partner": "Acme Holdings" }
}

Étapes suivantes

Opérations

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

Historique KYB

Récupérer chaque session liée à l’entreprise.

Référence de l'API

Schéma de GET /v3/businesses//.

Dernière modification le 7 novembre 2026

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 KYB des entreprises : schéma Didit

Identifiants

Statut

Champs agrégés des sessions

L’objet `features`

Horodatages d’activité

Métadonnées

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

Exemple de réponse

Étapes suivantes

Opérations

Historique KYB

Référence de l'API

​Identifiants

​Statut

​Champs agrégés des sessions

​L’objet features

​Horodatages d’activité

​Métadonnées

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

​Exemple de réponse

​Étapes suivantes

Opérations

Historique KYB

Référence de l'API

Identifiants

Statut

Champs agrégés des sessions

L’objet `features`

Horodatages d’activité

Métadonnées

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

Exemple de réponse

Étapes suivantes