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

# Liste de blocage d'entreprises : bloquer KYB et pays

> Bloquez des entités Didit Business par vendor_data ou pays : fonctionnement du contrôle et routes console et API pour ajouter ou retirer un blocage.

Les listes de blocage empêchent une entreprise qui n'a pas satisfait à vos contrôles de conformité, ou située dans un pays dangereux, de lancer de nouvelles sessions de Vérification d'entreprise (KYB) ou d'effectuer des transactions sur votre plateforme.

## Types d'identifiants pris en charge pour les entreprises

| Type | Clé | Correspond lorsque… |
| - | - | - |
| Entreprise | `BUSINESS` | Une nouvelle session ou transaction utilise le `vendor_data` figurant sur la liste de blocage |
| Pays | (configuré séparément) | Le pays de l'entreprise correspond à une liste de pays dangereux |
| IP | `IP_ADDRESS` | L'adresse IP du demandeur (ou sa plage CIDR) correspond |
| Empreinte de l'appareil | `DEVICE_FINGERPRINT` | L'appareil du demandeur correspond |
| Adresse | `WALLET_ADDRESS` | Le portefeuille crypto lié à l'entreprise correspond |
| Compte bancaire | `BANK_ACCOUNT` | L'IBAN ou le compte bancaire correspond |

> [!NOTE]
>
> Les listes de blocage de visages et de documents fonctionnent au niveau **individuel** (utilisateur), et non au niveau de l'entreprise. Pour bloquer des dirigeants ou des UBO, ajoutez-les à la liste de blocage en tant qu'utilisateurs : leur implication dans une entreprise est alors prise en compte dans l'examen des personnes clés de l'entreprise.

## Comment le blocage s'effectue

> [!NOTE]
>
> Une session de Vérification d'entreprise (KYB) refusée ne met pas l'entreprise sur liste de blocage. La session passe à `Declined`, l'entreprise reste `ACTIVE` et aucune entrée de liste n'est créée. Le blocage est une étape manuelle : ajoutez l'entrée depuis la [page de la liste de blocage](https://docs.didit.me/fr/console/blocklist-users.md) ou avec l'[API Lists](https://docs.didit.me/fr/management-api/lists/overview.md). Une entrée `BUSINESS` (le `vendor_data`) passe aussi le statut de l'entreprise à `BLOCKED`.

**1. Automatique, pays dangereux**

Si le pays de constitution de l'entreprise figure dans votre liste configurée de pays dangereux, la session de Vérification d'entreprise (KYB) est refusée.

**2. Automatique, entité sanctionnée**

Un résultat AML concernant l'entreprise dépassant le seuil de refus entraîne le refus de la session. Elle ne crée aucune entrée de liste : ajoutez vous-même l'entreprise à la liste de blocage si vous voulez que son `vendor_data` soit refusé par la suite.

**3. Manuel, depuis la console**

Un analyste ajoute une entreprise à la liste de blocage depuis *Businesses → \[business] → Actions → Add to blocklist*.

**4. Programmatique, via l'API Lists**

Utilisez l'[API Lists](https://docs.didit.me/fr/management-api/lists/overview.md) pour ajouter directement des entrées à la liste de blocage des entreprises.

## Pays dangereux

Chaque application fournit une liste par défaut de **pays dangereux** (configurable depuis *Settings → Blocklist → Countries*). Exemples de codes ISO inclus par défaut : `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR` (susceptibles de changer : la liste par défaut suit les recommandations du FATF et de l'OFAC).

Lorsqu'une entreprise est créée avec un `country_code` correspondant :

* La session de Vérification d'entreprise (KYB) est refusée.
* Aucun lien de session n'est émis.
* L'entreprise est créée avec le statut `BLOCKED`.

## Ajouter une entreprise à la liste de blocage via l'API

Utilisez l'[API Lists](https://docs.didit.me/fr/management-api/lists/overview.md) pour ajouter une entrée à la liste de blocage par programmation :

1. [Lister toutes les listes](https://docs.didit.me/fr/management-api/lists/list.md) filtrées par `entry_type=business` et `is_system=true` pour trouver la liste de blocage système des entreprises.
2. [Créer une entrée](https://docs.didit.me/fr/management-api/lists/create-entry.md) dans cette liste, avec `value` défini sur le `vendor_data` de l'entreprise, ainsi qu'un `display_label` et un `comment` facultatifs à des fins d'audit.

## Application au moment de la transaction

Les entreprises figurant sur une liste de blocage sont automatiquement prises en compte dans la Surveillance des transactions :

* Les transactions impliquant une **entreprise demanderesse figurant sur la liste de blocage** sont refusées automatiquement.
* Les transactions impliquant une **entreprise contrepartie figurant sur la liste de blocage** sont signalées ou refusées selon votre configuration des règles.

Les règles prédéfinies comme « Contrepartie sanctionnée » se déclenchent sur ces correspondances.

## Retirer une entreprise de la liste de blocage

* **Console** : *Blocklist → Businesses → row actions → Remove*.
* **API** : utilisez l'endpoint [Delete entry](https://docs.didit.me/fr/management-api/lists/delete-entry.md) avec l'UUID de la liste et l'UUID de l'entrée.

Le retrait ne modifie pas automatiquement le `status` de l'entreprise. Utilisez `PATCH /v3/businesses/{vendor_data}/update-status/` pour ramener l'entreprise au statut `ACTIVE`.

## Piste d'audit

Chaque ajout ou retrait est consigné dans le [journal d'audit](https://docs.didit.me/fr/console/audit-logs.md) avec :

* L'auteur (adresse e-mail de l'utilisateur, ou `'system'` ou `'api'`).
* L'horodatage.
* Le commentaire facultatif.
* La session de référence, si elle a été générée automatiquement.

## Étapes suivantes

> [card] [Lists API](https://docs.didit.me/fr/management-api/lists/overview.md)
>
> Référence complète de l'API des listes de blocage.

> [card] [Liste de blocage dans la console](https://docs.didit.me/fr/console/blocklist-users.md)
>
> Gérer les listes de blocage depuis l'interface.

> [card] [Opérations](https://docs.didit.me/fr/entities/businesses/operations.md)
>
> Modifier le statut d'une entreprise.


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