L'intégration avec Stripe vous permet d'enrichir votre interface Fygr grâce à la remontée des données de vos factures clients et les détails de vos transactions Stripe.

Afin d'effectuer une connexion avec Stripe, suivez les étapes ci-dessous :

Sur votre compte Fygr, cliquez sur le bonhomme en haut à droite, puis cliquez sur Intégrations :
Cliquez sur Ajouter une intégration :
Sélectionnez Stripe, puis Valider :
Sur votre compte Stripe, accédez à l'onglet Développeurs, puis à la sous-section Clés API :

💡 Pourquoi une clé restreinte plutôt qu'une clé secrète ?

Une clé secrète Stripe (sk_live_...) donne un accès total à votre compte : création de paiements, remboursements, virements, accès aux données clients. À l'inverse, une clé restreinte (rk_live_...) ne dispose que des permissions strictement nécessaires à l'intégration. En cas de compromission, l'impact est limité aux seules actions autorisées. Stripe recommande d'ailleurs systématiquement l'usage des clés restreintes plutôt que des clés secrètes.

Dans la section Clés restreintes, cliquez sur + Créer une clé limitée :
Donnez un nom descriptif à votre clé, par exemple Fygr - Intégration, puis configurez les permissions ci-dessous. Toutes les permissions doivent être réglées sur Lecture (Read) : Fygr ne modifie jamais vos données Stripe, il ne fait que les lire.

PERMISSIONS À ACCORDER À LA CLÉ RESTREINTE

Dans le formulaire de création de la clé restreinte, configurez exactement les permissions suivantes :

Ressources principales (Core resources)

Balance transactions (Transactions du solde) : Lecture ;
Balance transaction sources (Sources des transactions du solde) : Lecture ;
Charges (Paiements) : Lecture.

Ressources de facturation (Billing resources)

Invoices (Factures) : Lecture ;
Customers (Clients) : Lecture.

Toutes les autres permissions doivent rester sur Aucune (None). Fygr n'a besoin d'aucun accès en écriture sur votre compte Stripe.

💡 À quoi servent ces permissions ?

Chaque permission correspond à une donnée précise affichée dans Fygr :

Balance transactions et Balance transaction sources permettent de remonter l'ensemble des flux financiers transitant par Stripe (paiements reçus, frais, virements vers votre compte bancaire) ainsi que leur libellé détaillé (nom du client, description du paiement) ;
Charges est nécessaire pour récupérer le détail de chaque paiement individuel adossé à une transaction ;
Invoices et Customers permettent d'importer vos factures clients Stripe avec le nom du client associé.

Validez la création de la clé. Stripe vous affiche alors la clé restreinte, qui commence par rk_live_ (ou rk_test_ en mode test). Cliquez dessus pour la copier :

💡 Attention

La clé restreinte n'est affichée dans sa totalité qu'au moment de sa création. Copiez-la immédiatement et conservez-la dans un endroit sûr le temps de la coller dans Fygr. Si vous la perdez, vous devrez la révoquer et en créer une nouvelle.

Collez la clé restreinte sur votre compte Fygr, puis Valider :
Sélectionnez les données que vous souhaitez importer depuis Stripe, puis cliquez sur Synchroniser les données :
NB : 512 correspond aux transactions et 411 correspond aux factures clients.
Une fois la synchronisation terminée, cliquez sur Voir mon dashboard :
Allez sur l'onglet Échéances pour voir toutes vos factures importées :

Pour en savoir plus, consultez notre tutoriel vidéo 👇🏻

Comment fonctionne l’intégration entre Fygr et Stripe ?

PERMISSIONS À ACCORDER À LA CLÉ RESTREINTE