PayPal-API braucht ein Business-Konto? So nutzt du deine Daten

Du möchtest deine PayPal-Umsätze automatisch auswerten, mit Rechnungen abgleichen oder in deine Datenbank übernehmen. Bei der Suche nach einer PayPal-API landest du im Entwicklerportal: Business-Konto, App anlegen, Zugangsdaten erzeugen, OAuth einrichten. Aus einer kleinen Auswertung wird erst einmal ein Integrationsprojekt.

Mit Kontoflux.io kannst du die Daten eines unterstützten PayPal-Zugangs über eine vorhandene Verbindung importieren. Danach nutzt du sie über die Kontoflux.io-API, mit einem KI-Assistenten über MCP oder in einer Integration. Welche Voraussetzungen dein PayPal-Konto erfüllen muss, hängt dabei vom angebotenen Zugang ab.

Wann brauchst du für die PayPal-API ein Business-Konto?

Für eine eigene produktive PayPal-REST-Integration verlangt PayPal ein Business-Konto. Die offizielle PayPal-Einstiegsanleitung beschreibt außerdem die App-Zugangsdaten: Mit Client-ID und Client-Secret erhält deine Anwendung ein OAuth-Zugriffstoken. Ein Test in der Sandbox ist deshalb noch kein eingerichteter Zugriff auf die echten Kontodaten.

Zum Abrufen von Transaktionen bietet PayPal die Transaction Search API an. Sie verwendet einen eigenen Reporting-Zugriffsbereich. Für eine direkte Anbindung kümmerst du dich also um Zugang, Berechtigungen, Abrufe und die Weiterverarbeitung der Antworten. Das kann passen, wenn du diese Verbindung selbst entwickeln und betreiben möchtest.

PayPal-Daten über Kontoflux.io weiterverwenden

Kontoflux.io stellt dir einen anderen Ablauf bereit: Du suchst im Workspace nach PayPal, wählst einen verfügbaren Zugang und folgst dem Verbindungsformular. Anschließend stehen die importierten Konten und Buchungen in Kontoflux.io bereit. Den Überblick findest du auf unserer Seite zur PayPal-Anbindung.

Deine Anwendung liest diese Daten über Kontoflux.io. Du musst dafür keine eigene PayPal-REST-Integration entwickeln; den API-Zugang für deine Anwendung richtest du in Kontoflux.io ein. Auch Daten anderer verbundener Konten lassen sich über dieselbe Schnittstelle abrufen.

Prüfe zuerst den angebotenen PayPal-Zugang. Ob dein Privat- oder Geschäftskonto unterstützt wird und welche Freigaben nötig sind, zeigt der angebotene Zugang beim Verbinden. Prüfe das vor dem Einrichten deiner Auswertung. Die Voraussetzungen des jeweiligen PayPal-Zugangs gelten auch bei einer Verbindung über Kontoflux.io.

Per REST-API: PayPal-Umsätze in deiner Anwendung

Erstelle einen API-Schlüssel in Kontoflux.io und gib die benötigten Konten frei. Deine Anwendung kann anschließend die Transaktionen des verbundenen PayPal-Kontos abrufen und nach Konto oder Zeitraum filtern. Die Kontoflux.io-API eignet sich zum Beispiel für ein eigenes Finanzdashboard oder einen Rechnungsabgleich in deinem ERP.

Bei PayPal-Transaktionen können zusätzliche Angaben mitgeliefert werden. Dieser beispielhafte Ausschnitt zeigt eine Rechnungsnummer, eine Gebühr von null und einen Nettobetrag:

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

paypal.invoiceNumber ist die von PayPal gelieferte Rechnungsnummer, paypal.fee die Gebühr und paypal.net der Nettobetrag. Die Felder sind optional. Fehlt eine Gebühr, ist ihr Wert unbekannt; eine ausdrücklich gelieferte 0 bleibt dagegen erhalten. Auch eine Bankbuchung mit „PayPal“ im Verwendungszweck enthält nicht automatisch diese Zusatzdaten. Die Dokumentation zu PayPal-Daten erklärt die Felder und die verfügbaren Filter.

Für einen Rechnungsabgleich kannst du eine vorhandene Rechnungsnummer mit deinen offenen Posten vergleichen. Prüfe zusätzlich Betrag, Währung und Zahlungsrichtung. Ein Nettobetrag nach Gebühren kann vom Rechnungsbetrag abweichen. Wenn du Gebühren getrennt ausweist, ziehe sie nicht erneut von einem bereits gelieferten Nettobetrag ab.

Mit MCP: Fragen zu deinen PayPal-Umsätzen stellen

Wenn du eine Auswertung im Chat erstellen möchtest, verbinde deinen kompatiblen KI-Client mit dem MCP-Server von Kontoflux.io. Du legst fest, welche Konten und Werkzeuge die Integration freigibt. Der Assistent kann dann mit get_accounts die Konten und mit get_transactions deren Buchungen lesen.

Richte zuerst die Verbindung nach der MCP-Anleitung ein und kontrolliere, welche Konten dein Client sieht. Mit diesem Prompt kannst du danach einen überschaubaren Monatsbericht beginnen:

Vergleiche einige der genannten Buchungen mit deinem Konto. So erkennst du, ob der Zeitraum vollständig ist und der Assistent Gebühren und Nettobeträge passend verwendet. Für einen Vergleich mehrerer Monate findest du im Beitrag zum Finanzassistenten über MCP einen ausführlicheren Prompt.

Mit Ninox oder Webhooks im bestehenden Ablauf bleiben

Über die Ninox-Integration kannst du die importierten Umsätze in eine Tabelle übertragen und dort mit deinen Rechnungen oder Aufträgen verknüpfen. Wähle das verbundene PayPal-Konto aus und richte die Feldzuordnung anhand der tatsächlich verfügbaren Daten ein. Die Ninox-Anleitung führt dich durch die Einrichtung.

Für eine eigene empfangende Anwendung kannst du einen Webhook einrichten. Kontoflux.io sendet dann passende Kontodaten oder Transaktionen per HTTP-POST an deine HTTPS-Adresse. Lege die Kontenauswahl und den Umfang fest und prüfe den Empfang mit Testdaten. Deine Anwendung sollte dieselbe Transaktion auch bei wiederholter Zustellung nur einmal übernehmen.

So startest du mit deinem PayPal-Konto

1. Öffne im passenden Workspace Bankkonten → Bankkonto hinzufügen.
2. Suche nach PayPal und wähle den passenden angebotenen Zugang.
3. Folge dem Verbindungsformular und bestätige die angeforderten Freigaben.
4. Prüfe das importierte Konto und einige bekannte Transaktionen.
5. Richte deinen API-Zugang, MCP-Client oder deine Integration für dieses Konto ein.

Wenn kein passender Zugang erscheint, kläre die Verfügbarkeit mit dem Support. Die Anleitung zur PayPal-Anbindung beschreibt auch, welche Kontodaten du nach dem Verbinden prüfen solltest.

API und MCP lesen den zuletzt in Kontoflux.io importierten Datenstand. Eine Abfrage startet keinen neuen PayPal-Abruf. Prüfe deshalb den letzten Import und die vorhandene Historie, bevor du einen Bericht abschließt oder eine Zahlung als fehlend einordnest.