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

# KYB-Statuswerte-Referenz: Sitzung, Funktionen & AML

> Didit KYB-Statuswerte: exakte Codes für Sitzungen, Funktionen, Register- und AML-Prüfungen. Ab $2.00 pro Check, nach Land und Tarif.

Business Verification verfolgt den Status auf mehreren Ebenen: die **Sitzung**, einzelne **Funktionen**, die **Registerabfrage** und das **AML-Ergebnis**. Diese Seite ist das Referenzdokument für jeden Status.

Die API gibt Statuswerte als exakte Bezeichnungen zurück, bei denen Groß- und Kleinschreibung zählt, etwa `"In Progress"` und `"Not Finished"`. Dieselben Zeichenfolgen übermitteln auch Webhooks. Gleichen Sie anhand dieser Zeichenfolgen ab und nicht anhand von Namen in Großbuchstaben.

## Sitzungsstatus

Der Gesamtstatus einer Sitzung der Unternehmensverifizierung (KYB), das Feld, das Sie am häufigsten für Verzweigungen verwenden.

| Status | Bedeutung |
| - | - |
| `"Not Started"` | Sitzung erstellt, das Unternehmen hat den gehosteten Link noch nicht geöffnet. |
| `"In Progress"` | Der gehostete Ablauf ist aktiv: Registerabfragen, Dokumenten-Uploads oder AML-Screening laufen. |
| `"Awaiting User"` | Es wird auf eine Aktion des Endbenutzers gewartet, typischerweise die Einreichung der Schlüsselpersonen oder die Antwort auf eine Aufforderung zur erneuten Einreichung. Der Status wechselt automatisch, sobald der Benutzer die ausstehende Aktion abgeschlossen hat. |
| `"Approved"` | Alle erforderlichen Funktionen waren erfolgreich. Das Unternehmen ist verifiziert. |
| `"Declined"` | Eine kritische Prüfung ist fehlgeschlagen (aufgelöstes Unternehmen, sanktionierte Einheit, auf der Sperrliste geführte Einheit) oder eine Workflow-Regel hat die Sitzung abgelehnt. |
| `"In Review"` | Eine oder mehrere Funktionen erfordern eine manuelle Prüfung durch einen Analysten. |
| `"Resubmitted"` | Eine zuvor abgelehnte Sitzung oder eine Sitzung, für die eine erneute Einreichung angefordert wurde, wurde mit aktualisierten Daten erneut eingereicht. |
| `"Abandoned"` | Das Unternehmen hat den Ablauf nie abgeschlossen (Zeitüberschreitung). |
| `"Expired"` | Die Sitzung ist abgelaufen, bevor das Unternehmen sie abgeschlossen hat. |

> [!NOTE]
>
> `"Awaiting User"` ist vorübergehend. Sie müssen Sitzungen nicht manuell aus diesem Status herausführen. Sobald der Endbenutzer die ausstehende Aktion abschließt (etwa die Liste der Schlüsselpersonen einreicht oder ein angefordertes Dokument erneut hochlädt), bewertet Didit die Sitzung neu und setzt sie automatisch auf `"In Review"`, `"Approved"` oder `"Declined"`, je nach Ergebnis.

## Funktionsstatus

Jede KYB-Funktion hat einen eigenen Status, der in den Sitzungsstatus einfließt.

| Status | Bedeutung |
| - | - |
| `"Not Finished"` | Die Funktion wurde noch nicht gestartet oder läuft gerade. |
| `"Approved"` | Die Funktion war erfolgreich. |
| `"Declined"` | Die Funktion ist fehlgeschlagen (kritisch). |
| `"In Review"` | Die Funktion erfordert die Aufmerksamkeit eines Analysten. |
| `"Resub Requested"` | Das Unternehmen muss für diese Funktion erneut Daten einreichen, etwa indem ein Dokument erneut hochgeladen wird. |
| `"Awaiting User"` | Die Funktion wartet auf eine Aktion des Endbenutzers. Gilt für die Funktion für Schlüsselpersonen, solange der Benutzer die beteiligten Personen einreichen muss. Der Status wechselt automatisch bei der Einreichung. |

### Namen der KYB-Funktionen

Dies sind die Werte von `features` in einer KYB-Sitzung und in Webhooks:

* `KYB_REGISTRY`: Abfrage des Unternehmensregisters.
* `AML`: AML-Screening auf Unternehmensebene.
* `KYB_DOCUMENTS`: Erfassung und OCR von Dokumenten.
* `KYB_KEY_PEOPLE`: Schlüsselpersonen, also UBOs, Gesellschafter, Geschäftsführer, Vertreter und sonstige Organmitglieder.

## Registerstatus (vom Anbieter)

Der offizielle Status des Unternehmens, wie er aus maßgeblichen Registerquellen abgerufen wird. Er spiegelt den rechtlichen oder aufsichtsrechtlichen Status der Einheit wider, wie ihn das Register der jeweiligen Jurisdiktion meldet. Die genauen Werte variieren deshalb je nach Quelle. Er wird innerhalb der KYB-Entscheidung unter `company.registry_status` ausgegeben.

| Status | Bedeutung |
| - | - |
| `ACTIVE` | Das Unternehmen ist aktiv und rechtlich ordnungsgemäß. |
| `DISSOLVED` | Das Unternehmen wurde aufgelöst. |
| `DEREGISTERED` | Das Unternehmen wurde aus dem Register gestrichen. |
| `STRUCK_OFF` | Das Unternehmen wurde aus dem Register entfernt. |
| `CLOSED` | Das Unternehmen wurde geschlossen. |
| `INACTIVE` | Das Unternehmen ist inaktiv (ohne Geschäftstätigkeit). |
| `AUTHORISED` | Zugelassen (typischerweise für regulierte Unternehmen). |
| `APPOINTED_REPRESENTATIVE` | Beauftragter Vertreter einer anderen zugelassenen Firma. |
| `UNAUTHORISED` | Früher zugelassen, jetzt nicht mehr zugelassen. |
| `NO_LONGER_AUTHORISED` | Zulassung widerrufen. |
| `SEE_FULL_DETAILS` | Der Status erfordert eine manuelle Prüfung. |

> [!NOTE]
>
> Da `registry_status` die unverarbeiteten Registerwerte wiedergibt, verwenden Sie `verification_status` weiter unten, wenn Sie einen einheitlichen Indikator über alle Länder hinweg benötigen, mit dem Sie die Produktlogik steuern.

## Verifizierungsstatus des Unternehmens

Ein standardisierter, geschäftsorientierter Status für jedes Unternehmensergebnis. Er normalisiert die unterschiedlichen Register- und Unternehmensstatus verschiedener Länder und Quellen zu einem einheitlichen Indikator, den Sie direkt in Ihrem Produkt auswerten können. Er wird innerhalb der KYB-Entscheidung unter `company.verification_status` ausgegeben.

| Status | Bedeutung |
| - | - |
| `verified` | Das Unternehmen erscheint als aktiv und gültig. |
| `failed` | Das Unternehmen erscheint als inaktiv oder aufgelöst, oder es wurden Probleme festgestellt. |
| `unknown` | Die Informationen reichen nicht aus, oder der Status ist nicht eindeutig. |

## Abrufstatus des Unternehmens

Zeigt den Fortschritt beim Abrufen der Daten für einen bestimmten Unternehmensdatensatz aus externen oder amtlichen Registern an. Verwenden Sie ihn, um festzustellen, wie vollständig die abgerufenen Informationen für ein bestimmtes Unternehmen sind. Er wird innerhalb der KYB-Entscheidung unter `company.fetch_status` ausgegeben.

| Status | Bedeutung |
| - | - |
| `pending` | Zu diesem Zeitpunkt wurden nur teilweise oder grundlegende Unternehmensinformationen abgerufen. |
| `resolved` | Vollständige Unternehmensdaten wurden erfolgreich aus amtlichen Quellen abgerufen. |

## AML-Verifizierungsstatus

Wird für jedes Screening eines Unternehmens oder einer Person zurückgegeben.

| Status | Bedeutung |
| - | - |
| `"Approved"` | Keine Treffer über dem Schwellenwert. |
| `"Declined"` | Treffer mit hohem Schweregrad (bestätigte Sanktion oder PEP-Übereinstimmung). |
| `"In Review"` | Ein Treffer wurde gefunden, der eine manuelle Prüfung durch einen Analysten erfordert. |
| `"Not Finished"` | Das Screening ist noch nicht abgeschlossen. |

## Wie eine Entscheidung ihre Begründung darlegt

Die KYB-Entscheidung enthält keinen einzelnen Begründungscode als Zeichenkette.
Jedes Funktions-Array (`registry_checks[]`, `document_verifications[]`, `key_people_checks[]`, `aml_screenings[]`) enthält `warnings[]` mit `KYB_*`- und AML-Tags, und `decision_trace` zeigt, wie die Entscheidung zustande kam.
Lesen Sie die Tags in den [KYB-Warnungen](https://docs.didit.me/de/business-verification/warnings.md) und protokollieren Sie sie zusammen mit dem Sitzungsstatus.

Wenn ein Prüfer den Status manuell entgegen der plattformeigenen Aggregation festlegt, enthält die Entscheidung `status_override` mit dem Zeitpunkt `overridden_at` und dem `automatic_status`, den die Plattform gesetzt hätte.
Siehe das [Antwortschema](https://docs.didit.me/de/business-verification/response-schema.md).

## Nächste Schritte

> [card] [Antwortschema](https://docs.didit.me/de/business-verification/response-schema.md)
>
> Wo jeder Status in der Payload erscheint.

> [card] [Risikobewertung](https://docs.didit.me/de/business-verification/risk-assessment.md)
>
> Was ein KYB-Ergebnis bestimmt.

> [card] [Webhooks](https://docs.didit.me/de/business-verification/webhooks.md)
>
> Ereignisse, die bei Statusänderungen ausgelöst werden.


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