Aller au contenu
Retour à l’académie
Stripe10 min de lecture

Configurer Stripe pour un SaaS, comme il faut

De la création du compte au premier abonnement payant, avec les choix qui comptent à long terme.

Abderrahim Ben Jazia, PhDPar · Fondateur de FlowMRR, a créé puis revendu AIS (Avance Immédiate Services), logiciel agréé Urssaf d'avance immédiate du crédit d'impôtContenu relu :

Un paiement qui fonctionne ne suffit pas à valider une intégration Stripe. Taxes, prorata, échecs de paiement et webhooks demandent chacun un choix explicite, et plusieurs sont difficiles à modifier une fois les clients facturés. Ce guide propose un choix par défaut pour chacun, pour un SaaS B2B, de la création du compte au premier abonnement réel.

Avant de commencer

  • Accès à un environnement de test Stripe et droits de configuration de la facturation.
  • Vos offres, périodicités, devises et règles d'accès au service.
  • Un responsable de l'intégration serveur et un conseil fiscal pour vos marchés.

Périmètre

Fondations d'un SaaS B2B par abonnement, de l'activation du compte au premier abonnement réel. Le temps de lecture exclut la mise en œuvre et les tests. Ce guide n'est ni un conseil fiscal ou juridique, ni une intégration de production complète.

Étape 1

Créer un compte Stripe et finaliser l'activation

Inscrivez-vous sur dashboard.stripe.com avec votre adresse professionnelle. Renseignez les informations demandées sur l'entreprise, ses bénéficiaires effectifs, son compte bancaire et sa situation fiscale. Vous pouvez développer et tester immédiatement dans un environnement de test ; les paiements réels nécessitent l'approbation de Stripe, dont le délai dépend du dossier et des justificatifs demandés.

Astuce

Utilisez une adresse dédiée, comme facturation@votreentreprise.com, pour suivre les notifications de litiges et de virements échoués.

Étape 2

Configurer produits et prix

Dans Stripe, Product représente ce que vous vendez (par exemple « FlowMRR Starter ») et Price une façon de le payer : un montant, une devise et une périodicité (par exemple 29 € par mois ou 299 € par an en EUR, ou 29 $ par mois en USD). Créez un produit par offre et un tarif par périodicité et devise. Un tarif appartient à un seul produit, et son montant, sa devise et sa périodicité ne peuvent jamais être modifiés après sa création, qu'il ait servi ou non : pour facturer un autre montant, créez un nouveau Price et migrez-y les abonnements.

Notre recommandation : donnez à chaque tarif une lookup_key, comme starter_monthly_eur, et faites rechercher les tarifs par clé côté serveur plutôt que de coder les identifiants en dur. Pour changer un prix, créez le nouveau tarif avec transfer_lookup_key : la clé lui est transférée et votre code l'utilise sans nouveau déploiement.

Attention

Un tarif déjà utilisé ne peut pas être supprimé. Archivez-le : il ne peut plus servir à de nouveaux achats, et les abonnements existants continuent d'y faire référence.

Étape 3

Choisir le bon comportement de taxe

Notre recommandation : des prix hors taxes (exclusive) pour un SaaS B2B, car les acheteurs professionnels comparent les prix hors taxes. Choisissez des prix taxes comprises (inclusive) si vous vendez surtout à des particuliers ou dans des marchés où l'affichage TTC est obligatoire. Décidez avant de créer vos tarifs : une fois le tax_behavior d'un tarif défini sur inclusive ou exclusive, il ne peut plus être modifié, et changer d'approche impose de nouveaux tarifs et une migration. Stripe Tax calcule ensuite les taxes des transactions prises en charge à partir des catégories fiscales, de la localisation des clients et de vos immatriculations. Il ne calcule les taxes que là où vous avez ajouté une immatriculation et ne vous immatricule pas auprès des autorités fiscales.

Astuce

Définissez un comportement de taxe par défaut dans les réglages de Stripe Tax pour que chaque nouveau tarif en hérite, au lieu de choisir tarif par tarif.

Étape 4

Créer votre premier abonnement

Notre recommandation : Stripe Checkout en mode abonnement (mode: 'subscription'), une page hébergée par Stripe qui gère les moyens de paiement, 3D Secure et, avec Stripe Tax activé, le calcul des taxes. Choisissez Elements si le formulaire de paiement doit être intégré à votre propre page. Dans les deux cas, créez la session Checkout ou l'abonnement côté serveur.

Quatre règles gardent la facturation et les comptes synchronisés :

  • Créez ou réutilisez un client Stripe : créez-le une seule fois par compte, puis transmettez son identifiant dans customer à chaque session Checkout, pour qu'un compte n'ait jamais plusieurs clients Stripe.
  • Reliez les deux enregistrements : stockez l'identifiant client Stripe sur votre compte, et votre identifiant de compte dans les metadata du client Stripe et le client_reference_id de la session.
  • Envoyez un en-tête Idempotency-Key avec chaque requête de création, et réutilisez la même clé en cas de nouvel essai, pour qu'une coupure réseau ne crée jamais un second client ou abonnement.
  • N'accordez l'accès qu'à partir des webhooks : activez le service sur checkout.session.completed et prolongez-le sur invoice.paid. La redirection de succès n'affiche qu'une confirmation ; le client peut fermer l'onglet avant son chargement, et n'importe qui peut ouvrir cette URL.
Attention

Ne faites jamais confiance à un identifiant de tarif, un identifiant client ou un montant envoyé par le navigateur. Associez l'offre choisie à une lookup_key côté serveur, et prenez l'identifiant client depuis le compte authentifié.

Étape 5

Définir votre politique de prorata

Prévisualisez la facture avant de modifier un abonnement, puis définissez proration_behavior lors de la mise à jour :

Notre recommandation : pour un passage à une offre supérieure, utilisez always_invoice avec payment_behavior: pending_if_incomplete. L'abonnement n'est modifié qu'une fois le paiement réussi, donc un client n'obtient jamais une offre supérieure impayée ; en cas d'échec, la modification reste en attente et expire sous 23 heures. Pour une offre inférieure, utilisez create_prorations, ou none si vos conditions prévoient que le prix réduit s'applique au renouvellement.

  • create_prorations (par défaut) : crée des lignes de prorata généralement facturées sur la prochaine facture ; Stripe ne les facture immédiatement que dans certains cas.
  • always_invoice : facture immédiatement le prorata et tente le prélèvement.
  • none : aucun prorata ; le client paie le nouveau tarif complet à partir de la prochaine facture.
Étape 6

Configurer Smart Retries et comprendre la mise à jour des cartes

Dans Billing → Recouvrement de revenus → Relances, laissez Smart Retries activé. Pour les nouveaux comptes, la configuration par défaut prévoit jusqu'à 8 tentatives sur 2 semaines, et reste modifiable. Un refus définitif exige un nouveau moyen de paiement : pour des codes comme lost_card ou stolen_card, Stripe continue de planifier des tentatives, et le attempt_count de la facture augmente, mais aucun prélèvement n'a lieu tant que le client n'a pas ajouté une nouvelle carte. La mise à jour automatique des cartes enregistrées est activée par défaut lorsque l'émetteur transmet de nouvelles informations, sans pouvoir prévoir quelles cartes en bénéficieront.

Sur la même page, choisissez ce qui se passe après l'échec de la dernière tentative :

  • Résilier l'abonnement : il prend fin ; un client qui revient s'abonne de nouveau.
  • Le marquer comme impayé (unpaid) : il est conservé mais Stripe ne tente plus de paiement ; régler la dernière facture le réactive.
  • Le laisser en retard de paiement (past_due) : il continue de générer des factures et de prélever selon vos réglages de relance, et le client garde l'accès tant que votre application ne le lui retire pas.

Notre recommandation : marquez l'abonnement comme impayé et coupez l'accès. Le client peut le réactiver en réglant la dernière facture, sans se réabonner. Résiliez plutôt si vous voulez une fin nette et faites repasser les clients qui reviennent par Checkout. Ne le laissez en past_due que si votre équipe relance les paiements manuellement.

Astuce

Dans Recouvrement de revenus → Emails, activez « Envoyer des e-mails en cas d'échec des paiements par carte bancaire » et « Envoyer des e-mails pour les cartes arrivant à expiration ». Ces emails renvoient vers une page où le client peut mettre à jour sa carte.

Étape 7

Configurer le portail client

Configurez les actions autorisées dans le portail client Stripe : moyens de paiement, factures, changement d'offre et résiliation. Depuis votre application, authentifiez l'utilisateur, vérifiez côté serveur qu'il est bien titulaire du compte client Stripe, puis créez une nouvelle session. Un identifiant client transmis par le navigateur ne prouve pas cette appartenance.

Notre recommandation : autorisez la mise à jour du moyen de paiement, l'historique des factures et la résiliation en fin de période de facturation. N'activez le changement d'offre qu'une fois les règles de prorata de l'étape 5 en place.

Attention

Une session expire après 5 minutes sans utilisation, ou dans l'heure suivant la dernière activité si elle a été utilisée. Ne placez pas son URL dans un email en espérant un accès durable. Utilisez une route de facturation authentifiée, ou le lien de connexion réutilisable du portail avec authentification par email auprès de Stripe.

Étape 8

Configurer les webhooks

Dans Stripe Workbench → Webhooks → Create event destination, enregistrez l'URL de votre serveur et choisissez des événements snapshot si votre intégration lit event.data.object.

Notre recommandation : commencez par ces événements.

  • checkout.session.completed : un client a terminé Checkout ; reliez l'abonnement au compte et activez l'accès.
  • customer.subscription.created, customer.subscription.updated et customer.subscription.deleted : changements d'offre, de quantité, de statut et résiliations ; coupez l'accès à la suppression.
  • invoice.paid : un paiement a réussi ; prolongez l'accès pour la nouvelle période.
  • invoice.payment_failed : un paiement a échoué ; signalez le compte et prévenez le client.
  • invoice.payment_action_required : le client doit authentifier le paiement (3D Secure, fréquent dans l'UE avec la DSP2) ; invitez-le à le finaliser.
  • customer.subscription.trial_will_end : envoyé 3 jours avant la fin d'un essai ; vérifiez qu'un moyen de paiement est enregistré.
  • customer.updated : les coordonnées de facturation ou le moyen de paiement par défaut ont changé.

Vérifiez la signature et enregistrez durablement chaque événement, puis répondez rapidement par un code 2xx et effectuez le traitement métier de façon asynchrone, par exemple via une file d'attente. Un gestionnaire trop lent expire et Stripe renvoie l'événement ; le guide dédié détaille le traitement et les nouvelles tentatives.

Vérification, traitement et reprise des webhooks
Étape 9

Tester de bout en bout avec les cartes de test

Utilisez les horloges de test Stripe (test clocks) : créez l'horloge, puis un client rattaché à celle-ci AVANT l'abonnement. Commencez avec 4242 4242 4242 4242 pour réussir le premier paiement. Rattachez ensuite 4000 0000 0000 0341, qui s'enregistre correctement mais fait échouer les prélèvements suivants, et définissez-la comme moyen de paiement par défaut utilisé par l'abonnement avant d'avancer jusqu'au renouvellement. Attendez que l'horloge soit prête et examinez les événements de facture avant d'avancer à nouveau. Pour 3D Secure, payez dans Checkout avec 4000 0025 0000 3155, qui demande une authentification ; pour déclencher invoice.payment_action_required lors d'un renouvellement, utilisez 4000 0027 6000 3184, qui exige une authentification à chaque prélèvement. Testez aussi un passage à une offre supérieure, la résiliation, l'issue après la dernière tentative et le recouvrement. Tout se déroule en mode test : vous n'avez jamais besoin de payer avec une vraie carte, y compris la vôtre.

Écoute locale et factures de test générées par la CLI

stripe listen --events invoice.paid,invoice.payment_failed --forward-to localhost:4242/webhook
stripe trigger invoice.paid
stripe trigger invoice.payment_failed

localhost:4242/webhook est un exemple : remplacez-le par la route de webhook de votre application. Lancez stripe listen dans un terminal dédié et utilisez le secret de signature whsec_ qu'il affiche pour la vérification locale, puis lancez les commandes trigger dans un second terminal. Utilisez une CLI Stripe authentifiée dans un environnement de test, jamais --live ni des identifiants réels. Ces commandes créent des objets de test et peuvent émettre d'autres événements ; elles ne testent pas votre renouvellement réel et ne remplacent pas les horloges de test.

Référence des tests avec la CLI Stripe

Étape 10

Passer en production

Le mode production est séparé de votre environnement de test : les objets et la plupart des réglages ne sont pas repris. Parcourez cette liste avant d'encaisser votre premier paiement réel.

  • Clés de production : stockez la clé secrète de production (ou une clé restreinte) comme secret serveur, et vérifiez qu'aucune clé de test n'arrive en production.
  • Nouvel endpoint de webhook : créez-le en mode production avec les mêmes événements ; il a son propre secret de signature, à mettre à jour en production.
  • Produits et prix de production : utilisez « Copier en mode production » sur chaque produit, ou recréez-les. Les tarifs de production ont de nouveaux identifiants : vérifiez que chacun porte la bonne lookup_key.
  • Réglages de production : revoyez le portail client, les relances, les emails clients et Stripe Tax (y compris vos immatriculations) en mode production ; ne supposez pas que les réglages de test ont été repris.
  • Transaction réelle facultative : souscrivez votre offre la moins chère avec une vraie carte, vérifiez l'accès, le traitement des webhooks et la facture, puis remboursez et résiliez l'abonnement. Stripe conserve ses frais de traitement en cas de remboursement : ce contrôle coûte quelques centimes.

Vous disposez maintenant d'une base de facturation testée, du premier tarif au premier abonnement réel. Réévaluez vos immatriculations fiscales, l'issue des tentatives de paiement et le traitement des webhooks à mesure que vous ajoutez des marchés, des offres et des moyens de paiement.

Vérifications finales

Voyez vos données Stripe prendre vie

Connectez Stripe à FlowMRR pour suivre le revenu récurrent, l'attrition, les cohortes et les paiements échoués à partir des données synchronisées.

Questions

Stripe Checkout ou Stripe Elements ?+

Commencez par Checkout, comme recommandé à l'étape 4. Utilisez Elements lorsque le formulaire de paiement doit être intégré à votre propre page.

Comment gérer la TVA UE correctement ?+

Configurez Stripe Tax et ajoutez une immatriculation pour chaque pays où vous devez collecter la TVA. L'autoliquidation B2B dépend de l'éligibilité de la transaction, de la localisation et du statut fiscal du client, pas de son seul numéro de TVA. Collectez les numéros de TVA dans Checkout pour que Stripe Tax applique l'autoliquidation lorsqu'elle est possible.

Et si un client conteste un paiement ?+

Répondez depuis le Dashboard Stripe avant la date limite indiquée sur le litige. Fournissez la facture, la preuve d'acceptation de vos conditions, les traces d'utilisation et les échanges pertinents, conservés dans le respect de vos obligations de protection des données.

Nous contacter
FlowMRR

Écrivez-nous

Une question, un souci technique ou une idée de partenariat ? Échangez avec l'équipe FlowMRR.