Connecter Stripe à FlowMRR : accès, permissions et webhooks
Choisir une méthode, limiter les permissions et vérifier la synchronisation.
Contenu relu:
FlowMRR utilise les données Stripe pour suivre le revenu récurrent et le recouvrement. Vous pouvez choisir « Connecter avec Stripe » (OAuth) ou fournir une clé API. Ce guide explique les permissions, la configuration des webhooks et les vérifications à effectuer sans confondre accès accordé et traitement réussi.
Avant de commencer
Un compte FlowMRR et le droit d'autoriser l'accès au compte Stripe visé.
Un choix entre analyse en lecture seule et relances manuelles autorisées.
Une gestion sécurisée des identifiants et des environnements test ou réel correspondants.
Périmètre
Configuration et vérification de la connexion, pas création d'une intégration de facturation Stripe. Une relance manuelle réelle peut prélever un paiement ; aucun prélèvement n'est nécessaire pour terminer ce guide.
Étape 1
Choisir la méthode de connexion
« Connecter avec Stripe » vous redirige vers Stripe pour autoriser FlowMRR et lui remettre un jeton révocable. Les événements passent par la destination Connect de notre plateforme. Une clé API permet de choisir les permissions par ressource, mais demande de gérer la clé et de configurer un webhook sur le compte. Les deux méthodes permettent l'analyse si les données nécessaires sont lisibles ; vérifiez la première synchronisation et la livraison des événements.
Astuce
OAuth propose un parcours guidé ; la clé restreinte convient si vous souhaitez maîtriser les permissions ressource par ressource.
Étape 2
Comprendre l'accès en lecture-écriture
FlowMRR demande la portée read_write pour son intégration Stripe Connect OAuth. Cela décrit notre demande, sans affirmer que Stripe n'a jamais proposé read_only. FlowMRR lit les ressources de facturation pour l'analyse. Lorsque vous cliquez sur « Relancer le paiement », Invoice.pay tente de recouvrer une facture échouée existante et peut prélever le client. Avec une clé API, Points de terminaison webhook : Écriture permet aussi de créer ou supprimer le propre webhook de FlowMRR. FlowMRR ne modifie pas vos prix, abonnements ou fiches clients.
Attention
L'écran de consentement Stripe indiquera que FlowMRR peut « gérer » votre compte. C'est la formulation générique de Stripe pour la portée read_write ; notre comportement réel est décrit ci-dessus et dans notre page d'engagements sur les données.
Étape 3
Créer une clé API restreinte
Dans les paramètres des clés API Stripe, créez une clé restreinte nommée FlowMRR. Accordez les permissions de lecture nécessaires sur Clients, Abonnements, Factures, Produits, Prix, Coupons, Paiements, Remboursements, Litiges, Payment Intents, Moyens de paiement, Solde et Transactions de solde. Préférez des permissions par ressource aux groupes étendus. Ajoutez Factures : Écriture seulement pour les relances manuelles, et Points de terminaison webhook : Écriture seulement pour laisser FlowMRR gérer son propre webhook. Gardez la clé secrète et collez-la dans FlowMRR, jamais sur une page publique ou dans un message d'assistance.
Astuce
Pour renouveler une clé, créez sa remplaçante, enregistrez-la dans Paramètres → Stripe et vérifiez l'accès et la synchronisation avant de révoquer l'ancienne dans Stripe.
Étape 4
Comprendre les limites d'une clé en lecture seule
Une clé en lecture seule permet l'analyse si elle dispose de permissions suffisantes sur les ressources nécessaires. « Relancer le paiement » exige Factures : Écriture ; l'enregistrement automatique du webhook exige Points de terminaison webhook : Écriture. Sans webhook configuré, les mises à jour reposent sur la synchronisation planifiée plutôt que sur la livraison d'événements. Vérifiez la dernière synchronisation et les erreurs de permission : la lecture seule ne garantit pas à elle seule des données complètes. Vous pouvez enregistrer le webhook manuellement sans autoriser sa gestion par FlowMRR.
Étape 5
Enregistrer le webhook manuellement
Ouvrez FlowMRR → Paramètres → Stripe et utilisez « Enregistrer le webhook manuellement » pour obtenir l'URL et la liste exacte d'événements. Dans Stripe Workbench → Webhooks → Create event destination, collez l'URL, choisissez des événements snapshot et sélectionnez exactement la liste actuellement affichée par FlowMRR. Enregistrez le secret de signature commençant par whsec_ dans FlowMRR, avec éventuellement l'identifiant de la destination, puis validez. Un webhook configuré ne prouve pas la livraison ni le traitement réussis : vérifiez-les séparément.
Utilisez la liste affichée par FlowMRR, pas des exemples avec jokers ou tous les événements. Protégez le secret de signature comme un identifiant et vérifiez que le mode test ou réel correspond à la connexion.
Étape 6
Vérifier que tout fonctionne
Dans Paramètres → Stripe, consultez le mode de connexion, la configuration du webhook et la dernière synchronisation. Lancez la première synchronisation et vérifiez son achèvement ou ses erreurs ; sa durée dépend du volume du compte. Vérifiez la livraison d'un événement pertinent dans Stripe puis les données résultantes dans FlowMRR. Un statut de configuration ne prouve ni le traitement ni une mise à jour instantanée. Utilisez des identifiants réels pour les données réelles et des identifiants de test uniquement pour les essais.
Étape 7
Mettre en pause, révoquer et supprimer
Utilisez les contrôles de connexion pour mettre la synchronisation en pause, « Supprimer les identifiants » pour retirer l'accès stocké et l'option d'effacement disponible pour supprimer les données synchronisées dérivées. Avec une clé API, le nettoyage concerne le propre webhook de FlowMRR et nécessite la permission adaptée. Révoquez l'accès OAuth ou la clé dans Stripe lorsque vous y mettez fin. Consultez les engagements sur les données pour la conservation et la suppression de compte ; effacer les données FlowMRR n'implique pas de supprimer une fiche client Stripe.
Choisissez OAuth pour une connexion guidée ou une clé restreinte pour contrôler les permissions. Retenez les deux opérations d'écriture : gérer le propre webhook de FlowMRR lorsque cela est autorisé et relancer manuellement une facture, avec un prélèvement possible. Vérifiez la synchronisation après configuration.
FlowMRR peut-il prélever mes clients ou changer mes prix ?+
Une action manuelle « Relancer le paiement » utilise Invoice.pay sur une facture échouée existante et peut prélever le client. FlowMRR ne modifie pas les prix, abonnements ou fiches clients. Avec Points de terminaison webhook : Écriture sur une clé API, il peut créer ou supprimer son propre webhook ; cette gestion n'est pas un accès en lecture seule.
Où sont stockés mes identifiants ?+
Ils sont chiffrés au repos et utilisés côté serveur pour les accès Stripe autorisés. Retirez les identifiants stockés dans les Paramètres et révoquez l'accès dans Stripe selon le besoin. Consultez les engagements sur les données pour l'hébergement et la conservation actuels ; ne publiez jamais une clé.
La portée read_write donne-t-elle à FlowMRR accès à mon solde ou à mes virements ?+
Nous lisons votre solde pour afficher la trésorerie disponible dans la vue Trésorerie ; nous ne déplaçons jamais d'argent, ne demandons pas de virements et ne touchons pas aux coordonnées bancaires. L'initiation de virement n'est pas un appel que FlowMRR effectue, quelle que soit la portée accordée par Stripe.
