PayPal anbinden und nutzen

Verbinde dein PayPal-Konto mit Kontoflux.io, um die importierten Kontodaten und Umsätze in deinen Anwendungen zu nutzen. Du kannst sie per REST-API abrufen, mit einem KI-Assistenten über MCP auswerten oder an Ninox und eigene Webhook-Empfänger weitergeben.

Voraussetzungen und Kontotyp

Für PayPal nutzt du dieselbe Suche wie für eine Bankverbindung. Welche PayPal-Zugänge angeboten werden und ob dein Privat- oder Geschäftskonto unterstützt wird, prüfst du beim Verbinden. Folge den Anforderungen des gewählten Zugangs.

Für eine eigene produktive Anbindung an die PayPal-REST-API verlangt PayPal ein Business-Konto und App-Zugangsdaten; das beschreibt die offizielle PayPal-Einstiegsanleitung. Bei Kontoflux.io liest deine Anwendung die importierten Daten über die Kontoflux.io-API. Die Voraussetzungen des angebotenen PayPal-Zugangs gelten auch bei dieser Verbindung.

Diese Anleitung beschreibt den Zugriff auf Kontodaten. PayPal Checkout, das Auslösen von Zahlungen und Erstattungen gehören nicht zu diesem Datenzugang.

Verbindung einrichten

1. Melde dich in der Kontoflux.io App an. Öffne im passenden Workspace Bankkonten und wähle Bankkonto hinzufügen.
2. Suche nach PayPal.
3. Wähle den passenden Zugang aus der Trefferliste.
4. Folge den Anweisungen im Verbindungsformular und schließe die angeforderten Freigaben ab.
5. Prüfe das verbundene Konto unter Bankkonten. Klappe die Kontozeile auf und kontrolliere Zuletzt aktualisiert.
6. Öffne Transaktionen, wähle bei Konto dein PayPal-Konto und vergleiche einige bekannte Buchungen mit PayPal.

Wenn kein passender Zugang erscheint, kläre die Verfügbarkeit mit dem Support. Die Auswahl und die benötigten Angaben richten sich nach dem angebotenen Zugang.

Öffnet sich der Verbindungsdialog in einem neuen Tab, lass das ursprüngliche Fenster geöffnet. Weitere Hinweise findest du unter Bankkonten hinzufügen.

Kontodaten prüfen

Prüfe vor der Weitergabe an eine andere Anwendung, welche Angaben bei deinem Konto und deinen Buchungen tatsächlich gefüllt sind.

Bei Konten ohne IBAN zeigt die Kontoübersicht stattdessen die übermittelte Kontonummer. Auch die Spalte Gegenpartei IBAN verwendet die Kontonummer als Ersatz, wenn keine IBAN vorliegt. Du kannst Gegenpartei Kontonummer zusätzlich als eigene Spalte einblenden.

Lege deine Feldzuordnung in einer Integration anhand dieser Daten fest. Eine leere IBAN allein bedeutet nicht, dass der Import fehlgeschlagen ist. Mehr dazu unter Datenfelder verstehen.

PayPal-Daten per API abrufen

1. Erstelle unter Automationen → API einen API-Schlüssel.
2. Wähle unter Scope die Bereiche Konten und Transaktionen und gib unter Bankkonten dein PayPal-Konto frei. Speichere und aktiviere den Schlüssel.
3. Rufe die freigegebenen Konten ab und ermittle die id deines PayPal-Kontos.
4. Verwende diese Konto-ID für den Abruf seiner Transaktionen.

Die Beispiele verwenden Umgebungsvariablen für deine Workspace-Kennung und den Schlüssel:

curl --fail-with-body \
  "https://api.kontoflux.io/v1/${KONTOFLUX_WORKSPACE_ID}/accounts" \
  --header "Authorization: Bearer ${KONTOFLUX_API_KEY}"

Hinterlege die zurückgegebene Konto-ID als KONTOFLUX_PAYPAL_KONTO_ID. Verwende dafür die Kontoflux.io-Kennung, nicht deine PayPal-E-Mail-Adresse. Diese Anfrage lädt die ersten 50 Transaktionen des Kontos:

curl --fail-with-body --get \
  "https://api.kontoflux.io/v1/${KONTOFLUX_WORKSPACE_ID}/accounts/${KONTOFLUX_PAYPAL_KONTO_ID}/transactions" \
  --header "Authorization: Bearer ${KONTOFLUX_API_KEY}" \
  --data-urlencode 'limit=50' \
  --data-urlencode 'offset=0'

Die Antwort ist eine Liste. Für weitere Seiten erhöhst du offset um 50; X-Total-Count nennt die Zahl der passenden Ergebnisse. Wie du zusätzlich nach Zeitraum filterst, steht unter Transaktionen per API filtern.

Rechnungsnummer, Gebühr und Nettobetrag

In der API-Antwort können Transaktionen ein zusätzliches Objekt paypal enthalten. Dieser beispielhafte Ausschnitt zeigt die verfügbaren Felder:

{
  "paypal": {
    "invoiceNumber": "RE-2026-1042",
    "fee": 0,
    "net": 29.9
  }
}

Alle drei Angaben sind optional. Fehlen die Zusatzdaten vollständig, wird kein paypal-Objekt ausgegeben. Ein fehlender Wert bedeutet „unbekannt“, nicht null Euro. Verwende in JavaScript beispielsweise transaction.paypal?.fee ?? null, damit eine tatsächlich gelieferte 0 erhalten bleibt.

Ein PayPal-Eintrag im Verwendungszweck eines Bankumsatzes allein liefert diese Zusatzdaten nicht. Verbinde das PayPal-Konto selbst und prüfe die gelieferten Buchungen. Ein vollständigeres JavaScript-Beispiel zeigt den Umgang mit optionalen Feldern.

Vergleiche beim Rechnungsabgleich zusätzlich Betrag, Währung und Zahlungsrichtung. Ziehe Gebühren nicht nochmals von einem bereits gelieferten Nettobetrag ab. Wenn du PayPal und dein Bankkonto gemeinsam auswertest, berücksichtige Umbuchungen zwischen beiden Konten, damit dieselbe Zahlung nicht doppelt zählt.

PayPal mit MCP auswerten

1. Öffne Automationen → Integrationen und füge einen MCP-Server hinzu.
2. Gib unter MCP-Einstellungen → Verfügbare Tools die Werkzeuge get_accounts und get_transactions frei.
3. Wähle unter Bankkonten → Erlaubte Bankkonten dein PayPal-Konto aus und speichere die Einstellungen.
4. Richte den Zugang ein, aktiviere die Integration und verbinde deinen KI-Client nach der MCP-Anleitung.

Beginne zum Beispiel mit dieser Anfrage:

Zeige mir die freigegebenen Konten und frage, welches PayPal-Konto ich auswerten möchte. Lies anschließend die Buchungen dieses Kontos für den letzten vollständigen Kalendermonat in Europe/Berlin. Nenne die Datumsgrenzen und lade alle nötigen Ergebnisseiten. Prüfe die bookingDate jedes zurückgegebenen Eintrags gegen diese Grenzen und werte nur passende Buchungen aus. Fasse Einnahmen und Ausgaben getrennt nach Währung zusammen. Nenne den Datenstand und kennzeichne fehlende Angaben. Zähle jede Transaktions-ID nur einmal. Wenn du nicht alle nötigen Buchungen abrufen kannst, kennzeichne die Auswertung als unvollständig.

Prüfe einige Buchungen aus dem Ergebnis in Kontoflux.io. MCP verwendet den importierten Datenstand; eine Frage im Chat startet keinen neuen Abruf bei PayPal.

Ninox oder Webhooks verwenden

Für Ninox öffnest du Automationen → Integrationen und fügst Ninox hinzu. Wähle die Zieltabellen und ordne ihre Felder anhand der verfügbaren Kontodaten und Buchungen zu. Achte bei einem Konto ohne IBAN auf die tatsächlich gelieferten Kennungen. Die Ninox-Anleitung beschreibt Zugang, Feldzuordnung und die erste Übertragung.

Die PayPal-Zusatzfelder invoiceNumber, fee und net stehen in der aktuellen Ninox-Feldauswahl nicht bereit. Für eine eigene Weitergabe dieser Angaben kannst du die REST-API verwenden.

Für eine eigene empfangende Anwendung richtest du unter Automationen → Webhooks einen Webhook ein. Wähle den Scope Transaktionen und dein PayPal-Konto unter Bankkonten. Hinterlege die HTTPS-Adresse deines Empfängers und gehe die Webhook-Einrichtung durch. Testdaten senden erreicht die echte Empfangsadresse; verwende beim Empfänger einen passenden Testablauf.

Wenn Daten fehlen

Verfügbare Historie und Aktualität hängen vom Zugang und den abgeschlossenen Importen ab. Die Schritte unter Fehlende oder veraltete Umsätze helfen dir, die betroffene Stelle zu finden.