Dokumentation & Setup

Erfahre, wie du SyncroGate in wenigen Minuten zwischen Stripe und Lexware Office oder sevdesk einrichtest.

1. Lexware Office / sevdesk API-Key generieren

SyncroGate benötigt Schreibzugriff auf dein Buchhaltungssystem, um Belege als Entwurf oder festgeschrieben (Live-Modus) zu erzeugen.

Logge dich in dein Buchhaltungssystem ein.
Für Lexware Office: Navigiere oben rechts über das Zahnrad zu Erweiterungen → Public API und generiere einen neuen Schlüssel.
Für sevdesk: Klicke links unten auf Einstellungen → Benutzer, wähle deinen Namen und klicke auf API Token einblenden.
Kopiere diesen Schlüssel und füge ihn im SyncroGate-Dashboard unter Einstellungen → Schnittstellen ein.

2. Stripe Webhook einrichten

Stripe informiert SyncroGate in Echtzeit über erfolgreiche Zahlungen und Rückerstattungen. Dazu muss ein Webhook eingerichtet werden.

Logge dich in das Stripe Dashboard ein und öffne Entwickler/innen → Webhooks.
Klicke auf Ziel hinzufügen.
Wähle unter zu sendende Ereignisse folgende Events aus: checkout.session.completed, invoice.paid und charge.refunded.
Die API-Version muss nicht geändert werden.
Trage die Webhook-URL ein, die dir im SyncroGate Dashboard angezeigt wird.
Speichere den Webhook durch einen Klick auf Ziel erstellen.
Lass das Signatur-Geheimnis aufdecken (whsec_) und füge dieses im SyncroGate-Dashboard ein.

3. Unterstützte Stripe-Events

checkout.session.completed

Wird gefeuert, wenn ein Kunde einen Einmal-Kauf oder ein neues Abonnement über Stripe Checkout erfolgreich abschließt.

invoice.paid

Wird gefeuert, wenn eine wiederkehrende Zahlung (Subscription Renewal) erfolgreich abgebucht wurde.

charge.refunded

Erzeugt vollautomatisch eine Gutschrift / Rechnungskorrektur in Lexware Office oder sevdesk, sobald du via Stripe eine Rückerstattung auslöst.

4. Ausfallsicherheit (Idempotenz & Queue)

SyncroGate nutzt eine robuste Serverless-Infrastruktur. Wenn ein Webhook von Stripe bei uns eingeht, wird dieser zunächst als Pending in unserer PostgreSQL-Datenbank abgelegt (Idempotenz).

Sollte das Zielsystem zu diesem Zeitpunkt aufgrund von Wartungsarbeiten oder Rate-Limits nicht erreichbar sein, übernimmt unsere Hintergrund-Queue. Das System versucht die Verarbeitung automatisch mit einem exponentiellen Backoff bis zu 5-mal erneut, um Datenverlust auszuschließen. Im Event-Audit-Trail deines Dashboards kannst du den Status jederzeit einsehen und notfalls manuelle Retries anstoßen.