Entity-Webhooks für Benutzer und Unternehmen

Jede Änderung am Status oder an den Profildaten einer Benutzer- oder Unternehmens-Entität löst einen Webhook aus, damit Ihr System in Echtzeit reagieren kann. Verwenden Sie Webhooks für Entitäten, um Profildaten zu synchronisieren, Sperren an andere Systeme weiterzugeben oder nachgelagerte Compliance-Prozesse auszulösen.

Ereigniskatalog

Ereignis	Auslöser
`user.status.updated`	Der Status einer Benutzer-Entität ändert sich (`ACTIVE` ↔ `FLAGGED` ↔ `BLOCKED`)
`user.data.updated`	Die Profilfelder einer Benutzer-Entität ändern sich (Name, Geburtsdatum, Porträt, Summenzähler, Metadaten)
`business.status.updated`	Der Status einer Unternehmens-Entität ändert sich
`business.data.updated`	Die Profilfelder einer Unternehmens-Entität ändern sich (rechtlicher Name, Registernummer, Land, Zähler)

activity.created wird in subscribed_events akzeptiert und ist im Try Webhook-Tester enthalten, aber Didit liefert es derzeit nicht für den Live-Datenverkehr aus. Implementieren Sie darauf basierend keine Spiegelung der Zeitleiste.

Didit sendet außerdem Sitzungs-, Transaktions- und Unternehmenssitzungsereignisse, die auf Entitätsfelder verweisen. Siehe:

KYB-Webhooks: Unternehmenssitzungsereignisse
Transaction-Monitoring-Webhooks: Transaktionsereignisse
Webhook-Referenz: Signaturprüfung, Wiederholungen, Ziele

Payload-Strukturen

Webhooks für Entitäten sind flach: Es gibt keinen data-Wrapper und keinen event-Schlüssel. Lesen Sie webhook_type, um das Ereignis zuzuordnen.

{
  "event_id": "7f3c2c1e-6a1d-4c36-9d8e-0d3b5f4e2a10",
  "webhook_type": "user.status.updated",
  "timestamp": 1776333600,
  "created_at": 1776333594,
  "application_id": "0c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "environment": "live",
  "vendor_user_id": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "vendor_data": "user-42",
  "status": "BLOCKED",
  "previous_status": "ACTIVE"
}

Feld	Beschreibung
`vendor_user_id` / `vendor_business_id`	Die Kennung von Didit für die Entität. `business.*`-Ereignisse verwenden `vendor_business_id`.
`vendor_data`	Ihre Kennung für die Entität.
`status`	`ACTIVE`, `FLAGGED` oder `BLOCKED`.
`previous_status`	Nur bei `*.status.updated`.
`changed_fields` und `changes`	Nur bei `*.data.updated`.
`created_at`	Unix-Sekunden zum Zeitpunkt der letzten Aktualisierung der Entität.
`timestamp`	Unix-Sekunden, zu denen Didit den Webhook versendet hat.

`user.status.updated` / `business.status.updated`

Wird bei jeder Statusänderung ausgelöst. Der Payload enthält status und previous_status. Sie gibt keinen Grund für die Statusänderung an: Öffnen Sie die Entität in der Konsole, wenn Sie die Ursache benötigen.

`user.data.updated` / `business.data.updated`

Wird ausgelöst, wenn sich Profilfelder ändern. changed_fields listet die geänderten Felder auf, und changes enthält für jedes Feld den previous- und den current-Wert.

{
  "event_id": "5d1e8f9a-0c32-4b6a-a7b6-2b9d6f0a3c41",
  "webhook_type": "user.data.updated",
  "timestamp": 1776333700,
  "created_at": 1776333694,
  "application_id": "0c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "environment": "live",
  "vendor_user_id": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "vendor_data": "user-42",
  "status": "ACTIVE",
  "changed_fields": ["full_name", "session_count"],
  "changes": {
    "full_name": { "previous": null, "current": "John Doe" },
    "session_count": { "previous": 2, "current": 3 }
  }
}

Folgende Felder können in changed_fields auftreten:

Benutzer: vendor_data, display_name, full_name, date_of_birth, metadata, portrait_image, issuing_states, approved_emails, approved_phones, features, session_count, approved_count, declined_count, in_review_count, first_session_at, last_session_at.
Unternehmen: vendor_data, display_name, metadata, legal_name, registration_number, country_code, session_count, approved_count, declined_count, in_review_count, features, first_session_at, last_session_at.

Verwenden Sie changed_fields und changes, um nur die geänderten Felder zu synchronisieren.

Zustellung, Wiederholungen und Signatur

Alle Webhooks für Entitäten folgen dem standardmäßigen Zustellungsvertrag:

Signiert mit HMAC-SHA256 im X-Signature-V2-Header (empfohlen), mit dem secret_shared_key des Ziels. X-Signature und das veraltete X-Signature-Simple werden ebenfalls gesendet, zusammen mit X-Timestamp.
Mit bis zu 2 Wiederholungsversuchen, nach etwa 1 Minute und etwa 4 Minuten, wenn Ihr Endpoint mit 5xx oder 404 antwortet, eine Zeitüberschreitung auftritt oder keine Verbindung hergestellt werden kann. Die Webhook-Referenz enthält die vollständige Richtlinie.
Idempotenz: Jeder Webhook hat eine eindeutige event_id im Payload. Filtern Sie Duplikate auf Ihrer Seite heraus.

Siehe Webhook-Referenz für die Einrichtung von Zielen und Codebeispiele zur Signaturprüfung.

curl -X POST https://verification.didit.me/v3/webhook/destinations/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Entity sync",
    "url": "https://yourapp.com/webhooks/didit",
    "subscribed_events": [
      "user.status.updated",
      "user.data.updated",
      "business.status.updated",
      "business.data.updated"
    ]
  }'

Nächste Schritte

Webhook-Referenz

Ziele, Signaturen, Wiederholungen und Verifizierung.

Ziel anlegen

Registrieren Sie einen neuen Webhook-Endpoint.

Benutzeroperationen

Änderungen, die Benutzer-Webhooks auslösen.

Übersicht

Preise

Workflows & Verifizierung

Prüfung & Betrieb

Entitäten (Benutzer & Unternehmen)

Einstellungen & Anpassung

Sicherheit & Compliance

Didit Academy

Ressourcen

Entity-Webhooks für Benutzer und Unternehmen

Ereigniskatalog

Payload-Strukturen

`user.status.updated` / `business.status.updated`

`user.data.updated` / `business.data.updated`

Zustellung, Wiederholungen und Signatur

Abonnieren

Nächste Schritte

Webhook-Referenz

Ziel anlegen

Benutzeroperationen

​Ereigniskatalog

​Payload-Strukturen

​user.status.updated / business.status.updated

​user.data.updated / business.data.updated

​Zustellung, Wiederholungen und Signatur

​Abonnieren

​Nächste Schritte

Webhook-Referenz

Ziel anlegen

Benutzeroperationen

Ereigniskatalog

Payload-Strukturen

`user.status.updated` / `business.status.updated`

`user.data.updated` / `business.data.updated`

Zustellung, Wiederholungen und Signatur

Abonnieren

Nächste Schritte