Ereignistypen
Webhook-Payloads beschreiben einen Zustandsübergang eines Prozesses. Diese Seite dokumentiert das Payload-Schema und die vollständige Aufzählung der lastEvent-Werte.
Payload-Schema
| Feld | Typ | Beschreibung |
|---|---|---|
processId | string (UUID) | ID der Transaktion. |
state | string | Aktueller Zustand der Transaktion. Derzeit: PROCESS_STATE_FINISHED. |
result | string | Ergebnis des abgeschlossenen Prozesses. Vorhanden, wenn state=PROCESS_STATE_FINISHED. Mögliche Werte: ok, expired, invalid_identity. |
flow | string | Flow, der für diese Transaktion ausgeführt wurde (z. B. id, idtoken). |
lastEvent | string | Letztes Ereignis der Transaktion. Wird nur zurückgegeben, wenn result=expired. |
lastEventDescription | string | Menschenlesbare Beschreibung von lastEvent. Wird nur zurückgegeben, wenn result=expired. |
Das Feld state in Webhook-Payloads verwendet das Präfix PROCESS_STATE_*. Dies ist ein eigenständiges Vokabular, das sich von den Feldern result und status unterscheidet, die vom GetProcess-Endpunkt zurückgegeben werden und PROCESS_RESULT_* verwenden. Behandeln Sie diese nicht als austauschbar.
Beispiel-Payload
Abgeschlossen — erfolgreich
{
"processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",
"state": "PROCESS_STATE_FINISHED",
"flow": "id",
"result": "ok"
}
Abgeschlossen — abgelaufen
{
"processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",
"state": "PROCESS_STATE_FINISHED",
"flow": "id",
"result": "expired",
"lastEvent": "EVENT_TYPE_SESSION_ENDED",
"lastEventDescription": "Session ended by timeout or by new session created"
}
Aufzählung von lastEvent
Die vollständige Liste der Werte, die in lastEvent erscheinen können:
| Ereignis | Beschreibung |
|---|---|
EVENT_TYPE_PROCESS_CREATED | Prozess erstellt |
EVENT_TYPE_QR_CODE_READ | QR-Code wurde gelesen |
EVENT_TYPE_PROCESS_STARTED_BY_USER | Prozess vom Benutzer gestartet |
EVENT_TYPE_IDENTITY_VALIDATION_STEP_FINISHED | Schritt zur Identitätsvalidierung abgeschlossen |
EVENT_TYPE_DOCUMENT_STEP_STARTED | Dokumentenschritt wurde gestartet |
EVENT_TYPE_DOCUMENT_PHOTO_CAPTURED | Foto des Dokuments aufgenommen |
EVENT_TYPE_DOCUMENT_UPLOADED_FROM_GALLERY | Dokument aus der Galerie hochgeladen |
EVENT_TYPE_DOCUMENT_STEP_FINISHED | Dokumentenschritt abgeschlossen |
EVENT_TYPE_SESSION_ENDED | Sitzung durch Timeout oder durch eine neue Sitzung beendet |
EVENT_TYPE_ERROR_ON_DOCUMENT_STEP | Fehler beim Dokumentenschritt |
Die Menge der Ereignisse kann sich weiterentwickeln. Behandeln Sie die Ereignisse, auf die Ihr Endpunkt reagiert, als Konfiguration und nicht als hartcodierte Konstanten — so können neue Ereignisse ohne ein Deployment aktiviert werden.
Vollständiges Prozessergebnis abrufen
Der Webhook-Payload signalisiert, dass ein Prozess abgeschlossen wurde, und enthält das übergeordnete Ergebnis im Feld result. Um die vollständigen Details abzurufen — Erfassungsdaten, biometrische Werte, Dokumentenfelder usw. — rufen Sie den entsprechenden GetProcess-Endpunkt auf:
- Für visuelle / Web & Nativ-Abläufe: siehe API-Referenz > Web & Nativ > GET /v1/process/{id}.
- Für nicht-visuelle / API-Abläufe: siehe API-Referenz > API > GET /processes/v1/{id}.