GuidesE-commerce
Tuto : intégrer le paiement Stripe Checkout dans une web app
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
- 1Clic sur PayerLe navigateur appelle votre serveur.
- 2Session crééeVotre serveur redirige vers la page Stripe.
- 3PaiementChez Stripe : carte, Apple Pay, Google Pay, 3-D Secure.
- 4Webhook
checkout.session.completedvalide 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.