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

# Unternehmens-Sperrliste: KYB & Länder sperren

> Didit-Unternehmen per vendor_data oder Land sperren: Prüfablauf sowie Console- und API-Routen zum Hinzufügen und Entfernen.

Blocklists verhindern, dass ein Unternehmen, das Ihre Compliance-Prüfungen nicht bestanden hat, oder ein Unternehmen mit Sitz in einem gefährlichen Land, neue Sitzungen zur Unternehmensverifizierung (KYB) durchführt oder auf Ihrer Plattform Transaktionen durchführt.

## Unterstützte Identifikatortypen für Unternehmen

| Typ | Schlüssel | Trifft zu, wenn… |
| - | - | - |
| Unternehmen | `BUSINESS` | Eine neue Sitzung oder Transaktion verwendet das gesperrte `vendor_data` |
| Land | (separat konfiguriert) | Das Land des Unternehmens stimmt mit einer Liste gefährlicher Länder überein |
| IP | `IP_ADDRESS` | Die IP-Adresse des Antragstellers (oder der CIDR-Bereich) stimmt überein |
| Geräte-Fingerprint | `DEVICE_FINGERPRINT` | Das Gerät des Antragstellers stimmt überein |
| Wallet-Adresse | `WALLET_ADDRESS` | Die mit dem Unternehmen verknüpfte Krypto-Wallet stimmt überein |
| Bankkonto | `BANK_ACCOUNT` | IBAN / Bankkonto stimmt überein |

> [!NOTE]
>
> Gesichts- und Dokument-Sperrlisten wirken auf Ebene der **einzelnen Person** (Benutzer), nicht auf Unternehmensebene. Um Geschäftsführer oder UBOs zu sperren, sperren Sie diese als Benutzer. Ihre Beteiligung an jedem Unternehmen fließt dann in die Prüfung der Schlüsselpersonen des jeweiligen Unternehmens ein.

## Wie die Sperrung erfolgt

> [!NOTE]
>
> Eine abgelehnte Sitzung zur Unternehmensverifizierung (KYB) sperrt das Unternehmen nicht. Die Sitzung endet mit `Declined`, das Unternehmen bleibt `ACTIVE`, und es wird kein Listeneintrag geschrieben. Das Sperren ist ein manueller Schritt: Fügen Sie den Eintrag über die [Sperrlistenseite](https://docs.didit.me/de/console/blocklist-users.md) oder mit der [Lists API](https://docs.didit.me/de/management-api/lists/overview.md) hinzu. Ein `BUSINESS`-Eintrag (das `vendor_data`) setzt außerdem den Status des Unternehmens auf `BLOCKED`.

**1. Automatisch: bei gefährlichem Land**

Ist das Gründungsland des Unternehmens in Ihrer konfigurierten Liste gefährlicher Länder enthalten, wird die Sitzung zur Unternehmensverifizierung (KYB) abgelehnt.

**2. Automatisch: bei sanktionierter Entität**

Ein AML-Treffer für ein Unternehmen oberhalb der Ablehnungsschwelle führt zur Ablehnung der Sitzung. Dabei wird kein Listeneintrag geschrieben. Sperren Sie das Unternehmen selbst, wenn sein `vendor_data` ab dann abgelehnt werden soll.

**3. Manuell: über die Konsole**

Ein Analyst sperrt ein Unternehmen über *Businesses → \[business] → Actions → Add to blocklist*.

**4. Programmatisch: über die Lists API**

Verwenden Sie die [Lists API](https://docs.didit.me/de/management-api/lists/overview.md), um Einträge direkt zur Sperrliste für Unternehmen hinzuzufügen.

## Gefährliche Länder

Jede Anwendung wird mit einer Standardliste **gefährlicher Länder** ausgeliefert (konfigurierbar unter *Settings → Blocklist → Countries*). Beispiele für standardmäßig enthaltene ISO-Codes: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR` (Änderungen vorbehalten; die Standardliste orientiert sich an den Empfehlungen von FATF und OFAC).

Wird ein Unternehmen mit einem passenden `country_code` angelegt:

* Wird die Sitzung zur Unternehmensverifizierung (KYB) abgelehnt.
* Es wird kein Sitzungslink ausgegeben.
* Die Unternehmensentität wird im Status `BLOCKED` angelegt.

## Unternehmen per API zur Sperrliste hinzufügen

Verwenden Sie die [Lists API](https://docs.didit.me/de/management-api/lists/overview.md), um programmatisch einen Sperrlisteneintrag hinzuzufügen:

1. [Alle Listen auflisten](https://docs.didit.me/de/management-api/lists/list.md), gefiltert nach `entry_type=business` und `is_system=true`, um die systemseitige Sperrliste für Unternehmen zu finden.
2. [Einen Eintrag erstellen](https://docs.didit.me/de/management-api/lists/create-entry.md) auf dieser Liste mit `value`, der auf das `vendor_data` des Unternehmens gesetzt ist, sowie optional `display_label` und `comment` für Audit-Zwecke.

## Durchsetzung zum Zeitpunkt der Transaktion

Gesperrte Unternehmen werden automatisch in die Transaktionsüberwachung übernommen:

* Transaktionen mit einem **auf der Sperrliste stehenden Antragstellerunternehmen** werden automatisch abgelehnt.
* Transaktionen mit einer **gesperrten Gegenpartei (Unternehmen)** werden je nach Ihrer Regelkonfiguration markiert oder abgelehnt.

Voreingestellte Regeln wie „Sanctioned counterparty“ greifen bei diesen Treffern.

## Unternehmen von der Sperrliste entfernen

* **Konsole**: *Blocklist → Businesses → row actions → Remove*.
* **API**: Verwenden Sie den Endpoint [Eintrag löschen](https://docs.didit.me/de/management-api/lists/delete-entry.md) mit der Listen-UUID und der Eintrags-UUID.

Das Entfernen ändert den `status` des Unternehmens nicht automatisch. Verwenden Sie `PATCH /v3/businesses/{vendor_data}/update-status/`, um das Unternehmen wieder auf `ACTIVE` zu setzen.

## Audit-Trail

Jedes Hinzufügen und Entfernen wird im [Audit-Log](https://docs.didit.me/de/console/audit-logs.md) protokolliert, mit:

* Akteur (Benutzer-E-Mail oder `'system'`, `'api'`).
* Zeitstempel.
* Optionalem Kommentar.
* Referenz auf die Sitzung, falls automatisch erzeugt.

## Nächste Schritte

> [card] [Lists API](https://docs.didit.me/de/management-api/lists/overview.md)
>
> Vollständige Referenz der Sperrlisten-API.

> [card] [Sperrliste in der Konsole](https://docs.didit.me/de/console/blocklist-users.md)
>
> Sperrlisten über die Oberfläche verwalten.

> [card] [Operationen](https://docs.didit.me/de/entities/businesses/operations.md)
>
> Status von Unternehmen ändern.


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