API Setup Intents

Comment enregistrer des moyens de paiement avec l'API Setup Intents.

Vous pouvez utiliser l’API Setup Intents pour configurer un moyen de paiement en vue de paiements ultérieurs. Cela fonctionne comme un paiement, à ceci près qu’aucun montant n’est débité. Configurer un moyen de paiement en vue de paiements futurs.

L’objectif est de disposer d’identifiants de paiement enregistrés et optimisés pour les futurs paiements. Ainsi, quel que soit le scénario, le moyen de paiement sera correctement configuré. Par exemple, lorsque vous configurez une carte bancaire, il peut être nécessaire d’authentifier le client ou de vérifier la validité de sa carte auprès de la banque é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 accueillent des clients sans les débiter immédiatement :

Une société de location de voitures qui collecte les données du moyen de paiement du client avant que ne débute la période de location et qui débite sa carte bancaire au terme de la période de location
Un site Web de financement participatif qui collecte des données de cartes bancaires pour les débiter uniquement une fois l’objectif de la campagne atteint
Un fournisseur d’eau et d’énergie qui prélève un montant différent chaque mois en fonction du niveau de consommation, mais collecte les informations de paiement SEPA avant le premier mois d’abonnement

Remarque

Vous pouvez également configurer des moyens de paiement pour utilisation ultérieure avec Checkout.

Démarrer

Obtenir l’autorisation d’enregistrer un moyen de paiement

Conformité

Lorsque vous enregistrez les informations de paiement d’un client, vous êtes responsable du respect de l’ensemble des lois, réglementations et règles du réseau en vigueur. Si vous configurez un moyen de paiement pour de futurs paiements en session, par exemple en affichant le moyen de paiement sur 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 intitulée « Enregistrer mon moyen de paiement pour une utilisation ultérieure » pour recueillir le consentement. 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 pouvez utiliser le paramètre allow_redisplay de l’objet PaymentMethod.

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

Sur votre application ou votre site, précisez les conditions dans lesquelles s’effectuera le traitement des paiements et invitez vos clients à adhérer à ces dispositions. Donnez-vous a minima pour objectif :

Le consentement du client vous autorisant à déclencher un paiement ou une série de paiements en son nom
Fréquence prévue des paiements (à savoir, paiement ponctuel ou série de paiements récurrents)
La façon dont vous déterminez le montant du paiement

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

Pour les utilisateurs concernés par l’authentification forte du client (SCA), ce contrat facilitera l’aboutissement des paiements sans interruption. Une fois votre intégration configurée pour l’enregistrement de la carte bancaire du client, Stripe marquera tous les nouveaux paiements hors session comme transactions initiées par le marchand (MIT), de sorte que vos clients n’auront pas besoin de se connecter et de s’authentifier. Les transactions initiées par le marchand nécessitent l’établissement d’un contrat entre vous et votre client.

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

Le paramètre usage indique à Stripe comment vous comptez utiliser ultérieurement les données du moyen de paiement de votre client. Pour certains moyens de paiement, Stripe se base sur votre paramètre usage pour sélectionner le flux le plus fluide pour votre client. L’objectif de cette optimisation est d’augmenter le nombre de paiements réussis.

Par exemple, la réglementation européenne relative à la SCA peut exiger une authentification par le client de sa carte bancaire lors du processus d’enregistrement. Lorsque vous définissez le paramètre usage sur off_session, cela vous permet d’authentifier la carte bancaire de votre client pour ses paiements hors session sans qu’il n’ait à se connecter et à se réauthentifier. Bien que cela engendre une friction initiale dans le flux de configuration, le fait de définir le paramètre usage sur off_session permet de diminuer les interventions des clients pour leurs paiements hors session ultérieurs.

Toutefois, si vous ne comptez utiliser la carte bancaire qu’au moment du règlement par le client, définissez le paramètre usage sur on_session. De cette manière, la banque saura que vous ne comptez utiliser la carte qu’une fois le client prêt à s’authentifier. Ce réglage vous permet de différer l’authentification de la carte jusqu’au moment du règlement et d’éviter ainsi toute friction en amont.

Utilisation prévue de la carte bancaire	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 en session ou hors session	`off_session` (par défaut)

Usage est une optimisation. Vous pouvez toujours utiliser une carte bancaire configurée pour les paiements en session pour effectuer des paiements hors session, mais les banques sont plus susceptibles de rejeter le paiement hors session et d’exiger une authentification du client. Dans les deux cas, une authentification ultérieure peut s’avérer nécessaire, c’est pourquoi vous devez prévoir un processus de récupération dans votre application. Lorsqu’un paiement par carte hors session nécessite une authentification, ramenez votre client en ligne pour exécuter le paiement.

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

Remarque

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 de d’éviter d’avoir à authentifier chaque paiement.