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
- Melden Sie sich bei dashboard.stripe.com an
- Wählen Sie das zu verbindende Konto (oder die Sandbox) aus
- Gehen Sie zu Developers > API keys
- 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
- ✅ Balance Transactions
- ✅ Charges
- ✅ Checkout Sessions
- ✅ Customers
- ✅ Invoices
- ✅ Payment Intents
- ✅ Payment Links
- ✅ Payouts
- ✅ Products
- ✅ Subscriptions
Connect — Read
- ✅ All Connect resources (zur Identifizierung Ihres Stripe-Kontos bei der Verbindung)
Stripe ordnet das Lesen Ihres eigenen Kontos im Schlüssel-Editor dem Abschnitt Connect zu, auch wenn Sie Stripe Connect nicht nutzen: Eine Zeile „Account" gibt es nicht. Order Invoicer liest nur Ihr eigenes Konto.
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
- Klicken Sie auf Create key
- Stripe zeigt den Schlüssel nur einmal an — kopieren Sie ihn sofort
- Er beginnt mit
rk_live_(Produktionsmodus) oderrk_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
- Wählen Sie in Order Invoicer Stripe als E-Commerce-Plattform aus
- Fügen Sie den eingeschränkten Schlüssel in das Feld Eingeschränkter API-Schlüssel ein
- 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_succeededundcharge.refundedzu empfangen) - eine erste Synchronisierung Ihrer bestehenden Payment Links auslösen
Um die Stripe-Auszahlungen eines bereits verbundenen Shops (WooCommerce, PrestaShop oder Wix) zu synchronisieren, öffnen Sie im Connector Auszahlungen → Zahlungsanbieter, klicken Sie auf der Stripe-Karte auf Verbinden, fügen Sie den Schlüssel ein und speichern Sie. Das Formular listet die erforderlichen Berechtigungen auf. Werden Ihre Bestellungen bereits über Stripe bezahlt, erscheint die Karte oben unter Empfohlen für diesen Connector.
Fehlerbehebung
„The key is not recognized" / Ungültige Zugangsdaten
- Überprüfen Sie, ob der Schlüssel tatsächlich mit
rk_test_oderrk_live_beginnt (publishable-Schlüsselpk_…und secret-Schlüsselsk_…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 required permissions"
Die Meldung listet die fehlenden Berechtigungen unter dem Namen auf, den sie im Stripe-Schlüssel-Editor tragen. So fügen Sie sie hinzu:
- Gehen Sie zurück zu Developers > API keys in Stripe
- Klicken Sie neben Ihrem eingeschränkten Schlüssel auf Edit
- Setzen Sie jede aufgeführte Berechtigung auf die angegebene Stufe (Read oder Write). All Connect resources finden Sie im Abschnitt Connect: Stripe ordnet dort das Lesen Ihres eigenen Kontos ein, eine Zeile „Account" gibt es nicht
- 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 All Connect resources: 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:
- Lesen Sie den obigen Abschnitt zur Fehlerbehebung
- Prüfen Sie den Stripe-Status unter status.stripe.com
- Kontaktieren Sie unseren Support:
contact@orderinvoicer.com