Order Invoicer
Stripe

Stripe konfigurieren

Einen eingeschränkten Stripe-Schlüssel erstellen und Ihre Zahlungen mit Order Invoicer verbinden

Voraussetzungen

Stellen Sie vor dem Start sicher, dass:

  • Sie über ein aktives Stripe-Konto verfügen (Test- oder Live-Modus)
  • Sie Administratorzugriff auf das Stripe-Dashboard haben
  • Ihr Stripe-Konto die Stripe-Nutzungsbedingungen akzeptiert hat (andernfalls sind Payment Links nicht aktiviert)

Order Invoicer verwendet einen eingeschränkten API-Schlüssel (Präfix rk_test_ oder rk_live_). Es ist keine Installation einer Stripe-Connect-App erforderlich — Sie behalten die volle Kontrolle über den Schlüssel und können ihn jederzeit über Ihr Stripe-Dashboard widerrufen.

Einen eingeschränkten Schlüssel erstellen

Zu den Stripe-API-Schlüsseln gehen

  1. Melden Sie sich bei dashboard.stripe.com an
  2. Wählen Sie das zu verbindende Konto (oder die Sandbox) aus
  3. Gehen Sie zu Developers > API keys
  4. Scrollen Sie nach unten zu Restricted keys und klicken Sie auf + Create restricted key

Dem Schlüssel einen Namen geben

Verwenden Sie einen aussagekräftigen Namen — zum Beispiel Order Invoicer — Payment Links. Der Name ist nur in Ihrem Stripe-Dashboard sichtbar; er hilft Ihnen, den Schlüssel wiederzufinden, falls Sie ihn jemals widerrufen müssen.

Die erforderlichen Berechtigungen aktivieren

Order Invoicer benötigt die folgenden Berechtigungen, um Payment Links zu synchronisieren und die entsprechenden Rechnungen zu erstellen:

Read

  • ✅ Account (zur Identifizierung Ihres Stripe-Kontos bei der Verbindung)
  • ✅ Balance Transactions
  • ✅ Charges
  • ✅ Checkout Sessions
  • ✅ Customers
  • ✅ Payment Intents
  • ✅ Payment Links
  • ✅ Payouts
  • ✅ Products

Write

  • ✅ Webhook Endpoints (Order Invoicer erstellt den Webhook bei der Verbindung automatisch)

Alle diese Berechtigungen sind erforderlich. Fehlt eine, weist Order Invoicer den Schlüssel mit einer Meldung zurück, die die fehlende Berechtigung angibt — fügen Sie sie einfach hinzu und versuchen Sie es erneut.

Den Schlüssel generieren und kopieren

  1. Klicken Sie auf Create key
  2. Stripe zeigt den Schlüssel nur einmal an — kopieren Sie ihn sofort
  3. Er beginnt mit rk_live_ (Produktionsmodus) oder rk_test_ (Testmodus)

Der Schlüssel ist nach dem Schließen des Fensters nicht mehr sichtbar. Falls Sie ihn verlieren, erstellen Sie einen neuen und widerrufen Sie den alten.

Den Schlüssel in Order Invoicer eingeben

  1. Wählen Sie in Order Invoicer Stripe als E-Commerce-Plattform aus
  2. Fügen Sie den eingeschränkten Schlüssel in das Feld Restricted API key ein
  3. Klicken Sie auf Weiter

Order Invoicer wird:

  • den Schlüssel überprüfen, indem es Ihre Stripe-Kontoinformationen liest
  • automatisch einen Webhook auf Ihrem Stripe-Konto registrieren (um die Ereignisse checkout.session.completed, checkout.session.async_payment_succeeded und charge.refunded zu empfangen)
  • eine erste Synchronisierung Ihrer bestehenden Payment Links auslösen

Fehlerbehebung

„The key is not recognized" / Ungültige Zugangsdaten

  • Überprüfen Sie, ob der Schlüssel tatsächlich mit rk_test_ oder rk_live_ beginnt (publishable-Schlüssel pk_… und secret-Schlüssel sk_… funktionieren für diesen Ablauf nicht)
  • Stellen Sie sicher, dass Sie den vollständigen Schlüssel ohne führende oder nachfolgende Leerzeichen kopiert haben
  • Überprüfen Sie, ob der Schlüssel nicht aus dem Stripe-Dashboard widerrufen wurde

„Restricted key is missing the 'Account: Read' permission"

Der Schlüssel wurde ohne die Berechtigung Account → Read erstellt. Stripe schließt sie standardmäßig nicht ein, daher muss sie ausdrücklich hinzugefügt werden:

  1. Gehen Sie zurück zu Developers > API keys in Stripe
  2. Klicken Sie neben Ihrem eingeschränkten Schlüssel auf Edit
  3. Aktivieren Sie Account: Read
  4. Speichern Sie und versuchen Sie die Verbindung in Order Invoicer erneut

„Failed to create Stripe webhook endpoint"

Der Schlüssel hat keine Berechtigung zum Schreiben von Webhooks. Bearbeiten Sie den Schlüssel, aktivieren Sie Webhook Endpoints: Write und versuchen Sie es erneut.

Den Schlüssel manuell testen

Sie können mit cURL überprüfen, ob ein eingeschränkter Schlüssel funktioniert:

curl https://api.stripe.com/v1/account \
  -u "rk_test_votre_cle:"

Eine JSON-Antwort, die Ihr Konto beschreibt (mit "id": "acct_..."), bestätigt, dass der Schlüssel gültig ist und über die Berechtigung Account: Read verfügt.

Sicherheit

  • Der eingeschränkte Schlüssel wird auf Seiten von Order Invoicer verschlüsselt gespeichert
  • Sie können ihn jederzeit über Developers > API keys in Stripe widerrufen — die Verbindung wird sofort getrennt
  • Order Invoicer führt keine Schreiboperationen auf Ihrem Stripe-Konto durch, außer der anfänglichen Erstellung des Webhooks

Support

Falls Sie auf Schwierigkeiten stoßen:

  1. Lesen Sie den obigen Abschnitt zur Fehlerbehebung
  2. Prüfen Sie den Stripe-Status unter status.stripe.com
  3. Kontaktieren Sie unseren Support: contact@orderinvoicer.com

Squarespace konfigurieren

Einen Squarespace-API-Schlüssel erstellen, um Order Invoicer zu verbinden

Sylius installieren

Sylius für die Integration mit Order Invoicer konfigurieren

Auf dieser Seite

VoraussetzungenEinen eingeschränkten Schlüssel erstellenZu den Stripe-API-Schlüsseln gehenDem Schlüssel einen Namen gebenDie erforderlichen Berechtigungen aktivierenDen Schlüssel generieren und kopierenDen Schlüssel in Order Invoicer eingebenFehlerbehebung„The key is not recognized" / Ungültige Zugangsdaten„Restricted key is missing the 'Account: Read' permission"„Failed to create Stripe webhook endpoint"Den Schlüssel manuell testenSicherheitSupport