Configurer Stripe
Créez une clé restreinte Stripe et connectez vos paiements à Order Invoicer
Prérequis
Avant de commencer, assurez-vous que :
- Vous disposez d'un compte Stripe actif (mode test ou live)
- Vous avez un accès administrateur au tableau de bord Stripe
- Votre compte Stripe a accepté les Conditions de Service Stripe (sinon les Payment Links ne sont pas activés)
Order Invoicer utilise une clé API restreinte (préfixe rk_test_ ou rk_live_). Aucune installation d'app Stripe Connect n'est nécessaire — vous gardez le contrôle total de la clé et pouvez la révoquer à tout moment depuis votre tableau de bord Stripe.
Créer une clé restreinte
Accédez aux clés API Stripe
- Connectez-vous à dashboard.stripe.com
- Sélectionnez le compte (ou la sandbox) à connecter
- Allez dans Développeurs > Clés API
- Faites défiler jusqu'à Clés restreintes et cliquez sur + Créer une clé restreinte
Donnez un nom à la clé
Utilisez un nom explicite — par exemple Order Invoicer — Payment Links. Le nom n'est visible que dans votre tableau de bord Stripe ; il vous aide à retrouver la clé si vous devez la révoquer.
Activez les permissions requises
Order Invoicer a besoin des permissions suivantes pour synchroniser les Payment Links et créer les factures correspondantes :
Lecture (Read)
- ✅ Account (pour identifier votre compte Stripe à la connexion)
- ✅ Balance Transactions
- ✅ Charges
- ✅ Checkout Sessions
- ✅ Customers
- ✅ Payment Intents
- ✅ Payment Links
- ✅ Payouts
- ✅ Products
Écriture (Write)
- ✅ Webhook Endpoints (Order Invoicer crée le webhook automatiquement à la connexion)
Toutes ces permissions sont obligatoires. Si l'une d'elles manque, Order Invoicer rejettera la clé avec un message indiquant la permission absente — il suffit alors de l'ajouter et de réessayer.
Générez et copiez la clé
- Cliquez sur Créer une clé
- Stripe affiche la clé une seule fois — copiez-la immédiatement
- Elle commence par
rk_live_(mode production) ourk_test_(mode test)
La clé n'est plus visible après avoir fermé la fenêtre. Si vous la perdez, créez-en une nouvelle et révoquez l'ancienne.
Renseignez la clé dans Order Invoicer
- Dans Order Invoicer, sélectionnez Stripe comme plateforme e-commerce
- Collez la clé restreinte dans le champ Clé API restreinte
- Cliquez sur Suivant
Order Invoicer va :
- Vérifier la clé en lisant les informations de votre compte Stripe
- Enregistrer automatiquement un webhook sur votre compte Stripe (pour recevoir les événements
checkout.session.completed,checkout.session.async_payment_succeededetcharge.refunded) - Déclencher une première synchronisation de vos Payment Links existants
Dépannage
« La clé n'est pas reconnue » / Identifiants invalides
- Vérifiez que la clé commence bien par
rk_test_ourk_live_(les clés publishablepk_…et secretsk_…ne fonctionnent pas pour ce flux) - Assurez-vous d'avoir copié la clé complète, sans espace en début ou en fin
- Vérifiez que la clé n'a pas été révoquée depuis le tableau de bord Stripe
« Restricted key is missing the 'Account: Read' permission »
La clé a été créée sans la permission Account → Read. Stripe ne l'inclut pas par défaut, il faut l'ajouter explicitement :
- Retournez dans Développeurs > Clés API sur Stripe
- Cliquez sur Modifier à côté de votre clé restreinte
- Activez Account: Read
- Enregistrez et réessayez la connexion dans Order Invoicer
« Failed to create Stripe webhook endpoint »
La clé n'a pas l'autorisation d'écrire des webhooks. Modifiez la clé et activez Webhook Endpoints: Write, puis réessayez.
Tester manuellement la clé
Vous pouvez vérifier qu'une clé restreinte fonctionne avec cURL :
curl https://api.stripe.com/v1/account \
-u "rk_test_votre_cle:"Une réponse JSON décrivant votre compte (avec "id": "acct_...") confirme que la clé est valide et possède la permission Account: Read.
Sécurité
- La clé restreinte est stockée chiffrée côté Order Invoicer
- Vous pouvez la révoquer à tout moment depuis Développeurs > Clés API sur Stripe — la connexion sera immédiatement coupée
- Order Invoicer n'effectue aucune opération en écriture sur votre Stripe en dehors de la création initiale du webhook
Support
Si vous rencontrez des difficultés :
- Consultez la section de dépannage ci-dessus
- Vérifiez le statut de Stripe sur status.stripe.com
- Contactez notre support :
contact@orderinvoicer.com