Architecture Stripe

Comprendre les objets Stripe

Un slider simple pour passer de “page de paiement” à une vraie logique backend : session, paiement réel, abonnement, facture, webhook et metadata.

Slide 1 / 9 Connexion Firebase en attente...

Vue d'ensemble

Stripe n'est pas juste une page de paiement

Stripe fonctionne avec plusieurs objets qui ont chacun un rôle précis.

  • Checkout = tunnel de paiement.
  • Payment Intent = transaction bancaire.
  • Webhook = vérité reçue par ton backend.
Illustration des objets Stripe reliés à une application

Checkout Session

Le tunnel de paiement

Checkout Session représente l'expérience de paiement que l'utilisateur termine.

  • Elle contient le produit, le prix, le client et les options.
  • Elle peut porter des metadata utiles à ton app.
  • checkout.session.completed veut dire : tunnel terminé.
Illustration de Checkout Session comme tunnel de paiement

Payment Intent

La transaction bancaire réelle

Payment Intent suit la tentative de paiement jusqu'à validation ou échec.

  • Carte, wallet, SEPA ou autre moyen de paiement.
  • Autorisation, validation, échec ou traitement différé.
  • payment_intent.succeeded est l'événement clé pour un paiement unique.
Illustration de Payment Intent comme transaction bancaire

Subscription

L'abonnement vivant

Subscription représente une relation récurrente entre un client et une offre.

  • Plan, fréquence, statut, renouvellement.
  • Peut démarrer avec un essai ou une première facture.
  • Son statut peut évoluer dans le temps.
Illustration de Subscription comme abonnement récurrent

Invoice

La facture et la preuve de paiement

Invoice est centrale pour les abonnements et la facturation.

  • Elle regroupe lignes, taxes, client et statut.
  • Elle peut être payée, ouverte, annulée ou échouée.
  • invoice.paid confirme qu'une facture d'abonnement est payée.
Illustration de Invoice comme facture Stripe

Webhooks

La vérité qui arrive au backend

Le webhook informe ton application qu'un événement Stripe s'est produit.

  • Paiement réussi, facture payée, abonnement modifié.
  • Ton backend reçoit l'événement et met la base à jour.
  • C'est plus fiable que de croire seulement le retour navigateur.
Illustration de webhooks Stripe envoyés au backend

Metadata

Le lien entre Stripe et ton business

Les metadata enrichissent Stripe avec ta logique métier.

  • Source d'acquisition, campagne, affilié.
  • Utilisateur, plan, workspace, projet.
  • Très utile pour analytics, ROI et support client.
Illustration de metadata reliées à analytics et base de données

Événements fiables

Completed ne veut pas toujours dire payé

Certains moyens de paiement sont différés : SEPA, virement, ACH, Klarna, etc.

  • checkout.session.completed : le tunnel est terminé.
  • payment_intent.succeeded : paiement unique validé.
  • invoice.paid : facture d'abonnement payée.
Illustration des événements Stripe fiables selon le cas

Architecture SaaS

Le flow propre à retenir

Une intégration Stripe solide relie paiement, backend, analytics et accès utilisateur.

  • Landing page → Checkout avec metadata.
  • Webhook → base de données et dashboard.
  • Événement fiable → accès débloqué.
Illustration d'une architecture SaaS Stripe complète
Télécommande mobile Retour au cours