> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Statuts KYB : référence session, fonctionnalité, AML

> Statuts exacts des sessions KYB, fonctionnalités, registre et filtrages AML avec Didit. Dès $2.00 par vérification, selon pays et niveau.

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.

| Statut | Signification |
| - | - |
| `"Not Started"` | Session créée, mais l'entreprise n'a pas encore ouvert le lien hébergé. |
| `"In Progress"` | Le parcours hébergé est actif : recherches dans les registres, envoi de documents ou filtrage AML en cours. |
| `"Awaiting User"` | En attente d'une action de l'utilisateur final (généralement la soumission des personnes clés, ou la réponse à une demande de nouvel envoi). Passe automatiquement à l'état suivant dès que l'utilisateur a effectué l'action en attente. |
| `"Approved"` | Toutes les fonctionnalités requises ont été validées. L'entreprise est vérifiée. |
| `"Declined"` | Un contrôle critique a échoué (société dissoute, entité sous sanctions, figurant sur une liste de blocage) ou une règle du workflow a rejeté la session. |
| `"In Review"` | Une ou plusieurs fonctionnalités nécessitent un examen manuel par un analyste. |
| `"Resubmitted"` | La session précédemment refusée ou ayant fait l'objet d'une demande de nouvel envoi a été soumise à nouveau avec des données mises à jour. |
| `"Abandoned"` | L'entreprise n'a jamais terminé le parcours (délai dépassé). |
| `"Expired"` | La session a expiré avant que l'entreprise ne la termine. |

> [!NOTE]
>
> `"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.

| Statut | Signification |
| - | - |
| `"Not Finished"` | La fonctionnalité n'a pas encore démarré ou est en cours d'exécution. |
| `"Approved"` | La fonctionnalité a été validée. |
| `"Declined"` | La fonctionnalité a échoué (échec critique). |
| `"In Review"` | La fonctionnalité nécessite l'attention d'un analyste. |
| `"Resub Requested"` | L'entreprise doit soumettre à nouveau des éléments pour cette fonctionnalité (par exemple, renvoyer un document). |
| `"Awaiting User"` | La fonctionnalité attend une action de l'utilisateur final. S'applique à la fonctionnalité Personnes clés pendant que l'utilisateur doit soumettre les personnes concernées. Passe automatiquement à l'état suivant dès la soumission. |

### 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`.

| Statut | Signification |
| - | - |
| `ACTIVE` | L'entreprise est active et en règle. |
| `DISSOLVED` | L'entreprise a été dissoute. |
| `DEREGISTERED` | L'entreprise a été radiée. |
| `STRUCK_OFF` | L'entreprise a été rayée du registre. |
| `CLOSED` | L'entreprise a été fermée. |
| `INACTIVE` | L'entreprise est inactive (sans activité commerciale). |
| `AUTHORISED` | Agréée (généralement pour les entités réglementées). |
| `APPOINTED_REPRESENTATIVE` | Représentant désigné d'une autre entreprise agréée. |
| `UNAUTHORISED` | Précédemment agréée, désormais non agréée. |
| `NO_LONGER_AUTHORISED` | Agrément retiré. |
| `SEE_FULL_DETAILS` | Le statut nécessite un examen manuel. |

> [!NOTE]
>
> 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 | Signification |
| - | - |
| `verified` | L'entreprise semble active et valide. |
| `failed` | L'entreprise semble inactive ou dissoute, ou des problèmes ont été relevés. |
| `unknown` | Les informations sont insuffisantes ou le statut est ambigu. |

## 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 | Signification |
| - | - |
| `pending` | Seules des informations partielles ou de base sur l'entreprise ont été récupérées à ce stade. |
| `resolved` | Les données complètes de l'entreprise ont été récupérées avec succès auprès des sources officielles. |

## Statut de vérification AML

Renvoyé pour chaque filtrage (entreprise ou personne).

| Statut | Signification |
| - | - |
| `"Approved"` | Aucune correspondance au-dessus du seuil. |
| `"Declined"` | Correspondance de gravité élevée (sanction confirmée ou correspondance PEP). |
| `"In Review"` | Correspondance trouvée nécessitant un examen par un analyste. |
| `"Not Finished"` | Le filtrage n'est pas encore terminé. |

## 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](https://docs.didit.me/fr/business-verification/warnings.md), 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](https://docs.didit.me/fr/business-verification/response-schema.md).

## Étapes suivantes

> [card] [Schéma de la réponse](https://docs.didit.me/fr/business-verification/response-schema.md)
>
> Où chaque statut apparaît dans le payload.

> [card] [Évaluation des risques](https://docs.didit.me/fr/business-verification/risk-assessment.md)
>
> Ce qui détermine le résultat KYB.

> [card] [Webhooks](https://docs.didit.me/fr/business-verification/webhooks.md)
>
> Événements déclenchés lors des changements de statut.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.