Order Invoicer
Stripe

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

  1. Connectez-vous à dashboard.stripe.com
  2. Sélectionnez le compte (ou la sandbox) à connecter
  3. Allez dans Développeurs > Clés API
  4. 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é

  1. Cliquez sur Créer une clé
  2. Stripe affiche la clé une seule fois — copiez-la immédiatement
  3. Elle commence par rk_live_ (mode production) ou rk_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

  1. Dans Order Invoicer, sélectionnez Stripe comme plateforme e-commerce
  2. Collez la clé restreinte dans le champ Clé API restreinte
  3. 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_succeeded et charge.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_ ou rk_live_ (les clés publishable pk_… et secret sk_… 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 :

  1. Retournez dans Développeurs > Clés API sur Stripe
  2. Cliquez sur Modifier à côté de votre clé restreinte
  3. Activez Account: Read
  4. 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 :

  1. Consultez la section de dépannage ci-dessus
  2. Vérifiez le statut de Stripe sur status.stripe.com
  3. Contactez notre support : contact@orderinvoicer.com

On this page