Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous
AperçuAccepter un paiementMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usageUtiliser Managed PaymentsPaiements récurrents
Paiements par TPE
Terminal
Moyens de paiement
Opérations de paiement
Soldes et délai de règlementReçusRemboursements et annulations
Intégrations avancées
Au-delà des paiements

Enregistrer une carte bancaire avec MOTO pour de futurs paiements

Enregistrez les informations de carte pour paiement par courrier et par téléphone (MOTO) pour une utilisation ultérieure avec Stripe Terminal.

Demande d’accès

Pour activer le traitement des paiements MOTO, contactez le support Stripe.

Pour enregistrer les informations de paiement d’une transaction MOTO en vue d’un paiement ultérieur, vous devez :

  1. Créer ou récupérer un objet Customer.
  2. Créer un SetupIntent.
  3. Traiter le SetupIntent.
  4. Vérifier l’état du lecteur.
  5. Débiter le PaymentMethod enregistré

Créer ou récupérer un objet Customer

Pour débiter une carte bancaire enregistrée auprès de Stripe, celle-ci doit être associée à un objet Customer.

Lorsque vous incluez un objet Customer dans votre SetupIntent avant de confirmer, Stripe associe automatiquement le moyen de paiement par carte bancaire généré à l’objet Customer que vous créez/récupérez.

Ajoutez le code suivant sur votre serveur pour créer un nouvel objet Customer :

Command Line
curl
Ruby
Python
PHP
Java
Node.js
Go
.NET
Interface de ligne de commande Stripe
No results
curl https://api.stripe.com/v1/customers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -X "POST"

Créer un SetupIntent

Un SetupIntent est un objet qui représente votre intention de configurer le moyen de paiement d’un client en vue de futurs paiements. Le SetupIntent suit les étapes de ce processus de configuration. Les payment_method_types doivent inclure card.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d "payment_method_types[]"=card

Traiter le SetupIntent

Version bêta privée

Le CVC est obligatoire pour les transactions MOTO. Le contournement du CVC est disponible en version bêta privée et peut être demandé pour les commandes par courrier. Contactez le support Stripe pour y accéder.

Après avoir créé le SetupIntent, utilisez process_setup_intent pour traiter le paiement, en paramétrant process_config[moto] sur la valeur true. Indiquez la valeur allow_redisplay comme always ou restricted, qui indique dans quelle mesure un moyen de paiement peut être affiché dans le tunnel de paiement d’un client.

Command Line
cURL
No results
curl https://api.stripe.com/v1/terminal/readers/
{{READER_ID}}
/process_setup_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d setup_intent=
"{{SETUP_INTENT_ID}}"
 \
  -d "process_config[moto]"=true \
  -d allow_redisplay=always

La requête process_setup_intent est asynchrone. Après la requête, le lecteur vous invite à saisir le numéro de carte, le CVC, la date d’expiration et le code postal du titulaire de la carte.

Vérifier l'état du lecteur

Votre application doit suivre les instructions de vérification de l’état du lecteur pour confirmer l’aboutissement (l’approbation) d’un SetupIntent.

Débiter le PaymentMethod enregistré

Vous pouvez désormais débiter le PaymentMethod enregistré associé au Customer à l’aide d’un PaymentIntent.

En cours de test

Pour tester votre intégration, utilisez le lecteur de simulation et les numéros de carte de test simulés.

Conformité

Vous êtes responsable du respect de toutes les lois, réglementations et règles des réseaux applicables lorsque vous enregistrez les informations de paiement d’un client. Par exemple, le Comité européen de la protection des données a publié des recommandations sur l’enregistrement des informations de paiement. Ces exigences s’appliquent généralement si vous souhaitez enregistrer le moyen de paiement d’un 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, ou encore en passant une commande MOTO ou en magasin.

Intégrez à votre tunnel de paiement des conditions précisant la manière dont vous allez enregistrer les informations de moyen de paiement et offrant aux clients la possibilité de donner leur accord. Si vous envisagez de prélever le client alors qu’il ne paie pas activement, veillez à ce que vos conditions incluent au minimum les éléments suivants :

  • 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.

Lors de l’enregistrement d’un moyen de paiement, celui-ci ne peut être utilisé que pour l’usage spécifié dans vos conditions. Pour prélever un client lorsqu’il n’est pas activement en train de payer et enregistrer son moyen de paiement pour un usage futur, vous devez recueillir son consentement explicite. Une option consiste à proposer une case à cocher « Enregistrer mon moyen de paiement pour une utilisation ultérieure ».