Paiements par carte sans authentification bancaire
This integration supports businesses accepting only US and Canadian cards. It’s simpler up front, but does not scale to support a global customer base.
Comment fonctionne cette intégration?
En quoi diffère-t-elle de l'intégration mondiale?
Les entreprises en pleine croissance ou qui travaillent à l’international devraient opter pour notre intégration mondiale afin de prendre en charge les demandes d’authentification à deux facteurs des banques et permettre à leurs clients d’utiliser davantage de moyens de paiement.
Développer un formulaire de paiementCôté client
Elements fait partie de Stripe.js et fournit des composants d’interface utilisateur prêts à l’emploi permettant de collecter les informations de carte de vos clients. Celles-ci sont hébergées par Stripe et placées dans votre formulaire de paiement sous forme de balise iFrame. De cette façon, les informations de carte de votre client sont totalement séparées de votre code.
Configurer StripeCôté serveur
Utilisez une bibliothèque officielle pour effectuer des requêtes à l’API de Stripe à partir de votre application :
Effectuer un paiementCôté serveur
Configurez un point de terminaison sur votre serveur pour recevoir la requête du client.
Pour représenter votre intention d’encaisser le paiement d’un client, Stripe utilise un objet PaymentIntent qui suit les tentatives de débit et les changements d’état de paiement tout au long du processus.
Décidez toujours du montant à débiter côté serveur, un environnement sécurisé, plutôt que côté client. Cela permet d’éviter que des clients malveillants puissent définir leurs propres prix.
Créez un point de terminaison HTTP pour répondre à la requête AJAX de l’étape 1. Dans cet point de terminaison, décidez de quel montant débiter votre client. Pour créer un paiement, créez un PaymentIntent en utilisant l’ID de PaymentMethod de l’étape 1 avec le code suivant :
Alerte
Si vous réglez le paramètre error_on_requires_action sur true
lors de la confirmation d’un paiement et que ce paiement nécessite une authentification à deux facteurs de la part du client, le paiement échouera automatiquement.
Réponse de l’API Payment Intents
Lorsque vous effectuez un paiement à l’aide de l’API, la réponse indique l’état du PaymentIntent. L’état d’un paiement réussi est : succeeded
.
{ "id": "pi_0FdpcX589O8KAxCGR6tGNyWj", "object": "payment_intent", "amount": 1099, "charges": { "object": "list", "data": [ { "id": "ch_GA9w4aF29fYajT", "object": "charge", "amount": 1099, "refunded": false, "status": "succeeded", } ] }, "client_secret": "pi_0FdpcX589O8KAxCGR6tGNyWj_secret_e00tjcVrSv2tjjufYqPNZBKZc", "currency": "usd", "last_payment_error": null, "status": "succeeded", }
Si le paiement échoue, la réponse inclut le code de l’erreur et un message d’erreur. Voici un exemple de paiement en échec car la carte bancaire utilisée nécessitait une authentification à deux facteurs.
{ "error": { "code": "authentication_required", "decline_code": "authentication_not_handled", "doc_url": "https://stripe.com/docs/error-codes/authentication-required", "message": "This payment required an authentication action to complete, but `error_on_requires_action` was set. When you're ready, you can upgrade your integration to handle actions at https://stripe.com/docs/payments/payment-intents/upgrade-to-handle-actions.", "payment_intent": { "id": "pi_1G8JtxDpqHItWkFAnB32FhtI", "object": "payment_intent", "amount": 1099, "status": "requires_payment_method", "last_payment_error": { "code": "authentication_required", "decline_code": "authentication_not_handled", "doc_url": "https://stripe.com/docs/error-codes/authentication-required", "message": "This payment required an authentication action to complete, but `error_on_requires_action` was set. When you're ready, you can upgrade your integration to handle actions at https://stripe.com/docs/payments/payment-intents/upgrade-to-handle-actions.", "type": "card_error" }, }, "type": "card_error" } }
Tester l'intégration
Pour vérifier que votre intégration est prête, vous avez à votre disposition plusieurs cartes de test. Vous pouvez les utiliser en mode test avec n’importe quel CVC, code postal et date d’expiration non échue.
Numéro | Description |
---|---|
Réussite de la transaction et traitement immédiat du paiement. | |
Échoue toujours avec le code de refus de paiement insufficient_funds . | |
Exige l’authentification, qui dans cette intégration échouera avec un code de refus de paiement authentication_not_handled . |
Voir la liste complète des cartes de test.
Mettre à niveau votre intégration pour prendre en charge l'authentification de cartes
Félicitations! Vous avez réalisé une intégration capable de gérer des paiements par carte basiques. Veuillez noter que cette intégration génère des refus de paiement pour les cartes qui nécessitent une authentification lors du paiement.
Si vous commencez à voir de nombreux paiements s’afficher comme Failed
sur le Dashboard, cela veut dire qu’il est temps de mettre à niveau votre intégration. L’intégration mondiale de Stripe traite ces paiements au lieu de les refuser automatiquement.