KYB-Statuswerte-Referenz: Sitzung, Funktionen & AML

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.

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

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

Nächste Schritte

Antwortschema

Wo jeder Status in der Payload erscheint.

Risikobewertung

Was ein KYB-Ergebnis bestimmt.

Webhooks

Ereignisse, die bei Statusänderungen ausgelöst werden.

Erste Schritte

Funktionen

Unternehmensprofile

Referenz

Konsole

KYB-Statuswerte-Referenz: Sitzung, Funktionen & AML

Sitzungsstatus

Funktionsstatus

Namen der KYB-Funktionen

Registerstatus (vom Anbieter)

Verifizierungsstatus des Unternehmens

Abrufstatus des Unternehmens

AML-Verifizierungsstatus

Wie eine Entscheidung ihre Begründung darlegt

Nächste Schritte

Antwortschema

Risikobewertung

Webhooks

​Sitzungsstatus

​Funktionsstatus

​Namen der KYB-Funktionen

​Registerstatus (vom Anbieter)

​Verifizierungsstatus des Unternehmens

​Abrufstatus des Unternehmens

​AML-Verifizierungsstatus

​Wie eine Entscheidung ihre Begründung darlegt

​Nächste Schritte

Antwortschema

Risikobewertung

Webhooks

Sitzungsstatus

Funktionsstatus

Namen der KYB-Funktionen

Registerstatus (vom Anbieter)

Verifizierungsstatus des Unternehmens

Abrufstatus des Unternehmens

AML-Verifizierungsstatus

Wie eine Entscheidung ihre Begründung darlegt

Nächste Schritte