# 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](https://docs.stripe.com/payments/save-and-reuse.md).* (The Setup Intents API lets you build dynamic flows for collecting payment method details for future payments. It tracks the lifecycle of a payment setup flow and can trigger additional authentication steps if required by law or by the payment method) 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. ## 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 > Vous pouvez également configurer des modes de paiement pour une utilisation ultérieure lorsque vous les facturez pendant l’étape de [paiement](https://docs.stripe.com/payments/save-and-reuse.md?platform=checkout). #### Démarrer - [Enregistrer des cartes sans effectuer de paiement initial](https://docs.stripe.com/payments/save-and-reuse.md) - [Enregistrer des coordonnées bancaires pour les paiements par prélèvement SEPA](https://docs.stripe.com/payments/sepa-debit/set-up-payment.md) - [Enregistrer des coordonnées bancaires pour les paiements par prélèvement automatique BECS](https://docs.stripe.com/payments/au-becs-debit/set-up-payment.md) ## Obtenez l’autorisation d’enregistrer un mode de paiement Vous êtes responsable de votre conformité à toutes les lois, réglementations et règles de réseau applicables lorsque vous enregistrez les renseignements de paiement d’un client. ### Utilisation future pendant une session Si vous configurez un mode de paiement pour une utilisation future *on-session* (A payment is described as on-session if it occurs while the customer is actively in your checkout flow and able to authenticate the payment method) — par exemple, en affichant ce mode de paiement sur une future page de passage à la caisse — vous devez obtenir explicitement le consentement du client pour cette utilisation précise. Par exemple, ajoutez une case « Enregistrer mon mode de paiement pour une utilisation ultérieure » afin de recueillir ce consentement. Si vous devez faire la distinction entre les modes de paiement enregistrés uniquement pour des utilisations hors ligne et ceux que vous pouvez présenter à votre client pour de futurs achats effectués pendant une session, vous pouvez utiliser le paramètre [allow_redisplay](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-allow_redisplay) dans l’objet PaymentMethod. ### Utilisation ultérieure hors session Pour configurer un moyen de paiement en vue de paiements futurs *hors session* (A payment is described as off-session if it occurs without the direct involvement of the customer, using previously-collected payment information), 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](https://docs.stripe.com/payments/save-and-reuse.md?platform=web&ui=elements#collect-payment-details) ou l’[enregistrement des coordonnées bancaires SEPA](https://docs.stripe.com/payments/sepa-debit/set-up-payment.md). Pour les utilisateurs concernés par l’*authentification forte du client (SCA)* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase), 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* (A payment made off-session with a properly authenticated saved card, can qualify as merchant-initiated transaction and be exempt from SCA) (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. ## Précisez l’utilisation afin d’augmenter le taux de réussite Le paramètre d’[utilisation](https://docs.stripe.com/api/setup_intents/object.md#setup_intent_object-usage) 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* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase) 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* (A payment is described as on-session if it occurs while the customer is actively in your checkout flow and able to authenticate the payment method) uniquement | `on_session` | | Paiements effectués *hors session* (A payment is described as off-session if it occurs without the direct involvement of the customer, using previously-collected payment information) 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](https://docs.stripe.com/billing/revenue-recovery.md) 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 : ```curl curl https://api.stripe.com/v1/setup_intents \ -u "<>:" \ -d usage=on_session ``` > 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* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase). 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.