Accepter un paiement
Créez un formulaire de paiement ou utilisez une page de paiement préconfigurée pour commencer à accepter les paiements en ligne.
Redirigez vers une page de paiement hébergée par Stripe à l’aide de Stripe Checkout. Comparez cette intégration aux autres types d’intégration de Stripe.
Effort d'intégration
Type d'intégration
Redirection vers la page de paiement hébergée par Stripe
Personnalisation de l'interface utilisateur
Configurer StripeCôté serveur
Tout d’abord, inscrivez-vous pour créer un Compte Stripe.
Utilisez nos bibliothèques officielles pour accéder à l’API Stripe depuis votre application :
Rediriger votre client vers Stripe CheckoutCôté clientCôté serveur
Ajoutez sur votre site Web un bouton de paiement qui appelle un endpoint côté serveur afin de créer une session Checkout.
<html> <head> <title>Buy cool new product</title> </head> <body> <!-- Use action="/create-checkout-session.php" if your server is PHP based. --> <form action="/create-checkout-session" method="POST"> <button type="submit">Checkout</button> </form> </body> </html>
Une session Checkout est la représentation programmatique de ce que votre client voit lorsqu’il est redirigé vers le formulaire de paiement. Vous pouvez la configurer à l’aide de différentes options, par exemple :
- Les postes à facturer
- Les devises à utiliser
Vous devez également spécifier une success_url
, c’est-à-dire une page de votre site Web sur laquelle Checkout renvoie votre client une fois son paiement réalisé. Vous pouvez éventuellement spécifier une cancel_url
, c’est-à-dire une page de votre site Web vers laquelle Checkout renvoie les clients qui annulent le processus de paiement.
Note
Les sessions Checkout expirent 24 heures après leur création.
Après avoir créé une session Checkout, redirigez votre client vers l’URL renvoyée dans la réponse.
Note
Les cartes bancaires et autres moyens de paiement fréquemment utilisés, et donc susceptibles de vous aider à développer votre clientèle, sont activés par Stripe par défaut. Vous avez la possibilité d’activer ou de désactiver des moyens de paiement directement depuis le Dashboard Stripe. Stripe évalue la devise, les restrictions liées aux moyens de paiement et d’autres paramètres pour déterminer la liste des moyens de paiement à afficher dans Checkout.
Testez votre endpoint en démarrant votre serveur Web (par exemple, localhost:4242
) et en exécutant la commande suivante :
curl -X POST -is "http://localhost:4242/create-checkout-session" -d ""
Une réponse semblable à celle ci-dessous devrait s’afficher dans votre terminal :
HTTP/1.1 303 See Other Location: https://checkout.stripe.com/c/pay/cs_test_... ...
Test
Vous devriez maintenant disposer d’un bouton de règlement fonctionnel qui redirige votre client vers Stripe Checkout.
- Cliquez sur le bouton de règlement.
- Vous êtes redirigé vers le formulaire de paiement Stripe Checkout.
Si votre intégration ne fonctionne pas :
- Ouvrez l’onglet Réseau dans les outils de développement de votre navigateur.
- Cliquez sur le bouton de paiement et assurez-vous qu’une requête XHR est bien envoyée à votre endpoint côté serveur (
POST /create-checkout-session
). - Vérifiez que la requête renvoie bien un état 200.
- Utilisez
console.log(session)
dans l’écouteur du clic sur le bouton pour vous assurer que les données appropriées sont renvoyées.
Pour visualiser l’affichage des moyens de paiement pour les clients, saisissez un ID de transaction ou définissez le montant et la devise d’une commande dans le Dashboard.
Afficher une page de confirmation de paiementCôté clientCôté serveur
Il est important de présenter une page de confirmation à votre client une fois qu’il a validé le formulaire de paiement. Nous vous conseillons d’héberger cette page sur votre site.
Créez une page de confirmation minimale :
<html> <head><title>Thanks for your order!</title></head> <body> <h1>Thanks for your order!</h1> <p> We appreciate your business! If you have any questions, please email <a href="mailto:orders@example.com">orders@example.com</a>. </p> </body> </html>
Ensuite, mettez à jour l’endpoint de création de sessions Checkout pour qu’il utilise cette nouvelle page :
Note
Pour personnaliser votre page de confirmation de paiement, consultez le guide dédié à ce sujet.
Test
- Cliquez sur votre bouton de paiement.
- Remplissez le formulaire de paiement avec les informations d’une carte de test :
- Saisissez le numéro de carte
4242 4242 4242 4242
. - Saisissez une date d’expiration postérieure à la date du jour.
- Saisissez un code CVC à 3 chiffres.
- Saisissez un code postal de facturation.
- Saisissez le numéro de carte
- Cliquez sur Payer.
- Vous êtes redirigé vers votre nouvelle page de confirmation de paiement.
Ensuite, recherchez le nouveau paiement dans le Dashboard Stripe. Les paiements réussis apparaissent dans la liste des paiements. Lorsque vous cliquez sur un paiement, vous accédez aux informations relatives à ce dernier. La section Récapitulatif Checkout présente les informations de facturation et la liste des articles achetés, que vous pouvez utiliser pour traiter manuellement la commande.
Tester votre intégration
Pour tester votre intégration de formulaire de paiement hébergé par Stripe :
- Créez une session Checkout.
- Renseignez les informations d’un moyen de paiement du tableau suivant.
- Saisissez une date d’expiration postérieure à la date du jour.
- Saisissez un code CVC à 3 chiffres.
- Saisissez un code postal de facturation.
- Cliquez sur Payer. Vous êtes redirigé(e) vers votre
success_url
. - Accédez au Dashboard et recherchez le paiement sur la page des paiements. Si votre paiement a abouti, il apparaîtra dans cette liste.
- Cliquez sur votre paiement afin d’afficher plus d’informations, par exemple un récapitulatif Checkout contenant les informations de facturation et la liste des articles achetés. Vous pouvez utiliser ces informations pour traiter votre commande.
En savoir plus sur le test de votre intégration.
Consultez la section consacrée aux tests pour obtenir des informations supplémentaires sur la manière de tester votre intégration.
Cartes de test
Numéro | Description |
---|---|
Fait aboutir le paiement et le traite immédiatement. | |
Nécessite une authentification 3D Secure 2 pour que le paiement aboutisse. | |
Échec systématique avec le code de refus de paiement insufficient_funds . |
Apple Pay et Google Pay
Vous pouvez activer Apple Pay et Google Pay dans vos paramètres des moyens de paiement. Apple Pay est activé par défaut.
Aucune modification de l’intégration n’est requise pour activer Apple Pay ou Google Pay dans les pages hébergées par Stripe de Checkout. Stripe gère ces paiements de la même manière que les paiements par carte bancaire.
Maintenant que votre intégration de base fonctionne, apprenez comment recevoir une notification par voie programmatique lorsqu’un client effectue un paiement.