API entreprises KYB : opérations CRUD fournisseur

Toutes les opérations de gestion des entreprises passent par six endpoints publics sous /v3/businesses/. Cette page présente le fonctionnement général. Consultez la référence de l’API pour les schémas complets des requêtes et des réponses.

Lister les entreprises

GET /v3/businesses/ Liste paginée des entreprises de votre application, avec des filtres par statut, recherche, pays et plage de dates.

curl -G https://verification.didit.me/v3/businesses/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "status=ACTIVE" \
  --data-urlencode "country_code=GBR" \
  --data-urlencode "page_size=50"

Consulter une entreprise

GET /v3/businesses/{vendor_data}/ Récupère une seule entreprise à partir de son vendor_data.

curl https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY"

Créer une entreprise

POST /v3/businesses/create/ Créez une entreprise à l’avance, avant le lancement de toute session de Vérification d’entreprise (KYB) :

curl -X POST https://verification.didit.me/v3/businesses/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "biz-acme",
    "display_name": "Acme Corp",
    "country_code": "GBR",
    "metadata": { "partner": "Acme Holdings" }
  }'

Renvoie une erreur de conflit si une entreprise avec ce vendor_data existe déjà. Utilisez PATCH pour mettre à jour une entreprise existante.

Mettre à jour une entreprise

PATCH /v3/businesses/{vendor_data}/ Met à jour les champs de profil modifiables. Les champs issus des recherches dans le registre des sociétés (legal_name, registration_number, country_code) sont en lecture seule après la vérification, mais peuvent être remplacés : chaque remplacement est signalé dans le journal d’audit. Champs modifiables : display_name, metadata, tags. En lecture seule après vérification : tous les champs issus du registre, les compteurs agrégés et la carte features.

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "metadata": { "tier": "enterprise" } }'

Émet business.data.updated.

Changer le statut

PATCH /v3/businesses/{vendor_data}/update-status/ Fait passer une entreprise entre les statuts ACTIVE, FLAGGED et BLOCKED.

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/update-status/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "BLOCKED",
    "reason": "Sanctioned subsidiary detected in ownership chain"
  }'

De → vers	Déclencheur courant
`ACTIVE` → `FLAGGED`	Session de Vérification d’entreprise (KYB) passée à `In Review`, alerte de la surveillance AML continue, règle sur les transactions
`ACTIVE` → `BLOCKED`	Entité sanctionnée confirmée, ajout manuel à la liste de blocage
`FLAGGED` → `ACTIVE`	L’analyste a validé l’examen
`BLOCKED` → `ACTIVE`	Déblocage manuel après remédiation

Émet business.status.updated.

Supprimer des entreprises (par lot)

POST /v3/businesses/delete/ Supprime une ou plusieurs entreprises. Les fiches d’entreprise sont supprimées définitivement. Leurs sessions de vérification ne sont pas concernées par cet endpoint : elles subsistent, leur lien avec l’entreprise étant supprimé. Supprimez-les avec Delete Session. Les transactions ne sont pas non plus concernées : supprimez-les depuis la Console.

curl -X POST https://verification.didit.me/v3/businesses/delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "vendor_data": ["biz-acme", "biz-alpha", "biz-beta"] }'

Idempotent : supprimer une entreprise déjà supprimée n’a aucun effet.

Modèle d’autorisation

Tous les endpoints /v3/businesses/* sont régis par la ressource d’autorisation businesses :

Rôle	Liste	Lecture	Création	Mise à jour	Mise à jour du statut	Suppression
OWNER	✅	✅	✅	✅	✅	✅
ADMIN	✅	✅	✅	✅	✅	✅
COMPLIANCE_OFFICER	✅	✅	❌	✅	✅	❌
DEVELOPER	✅	✅	✅	❌	❌	❌
READER	✅	✅	❌	❌	❌	❌

Consultez Rôles et autorisations.

Webhooks déclenchés par ces opérations

Opération	Webhook
`create`	`business.data.updated`
`update`	`business.data.updated` avec `changed_fields`
`update-status`	`business.status.updated`
`delete`	`business.data.updated` avec `deleted_at` renseigné

Étapes suivantes

Modèle de données

Référence complète des champs.

API de liste

Schéma de GET /v3/businesses/.

API de création

Schéma de POST /v3/businesses/create/.

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

API entreprises KYB : opérations CRUD fournisseur

Lister les entreprises

Consulter une entreprise

Créer une entreprise

Mettre à jour une entreprise

Changer le statut

Supprimer des entreprises (par lot)

Modèle d’autorisation

Webhooks déclenchés par ces opérations

Étapes suivantes

Modèle de données

API de liste

API de création

​Lister les entreprises

​Consulter une entreprise

​Créer une entreprise

​Mettre à jour une entreprise

​Changer le statut

​Supprimer des entreprises (par lot)

​Modèle d’autorisation

​Webhooks déclenchés par ces opérations

​Étapes suivantes

Modèle de données

API de liste

API de création

Lister les entreprises

Consulter une entreprise

Créer une entreprise

Mettre à jour une entreprise

Changer le statut

Supprimer des entreprises (par lot)

Modèle d’autorisation

Webhooks déclenchés par ces opérations

Étapes suivantes