Enregistrer directement les informations sans débiter le client

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 ajoutez un client à votre SetupIntent avant de confirmer, Stripe associe automatiquement le moyen de paiement par carte généré à l’objet Customer fourni.

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

curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

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. Dans le cas de Terminal, cela inclut la collecte et l’enregistrement du consentement du titulaire de carte.

Vous devez créer le SetupIntent sur votre serveur et inclure card_present dans le paramètre payment_method_types. Spécifiez usage=on_session si vous comptez uniquement réutiliser le moyen de paiement lorsque le client est dans votre tunnel de paiement.

# Request
curl https://api.stripe.com/v1/setup_intents \
  -u "sk_test_26PHem9AhJZvU623DfE1x4sd:" \
  -d "payment_method_types[]"=card_present \
  -d "customer"={{CUSTOMER_ID}}

# Response
{
  "id": "seti_1234567890abcdefghijklmn",
  "object": "setup_intent",
  ...  # other SetupIntent fields
}

Collecter un moyen de paiement pour l’enregistrement

Après avoir créé un SetupIntent, vous devez ensuite collecter un moyen de paiement et obtenir le consentement du client. Transmettez allow_redisplay avec la valeur always ou limited. Cette valeur indique le degré d’affichage d’un moyen de paiement dans le tunnel de paiement d’un client.

Vous devez appeler l’endpoint process_setup_intent, qui gère à la fois la collecte et la confirmation du SetupIntent. Si le client donne son consentement, définissez allow_redisplay sur always ou limited.

curl https://api.stripe.com/v1/terminal/readers/{{READER_ID}}/process_setup_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d setup_intent={{SETUP_INTENT_ID}} \
  -d allow_redisplay=always

Cette méthode recueille les données chiffrées du moyen de paiement à l’aide du lecteur de carte connecté, et les associe au SetupIntent.

Annuler la collecte

Annulation programmatique

Vous pouvez annuler la collecte d’un moyen de paiement en appelant cancel_action.

Envoyer les informations du moyen de paiement à Stripe

Votre précédent appel à process_setup_intent traite la confirmation pour vous. Aucune autre action n’est donc nécessaire.

Une fois opérationnelle, la configuration renvoie la valeur succeeded pour la propriété status du SetupIntent, ainsi qu’un SetupAttempt.payment_method_details.card_present.generated_card qui est un moyen de paiement card réutilisable que vous pouvez utiliser pour les paiements en ligne.

Le moyen de paiement generated_card est associé automatiquement au client que vous avez indiqué lors de la création du SetupIntent. Vous pouvez récupérer le moyen de paiement generated_card en développant la propriété latest_attempt du SetupIntent. Vérifiez systématiquement la valeur generated_card ; pour les moyens de paiement qui n’autorisent pas les cartes générées, la valeur est vide.

curl -G https://api.stripe.com/v1/setup_intents/
{{SETUP_INTENT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "expand[]"=latest_attempt

Vous pouvez également récupérer le moyen de paiement associé en récupérant la liste des moyens de paiement associés au client.

curl -G https://api.stripe.com/v1/customers/
{{CUSTOMER_ID}}
/payment_methods \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=card

Si vous n’avez pas fourni de client lors de la création du SetupIntent, vous pouvez associer le moyen de paiement generated_card à un objet Customer dans un appel distinct.

curl https://api.stripe.com/v1/payment_methods/
{{PAYMENT_METHOD_ID}}
/attach \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}

Si la configuration n’aboutit pas, examinez l’erreur renvoyée pour en déterminer la cause. Par exemple, omettre de recueillir le consentement du client et d’en informer Stripe entraîne une erreur.

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