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. Découvrez comment cette intégration se compare aux autres types d’intégration de Stripe.
Effort d'intégration
Type d'intégration
Rediriger 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 à partir de votre application :
Rediriger le client vers Checkout de StripeCôté clientCôté serveur
Ajoutez à votre site Web un bouton de paiement qui appelle un point de terminaison 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 à l’aide d’un programme 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 :
- Postes à facturer
- Devises à utiliser
Vous devez également préciser success_url
, une page de votre site Web sur laquelle Checkout renvoie votre client après qu’il a terminé le paiement. Vous pouvez éventuellement fournir cancel_url
, une page sur votre site Web sur laquelle Checkout renvoie votre client après qu’il a annulé le processus de paiement.
Remarques
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.
Remarques
Par défaut, les cartes ainsi que d’autres moyens de paiement courants qui peuvent vous aider à toucher davantage de clients sont activés. Vous pouvez activer ou désactiver les moyens de paiement directement à partir du Dashboard Stripe. Stripe évalue la devise, les restrictions des moyens de paiement et d’autres paramètres pour déterminer la liste des moyens de paiement pris en charge à afficher dans Checkout.
Testez votre point de terminaison 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 ""
Vous devriez voir une réponse dans votre terminal qui ressemble à ceci :
HTTP/1.1 303 See Other Location: https://checkout.stripe.com/c/pay/cs_test_... ...
Test
Vous devriez maintenant disposer d’un bouton de paiement fonctionnel qui redirige votre client vers Stripe Checkout.
- Cliquez sur le bouton de paiement.
- Vous êtes redirigé vers le formulaire de paiement de 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 point de terminaison côté serveur (
POST /create-checkout-session
). - Vérifiez que la requête renvoie 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 voir comment vos moyens de paiement s’affichent pour les clients, saisissez un identifiant de transaction ou définissez un montant et une devise de commande dans le Dashboard.
Afficher une page de réussiteCô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. Hébergez cette page sur votre site.
Créez une page de réussite 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 le point de terminaison de création de la session Checkout pour utiliser cette nouvelle page :
Remarques
Si vous souhaitez personnaliser votre page de réussite, lisez le guide relatif à la page de réussite personnalisée.
Test
- Cliquez sur votre bouton de paiement.
- Remplissez les détails du paiement en fournissant les informations de la carte de test :
- Saisissez
4242 4242 4242 4242
comme numéro de carte. - Indiquez une date future pour l’expiration de la carte.
- Saisissez n’importe quel code CVC à 3 chiffres.
- Saisissez n’importe quel code postal pour la facturation
- Saisissez
- Cliquez sur Payer.
- Vous êtes redirigé vers votre nouvelle page de réussite.
Ensuite, recherchez le nouveau paiement dans le Dashboard Stripe. Les paiements réussis s’affichent dans la liste des paiements. Lorsque vous cliquez sur un paiement, vous accédez à la page des détails de ce paiement. La section Résumé Checkout présente les informations de facturation et la liste des articles achetés, que vous pouvez utiliser pour traiter manuellement la commande.
Testez votre intégration
Pour tester l’intégration de votre formulaire de paiement hébergé par Stripe :
- Créer une session Checkout.
- Remplissez le formulaire de paiement et indiquez-y une méthode qui provient 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 alors redirigé vers votre
success_url
. - Accédez au Dashboard et cherchez le paiement dans la page des paiements. Si votre paiement a été effectué, vous le verrez dans cette liste.
- Cliquez sur votre paiement pour voir plus d’informations, comme un résumé Checkout qui comprend les informations de facturation et la liste des articles achetés. Vous pouvez utiliser ces informations pour traiter la commande.
Découvrez comment tester votre intégration.
Consultez la section Test pour obtenir des informations supplémentaires sur la manière de tester votre intégration.
Cartes de test
Numéro | Description |
---|---|
Transaction effectuée et traitement immédiat du paiement. | |
Une authentification 3D Secure 2 doit être effectuée pour que le paiement soit réussi. | |
Échoue toujours avec le code de refus de paiement insufficient_funds . |
Apple Pay et Google Pay
Vous pouvez activer Apple Pay et Google Pay dans les paramètres de vos moyens de paiement. Apple Pay est activé par défaut.
Les pages hébergées par Checkout n’ont pas besoin de modifications d’intégration pour activer Apple Pay ou Google Pay. Stripe gère ces paiements de la même manière que les autres paiements par carte.
Maintenant que votre intégration de base fonctionne, apprenez comment recevoir une notification au moyen d’un programme lorsqu’un client effectue un paiement.