Accéder directement au contenu
Créez un compte
 ou
connectez-vous
Le logo de la documentation Stripe
/
Créer un compte
Connectez-vous

Accepter un paiement

Acceptez les paiements en ligne en toute sécurité.

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.

Aperçu de Checkout

Effort d'intégration

Peu de codage

Type d'intégration

Rediriger vers la page de paiement hébergée par Stripe

Personnalisation de l'interface utilisateur

Personnalisation limitée

Essayer

First, register for a Stripe account.

Use our official libraries to access the Stripe API from your application:

Command Line
# Available as a gem
sudo gem install stripe
Gemfile
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Rediriger le client vers Checkout de Stripe
Côté client
Côté serveur

Ajoutez à votre site Web un bouton de paiement qui fait appel à un point de terminaison côté serveur afin de créer une session Checkout.

Vous pouvez également créer une session Checkout pour un client existant, ce qui vous permet de remplir automatiquement les coordonnées des clients connus dans les champs Checkout et d’unifier leur historique d’achat.

checkout.html
<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 ce qui suit :

Vous devez remplir l’objet success_url avec l’URL d’une page de votre site Web vers laquelle Checkout renvoie votre client après qu’il a effectué le paiement. Vous pouvez également fournir une valeur cancel_url d’une page de votre site Web vers laquelle Checkout renvoie votre client s’il met fin au processus de paiement avant d’effectuer le paiement.

Remarques

Par défaut, 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.

# This example sets up an endpoint using the Sinatra framework.


require 'json'
require 'sinatra'
require 'stripe'

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'


post '/create-checkout-session' do
  session = Stripe::Checkout::Session.create({
    line_items: [{
      price_data: {
        currency: 'usd',
        product_data: {
          name: 'T-shirt',
        },
        unit_amount: 2000,
      },
      quantity: 1,
    }],
    mode: 'payment',
    # These placeholder URLs will be replaced in a following step.
    success_url: 'https://example.com/success',
    cancel_url: 'https://example.com/cancel',
  })

  redirect session.url, 303
end

Modes de paiement

Par défaut, Stripe active les cartes et d’autres modes de paiement courants. Vous pouvez activer ou désactiver des moyens de paiement individuels dans le Dashboard Stripe. Dans Checkout, Stripe évalue la devise et les restrictions éventuelles, puis présente dynamiquement au client les modes de paiement pris en charge.

Pour voir comment vos moyens de paiement sont affichés pour les clients, saisissez un ID de transaction ou définissez un montant et une devise de commande dans le Dashboard.

Vous pouvez activer Apple Pay et Google Pay dans vos paramètres des moyens de paiement. Par défaut, Apple Pay est activé et Google Pay est désactivé. Cependant, dans certains cas, Stripe les filtre même lorsqu’ils sont activés. Nous filtrons Google Pay si vous activez les taxes automatiques sans collecter d’adresse de livraison.

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 autres paiements par carte.

Confirmez votre point de terminaison

Confirmez que votre point de terminaison est accessible en démarrant votre serveur Web (par exemple, localhost:4242) et en exécutant la commande suivante :

Command Line
curl -X POST -is "http://localhost:4242/create-checkout-session" -d ""

Une réponse semblable à celle ci-dessous devrait être affichée dans votre terminal :

Command Line
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.

  1. Cliquez sur le bouton de paiement.
  2. Vous êtes redirigé vers le formulaire de paiement Stripe Checkout.

Si votre intégration ne fonctionne pas :

  1. Ouvrez l’onglet Réseau dans les outils développeur de votre navigateur.
  2. Cliquez sur le bouton de paiement et assurez-vous qu’une requête XHR a bien été envoyée à votre point de terminaison côté serveur (POST /create-checkout-session).
  3. Vérifiez que la requête renvoie un état 200.
  4. Utilisez console.log(session) dans le détecteur de clics de bouton pour vous assurer que les données appropriées sont renvoyées.

Afficher une page de réussite
Côté client
Cô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 :

success.html
<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 :

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  --data-urlencode success_url="http://localhost:4242/success.html" \
  --data-urlencode cancel_url="http://localhost:4242/cancel.html"

Remarques

Pour personnaliser votre page de confirmation de paiement, consultez le guide dédié à ce sujet.

Test

  1. Cliquez sur votre bouton de paiement.
  2. 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
  3. Cliquez sur Payer.
  4. 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.

Gérer les événements post-paiement

Stripe envoie un événement checkout.session.completed lorsqu’un client finalise le paiement de la session Checkout. Utilisez l’outil de webhook du Dashboard ou suivez le guide consacré aux webhooks pour recevoir et gérer ces événements, qui peuvent vous amener à :

  • Envoyer un courriel de confirmation de commande à votre client.
  • Enregistrer la vente dans une base de données.
  • Démarrer un processus d’expédition.

Écoutez ces événements plutôt que d’attendre que votre client soit redirigé vers votre site Web. Le déclenchement du traitement uniquement à partir de votre page de renvoi Checkout n’est pas fiable. Si vous configurez votre intégration de manière à ce qu’elle écoute les événements asynchrones, vous pourrez accepter plusieurs types de modes de paiement avec une seule intégration.

Pour en savoir plus, consultez notre guide de traitement avec Checkout.

Gérez les événements suivants lors de l’encaissement de paiements avec Checkout :

ÉvénementDescriptionAction
checkout.session.completedEnvoyé lorsqu’un client finalise avec succès la session Checkout.Envoyez au client une confirmation de commande et traitez sa commande.
checkout.session.async_payment_succeededEnvoyé lorsqu’un paiement effectué avec un mode de paiement différé (par exemple, ACH Direct Debit) aboutit.Envoyez au client une confirmation de commande et traitez sa commande.
checkout.session.async_payment_failedEnvoyé lorsqu’un paiement effectué avec un mode de paiement différé (par exemple, ACH Direct Debit) échoue.Informez le client de l’échec et redirigez-le vers la session pour qu’il effectue une nouvelle tentative de paiement.

Testez votre intégration

Pour tester l’intégration de votre formulaire de paiement hébergé par Stripe :

  1. Créer une session Checkout.
  2. 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.
  3. Cliquez sur Payer. Vous êtes alors redirigé vers votre success_url.
  4. Accédez au Dashboard et recherchez le paiement sur la page Transactions. Si votre paiement a été effectué, vous le verrez dans cette liste.
  5. 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.

Numéro de carteScénarioComment tester
Le paiement par carte est réussi et ne nécessite pas d’authentification.Remplissez le formulaire de paiement par carte de crédit en saisissant le numéro de carte de crédit ainsi qu’une date d’expiration, un CVC et un code postal de votre choix.
Le paiement par carte requiert une authentification.Remplissez le formulaire de paiement par carte de crédit en saisissant le numéro de carte de crédit ainsi qu’une date d’expiration, un CVC et un code postal de votre choix.
La carte est refusée avec un code de refus de type insufficient_funds.Remplissez le formulaire de paiement par carte de crédit en saisissant le numéro de carte de crédit ainsi qu’une date d’expiration, un CVC et un code postal de votre choix.
Le numéro de carte UnionPay a une longueur variable de 13 à 19 chiffres.Remplissez le formulaire de paiement par carte de crédit en saisissant le numéro de carte de crédit ainsi qu’une date d’expiration, un CVC et un code postal de votre choix.

Consultez la section Test pour obtenir des informations supplémentaires sur la manière de tester votre intégration.

Cartes de test

NuméroDescription
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.

Voir aussi

Cette page vous a-t-elle été utile?
OuiNon
Besoin d'aide? Contactez le service d'assistance.
Rejoignez notre programme d'accès anticipé.
Consultez notre journal des modifications.
Des questions? Contactez l'équipe commerciale.
GML? Lire llms.txt.
Optimisé par Markdoc
Code quickstart
Guides associés
API Elements Appearance
Plus de scénarios de paiement
Fonctionnement des cartes
Produits utilisés
Payments
Elements
Checkout