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)
workflow_id und kopieren Sie ihn. Sie benötigen ihn im nächsten Schritt.2
Eine Unternehmensverifizierungs-Sitzung (KYB) über die API erstellen
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.6
Auf die Entscheidung reagieren
Abhängig von
status:"Approved": Nehmen Sie das Unternehmen auf."Declined": Lehnen Sie ab und protokollieren Sie diewarnings[]-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_dataals 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.