Übersicht der Stripe-Integration

Die Stripe-Integration ermöglicht automatische Rechnungsstellung, Fiskalisierung und den Versand von Rechnungen für Zahlungen, die über die Stripe-Plattform empfangen werden. Unterstützt werden einmalige Zahlungen über den Web-Checkout-Warenkorb sowie periodische Zahlungen über Stripe Subscription Invoicing.

Die Integration basiert auf dem Stripe-WebHooks-Mechanismus – bei Transaktionen oder Statusänderungen auf dem Stripe-Konto werden die Daten automatisch an Kigo gesendet, die ein Dokument erstellt und fiskalisiert.

Unterstützte externe Systeme

Neben direkten Stripe-Zahlungen erkennen und fiskalisieren wir automatisch Zahlungen, die über Stripe aus diesen Plattformen eingehen:

• Thinkific — Plattform für Online-Kurse
• Wix — Websites und Webshop
• Bokun — Ausflugs- und Tourbuchungen
• Weitere Plattformen — jede Zahlung, die zur Stripe-Transaktion Standard-Metadaten (E-Mail, Bestellnummer, Positionen) mitsendet, wird automatisch erkannt

Neben Stripe integriert sich Kigo direkt mit WooCommerce- und Shopify-Webshops und bietet eine REST-API zur Anbindung eigener Systeme.

WebHook einrichten

Vorgehensweise zur Erstellung eines Stripe-WebHooks:

1. Melden Sie sich im Stripe Dashboard unter dashboard.stripe.com an.
2. Öffnen Sie Developers → Webhooks und klicken Sie auf Add destination.
3. Wählen Sie im Schritt Select events die Ereignisse aus, die Sie verfolgen möchten:
   • invoice.payment_succeeded — wenn die Zahlung erfolgreich durchgeführt wurde
   • invoice.created — wenn eine Rechnung bei Stripe erstellt wurde
   • invoice.sent — wenn die Rechnung an den Kunden gesendet wurde
   • payment_intent.succeeded — wenn eine Zahlung ohne Rechnung erfolgreich bestätigt wurde
4. Wählen Sie Webhook endpoint als Zieltyp.
5. Fügen Sie im Feld Endpoint URL die Adresse aus den Kigo Stripe-Einstellungen ein.
6. Klicken Sie auf Create destination zum Speichern.

API-Schlüssel und Stripe Invoicing

Für die erweiterte Integration (Stripe Invoicing) ist ein geheimer API-Schlüssel erforderlich, der Kigo das Abrufen zusätzlicher Daten aus dem Stripe-System ermöglicht.

Vorgehensweise zum Erhalt des API-Schlüssels:

1. Öffnen Sie im Stripe Dashboard Developers → API keys.
2. Klicken Sie auf Create secret key und geben Sie einen Namen ein (z.B. Kigo).
3. Kopieren Sie den angezeigten geheimen Schlüssel – er wird nur einmal angezeigt.
4. Öffnen Sie in Kigo den Tab Stripe Invoicing Einstellungen und geben Sie den Schlüssel im vorgesehenen Feld ein.

Wichtig: Teilen Sie den geheimen API-Schlüssel nicht und senden Sie ihn nicht per E-Mail.

Vorteile der Stripe Invoice-Integration

WebHook-Ereignisse, die Stripe sendet, enthalten oft nicht alle Informationen, die für die Rechnungserstellung erforderlich sind (Kundenname, E-Mail, Bestellpositionen). Durch Eingabe des geheimen API-Schlüssels ermöglichen Sie Kigo, diese Daten automatisch durch Abruf aus dem Stripe-System zu ergänzen.

Zusätzliche Möglichkeiten umfassen:

• Abruf detaillierter Rechnungspositionen aus dem Stripe Invoice
• Verknüpfung von Bestellungen mit tatsächlichen Kunden
• Verfolgung des Zahlungsstatus
• Initiierung der Erstattungsausstellung

Häufige Fragen und Hinweise

• Kann ich nur den WebHook ohne API-Schlüssel verwenden? Ja, die grundlegende Integration über WebHook funktioniert ohne API-Schlüssel, aber die Daten auf der Rechnung können unvollständig sein (z.B. kann der Kundenname fehlen).
• Sendet Stripe Testanfragen? Ja, nach der Erstellung des WebHooks sendet Stripe Testanfragen, damit Sie die korrekte Integration überprüfen können.
• Welches Event für payment_intent.succeeded wählen? Dieses Event wird unterstützt, aber wenden Sie sich für zusätzliche Informationen zur Konfiguration an den Support.
• Was wenn die Integration nicht funktioniert? Überprüfen Sie die Korrektheit der URL im Stripe Dashboard, prüfen Sie das WebHook-Zustellungsprotokoll und kontaktieren Sie den Kigo-Support.