Passer au contenu principal

Comment fonctionne l'intégration entre Okimia et Stripe ?

Okimia s'intègre à Stripe pour récupérer vos factures clients et les détails de vos transactions Stripe.

S
Écrit par Support Okimia

L'intégration avec Stripe vous permet d'enrichir votre interface Okimia 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 Okimia, 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 :

    Onglet Développeurs de Stripe.

💡 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 Okimia - Intégration, puis configurez les permissions ci-dessous. Toutes les permissions doivent être réglées sur Lecture (Read) : Okimia 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). Okimia 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 Okimia :

  • Balance transactions et Balance transaction sources permettent de remonter l'ensemble des flux financiers transitant par Stripe ;

  • Charges est nécessaire pour récupérer le détail de chaque paiement individuel ;

  • 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_. 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. Si vous la perdez, vous devrez la révoquer et en créer une nouvelle.

  • Collez la clé restreinte sur votre compte Okimia, puis Valider

  • Sélectionnez les données que vous souhaitez importer depuis Stripe, puis cliquez sur Synchroniser les données

  • 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 👇🏻

Articles connexes
Avez-vous trouvé la réponse à votre question ?