De la création du compte au premier abonnement payant, avec les choix qui comptent à long terme.
Contenu relu:
Un paiement qui fonctionne ne suffit pas à valider une intégration Stripe. Taxes, prorata, recouvrement et webhooks demandent des choix explicites. Ce guide présente les bases pour un SaaS B2B ; prévoyez du temps supplémentaire pour la vérification du compte, le développement et les tests avant la mise en production.
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 par abonnement. Le temps de lecture exclut la mise en œuvre et la vérification. Ce guide ne certifie pas la conformité fiscale et ne fournit pas 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. Le mode test est disponible avant l'activation ; les paiements réels nécessitent l'approbation de Stripe. 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 une offre et Price son tarif pour une périodicité et une devise données, par exemple 29 € par mois ou 299 € par an. Créez un produit par offre et un tarif par périodicité et devise. Pour changer le montant d'un tarif, créez un nouveau Price et préparez la migration des abonnements concernés.
Attention
Archivez les tarifs déjà utilisés plutôt que de chercher à les supprimer : les abonnements existants peuvent encore y faire référence.
Étape 3
Choisir le bon comportement de taxe
Choisissez des prix taxes comprises (inclusive) ou hors taxes (exclusive) selon votre marché et les règles d'affichage applicables. Stripe Tax peut calculer les taxes des transactions prises en charge après configuration des catégories fiscales, de la localisation des clients et de vos immatriculations. Son activation ne vous immatricule pas automatiquement auprès des autorités fiscales et ne remplace pas vos obligations déclaratives.
Astuce
Faites confirmer par un conseiller fiscal où vous devez vous immatriculer, collecter et déclarer les taxes. Les tarifs de Stripe Tax et les services d'immatriculation ou de déclaration disponibles dépendent de l'offre et du pays ; vérifiez les conditions en vigueur.
Étape 4
Définir votre politique de prorata
Prévisualisez la facture avant de modifier un abonnement et choisissez une politique conforme à vos conditions de vente. create_prorations crée les lignes de prorata sans nécessairement les facturer immédiatement. always_invoice les facture immédiatement et tente le recouvrement lorsque cela s'applique ; cela ne garantit pas la réussite du paiement. Prévoyez le traitement des échecs avant d'accorder l'accès à une offre supérieure.
Étape 5
Configurer Smart Retries et comprendre la mise à jour des cartes
Consultez les réglages de recouvrement de Stripe. La configuration recommandée de Smart Retries prévoit 8 tentatives sur 2 semaines et reste modifiable. Un refus définitif exige un nouveau moyen de paiement ; la hausse de attempt_count ne prouve pas qu'un nouveau prélèvement a eu lieu. 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.
Astuce
Vérifiez votre contrat et les conditions Stripe en vigueur pour les frais. Les mises à jour et nouvelles tentatives ne garantissent pas le recouvrement.
Étape 6
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.
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 7
Configurer les webhooks
Dans Stripe Workbench → Webhooks → Create event destination, enregistrez l'URL de votre serveur. Choisissez des événements snapshot si votre intégration lit event.data.object. Selon vos besoins, sélectionnez customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.paid, invoice.payment_failed et customer.updated. Vérifiez la signature et enregistrez durablement les événements avant de les acquitter ; le guide dédié détaille leur traitement.
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. Testez aussi résiliation et recouvrement. N'utilisez jamais de vraies cartes en mode test ; ce tutoriel n'exige pas de paiement réel avec votre propre carte.
Utilisez une CLI Stripe authentifiée dans un environnement de test, jamais --live ni des identifiants réels. Lancez d'abord l'écoute locale. 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.
La CLI Stripe (stripe listen --forward-to localhost:3000/api/webhooks/stripe) transmet les événements à votre serveur local pour tester leur réception.
Ces choix posent une base de facturation que vous pouvez tester. Réévaluez les obligations fiscales, les échecs de paiement et le traitement des webhooks à mesure que votre activité évolue.
Checkout propose une page de paiement hébergée et réduit le travail d'intégration. Elements donne davantage de contrôle sur un formulaire intégré à votre interface. Choisissez selon votre parcours de paiement et vos contraintes ; chaque solution conserve des obligations de sécurité et de conformité pour votre entreprise.
Comment gérer la TVA UE correctement ?+
Configurez Stripe Tax pour les transactions prises en charge et vérifiez séparément vos immatriculations et obligations déclaratives. 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. Consultez un conseiller fiscal pour vos marchés.
Et si un client conteste un paiement ?+
Consultez les délais et les éléments demandés dans Stripe. Conservez les factures, les preuves d'acceptation des conditions et les échanges pertinents, dans le respect de vos obligations de protection des données. Présenter des preuves ne garantit pas une décision favorable.
