PayPal als Zahlungsanbieter einrichten

PayPal ist einer der unterstützten Payment Service Provider in FSC. Damit Online-Zahlungen über PayPal entgegengenommen werden können, muss eine PayPal-Developer-App angelegt und ein Webhook konfiguriert werden. Diese Anleitung führt Schritt für Schritt durch den kompletten Prozess.

Wo zu finden

In FSC unter Einstellungen → Zahlungsanbieter → PayPal.

Übersicht: benötigte Daten aus PayPal

Aus dem PayPal-Konto werden drei Werte gebraucht, die in FSC hinterlegt werden:

• Client ID (aus der PayPal-App)
• Secret (aus der PayPal-App)
• Webhook ID (aus dem angelegten Webhook, Format WH-...)

Schritt 1: PayPal-App anlegen

1. Auf https://developer.paypal.com/dashboard/ mit dem PayPal-Business-Konto einloggen.
2. Oben zwischen Sandbox (Testumgebung) und Live (Produktion) umschalten. Für den produktiven Betrieb ist Live erforderlich.
3. Menüpunkt Apps & Credentials öffnen.
4. Auf Create App klicken, einen aussagekräftigen Namen vergeben (z.B. FSC Buchungsportal) und Merchant als App-Typ auswählen.
5. Nach dem Anlegen werden Client ID und Secret angezeigt. Das Secret muss über Show eingeblendet werden.

Schritt 2: Zugangsdaten in FSC eintragen

1. In FSC zu Einstellungen → Zahlungsanbieter → PayPal wechseln.
2. Client ID und Secret aus PayPal in die entsprechenden Felder eintragen.
3. Testmodus deaktivieren, sofern die Live-Zugangsdaten verwendet werden. Für Sandbox-Tests bleibt der Testmodus aktiv und optional wird der Name des Sandbox-Kontos hinterlegt.
4. Speichern.

Schritt 3: Webhook in PayPal einrichten

Der Webhook sorgt dafür, dass PayPal Zahlungsereignisse an FSC meldet, damit Buchungen korrekt als bezahlt markiert werden.

1. Im PayPal-Developer-Dashboard die zuvor angelegte App öffnen.
2. Nach unten scrollen bis zum Abschnitt Webhooks und auf Add Webhook klicken.
3. Als Webhook URL die FSC-Adresse eintragen, mit der eigenen Portal-Domain:
   https://<eure-fsc-domain>/de/portal/paypal_payment_intents/webhook
   Beispiel: https://fussballschule.arminia.de/de/portal/paypal_payment_intents/webhook
4. Folgende Event types müssen aktiviert werden:
   • CHECKOUT.ORDER.APPROVED (löst die Zahlungserfassung aus)
   • CHECKOUT.ORDER.COMPLETED (Bestätigung des Checkouts)
   • PAYMENT.CAPTURE.COMPLETED (schaltet die Buchung final als bezahlt frei)
   • PAYMENT.CAPTURE.REFUNDED (für Rückerstattungen)
   • PAYMENT.CAPTURE.DENIED (für abgelehnte Zahlungen)
   • PAYMENT.CAPTURE.REVERSED (für zurückgezogene Zahlungen)
5. Webhook speichern. PayPal zeigt nun die Webhook ID im Format WH-... an.

Schritt 4: Webhook ID in FSC hinterlegen

1. Die Webhook ID aus PayPal kopieren.
2. In FSC unter Einstellungen → Zahlungsanbieter → PayPal in das Feld Webhook ID einfügen.
3. Speichern.

Schritt 5: Testbuchung durchführen

Zum Abschluss eine kleine Testbuchung im Buchungsportal durchführen und den PayPal-Button verwenden. Nach erfolgreicher Zahlung sollte die Zahlungserwartung im Backend automatisch als bezahlt erscheinen.

Optionale Einstellungen

Bestimmte Zahlungsmethoden ausblenden

Im Feld Disallowed Methods lassen sich einzelne PayPal-Zahlungsmethoden deaktivieren. Kommagetrennte Werte, z.B.:

• CARD um Kredit- und Debitkarten über PayPal auszublenden
• CREDIT um die PayPal-Ratenzahlung auszublenden

Mehrere Werte kombinieren: CARD,CREDIT. Leer lassen, wenn alle Methoden angeboten werden sollen.

Sandbox-Test

Für Testläufe kann im PayPal-Developer-Dashboard oben auf Sandbox umgeschaltet und dort eine separate App plus Webhook angelegt werden. In FSC dann den Testmodus aktivieren und die Sandbox-Zugangsdaten eintragen. Der Sandbox-Kontoname ist optional und dient der eigenen Übersicht.

Hinweise

• Client ID und Secret werden in FSC verschlüsselt gespeichert und nach dem Speichern nicht wieder im Klartext angezeigt.
• Sandbox- und Live-Zugangsdaten sind bei PayPal getrennt. Ein Umschalten von Testmodus auf Live erfordert neue Zugangsdaten und einen neuen Webhook.
• Änderungen am Webhook (z.B. neue Events) erzeugen keine neue Webhook ID, ein Löschen und Neuerstellen jedoch schon. In diesem Fall die neue Webhook ID in FSC nachtragen.