Paiements pour les clients existants

Appelez l’enpoint list Payment Method avec le paramètre allow_redisplay pour récupérer les moyens de paiement réutilisables d’un client.

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

Utilisez les données de la réponse de l’API pour afficher les moyens de paiement dans votre propre interface utilisateur et laissez le client en sélectionner un.

Créez un PaymentIntent pour essayer de facturer le client avec le moyen de paiement qu’il a sélectionné.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d customer={{CUSTOMER_ID}} \
  -d payment_method={{PAYMENT_METHOD_ID}} \
  -d confirm=true \
  --data-urlencode return_url="https://example.com/order/123/complete"

Si l’appel à l’API échoue et renvoie une erreur 402, cela signifie que le paiement a été refusé. Demandez au client de réessayer ou d’utiliser un autre moyen de paiement.

Si la création du PaymentIntent a bien abouti, vérifiez son status :

• succeeded indique que le client a été débité comme prévu. Affichez un message de réussite du paiement pour votre client.
• requires_action indique que vous devez demander une action supplémentaire, telle que l’authentification avec 3D Secure. Appelez handleNextAction dans le front-end pour déclencher l’action que le client doit effectuer.

const { error, paymentIntent } = await stripe.handleNextAction({
  clientSecret: "{{CLIENT_SECRET}}"
});

if (error) {
  // Show error from Stripe.js
} else {
  // Actions handled, show success message
}

Stripe envoie un événement payment_intent.succeeded à l’issue du paiement. Utilisez l’outil de webhook du Dashboard ou suivez le guide consacré aux webhooks pour recevoir ces événements et exécuter des actions, comme envoyer une confirmation de commande par e-mail à votre client, enregistrer la vente dans une base de données ou lancer un flux de livraison.

Plutôt que d’attendre un rappel de votre client, écoutez ces événements. Côté client, il arrive en effet que l’utilisateur ferme la fenêtre de son navigateur ou quitte l’application avant l’exécution du rappel. Certains clients malintentionnés peuvent d’autre part tenter de manipuler la réponse. En configurant votre intégration de manière à ce qu’elle écoute les événements asynchrones, vous pourrez accepter plusieurs types de moyens de paiement avec une seule et même intégration.

En plus de l’événement payment_intent.succeeded, nous vous recommandons de gérer ces autres événements lorsque vous encaissez des paiements à l’aide de l’Element Payment :