PayPal

Verfügbar

Diese Integration ist in Frihet aktiv und einsatzbereit.

Verbinden Sie Ihr PayPal Business-Konto mit Frihet. Importieren Sie Transaktionen, überprüfen Sie Salden und gleichen Sie internationale Zahlungen automatisch mit Ihren Rechnungen ab. Unterstützt den Sandbox-Modus für Tests.

Wozu dient es?

Mit integriertem PayPal:

• Transaktionen importieren — Überträgt PayPal-Zahlungen automatisch als Rechnungen in Frihet
• Vollständige Paginierung — Importiert alle Transaktionen ohne Begrenzung (automatische Paginierung)
• Intelligenter Verlauf — Erster Import: 1 Jahr Verlauf. Danach: nur neue Transaktionen seit der letzten Synchronisierung
• Rückerstattungen — Rückerstattungen werden mit dem Präfix [Refund] und negativem Betrag für eine klare Buchhaltung importiert
• Salden abfragen — Zeigen Sie Ihr PayPal-Guthaben direkt im Frihet-Dashboard an
• Zahlungen abgleichen — Ordnet PayPal-Transaktionen bestehenden Rechnungen zu
• Mehrwährung — Verwaltet Zahlungen in EUR, USD, GBP und anderen Währungen
• Deduplizierung — Bereits importierte Transaktionen werden nicht dupliziert (Präfix PP-)
• Sandbox-Modus — Testen Sie die Integration ohne Beeinflussung realer Daten

Anforderungen

• PayPal Business-Konto — Persönliche Konten haben keinen API-Zugriff
• Anwendung bei PayPal Developer — Zum Abrufen von Client ID und Client Secret
• Frihet Pro oder höher

PayPal mit Frihet verbinden

Schritt 1: Eine Anwendung bei PayPal Developer erstellen

1. Gehen Sie zu developer.paypal.com
2. Melden Sie sich mit Ihrem PayPal Business-Konto an
3. Gehen Sie im Dashboard zu Apps & Credentials
4. Wählen Sie den Modus Live (oder Sandbox für Tests)
5. Klicken Sie auf Create App
6. Geben Sie einen Namen ein (z.B. "Frihet ERP")
7. Klicken Sie auf Create App

Nach der Erstellung sehen Sie:

• Client ID — Eine öffentliche Kennung (z.B. AaBbCcDdEe...)
• Client Secret — Ein privater Schlüssel (klicken Sie auf "Show", um ihn anzuzeigen)

Secret speichern

Der Client Secret wird nur einmal angezeigt. Kopieren Sie ihn und speichern Sie ihn an einem sicheren Ort, bevor Sie fortfahren.

Schritt 2: In Frihet konfigurieren

1. Gehen Sie zu Einstellungen → Integrationen
2. Suchen Sie nach PayPal
3. Klicken Sie auf Verbinden
4. Geben Sie Ihre Client ID und Ihr Client Secret ein
5. Wählen Sie den Modus:
   • Live — Für reale Transaktionen
   • Sandbox — Für Tests mit fiktiven Daten
6. Klicken Sie auf Verbindung überprüfen
7. Wenn die Verbindung erfolgreich ist, sehen Sie "Verbunden"

Schritt 3: Verbindung überprüfen

1. Frihet ruft automatisch ein OAuth2-Token mit Ihren Zugangsdaten ab
2. Wenn die Überprüfung erfolgreich ist, sehen Sie Ihr PayPal-Guthaben im Dashboard
3. Sie können einen Testimport mit den letzten Transaktionen durchführen

So funktioniert es

Frihet verwendet die PayPal REST API v2 mit OAuth2-Authentifizierung (Client Credentials Flow):

1. Sie geben Client ID und Client Secret an
2. Frihet fordert automatisch ein Zugriffstoken von PayPal an
3. Mit diesem Token fragt Frihet Transaktionen und Salden ab
4. Die Zugangsdaten werden verschlüsselt (AES-256-GCM) in Frihet gespeichert
5. Das Token wird automatisch erneuert, wenn es abläuft

Sie müssen zu keinem Zeitpunkt Token manuell verwalten.

Synchronisierte Daten

Daten	Richtung	Häufigkeit
Empfangene Transaktionen	PayPal → Frihet	Bei Bedarf / Periodisch
Kontostand	PayPal → Frihet	Bei jeder Abfrage
Zahlerdaten	PayPal → Frihet	Mit jeder Transaktion
Währung und Wechselkurs	PayPal → Frihet	Mit jeder Transaktion

Anwendungsfälle

Freelancer mit internationalen Kunden

Sie erhalten Zahlungen von Kunden in USD und EUR über PayPal. Frihet importiert jede Zahlung, ordnet sie der entsprechenden Rechnung zu und wandelt den Betrag in Ihre Basiswährung um.

Online-Shop mit PayPal als Zahlungsmethode

Sie erhalten Zahlungen von Kunden über PayPal Checkout. Die Transaktionen werden in Frihet importiert und können mit den fakturierten Bestellungen abgeglichen werden.

Saldo vor Bezahlung von Lieferanten überprüfen

Überprüfen Sie Ihr PayPal-Guthaben direkt im Frihet-Dashboard, ohne die Anwendung zu verlassen. Entscheiden Sie, ob Sie über ausreichende Mittel verfügen, bevor Sie Überweisungen tätigen.

Sandbox-Modus

Um die Integration ohne Beeinflussung realer Daten zu testen:

1. Erstellen Sie unter developer.paypal.com eine App im Sandbox-Modus
2. Verwenden Sie die Sandbox-Zugangsdaten in Frihet (wählen Sie den Modus "Sandbox")
3. PayPal stellt Testkonten mit fiktivem Guthaben zur Verfügung
4. Überprüfen Sie, ob die Transaktionen korrekt importiert werden
5. Wenn Sie bereit sind, wechseln Sie in den Live-Modus mit Produktionszugangsdaten

Fehlerbehebung

"Authentifizierungsfehler"

• Überprüfen Sie, ob Client ID und Client Secret korrekt sind
• Stellen Sie sicher, dass Sie Live-Zugangsdaten im Live-Modus und Sandbox-Zugangsdaten im Sandbox-Modus verwenden
• Überprüfen Sie, ob Ihr PayPal Business-Konto aktiv und verifiziert ist

"Transaktionen werden nicht importiert"

• Überprüfen Sie, ob im abgefragten Zeitraum Transaktionen vorhanden sind (1 Jahr beim ersten Import, seit der letzten Synchronisierung bei späteren Importen)
• Generieren Sie im Sandbox-Modus Testtransaktionen über das PayPal Developer-Dashboard
• Überprüfen Sie, ob Ihre Anwendung bei PayPal die erforderlichen Berechtigungen aktiviert hat
• Wenn der Toast "No new transactions to import" anzeigt, sind alle Transaktionen bereits in Frihet vorhanden

"API-Berechtigungsfehler"

• Stellen Sie beim Erstellen der App bei PayPal Developer sicher, dass der Transaktions-Scope enthalten ist
• Wenn Sie Berechtigungen geändert haben, generieren Sie ein neues Client Secret und aktualisieren Sie es in Frihet

"Ich möchte von Sandbox zu Live wechseln"

1. Gehen Sie zu Einstellungen → Integrationen → PayPal
2. Klicken Sie auf Trennen
3. Verbinden Sie sich erneut mit den Produktionszugangsdaten (Live)

Nächste Schritte

• [Verbinden Sie Stripe für Kartenzahlungen ./stripe)
• [Verbinden Sie GoCardless für SEPA-Lastschriften ./gocardless)
• [Automatisieren Sie Workflows mit n8n ./n8n)