Zum Hauptinhalt springen

PayPal einrichten

Bereich: Einrichtung externer Dienste · Status: aktiv (Modul payPal) Verfügbar für: Betreiber / technisch verantwortliche Person

In einem Satz​

So wird ein PayPal-Geschäftskonto mit Cofys verbunden, damit Teilnehmer per PayPal bezahlen und Zahlungsänderungen automatisch ankommen.

Wofür brauche ich das?​

  • PayPal als Zahlungsart in Buchung und Mitgliedschaft anbieten.
  • Rückbuchungen, Erstattungen und verspätete Zahlungen automatisch in Cofys sehen.

Wo finde ich es?​

Bei PayPal: Developer Dashboard. In Cofys: Konfiguration der Instanz (AccessKeys::paypal), Modul payPal.

So funktioniert es​

1. Geschäftskonto anlegen

  1. Ein PayPal-Geschäftskonto eröffnen (paypal.com/bizsignup); private Konten funktionieren nicht.
  2. E-Mail-Adresse bestätigen.
  3. Unter Bankkonto ein Bankkonto hinterlegen – sonst sperrt PayPal das Konto vorübergehend.
  4. Unter Limits aufheben prüfen, ob weitere Einschränkungen zu beheben sind.

2. App und Zugangsdaten erzeugen

  1. Im Developer Dashboard im Modus Live auf Create App klicken.
  2. Client ID und Secret kopieren.
  3. Unter Features setzen: Vault an, Native Checkout SDK aus, Subscriptions an, Invoicing an, PayPal Here aus, Payouts aus, Customer Disputes an, Log in with PayPal aus, Transaction Search an.

Ältere Ansicht des PayPal Developer Dashboards: „Live“ wählen, „Create App“ Älterer Screenshot – die Oberfläche hat sich inzwischen geändert, die Schritte bleiben gleich.

3. Webhook anlegen

  1. In der App unter Live Webhooks einen Webhook hinzufügen.
  2. URL: https://<Adresse der Instanz>/api/v2/payments/paypal/webhook/
  3. Diese Ereignisse aktivieren (genau diese wertet Cofys aus):
    • PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.PENDING, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED
    • PAYMENT.AUTHORIZATION.CREATED, PAYMENT.AUTHORIZATION.VOIDED
    • CUSTOMER.DISPUTE.CREATED, CUSTOMER.DISPUTE.UPDATED, CUSTOMER.DISPUTE.RESOLVED

4. In Cofys eintragen Client ID und Secret in AccessKeys::paypal eintragen, Modul payPal aktivieren.

Einstellungen und Optionen​

Parameter (AccessKeys::paypal)Inhalt
client-idClient ID der Live-App
secretSecret der Live-App

Was passiert automatisch?​

  • Nach jeder Zahlung fragt Cofys den Status direkt bei PayPal ab; spätere Änderungen kommen über den Webhook.
  • Webhook-Inhalte werden nicht blind übernommen: Cofys holt den aktuellen Status immer selbst bei PayPal ab.

Grenzen und Besonderheiten​

  • Andere als die oben genannten Ereignisse ignoriert Cofys; zusätzlich aktivierte Ereignisse schaden nicht.
  • Die frühere Anleitung für Cofys 1 („My Apps & Credentials“, Ereignisse Checkout order approved/declined) ist überholt.

Hängt zusammen mit​