GuidesE-commerce

Tuto : intégrer le paiement Stripe Checkout dans une web app

Par l’équipe Banzai LabsMis à jour le 2 min de lecture

PayerStripe CheckoutRetourwebhookLa commande est validée par le webhook, pas par la page de retour
Le client paie sur la page Stripe ; la commande est confirmée par le webhook.

1. Créer la session (serveur)

import Stripe from 'stripe';
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);

export async function POST() {
  const session = await stripe.checkout.sessions.create({
    mode: 'payment',
    line_items: [{ price: 'price_123', quantity: 1 }],
    success_url: 'https://exemple.fr/merci?session_id={CHECKOUT_SESSION_ID}',
    cancel_url: 'https://exemple.fr/panier',
  });
  return Response.redirect(session.url!, 303);
}

Le prix price_123 est créé dans le tableau de bord Stripe ou par l’API : le montant ne vient jamais du navigateur.

2. Le parcours

  1. 1Clic sur PayerLe navigateur appelle votre serveur.
  2. 2Session crééeVotre serveur redirige vers la page Stripe.
  3. 3PaiementChez Stripe : carte, Apple Pay, Google Pay, 3-D Secure.
  4. 4Webhookcheckout.session.completed valide la commande.

3. La page de retour

Elle remercie et affiche le récapitulatif en relisant la session (session_id). Elle ne crée rien : c’est le rôle du webhook.

4. Mode abonnement

Même code avec mode: 'subscription' et un prix récurrent. Le portail client de Stripe gère ensuite carte, factures et résiliation.

La suite indispensable : des webhooks Stripe fiables. Le principe : le webhook.

Questions fréquentes

Checkout ou formulaire intégré ?
Checkout se met en place en une journée et gère cartes, portefeuilles et 3-D Secure. Un formulaire intégré (Payment Element) laisse plus de liberté de design, pour plus de travail.
Pourquoi ne pas valider la commande sur la page de retour ?
Le client peut fermer l’onglet avant d’y arriver. Le webhook, lui, arrive toujours, et Stripe le renvoie en cas d’échec.
Comment tester sans payer ?
En mode test, avec les clés de test et les numéros de carte de test fournis par Stripe.

À lire ensuite

Tous les guides