Zum Hauptinhalt springen
Dieser Leitfaden führt Sie in unter 10 Minuten durch eine vollständige Unternehmensverifizierung (KYB). Sie erstellen einen Workflow, starten eine Sitzung, senden den gehosteten Verifizierungslink an Ihren Ansprechpartner im Unternehmen, warten auf den Webhook und rufen die endgültige Entscheidung ab.

Voraussetzungen

  • Eine Didit-Anwendung mit aktiviertem KYB. Erstellen Sie bei Bedarf eine unter business.didit.me.
  • Ein API-Schlüssel aus Developer Settings → API Keys.
  • Ein aus dem Internet erreichbarer Webhook-Endpoint (für den Entscheidungs-Webhook).

Schritte

1

Einen Unternehmensverifizierungs-Workflow in der Konsole erstellen

Öffnen Sie Workflows → Create workflow. Wählen Sie als Workflow-Typ Unternehmensverifizierung (KYB) aus.Aktivieren Sie die Funktionen, die Sie benötigen:
  • Abfrage des Unternehmensregisters (erforderlich)
  • Unternehmens-AML (empfohlen)
  • Schlüsselpersonen (für die meisten regulierten Branchen erforderlich)
  • Dokumente (optional: Wählen Sie die Dokumenttypen aus, die Sie verlangen)
Speichern Sie den workflow_id und kopieren Sie ihn. Sie benötigen ihn im nächsten Schritt.
2

Eine Unternehmensverifizierungs-Sitzung (KYB) über die API erstellen

Die Antwort enthält die session_id, session_number und url, also den gehosteten Verifizierungslink, den Sie an den Ansprechpartner im Unternehmen senden. Der Workflow-Typ (KYB) kennzeichnet die Sitzung automatisch als Unternehmenssitzung.
3

Den Link an Ihren Ansprechpartner im Unternehmen senden

Senden Sie die url über Ihre eigene E-Mail oder Ihren eigenen Chat an den Unternehmensadministrator. Dieser öffnet den Link, trägt die Registerdaten ein, fügt Schlüsselpersonen und wirtschaftlich Berechtigte (UBOs) hinzu und lädt Dokumente hoch.Sie können die gehostete Nutzererfahrung mit Branding, Logo und Domain anpassen. Siehe White-Label.
4

Den Status-Webhook empfangen

Sobald das Unternehmen den Ablauf abgeschlossen hat und die KYB-Verarbeitung einen Endstatus erreicht, sendet Didit ein status.updated-Ereignis per POST an Ihren Webhook-Endpoint. Unternehmenssitzungs-Ereignisse enthalten session_kind: "business" innerhalb von data. Filtern Sie danach, um das Ereignis an Ihren KYB-Handler weiterzuleiten.Prüfen Sie die HMAC-Signatur X-Signature-V2, bevor Sie dem Ereignis vertrauen (siehe Webhooks), und lösen Sie dann Ihre nachgelagerte Logik aus. Speichern Sie das secret_shared_key des Ziels (das bei der Registrierung des Webhooks zurückgegeben wird) als DIDIT_WEBHOOK_SECRET in Ihrer .env.Beispiel-Payload:
5

Die Entscheidung abrufen (optional)

Die status.updated-Webhook-Payload enthält bereits die vollständige Entscheidung. Sie müssen diesen Endpoint nur aufrufen, wenn Sie keine Webhooks abonniert haben oder die Entscheidung später bei Bedarf abrufen möchten.
Die Entscheidung umfasst Registerdaten, Schlüsselpersonen (wirtschaftlich Berechtigte, Gesellschafter, Geschäftsführer und Vertreter), AML-Treffer, Dokumente und die Ergebnisse je Funktion. Die vollständige Payload-Referenz finden Sie im Antwortschema.
6

Auf die Entscheidung reagieren

Abhängig von status:
  • "Approved": Nehmen Sie das Unternehmen auf.
  • "Declined": Lehnen Sie ab und protokollieren Sie die warnings[]-Tags aus der Entscheidung.
  • "In Review": Warten Sie auf die Entscheidung des Prüfers. Sie erhalten einen weiteren Webhook, sobald sie feststeht.

Node.js-Beispiel

Was automatisch passiert

  • Abfrage des Unternehmensregisters in 190+ Jurisdiktionen.
  • Ermittlung der wirtschaftlich Berechtigten (UBOs) und Organmitglieder aus den Registerdaten.
  • Unternehmensbezogenes AML-Screening (Sanktionen, PEP, negative Medienberichte).
  • Personenbezogenes AML-Screening für jede identifizierte Partei.
  • Dokumenten-OCR und Dokumentenabgleich.
  • Erstellung und Aggregation von Unternehmensprofilen, wobei vendor_data als Schlüssel verwendet wird.

Nächste Schritte

Integrationsleitfaden

End-to-End-Architektur, Polling versus Webhooks, Logik für Wiederholungsversuche.

KYB-Webhooks

Jedes KYB-Ereignis und jede Payload-Struktur.

Statusangaben

Referenz für Sitzungs-, Funktions- und Registerstatus.

Antwortschema

Die vollständige KYB-Entscheidungs-Payload.

Unternehmensentitäten

Wie Profile über Sitzungen hinweg aggregiert werden.
Zuletzt geändert am 7. November 2026