Öffne Einstellungen (Zahnrad oben rechts in der App) → Tab Integrationen, wähle deine Plattform, stelle den Umsatzsteuersatz ein, trage die Zugangsdaten ein und klicke auf Speichern. Kontolux zeigt dir eine persönliche Webhook-URL. Diese trägst du im Konto deiner Plattform ein. Ab dann bucht Kontolux jede Zahlung automatisch.
Webhook-Integration einrichten (allgemein)
-
Integrationen öffnen
Öffne Einstellungen (Zahnrad oben rechts in der App) und wechsle in den Tab Integrationen.
-
Umsatzsteuersatz wählen
Wähle für die Plattform 19 %, 7 %, „0 % – Kleinunternehmer nach § 19 UStG“ oder „Keine Angabe“; vorausgewählt ist keiner, ohne Auswahl lässt sich nicht speichern. Daraus ergeben sich Kategorie und Sachkonto der Belege. Bei „Keine Angabe“ legt Kontolux die Belege ohne Steuersatz an; sie bleiben offen, bis du den Satz im Beleg ergänzt. Der Satz gilt für alle Zahlungen dieser Plattform. Das Land des Kunden wertet Kontolux nur aus, wenn die Plattform es übermittelt und die Funktion „Bestellungen an Kunden im Ausland“ für dein Konto freigeschaltet ist; solche Belege bleiben dann zur Klärung offen. Bis dahin prüfst und korrigierst du Zahlungen mit abweichender Besteuerung, etwa von Kunden außerhalb Deutschlands, selbst am Beleg.
-
Zugangsdaten eintragen und speichern
Je nach Plattform: Secret, API-Key, Passphrase oder App-Zugangsdaten (siehe Tabelle unten). Klicke auf Speichern. Bei Stripe, PayPal und Shopify holst du dir zuerst die URL (siehe unten).
-
Webhook-URL beim Anbieter eintragen
Kopiere die angezeigte URL mit „Kopieren“ und trage sie im Konto deiner Plattform ein.
-
Aktiv-Status prüfen
Das Badge der Plattform zeigt Aktiv. Nach der nächsten Zahlung erscheint der Beleg im Belegarchiv.
Alle Plattformen im Überblick
| Plattform | Du brauchst | Webhook eintragen unter | Gebucht wird |
|---|---|---|---|
| Stripe | Signing-Secret (whsec_…) | Entwickler → Webhooks | Jede Zahlung einmal, Erstattungen, Rechnungs-PDFs |
| PayPal | Client ID, Secret, Webhook ID | developer.paypal.com → deine App → Webhooks | PAYMENT.CAPTURE.COMPLETED |
| Shopify | Signaturschlüssel des Shops | Einstellungen → Benachrichtigungen → Webhooks | Bezahlte Bestellungen, Erstattungen |
| Mollie | API-Key (live_…) | Entwickler → Webhooks | Zahlungen mit Status „paid“ |
| Digistore24 | IPN-Passphrase | Konto → Einstellungen → Integrationen → IPN | Verkäufe und Rebilling |
| CopeCart | Webhook-Secret | Einstellungen → Webhooks | Abgeschlossene Bestellungen |
| SumUp | Webhook-Secret | Einstellungen → Webhooks | Erfolgreiche Kartenzahlungen |
| Ablefy | nichts (geheime URL) | Einstellungen → Webhooks | Zahlungen, Raten, Erstattungen |
Für jede Plattform gibt es eine eigene Seite mit detaillierter Schritt-für-Schritt-Anleitung.
Stripe, PayPal und Shopify: erst URL, dann Secret
Bei Stripe und PayPal entsteht das Signing-Secret bzw. die Webhook ID erst, nachdem du die Kontolux-URL beim Anbieter eingetragen hast. Deshalb sind diese Karten — genau wie Shopify — in zwei Schritte geteilt:
- Schritt 1: Klicke auf „Webhook-URL anzeigen“, kopiere die URL und trag sie beim Anbieter ein.
- Schritt 2: Kopiere das Secret bzw. die Webhook ID vom Anbieter, trag es in Kontolux ein und speichere. Erst dann ist die Integration aktiv.
Was mit den automatischen Belegen passiert
- Sie erscheinen als bezahlte Belege im Belegarchiv, im Monatsabschluss und im DATEV-Export. Kontolux legt sie ohne Bestätigung im Einzelfall an; der Umsatzsteuersatz kommt aus deiner Einstellung für die Integration. Bei Regelbesteuerten zählen sie auch in Voranmeldung und EÜR, auch Zahlungen von Kunden außerhalb Deutschlands, solange die Funktion „Bestellungen an Kunden im Ausland“ für dein Konto nicht freigeschaltet ist (danach bleiben Belege mit Kunden im Ausland zur Klärung offen). Prüfe sie deshalb regelmäßig.
- Ist für eine Integration kein Satz gespeichert (etwa weil sie eingerichtet wurde, bevor es die Auswahl gab) oder hast du „Keine Angabe“ gewählt, nimmt Kontolux keinen Steuersatz an: Der Beleg trägt den Hinweis „Steuersatz offen“ und zählt bei Regelbesteuerten in Voranmeldung und EÜR als nicht berechnet, bis du den Satz im Beleg ergänzt. Einen früher gespeicherten Satz, etwa 19 % aus der Zeit, als dieser Satz vorausgewählt war, verwendet Kontolux weiter. Prüfe deshalb die Einstellung jeder bestehenden Integration.
- Du kannst Kategorie, Buchungstext und MwSt-Satz ändern und eine eigene Datei anhängen. Betrag und Datum bleiben gesperrt.
- Jedes Ereignis wird nur einmal gebucht, auch wenn die Plattform den Webhook wiederholt.
- Die Monatsabrechnungen der Plattformen legst du als Sammelbeleg ab — ohne Doppelbuchung.
Es kommen keine Belege an? Checkliste
- Steht das Badge der Plattform auf Aktiv?
- Hast du die Webhook-URL vollständig kopiert, ohne Leerzeichen am Ende?
- Ist das Secret bzw. die Passphrase in Kontolux und beim Anbieter exakt gleich?
- Hast du beim Anbieter die richtigen Ereignisse abonniert?
- Nutzt du Live-Zugangsdaten und keine Test-Zugangsdaten?
- Bei Stripe, PayPal und Shopify: Hast du Schritt 2 (Secret bzw. Webhook ID speichern) abgeschlossen?
- Bei Shopify: Hast du beide Webhooks angelegt (
Order paymentundRefund create) und das Format JSON gewählt?
Hilft nichts davon, schreib uns an info@kontolux-ai.de.
Häufige Fragen
Kann ich mehrere Plattformen gleichzeitig verbinden?
Ja. Jede Plattform hat ihre eigene Karte, eigene Zugangsdaten und einen eigenen Umsatzsteuersatz.
Werden meine Zugangsdaten angezeigt?
Nein. Nach dem Speichern zeigt Kontolux nur noch die letzten vier Zeichen an.
Wie beende ich eine Integration?
Lösche den Webhook im Konto der jeweiligen Plattform (bei SumUp: widerrufe den API-Schlüssel im SumUp-Dashboard). Danach kommen keine neuen Ereignisse mehr an. Bereits gebuchte Belege bleiben erhalten. Die bei Kontolux gespeicherten Zugangsdaten bleiben bis zur Kontolöschung gespeichert, weil es in der App noch keinen Knopf zum Trennen gibt; auf Anfrage an info@kontolux-ai.de löschen wir sie von Hand, spätestens innerhalb eines Monats.
Verwandte Artikel
Noch Fragen? Frag direkt den Chat in der App oder schreib an info@kontolux-ai.de. Wir antworten innerhalb von 24 Stunden.