Passer au contenu principal
Business Verification suit le statut à plusieurs niveaux : la session, chaque fonctionnalité, la recherche dans le registre et le résultat AML. Cette page est la référence de chaque état. L’API renvoie les valeurs de statut sous forme de libellés exacts, sensibles à la casse, comme "In Progress" et "Not Finished", les mêmes chaînes que transmettent les webhooks. Faites vos correspondances sur ces chaînes, et non sur des noms en majuscules.

​
Statut de la session

Le statut global d’une session de Vérification d’entreprise (KYB) : c’est le champ unique sur lequel vous vous appuierez le plus souvent.
"Awaiting User" est transitoire : vous n’avez pas besoin de faire sortir manuellement les sessions de cet état. Dès que l’utilisateur final effectue l’action en attente (par exemple, il soumet la liste des personnes clés ou renvoie un document demandé), Didit réévalue la session et la fait passer automatiquement à "In Review", "Approved" ou "Declined" selon le résultat.

​
Statut de la fonctionnalité

Chaque fonctionnalité KYB a son propre statut, qui se répercute sur le statut de la session.

​
Noms des fonctionnalités KYB

Ce sont les valeurs de features dans une session KYB et dans les webhooks :
  • KYB_REGISTRY : recherche dans le registre des sociétés.
  • AML : filtrage AML au niveau de l’entreprise.
  • KYB_DOCUMENTS : collecte de documents et OCR.
  • KYB_KEY_PEOPLE : personnes clés, à savoir les bénéficiaires effectifs (UBO), les actionnaires, les dirigeants, les représentants et les autres mandataires sociaux.

​
Statut du registre (fourni par le prestataire)

Le statut officiel de l’entreprise tel qu’obtenu auprès des sources de registres faisant autorité. Il reflète la situation juridique ou réglementaire de l’entité telle que déclarée par le registre de la juridiction concernée, de sorte que les valeurs exactes varient selon la source. Il apparaît dans la décision KYB sous company.registry_status.
Comme registry_status reflète les valeurs brutes des registres, utilisez verification_status ci-dessous lorsque vous avez besoin d’un indicateur cohérent, valable dans toutes les juridictions, pour piloter la logique de votre produit.

​
Statut de vérification de l’entreprise

Un statut standardisé, orienté entreprise, pour chaque résultat d’entreprise. Il normalise les statuts variables des registres et des entreprises selon les pays et les sources en un indicateur unique et cohérent, directement exploitable dans votre produit. Il apparaît dans la décision KYB sous company.verification_status.

​
Statut de récupération des données de l’entreprise

Indique l’avancement de la récupération des données pour une fiche d’entreprise donnée, auprès de registres externes ou officiels. Utilisez-le pour déterminer le degré de complétude des informations récupérées pour une entreprise donnée. Il apparaît dans la décision KYB sous company.fetch_status.

​
Statut de vérification AML

Renvoyé pour chaque filtrage (entreprise ou personne).

​
Comment une décision s’explique

La décision KYB ne contient pas de code de motif unique sous forme de chaîne. Chaque tableau de fonctionnalités (registry_checks[], document_verifications[], key_people_checks[], aml_screenings[]) contient warnings[] avec les étiquettes KYB_* et AML, et decision_trace enregistre la manière dont la décision a été prise. Lisez les étiquettes dans Avertissements KYB, et consignez-les à côté du statut de la session. Lorsqu’un réviseur définit manuellement le statut contrairement à l’agrégation effectuée par la plateforme, la décision contient status_override avec l’horodatage overridden_at et le automatic_status que la plateforme aurait défini. Consultez le schéma de la réponse.

​
Étapes suivantes

Schéma de la réponse

Où chaque statut apparaît dans le payload.

Évaluation des risques

Ce qui détermine le résultat KYB.

Webhooks

Événements déclenchés lors des changements de statut.
Dernière modification le 7 novembre 2026