Fonctionnement des SetupIntents
Découvrez comment les SetupIntents fonctionnent dans le tunnel de paiement.
Les tunnels de paiement asynchrones peuvent être complexes à gérer, car ils dépendent d’interactions avec les clients qui se déroulent en dehors de votre application. Les PaymentIntents et les SetupIntents en simplifient la gestion en vous permettant de suivre l’état du processus.
Lorsque le SetupIntent est créé, son état est requires_1 jusqu’à ce qu’un moyen de paiement soit associé.
Une fois que le client a fourni ses informations de paiement, le SetupIntent peut être confirmé.
Dans la plupart des intégrations, cet état est ignoré parce que l’information sur le moyen de paiement est soumise au moment de la confirmation du SetupIntent.
Si la configuration nécessite des actions supplémentaires, telles que l’authentification avec 3D Secure , l’état du SetupIntent est requires_1.
Une fois les actions nécessaires effectuées, le SetupIntent passe à l’état processing. Si certains moyens de paiement (notamment les cartes bancaires) sont généralement traités rapidement, d’autres peuvent nécessiter plusieurs jours.
Si l’état d’un SetupIntent indique qu’il est succeeded (réussi), cela signifie que la configuration a réussi.
Vous pouvez maintenant associer ce moyen de paiement à un objet Customer et l’utiliser lors de paiements futurs.
Si la configuration échoue, le SetupIntent repasse à l’état requires_.
Vous pouvez annuler un SetupIntent à tout moment avant que son état passe à processing ou succeeded.
1 Les versions de l’API antérieures au 11-02-2019 affichaient requires_ au lieu de requires_ et requires_ au lieu de requires_.