In dieser Anleitung erfahren Sie, wie Sie eine PayPal-App für klassische Einmalzahlungen (Checkout) anlegen und in InvoFlux hinterlegen, damit Ihre Kunden Rechnungen direkt per PayPal bezahlen können.
Voraussetzungen
- PayPal Business-Konto mit Zugang zum Developer Dashboard.
- InvoFlux-Account mit aktivierter PayPal-Zahlungsart.
- Optional: PayPal Sandbox-Konten für Tests (ein Business- und ein Käufer-Konto).
Schritt 1: PayPal REST-App für Checkout anlegen
- Melden Sie sich im PayPal Developer Dashboard an.
- Klicken Sie links auf My Apps & Credentials.
- Wählen Sie oben die Umgebung:
- Sandbox für Tests
- Live für echte Zahlungen
- Klicken Sie unter REST API apps auf Create App.
- Vergeben Sie einen Namen, z. B. InvoFlux Checkout, und ordnen Sie das Business-Konto zu.
- Nach dem Erstellen sehen Sie:
- Client ID
- Secret (ggf. auf „Show“ klicken)
- Notieren Sie Client-ID und Secret für die weitere Konfiguration in InvoFlux.
Tipp: Legen Sie getrennte Apps für Sandbox und Live an, um Test- und Produktivumgebung strikt zu trennen.
Schritt 2: PayPal Checkout in InvoFlux konfigurieren
- Melden Sie sich in InvoFlux an.
- Öffnen Sie Einstellungen → Zahlungen → PayPal Checkout (oder den entsprechenden Bereich).
- Tragen Sie dort ein:
- Client-ID Ihrer PayPal-App
- Secret Ihrer PayPal-App
- Umgebung: Sandbox oder Live
- Speichern Sie die Einstellungen.
Schritt 3: PayPal als Zahlungsmethode in Rechnungen nutzen
- Erstellen Sie in InvoFlux eine neue Rechnung für einen Kunden.
- Aktivieren Sie bei der Rechnung die Zahlungsart PayPal (falls Ihre Version das je Rechnung steuert).
- Senden Sie die Rechnung per E-Mail oder geben Sie dem Kunden den Zahlungslink.
- Der Kunde kann nun über einen PayPal-Button auf der Rechnungsseite direkt bezahlen.
Hinweis: Im Hintergrund wird eine PayPal-Order über die PayPal REST-API erstellt, und nach erfolgreicher Bezahlung wird der Status in InvoFlux aktualisiert.
Schritt 4: Test mit der PayPal-Sandbox
- Stellen Sie sicher, dass in InvoFlux die Sandbox-Client-ID und das Sandbox-Secret hinterlegt sind.
- Erstellen Sie eine Testrechnung und schicken Sie den PayPal-Zahlungslink an ein Sandbox-Käuferkonto.
- Loggen Sie sich als Sandbox-Käufer bei PayPal ein und schließen Sie die Zahlung ab.
- Nach der Rückleitung zu InvoFlux sollte die Rechnung als bezahlt markiert sein.
- Prüfen Sie optional im Sandbox-Business-Konto, ob der Zahlungseingang verbucht wurde.
Fehlerbehebung
PayPal-Button wird nicht angezeigt
- Prüfen Sie, ob in InvoFlux die Client-ID korrekt hinterlegt ist.
- Stellen Sie sicher, dass die Rechnungswährung von PayPal unterstützt wird.
- Kontrollieren Sie, ob JavaScript im Browser des Kunden aktiviert ist (PayPal JavaScript SDK).
Zahlung läuft durch, Rechnung bleibt offen
- Prüfen Sie, ob der Webhook für PayPal in InvoFlux korrekt eingerichtet ist (siehe separate Webhook-Dokumentation).
- Kontrollieren Sie die Server-Logs von InvoFlux auf Fehlermeldungen rund um PayPal-Callbacks.
Wenn Sie bei der Einrichtung Unterstützung benötigen, wenden Sie sich an den InvoFlux-Support.