Fonctionnement des sessions
Découvrez les différents états et le cycle de vie des VerificationSessions.
Les flux de vérification asynchrones sont complexes à gérer, car ils reposent sur les interactions des clients qui ont lieu en dehors de votre application. Les VerificationSessions simplifient ce processus en assurant le suivi de l’état des flux de vérification.
Lors de sa création, la VerificationSession présente l’état requires_ et elle est prête à ce que l’utilisateur commence le processus de vérification. Il est recommandé de créer la VerificationSession juste avant le démarrage du flux de vérification.
Dès que l’utilisateur soumet la session, l’état de la VerificationSession passe à processing. La plupart des contrôles de vérification sont traités en moins de 1 minute.
Lorsqu’une VerificationSession affiche l’état verified, cela signifie que le flux de vérification est terminé. Le traitement de tous les contrôles de vérification a pris fin avec succès.
En cas d’échec de l’un des contrôles de vérification (par exemple, à cause d’un document falsifié), la VerificationSession revient à l’état requires_. Le champ last_ de la session fournit une explication de l’échec de la vérification. Si vous souhaitez que l’utilisateur se soumette à une seconde tentative de vérification, vous devez récupérer la VerificationSession pour obtenir une autre URL ou une autre clé secrète du client. Les détails fournis dans le champ provided_ peuvent être visibles par l’utilisateur.
Vous pouvez annuler une VerificationSession à tout moment avant qu’elle ne passe à l’état processing ou verified. Cette action invalide la VerificationSession pour les tentatives de soumission ultérieures, et elle ne peut être annulée.
Événements de session
Les événements sont créés lorsqu’une session change d’état. Voici la liste complète des types d’événement d’une VerificationSession :
| Type d’événement | Description |
|---|---|
identity. | La session a été créée. |
identity. | L’utilisateur a correctement communiqué ses informations et les contrôles de vérification sont en cours de traitement. |
identity. | Le traitement de tous les contrôles de vérification est terminé. La vérification a été effectuée avec succès. |
identity. | Le traitement de tous les contrôles de vérification est terminé, et au moins un des contrôles a échoué. |
identity. | La session a été annulée et les futures tentatives de soumission ont été désactivées. Cet événement est envoyé lorsqu’une session est annulée ou expurgée. |
identity. | La session a été expurgée. Vous devez créer un endpoint de webhook qui s’abonne explicitement à ce type d’événement pour y accéder. Les endpoints de webhook qui s’abonnent à tous les événements n’incluent pas ce type d’événement. |
Il est conseillé d’agir en fonction de certains événements, notamment en envoyant un e-mail à l’utilisateur en cas d’échec ou de succès de la vérification.
Stripe vous recommande d’écouter les événements à l’aide de webhooks.