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.
Intégrez un formulaire de paiement prédéfini sur votre site à 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
Intégrer un formulaire de paiement préconfiguré sur votre site
Personnalisation de l'interface utilisateur
Utilisez les paramètres de l’image de marque dans le Dashboard Stripe pour faire correspondre Checkout à la conception de votre site.
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 :
Créer une session CheckoutCôté serveur
À partir de votre serveur, créez une session Checkout et définissez le ui_mode à embedded
. Vous pouvez configurer la session Checkout avec postes de facture pour inclure des options telles que la devise.
Pour renvoyer les clients vers une page personnalisée que vous hébergez sur votre site Web, précisez l’adresse URL de cette page dans le paramètre return_url. Incluez le modèle de variable {CHECKOUT_SESSION_ID}
dans l’adresse URL pour récupérer l’état de la session sur la page de retour. Checkout remplace automatiquement la variable par l’ID de session Checkout avant la redirection.
En savoir plus sur la configuration de la page de retour et des autres options pour personnaliser le comportement de redirection.
Après avoir créé la session Checkout, utilisez le client_secret
retourné dans la réponse pour charger Checkout.
Monter CheckoutCôté client
Checkout renders in an iframe that securely sends payment information to Stripe over an HTTPS connection.
Erreur fréquente
Avoid placing Checkout within another iframe because some payment methods require redirecting to another page for payment confirmation.
Personnaliser l’apparence
Personnalisez Checkout pour qu’il corresponde à la conception de votre site en définissant la couleur d’arrière-plan, la couleur des boutons, la taille de la bordure et les polices dans les paramètres de marque de votre compte.
Par défaut, Checkout est rendu sans rembourrage ou marge externe. Nous vous recommandons d’utiliser un élément conteneur tel qu’un div pour appliquer la marge souhaitée (par exemple, 16 pixels de tous les côtés).
Afficher une page de retour
Une fois une que votre client a effectué une tentative de paiement, Stripe le redirige vers une page de retour hébergée sur votre site. Lors de la création de la session Checkout, vous avez précisé l’URL de la page de retour dans le paramètre return_url. En savoir plus sur les autres options permettant de personnaliser le comportement de redirection.
Lors de l’affichage de votre page de retour, récupérez l’état de la session Checkout à l’aide de l’ID de session Checkout qui figure dans l’URL. Gérez le résultat en fonction de l’état de la session comme suit :
complete
: le paiement a été effectué. Utilisez les informations de la session Checkout pour afficher une page de confirmation de paiement.open
: le paiement a échoué ou a été annulé. Chargez Checkout à nouveau afin que votre client puisse réessayer.
const session = await fetch(`/session_status?session_id=${session_id}`) if (session.status == 'open') { // Remount embedded Checkout } else if (session.status == 'complete') { // Show success page // Optionally use session.payment_status or session.customer_email // to customize the success page }
Moyens de paiement basés sur la redirection
Lors du paiement, certains moyens de paiement redirigent le client vers une page intermédiaire, telle qu’une page d’autorisation bancaire. Lorsqu’il a terminé de remplir cette page, Stripe le redirige vers votre page de retour.
En savoir plus sur les moyens de paiement basés sur la redirection et le comportement de redirection.
Testez votre intégration
Pour tester l’intégration de votre formulaire de paiement intégré :
- Créez une session de paiement intégrée et montez Checkout sur votre page.
- Remplissez le formulaire de paiement et indiquez-y un moyen de paiement qui provient du tableau ci-dessous.
- 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
return_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.