Enregistrer et récupérer les moyens de paiement des clients

Vous pouvez enregistrer les moyens de paiement de vos clients sur un objet Customer en vue d’une utilisation ultérieure, grâce à la fonctionnalité d’enregistrement des moyens de paiement du composant Payment Element. Cela vous permet de :

• Invitez les clients à consentir à l’enregistrement des moyens de paiement comme card, us_bank_account et sepa_debit.
• Enregistrez des moyens de paiement quand les acheteurs fournissent un consentement conforme au RGPD, tant pour les paiements ponctuels que pour les transactions récurrentes.
• Montrez aux clients les moyens de paiement enregistrés pour leurs futurs achats. Les clients peuvent également supprimer et modifier leurs informations de paiement.
• Configurez le composant Payment Element de façon à ce qu’il exige la collecte du CVC pour une transaction donnée.

Pour intégrer les moyens de paiement enregistrés au Payment Element, commencez par apprendre à concevoir une intégration si vous utilisez le Payment Element pour la première fois. Si vous disposez déjà d’une intégration au Payment Element, recherchez l’étape Enregistrer et récupérer les moyens de paiement des clients dans le guide d’intégration que vous avez suivi pour activer les moyens de paiement enregistrés.

Utiliser les moyens de paiement enregistrés avec Link

Link est un réseau de moyens de paiement enregistrés commun à tous les utilisateurs de Stripe. Vous pouvez utiliser Link avec vos moyens de paiement enregistrés, sans aucune configuration supplémentaire.

• Les nouveaux clients peuvent enregistrer leur moyen de paiement auprès d’une entreprise donnée, auprès de Link, ou les deux.
• Les clients qui disposent à la fois d’un moyen de paiement enregistré auprès de Link et d’un moyen de paiement enregistré auprès d’une entreprise voient s’afficher celui associé à l’entreprise une fois la page chargée.

Enregistrez des moyens de paiement avec Link.

Réutilisez un moyen de paiement précédemment enregistré.

Collecter à nouveau les informations de paiement

Pour plus de sécurité, vous pouvez spécifier l’attribut require_cvc_recollection pour demander au composant Payment Element de collecter à nouveau le CVC lorsque le client effectue un paiement par carte.

payment_method_options: {
  card: {required_cvc_recollection: true}
}

Enregistrer un moyen de paiement pour un abonnement ou une transaction récurrente

Si la case Enregistrer les informations de paiement pour vos futurs achats apparaît et est sélectionnée lorsque vous confirmez un paiement, la valeur allow_redisplay du moyen de paiement est always. Cela signifie que le client a accepté que ce moyen de paiement soit utilisé pour l’abonnement et les sessions futures. Si le client n’a pas coché cette case, la valeur de allow_redisplay est limited. Cela signifie que vous ne pouvez pas utiliser le moyen de paiement pour des paiement futurs : il est limité à l’abonnement que vous êtes en train de configurer.

Empêcher la suppression des moyens de paiement dans les abonnements

Si un moyen de paiement est enregistré en vue d’une utilisation future et qu’il est également utilisé dans le cadre d’un abonnement en cours, sa suppression de la section Enregistré du composant Payment Element le supprimera également de l’abonnement. Nous vous recommandons de désactiver la suppression des moyens de paiement enregistrés de Payment Element pour éviter de supprimer le moyen de paiement d’un abonnement actif. Gérez plutôt les moyens de paiement dans une page de paramètres du compte ou une page similaire permettant d’afficher les abonnements existants.

Afficher les moyens de paiement enregistrés actuels

Si des moyens de paiement existants sont associés à des clients sur votre compte Stripe à partir d’une intégration Card Element, d’une utilisation directe de l’API Stripe ou d’une autre méthode, ces moyens de paiement ne seront pas affichés dans Payment Element, car leur propriété allow_redisplay est unspecified. Si la propriété allow_redisplay est définie sur always, le moyen de paiement est affiché dans Payment Element.

Vous pouvez utiliser l’une des méthodes suivantes pour afficher les moyens de paiement précédemment enregistrés :

• Si le client a consenti en bonne et due forme à l’enregistrement de son moyen de paiement, définissez allow_redisplay sur always.
  • Utilisez l’API Payment Method Update pour mettre à jour un moyen de paiement individuel.
• Configurez l’API Customer Session de manière à inclure les moyens de paiement lorsque allow_redisplay="unspecified".

Recueillir le consentement à la réutilisation d’un moyen de paiement en dehors de Payment Element

Le composant Payment Element s’appuie sur l’état de la case à cocher Enregistrer les informations de paiement pour vos futurs achats pour déterminer si un client a consenti à l’enregistrement d’un moyen de paiement. Si vous recueillez ce consentement d’une autre manière (par exemple par le biais de vos Conditions générales sur votre site Web ou d’un texte de consentement affiché en dehors de Payment Element), vous pouvez remplacer le consentement fourni par l’instance d’Elements quand vous confirmez le Payment Intent.

Si votre intégration utilise stripe.confirmPayment, stripe.confirmSetup ou stripe.createConfirmationToken, transmettez une valeur allow_redisplay explicite dans le hachage d’options afin de remplacer la valeur de l’instance Elements.