PayPal verbinden

PayPal wird über eine eigene REST-App in deinem PayPal-Konto verbunden. Das dauert einmalig ein paar Minuten, danach läuft alles automatisch.

Einrichtung

1. Im PayPal Developer Dashboard unter Apps & Credentials eine eigene REST-App anlegen (Create App, Name z. B. Rechnungskit). Wichtig: oben Live auswählen, nicht Sandbox. Rechnungskit braucht Live-Zugangsdaten, auch im Rechnungskit-Testmodus.
2. In der App unter Add-on services das Häkchen Transaction search AKTIVIEREN (standardmäßig aus). Wichtig: PayPal schaltet die Daten erst mit bis zu 9 Stunden Verzögerung frei. Direkt nach dem Aktivieren liefert der Abruf also noch nichts, und "Zahlungen synchronisieren" meldet "0 Zahlungen geprüft", obwohl die Verbindung korrekt ist. Das ist normal: Rechnungskit ruft alle paar Stunden automatisch ab und holt die letzten 7 Tage nach, sobald PayPal die Daten bereitstellt, meist am nächsten Morgen. Bleibt es auch nach einem Tag bei 0, prüfe, ob die REST-App wirklich zu dem PayPal-Konto gehört, auf dem die Shop-Zahlungen eingehen. Customer disputes ist standardmäßig an und bleibt an. Alle anderen Häkchen (Checkout, SDKs, Vault, Subscriptions, Invoicing, Payouts) sind für Rechnungskit ohne Bedeutung.
3. Client-ID und Client-Secret unter Einstellungen → Verbinden bei PayPal eintragen. Rechnungskit erkennt automatisch, ob es sich um Live- oder Sandbox-Zugangsdaten handelt.
4. Den Webhook registriert Rechnungskit automatisch in deiner App, inklusive Signatur-Prüfung der Meldungen. Der Bereich Live Webhooks im PayPal-Dashboard kann leer bleiben.

Was automatisch passiert

• Zahlungen und Erstattungen kommen per signiertem Webhook an, Erstattungen erzeugen automatisch die Stornorechnung.
• Die PayPal-Gebühr wird je Transaktion erfasst und als eigene Buchung ausgewiesen, nicht mit dem Umsatz verrechnet. Das PayPal-Konto wird wie ein eigenes Zahlungsmittelkonto behandelt.
• Rücklastschriften (Disputes) öffnen den Posten wieder und landen zur Klärung in den Aufgaben, inklusive Dispute-Gebühr. Gewonnene Disputes werden entsprechend aufgelöst, ein automatischer Storno entsteht nicht.
• Die Bestellnummer wird aus den PayPal-Feldern (custom_id, invoice_id) gelesen und für die Zuordnung genutzt.
• Bei Shopify steht in invoice_id nicht immer die Bestellnummer, sondern teils ein interner Schlüssel der Checkout-Sitzung. Für diese Zahlungen liest Rechnungskit die PayPal-Transaktionsnummer aus der Shopify-Bestellung und ordnet darüber eindeutig zu. Das braucht keine Einstellung, nur die verbundene Shopify-Verbindung (siehe zahlungen-abgleich).

Abhebungen aufs Bankkonto

PayPal hat keine Auszahlungs-API wie Stripe oder Mollie. Rechnungskit liest stattdessen täglich die Transaktionshistorie (Transaction Search, letzte 30 Tage) und erkennt Abhebungen auf dein Bankkonto als Umbuchungen.

Grenzen, ehrlich benannt

• Rückzahlungen eines PayPal-Geschäftskredits werden nie automatisch verbucht, PayPal dokumentiert deren Buchungscodes nicht verlässlich. Sie erscheinen als monatliche Klärungsaufgabe.
• Läuft PayPal bei dir über Mollie, brauchst du die direkte PayPal-Anbindung nicht, das übernimmt die Mollie-Integration.
• Ohne aktivierte Transaction-Search-Funktion in der REST-App bleiben Gebühren und Abhebungen unvollständig.

Wo in der App

• /settings/connect, PayPal verbinden
• /payments, Zahlungen, Disputes und Klärfälle
• /payouts, erkannte Abhebungen und Gebühren