L'API Setup Intents

Découvrez comment enregistrer des moyens de paiement avec l'API Setup Intents.

Vous pouvez utiliser l’API Setup Intents pour configurer un moyen de paiement pour les paiements ultérieurs. Cela fonctionne comme un paiement, mais aucun montant n’est débité. Configurer un moyen de paiement pour les paiements ultérieurs.

Cela permet d’enregistrer des identifiants de paiement et d’optimiser les paiements futurs. Ainsi, quel que soit le scénario, le moyen de paiement est configuré. Par exemple, lorsque vous configurez une carte, il peut être nécessaire d’authentifier le client ou de vérifier la validité de sa carte auprès de l’institution financière émettrice. Stripe met à jour l’objet SetupIntent tout au long de ce processus.

Interface utilisateur qui recueille les informations de la carte sans débiter la carte

Enregistrer et réutiliser des moyens de paiement

L’API Setup Intents est utile aux entreprises qui inscrivent des clients sans les débiter immédiatement :

Une entreprise de location de voitures qui collecte les informations de moyen de paiement avant la location et débite la carte de son client à la fin de la période de location
Un site Web de financement participatif qui collecte les informations de carte pour les débiter uniquement une fois l’objectif de la campagne atteint
Un fournisseur d’électricité qui prélève un montant différent chaque mois en fonction du niveau de consommation, mais recueille les informations de paiement SEPA avant le premier mois de paiement

Remarques

Vous pouvez également configurer des moyens de paiement pour les utiliser ultérieurement avec Checkout.

Démarrer

Obtenir l’autorisation d’enregistrer un moyen de paiement

Conformité

Vous êtes responsable de votre conformité à toutes les lois, réglementations et règles de réseau applicables lorsque vous enregistrez les éléments qui définissent le paiement d’un client. Si vous configurez un moyen de paiement pour des paiements futurs en session, par exemple en affichant le moyen de paiement dans une future page de paiement, assurez-vous de recueillir explicitement le consentement du client pour cette utilisation spécifique. Par exemple, incluez une case à cocher « Enregistrer mon moyen de paiement pour une utilisation ultérieure » pour recueillir le consentement du client. Si vous devez faire la distinction entre les moyens de paiement enregistrés uniquement pour les utilisations hors ligne et les moyens de paiement que vous pouvez présenter à votre client pour de futurs achats en session, vous pourrez utiliser le paramètre allow_redisplay de l’objet PaymentMethod.

Pour configurer un moyen de paiement en vue de paiements futurs hors session, vous devez obtenir l’autorisation de votre client. En établissant au préalable un contrat (parfois appelé mandat), vous pouvez débiter votre client quand il n’utilise pas activement votre site Web ou votre application.

Ajoutez à votre application ou votre site des conditions précisant comment seront effectués les paiements, et invitez vos clients à y adhérer. Vos conditions doivent au minimum comporter les éléments suivants :

Le consentement du client vous autorisant à prélever un paiement ou une série de paiements en son nom
La fréquence prévue des paiements (c’est-à-dire ponctuel ou récurrents)
La façon dont vous déterminez le montant du paiement

Consultez le texte de mandat recommandé pour l’enregistrement des cartes ou l’enregistrement des coordonnées bancaires SEPA.

Pour les utilisateurs concernés par l’authentification forte du client (SCA), ce contrat vous aidera à effectuer les paiements sans interruption. Lorsque vous aurez configuré votre intégration pour l’enregistrement d’une carte, Stripe marquera tous les nouveaux paiements hors session comme transactions effectuées par le marchand (MIT), de sorte que vos clients n’auront pas besoin de se connecter et de s’authentifier. Les transactions effectuées par le marchand nécessitent d’établir un contrat entre votre client et vous.

Définir l’utilisation pour améliorer votre taux de réussite

Le paramètre d’utilisation indique à Stripe comment vous prévoyez utiliser les informations de moyen de paiement ultérieurement. Pour certains moyens de paiement, Stripe peut utiliser votre paramètre usage pour choisir le flux le plus fluide pour le client. L’objectif de cette optimisation est d’augmenter le nombre de paiements réussis.

Par exemple, la réglementation européenne en matière d’authentification forte du client peut nécessiter une authentification du client lors du processus d’enregistrement de carte bancaire. Lorsque vous définissez le paramètre usage sur off_session, cela permet d’authentifier correctement une carte bancaire en vue de paiements hors session, sans que votre client ait besoin de se connecter et s’authentifier à nouveau. Bien que cela engendre une complexité initiale lors du flux de configuration, définir le paramètre usage sur off_session permet de diminuer les interventions des clients pour les paiements hors session ultérieurs.

Toutefois, si vous ne comptez utiliser une carte bancaire qu’au moment du paiement par le client, définissez le paramètre usage sur on_session. De cette manière, l’institution financière saura que vous ne comptez utiliser la carte que lorsque le client est prêt à s’authentifier. Vous pouvez donc différer l’authentification des informations de carte jusqu’au moment du paiement et ainsi éviter toute perturbation en amont.

Utilisation prévue de la carte	Valeur d’énumération d’utilisation à utiliser
Paiements effectués pendant une session uniquement	`on_session`
Paiements effectués hors session uniquement	`off_session` (par défaut)
Paiements effectués pendant une session ou hors session	`off_session` (par défaut)

Le paramètre usage est un paramètre d’optimisation. Vous pouvez également utiliser une carte configurée pour les paiements pendant une session pour effectuer des paiements hors session, mais dans ce cas, l’institution financière risque davantage d’exiger une authentification du client et de rejeter le paiement. Dans les deux cas, une authentification ultérieure peut être nécessaire, alors développez un processus de récupération dans votre application. Lorsqu’une carte hors session exige une authentification du client, demandez à votre client de se reconnecter pour finaliser le paiement.

En l’absence de précision, le paramètre usage est défini sur off_session par défaut. Voyez comment créer un SetupIntent et définir le paramètre usage sur votre serveur ci-dessous :

Remarques

Suivez les conseils de cette page pour développer une intégration capable de gérer les cartes nécessitant une authentification forte du client. Un bon signalement des transactions permet à Stripe de demander les exemptions à la SCA appropriées en votre nom et ainsi d’éviter d’avoir à authentifier chaque paiement.