Construire un SaaS avec les paiements Stripe

Un SaaS fiable a besoin d’un système de paiement robuste. Stripe facilite l’encaissement, la gestion des abonnements et la facturation.

Configurer Stripe

Commencez par installer le SDK Stripe :

npm install stripe @stripe/stripe-js

Créez ensuite une instance Stripe côté serveur :

import Stripe from "stripe";

export const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!, {
  apiVersion: "2024-12-18.acacia",
});

Créer un abonnement

La création d’un abonnement suit trois étapes :

1. Créer un client
2. Associer un moyen de paiement
3. Créer l’abonnement

const subscription = await stripe.subscriptions.create({
  customer: customerId,
  items: [{ price: priceId }],
  payment_behavior: "default_incomplete",
  expand: ["latest_invoice.payment_intent"],
});

Traiter les webhooks

Les webhooks sont indispensables pour garder la base de données synchronisée :

export async function POST(req: Request) {
  const body = await req.text();
  const sig = req.headers.get("stripe-signature")!;

  const event = stripe.webhooks.constructEvent(body, sig, webhookSecret);

  switch (event.type) {
    case "customer.subscription.created":
      // Traiter le nouvel abonnement
      break;
    case "invoice.paid":
      // Traiter le paiement réussi
      break;
  }
}

Bonnes pratiques

• Utilisez toujours les webhooks pour la logique métier critique.
• Enregistrez les identifiants Stripe dans votre base de données.
• Gérez explicitement les erreurs.
• Testez localement avec la CLI Stripe.