Accéder directement au contenu
Créez un compte
ou
connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compte
Connectez-vous
Démarrer
Paiements
Revenus
Plateformes et places de marché
Gestion de fonds
Ressources pour les développeurs
Aperçu
À propos des paiements Stripe
Mettre votre intégration à niveau
Analyses des paiements
Paiements en ligne
PrésentationTrouver votre cas d'usageManaged Payments
Utiliser Payment Links
Créer une page de paiement
Développer une intégration avancée
Développer une intégration dans l'application
Moyens de paiement
Ajouter des moyens de paiement
Gérer les moyens de paiement
Paiement accéléré avec Link
Interfaces de paiement
Payment Links
Checkout
Elements pour le web
Elements intégrés à l'application
Scénarios de paiement
Gérer plusieurs devises
Tunnels de paiement personnalisés
Acquisition flexible
Orchestration
Paiements par TPE
Terminal
    Présentation
    Accepter les paiements par TPE
    Conception d'intégration
    Choisir votre lecteur
    Concevoir une intégration
    Démarrage rapide
    Exemples d'applications
    Tests
    Configuration de Terminal
    Configurer votre intégration
    Se connecter à un lecteur
    Acceptation d'un paiement
    Encaisser des paiements par carte
    Autres moyens de paiement
    Accepter les paiements hors ligne
    Paiement des commande par courrier/par téléphone
    Spécificités régionales
    Lors du règlement
    Collecter des pourboires
    Collecter et enregistrer des informations de paiement pour une utilisation ultérieure
      Enregistrer la carte avant achat
      Enregistrer la carte après le paiement
    Autorisations flexibles
    Après le paiement
    Rembourser des transactions
    Fournir des reçus
    Personnalisez Checkout
    Affichage du panier
    Collecter les données saisies à l'écran
    Collecter les données des lectures de la piste magnétique
    Collecter les données des paiements NFC sans contact
    Applications sur des appareils
    Gérer les lecteurs
    Commander, renvoyer ou remplacer des lecteurs
    Enregistrer des lecteurs
    Gérer les emplacements et les zones
    Configurer des lecteurs
    Suivre les lecteurs
    Chiffrement
    Références
    Documentation de l'API
    Lecteurs mobiles
    Lecteurs intelligents
    Guide de migration du SDK
    Liste de contrôle pour le déploiement
    Fiches produit du lecteur Stripe Terminal
Au-delà des paiements
Constituez votre entreprise
Cryptomonnaies
Financial Connections
Climate
AccueilPaiementsTerminalCollect and save payment details for future use

Enregistrer les informations de paiement après le paiement

Acceptez un paiement en personne et enregistrez les informations de paiement pour les utiliser plus tard, en l'absence du client.

Vous pouvez utiliser Stripe Terminal pour enregistrer les informations de paiement d’un achat en magasin. Un paiement card_present réussi renvoie un PaymentMethod card réutilisable dans l’attribut generated_card. Il existe plusieurs cas d’usage :

  • Un client d’une salle de sport paie par TPE une première séance et un abonnement. La transaction crée une generated_card qui sera utilisée pour les futurs renouvellements automatiques de l’abonnement.
  • Un client d’une boutique de vêtements fournit son adresse e-mail au moment d’effectuer un achat à la caisse. La transaction crée un dossier client et enregistre la generated_card associée. Cela permet au client de se connecter ultérieurement au site Web de la boutique et de passer une commande en utilisant la même carte.

Le paiement initial par TPE bénéficie du transfert de responsabilité, et, sur certains marchés, d’une tarification plus basse accordée aux paiements standard sur Terminal. Toutefois, les paiements ultérieurs effectués à l’aide de la generated_card sont des transactions en ligne sans présentation de carte, sans le transfert de responsabilité.

Remarque

Nous avons modifié le modèle de consentement du client pour cette fonctionnalité afin d’exiger le paramètre allow_redisplay. Vous devez mettre à jour votre intégration pour utiliser allow_redisplay. Cette mise à jour est devenue obligatoire le 31 mars 2025 pour les utilisateurs non-React Native, et le sera pour les utilisateurs React Native le 30 septembre 2025. Pour plus d’informations, consultez l’entrée du journal des modifications.

Créer un objet Customer

Pour configurer une carte bancaire en vue de paiements futurs, vous devez l’associer à un client. Lorsque votre client ouvre un compte chez vous, créez un objet Customer, qui permet de réutiliser des moyens de paiement et d’assurer le suivi de plusieurs paiements.

Command Line
cURL
curl https://api.stripe.com/v1/customers \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d name="Jenny Rosen" \ --data-urlencode email="jennyrosen@example.com"

Lorsque la création aboutit, l’objet Customer est renvoyé. Vous pouvez l’examiner pour identifier l’id du client et stocker cette valeur dans votre base de données pour la récupérer ultérieurement.

Vous pouvez trouver ces clients sur la page Clients du Dashboard.

Créer un PaymentIntent

Documentation de l'API

  • Créer un PaymentIntent

Lors de la création d’un PaymentIntent, demandez une generated_card en spécifiant une valeur pour setup_future_usage. Si vous comptez uniquement réutiliser le moyen de paiement lorsque le client est dans votre tunnel de paiement, utilisez on_session. Sinon, utilisez off_session.

Command Line
curl
curl https://api.stripe.com/v1/payment_intents \ -u
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:
\ -d "setup_future_usage"="off_session" \ -d "customer"="{{CUSTOMER_ID}}" \ -d "amount"=1000 \ -d "currency"="usd" \ -d "payment_method_types[]"="card_present"

Remarque

Les cartes Visa, Mastercard, American Express, Discover, comarquées eftpos, Interac et girocard sont prises en charge en tant que moyens de paiement card_present qui peuvent être enregistrés en tant que type card.

Collecter et traiter un moyen de paiement

Remarque

Cette fonctionnalité nécessite que vos requêtes API incluent Stripe-Version: 2024-09-30.acacia. Pour plus d’informations, consultez l’entrée du journal des modifications.

Documentation de l'API

  • process_payment_intent

Documentation de l'API

  • collect_payment_method

Lorsque le client est prêt à payer et a consenti à ce que les informations de son moyen de paiement soient enregistrées, transmettez allow_redisplay défini sur always ou limited dans l’appel process_payment_intent ou collect_payment_methodPreview. La valeur indique le degré d’affichage d’un moyen de paiement dans le tunnel de paiement d’un client.

Command Line
cURL
curl https://api.stripe.com/v1/terminal/readers/{{READER_ID}}/process_payment_intent \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d payment_intent={{PAYMENT_INTENT_ID}} \ -d "process_config[allow_redisplay]"=always
Command Line
cURL
curl https://api.stripe.com/v1/terminal/readers/{{READER_ID}}/collect_payment_method \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d payment_intent={{PAYMENT_INTENT_ID}} \ -d "collect_config[allow_redisplay]"=always

Documentation de l'API

  • confirm_payment_intent

Si vous utilisez le flux collect_payment_method, qui permet d’accéder à des données utiles telles que la marque de la carte et le financement du PaymentMethod avant de le confirmer, vous devez également confirmer séparément le PaymentIntent.

Command Line
cURL
curl https://api.stripe.com/v1/terminal/readers/{{READER_ID}}/confirm_payment_intent \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d payment_intent={{PAYMENT_INTENT_ID}}

Accéder à la generated_card

Un paiement réussi avec un moyen de paiement qui prend en charge une utilisation ultérieure renvoie un PaymentIntent à l’état requires_capture ou succeeded. Vous pouvez récupérer le moyen de paiement generated_card en développant la propriété latest_charge du PaymentIntent et en affichant payment_method_details.card_present. Si vous avez transmis l’ID du client dans l’appel de création du PaymentIntent, le PaymentMethod réutilisable est automatiquement associé à l’objet Customer. Sinon, vous pouvez l’associer manuellement dans un appel distinct.

Vérifiez toujours que le fichier PaymentIntent.latest_charge contient une valeur generated_card. Certains paiements, tels que les paiements par portefeuille électronique et les paiements par carte Interac, eftpos ou girocard d’une seule marque, peuvent ne pas créer de carte générée. Si c’est le cas, et que vous avez besoin d’un moyen de paiement réutilisable, deux options s’offrent à vous :

  • Invitez le client à enregistrer un autre moyen de paiement à l’aide du tunnel pour enregistrer un moyen de paiement sans effectuer de paiement.
  • Remboursez le paiement par TPE, indiquez que la transaction a échoué et demandez au client d’utiliser un autre moyen de paiement.

Considérations relatives aux wallets mobiles

Les portefeuilles mobiles enregistrés sont réservés aux paiements off_session tels que les abonnements futurs ou les autres paiements que vous initiez au nom de votre client. Lorsque vous enregistrez un moyen de paiement par portefeuille électronique, la generated_card présente allow_redisplay=limited, pour indiquer ses considérations d’utilisation spécifiques.

Lorsque vous tentez de débiter un portefeuille mobile, veillez à transmettre off_session=true lors de la confirmation PaymentIntent. Si le client est présent dans votre tunnel de paiement, vous devrez plutôt utiliser les intégrations Apple Pay et Google Pay pour demander à nouveau la présentation du 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. Par exemple, le Conseil européen de la protection des données a émis des recommandations concernant l’enregistrement des données de paiement. Ces exigences s’appliquent généralement si vous souhaitez enregistrer le moyen de paiement de votre client pour une utilisation ultérieure, par exemple en lui présentant le moyen de paiement dans le tunnel de paiement pour un achat futur ou en le facturant lorsqu’il n’utilise pas activement votre site web ou votre application.

Ajoutez des conditions d’utilisation à votre site Web ou à votre application pour indiquer comment vous prévoyez d’enregistrer des informations relatives aux moyens de paiement et qui permettent aux clients d’y adhérer. Si vous prévoyez de facturer le client lorsqu’il est hors ligne, assurez-vous que vos conditions d’utilisation couvrent également ce qui suit :

  • Le consentement du client vous autorisant à déclencher un paiement ou une série de paiements en son nom pour les transactions spécifiées
  • Le calendrier et la fréquence prévus des paiements (par exemple, si les paiements concernent des versements échelonnés ou d’abonnement planifiés, ou des recharges non planifiées).
  • La façon dont vous déterminez le montant du paiement.
  • Votre politique d’annulation, si vous configurez le moyen de paiement dans le cadre d’un abonnement

Veillez à conserver une trace écrite de l’acceptation de ces conditions par votre client.

Lorsque vous enregistrez un moyen de paiement, il ne peut être utilisé que pour l’utilisation spécifique prévue dans vos conditions d’utilisation. Si vous souhaitez facturer un client lorsqu’il est hors ligne et enregistrer son moyen de paiement pour lui présenter comme moyen de paiement enregistré lors d’achats ultérieurs, vous devez recueillir explicitement son consentement. Pour ce faire, vous pouvez notamment proposer une case « Enregistrer mon moyen de paiement pour une utilisation ultérieure ».

Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc