Kontolux AI nutzt die offizielle PayPal-REST-Schnittstelle: Bei jeder abgeschlossenen Zahlung (Event PAYMENT.CAPTURE.COMPLETED) schickt PayPal einen Webhook, Kontolux lässt ihn von PayPal verifizieren und bucht die Zahlung als Einnahme-Beleg mit Umsatzsteuersatz und Sachkonto. Du brauchst dafür eine PayPal-App mit Client ID, Secret und Webhook ID.
So funktioniert die PayPal-Integration
- Zahlung bei PayPalDein Kunde bezahlt wie gewohnt.
- Webhook an KontoluxPayPal meldet die Zahlung sofort an deine persönliche URL. Kontolux prüft die Echtheit.
- Beleg im ArchivBezahlter Beleg mit dem eingestellten MwSt-Satz, Kategorie und Sachkonto; ohne eingestellten Satz bleibt er offen.
Für die Verbindung legst du auf developer.paypal.com eine eigene „App“ an. Kontolux nutzt deren Zugangsdaten nur für einen Zweck: jede eingehende Webhook-Nachricht bei PayPal gegenprüfen zu lassen. So kann niemand gefälschte Zahlungen in dein Belegarchiv schleusen.
Welche PayPal-Ereignisse gebucht werden
PAYMENT.CAPTURE.COMPLETED— eine abgeschlossene Zahlung wird als Einnahme gebucht.PAYMENT.CAPTURE.REFUNDED— Erstattungen werden automatisch als Abzug gebucht. Abonniere dieses Event beim Webhook in deiner PayPal-App mit.- Andere Ereignisse wie abgelehnte Zahlungen werden ignoriert.
Gut zu wissen: PayPal meldet per Webhook zuverlässig Zahlungen, die über den PayPal-Checkout bzw. die REST-Schnittstelle laufen. Direkte Zahlungen per „Geld senden“ oder über Drittsysteme lösen nicht immer ein Event aus. Gleiche deshalb einmal im Monat mit deiner PayPal-Aktivitätenübersicht ab.
Was im Beleg steht
Betrag, Zahlungsdatum, Zahler, die PayPal-Transaktions-ID als Buchungstext sowie Kategorie und Sachkonto nach deinem Kontenrahmen (SKR03 oder SKR04).
Umsatzsteuer, Kategorie und Sachkonto
Den Umsatzsteuersatz legst du einmal pro Integration fest. Kontolux ordnet jedem Einnahme-Beleg daraus die passende Kategorie und das Sachkonto deines Kontenrahmens zu. 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 (mehr in der Hilfe); solche Belege bleiben dann zur Klärung offen. Bis dahin zählen solche Zahlungen mit dem eingestellten Satz; verkaufst du auch ins Ausland, prüfe und korrigiere diese Belege selbst.
| Deine Einstellung | Kategorie im Beleg | Typisch für |
|---|---|---|
| 19 % Umsatzsteuer | Einnahmen 19% (z. B. SKR03 8400) | Regelbesteuerte Selbstständige |
| 7 % Umsatzsteuer | Einnahmen 7% | Ermäßigte Leistungen, z. B. bestimmte Bücher |
| 0 % – Kleinunternehmer nach § 19 UStG | Einnahmen steuerfrei | Kleinunternehmer |
| Keine Angabe | keine; Beleg ohne Steuersatz mit Hinweis „Steuersatz offen“ | Satz steht noch nicht fest; bei Regelbesteuerung zählt der Beleg bis zur Ergänzung als nicht berechnet |
Jeden automatisch angelegten Beleg kannst du im Belegarchiv nachträglich anpassen: Kategorie, Buchungstext und MwSt-Satz ändern oder eine Datei anhängen. Betrag und Datum bleiben gesperrt, weil sie direkt von PayPal stammen.
PayPal mit Kontolux verbinden: Schritt für Schritt
Du brauchst ein Kontolux-Konto (kostenlos) und Zugriff auf dein PayPal-Konto.
-
PayPal-App anlegen
Melde dich auf developer.paypal.com an, öffne Apps & Credentials, wechsle auf Live und erstelle eine neue App. Kopiere Client ID und Secret.
-
Webhook-URL anzeigen
Öffne in Kontolux Einstellungen → Integrationen → PayPal, wähle deinen Umsatzsteuersatz und klicke unter „Schritt 1“ auf Webhook-URL anzeigen. Kopiere die URL.
-
Webhook bei PayPal hinzufügen
Öffne in deiner PayPal-App den Bereich Webhooks → Add Webhook, füge die Kontolux-URL ein und abonniere die Events
PAYMENT.CAPTURE.COMPLETEDundPAYMENT.CAPTURE.REFUNDED. PayPal zeigt dir danach die Webhook ID. -
Zugangsdaten speichern
Trage in Kontolux unter „Schritt 2“ Client ID, Client Secret und Webhook ID ein und klicke auf Speichern.
-
Fertig
Das Badge wechselt auf Aktiv. Neue PayPal-Zahlungen erscheinen ab jetzt automatisch im Belegarchiv.
Mehr Details zu allen Plattformen findest du im Hilfe-Artikel Zahlungsanbieter per Webhook verbinden.
Für wen sich die PayPal-Integration lohnt
Freelancer mit Kunden im Ausland
Kunden zahlen bequem per PayPal — die Einnahme ist sofort erfasst.
Kleine Online-Shops
PayPal-Checkout-Zahlungen landen ohne Export-Umweg im Belegarchiv.
Kreative & Künstler
Auftragsarbeiten und Prints per PayPal abrechnen, ohne Buchhaltungsstau am Monatsende.
Häufige Fragen zur PayPal-Buchhaltung
Muss ich PayPal-Einnahmen versteuern?
Ja. Geschäftliche Zahlungen über PayPal sind Betriebseinnahmen und gehören in deine Buchhaltung — genauso wie Überweisungen aufs Bankkonto. Kontolux erfasst sie automatisch als Beleg, damit keine Zahlung in der Einnahmenüberschussrechnung fehlt.
Brauche ich ein PayPal-Geschäftskonto?
Für Live-Zugangsdaten auf developer.paypal.com brauchst du in der Regel ein PayPal-Geschäftskonto. Die Umstellung eines Privatkontos ist bei PayPal kostenlos.
Warum braucht Kontolux Client ID und Secret?
Damit Kontolux jede eingehende Webhook-Nachricht direkt bei PayPal verifizieren kann. Kontolux löst damit keine Zahlungen aus und hat keinen Zugriff auf dein Guthaben.
Werden PayPal-Gebühren gebucht?
Nein, gebucht wird der Zahlungseingang. PayPal-Gebühren erfasst du als Ausgabe, z. B. monatlich gesammelt aus deiner PayPal-Übersicht.
Was passiert mit Rückerstattungen?
Wenn du beim Webhook das Event PAYMENT.CAPTURE.REFUNDED mit abonnierst, bucht Kontolux Erstattungen automatisch als Abzug.
Kann ich einen PayPal-Beleg bearbeiten?
Kategorie, Buchungstext und MwSt-Satz kannst du im Belegarchiv ändern und eine Datei anhängen. Betrag und Datum kommen von PayPal und bleiben gesperrt.
Was kostet die PayPal-Integration?
Nichts extra. Alle Integrationen sind in Kontolux AI enthalten, und Kontolux ist in der aktuellen Beta-Phase komplett kostenlos.