So funktionieren Sitzungen
Alles über den Status und Lebenszyklus von VerificationSessions.
Asynchrone Verifizierungsabläufe sind nicht einfach zu verwalten, da sie von Kundeninteraktionen abhängig sind, die sich außerhalb Ihrer Anwendung abspielen. VerificationSessions vereinfachen dies, indem sie den Status des Verifizierungsablaufs verfolgen.
Wenn die VerificationSession erstellt wird, befindet sie sich im Status requires_ und wartet darauf, dass Ihr/e Nutzer/in den Verifizierungsvorgang startet. Wir empfehlen, die VerificationSession direkt vor dem Start des Verifizierungsvorgangs zu erstellen.
Sobald der/die Nutzer/in die Sitzung übermittelt, wechselt die VerificationSession zu processing. Die meisten Verifizierungsprüfungen werden in weniger als 1 Minute abgewickelt.
Eine VerificationSession mit dem Status verified bedeutet, dass der Verifizierungsablauf abgeschlossen ist. Die Verarbeitung aller Verifizierungsprüfungen ist abgeschlossen und alle wurden erfolgreich verifiziert.
Wenn eine der Verifizierungsprüfungen fehlschlägt (zum Beispiel aufgrund eines manipulierten Dokuments), wechselt der Status der VerificationSession wieder zu requires_. Eine Erklärung für den Verifizierungsfehler finden Sie im Feld last_ der Sitzung. Wenn Sie möchten, dass Ihre Nutzer/innen erneut versuchen, sich zu verifizieren, müssen Sie die VerificationSession abrufen, um eine neue URL oder ein neues Client-Geheimnis zu erhalten. Im Feld provided_ angegebene Details werden Ihrem Nutzer/Ihrer Nutzerin möglicherweise angezeigt.
Sie können eine VerificationSession jederzeit abbrechen, bevor sie den Status processing oder verified annimmt. Dadurch wird die VerificationSession für zukünftige Übermittlungsversuche ungültig und dies kann nicht rückgängig gemacht werden.
Sitzungsereignisse
Jedes Mal, wenn sich der Status einer Sitzung ändert, werden Ereignisse erstellt. Hier ist eine vollständige Liste der Ereignistypen in einer VerificationSession:
| Ereignistyp | Beschreibung |
|---|---|
identity. | Die Sitzung wurde erstellt. |
identity. | Der/die Nutzer/in hat seine/ihre Informationen erfolgreich übermittelt und die Verifizierungsprüfungen wurden gestartet. |
identity. | Die Verarbeitung aller Verifizierungsprüfungen ist abgeschlossen, und alle waren erfolgreich. |
identity. | Die Verarbeitung aller Verifizierungsprüfungen ist abgeschlossen, und mindestens eine dieser Prüfungen ist fehlgeschlagen. |
identity. | Die Sitzung wurde abgebrochen und zukünftige Übermittlungsversuche wurden deaktiviert. Dieses Ereignis wird gesendet, wenn eine Sitzung abgebrochen oder entfernt wird. |
identity. | Die Sitzung wurde entfernt. Um darauf zuzugreifen, müssen Sie einen Webhook-Endpoint erstellen, der diesen Ereignistyp ausdrücklich abonniert. Webhook-Endpoints, die alle Ereignisse abonnieren, enthalten diesen Ereignistyp nicht. |
In Reaktion auf bestimmte Ereignisse möchten Sie gegebenenfalls bestimmte Aktionen ausführen, wie eine E-Mail an eine/n Nutzer/in senden, wenn eine Verifizierung erfolgreich ist oder fehlschlägt.
Stripe empfiehlt, dass Sie mit Webhooks nach entsprechenden Ereignissen Ausschau halten.