Dokumentation & Setup

Erfahre, wie du SyncroGate in wenigen Minuten zwischen Stripe und Lexoffice einrichtest.

1. Lexoffice API-Key generieren

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

Logge dich in deinen Lexoffice-Account ein.
Navigiere oben rechts über das Zahnrad zu Erweiterungen.
Scrolle nach unten zu Public API und generiere einen neuen API-Schlüssel.
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. Dazu muss ein Webhook eingerichtet werden.

Logge dich in das Stripe Dashboard ein und öffne Entwickler → Webhooks.
Klicke auf Endpunkt hinzufügen.
Trage die Webhook-URL ein, die dir im SyncroGate Dashboard angezeigt wird.
Wähle unter zu sendende Ereignisse folgende Events aus: checkout.session.completed und invoice.paid.
Speichere den Webhook. Stripe zeigt dir nun ein Signing Secret an (beginnt mit whsec_).
Trage dieses Secret im SyncroGate-Dashboard unter den API-Einstellungen 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.

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 Lexoffice 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 Lexoffice-Audit-Trail deines Dashboards kannst du den Status jederzeit einsehen und notfalls manuelle Retries anstoßen.