Zum Inhalt springen

Integration · PayPal

PayPal Buchhaltung automatisch — Kontolux AI

PayPal-Einnahmen aus dem Kontoauszug abtippen? Nicht mehr nötig. Kontolux AI empfängt jede abgeschlossene PayPal-Zahlung per Webhook und legt sie automatisch als bezahlten Beleg in deinem Belegarchiv an.

Aktuell kostenlos · Keine Kreditkarte

Kurz erklärt

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

  1. Zahlung bei PayPalDein Kunde bezahlt wie gewohnt.
  2. Webhook an KontoluxPayPal meldet die Zahlung sofort an deine persönliche URL. Kontolux prüft die Echtheit.
  3. 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 EinstellungKategorie im BelegTypisch für
19 % UmsatzsteuerEinnahmen 19% (z. B. SKR03 8400)Regelbesteuerte Selbstständige
7 % UmsatzsteuerEinnahmen 7%Ermäßigte Leistungen, z. B. bestimmte Bücher
0 % – Kleinunternehmer nach § 19 UStGEinnahmen steuerfreiKleinunternehmer
Keine Angabekeine; 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.

  1. 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.

  2. 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.

  3. 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.COMPLETED und PAYMENT.CAPTURE.REFUNDED. PayPal zeigt dir danach die Webhook ID.

  4. Zugangsdaten speichern

    Trage in Kontolux unter „Schritt 2“ Client ID, Client Secret und Webhook ID ein und klicke auf Speichern.

  5. 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.

PayPal-Zahlungen automatisch gebucht.

Verbinde PayPal in fünf Minuten mit Kontolux AI — und jede Zahlung landet ab sofort von selbst in deiner Buchhaltung.

Jetzt kostenlos testen →

Kostenlos in der Beta · Keine Kreditkarte

Hinweis: Kontolux AI ist eine Software für deine eigene Buchhaltung. Sie rechnet mit deinen Angaben, prüft deinen Einzelfall nicht und berät nicht steuerlich oder rechtlich. Die Ratgeber-Inhalte sind allgemeine Informationen.