Konfiguration von PayPal

Diese Anleitung zeigt, woher Sie die Zugangsdaten für PayPal bekommen und wo Sie sie im Shop eintragen. Sie gilt für das Modul PayPal und das Modul PayPal PLUS. Beide nutzen die REST-Schnittstelle von PayPal.

Voraussetzungen

• ein PayPal-Geschäftskonto
• Zugang zum PayPal Developer Dashboard
• der Shop ist per HTTPS erreichbar (für den WebHook zwingend)

Client ID und Secret erzeugen

1. Melden Sie sich im PayPal Developer Dashboard an und öffnen Sie Apps & Credentials.
2. Legen Sie mit Create App eine App an (z. B. „Shop“).
3. PayPal zeigt die Client ID und das dazugehörige Secret an.
4. Live- und Sandbox-Betrieb haben getrennte Zugangsdaten. Wechseln Sie oben rechts zwischen Sandbox und Live und notieren Sie die Daten für den Modus, den Sie nutzen wollen.

Zugangsdaten im Shop eintragen

Modul PayPal

Öffnen Sie wpShopGermany → Konfiguration → Module → PayPal. Im Kasten Zugangsdaten tragen Sie Client ID und Secret ein. Ist Sandbox Modus aktiv, gehören hier die Sandbox-Daten hinein, sonst die Live-Daten; beim Umschalten tauschen Sie also auch die Zugangsdaten.

Nach dem Speichern zeigt der Kasten Verbindung zu PayPal, welche Umgebung aktiv ist, ob die Zugangsdaten funktionieren und ob der WebHook angemeldet ist.

Modul PayPal PLUS

Öffnen Sie wpShopGermany → Konfiguration → Module → PayPal PLUS. Tragen Sie Client ID und Secret für den Livebetrieb ein. Aktivieren Sie Sandbox, erscheinen die zusätzlichen Felder Client ID (Sandbox) und Secret (Sandbox) für die Testdaten.

Automatische Statusänderung über den WebHook

Damit der Shop von eingehenden Zahlungen erfährt, meldet PayPal sie an eine Adresse des Shops, den WebHook. Die Adresse steht in den Moduleinstellungen unter WebHook URL. Sie muss per HTTPS von außen erreichbar sein.

Automatisch anmelden (empfohlen): Aktivieren Sie WebHook beim Speichern anmelden (Modul PayPal) bzw. Beim Speichern versuchen, den Webhook anzumelden. (Modul PayPal PLUS) und speichern Sie die Einstellungen. Der Shop meldet den WebHook dann selbst bei PayPal an.

Manuell anmelden:

1. Fügen Sie in Ihrer App im Bereich der WebHooks mit Add Webhook einen neuen WebHook hinzu.
2. Kopieren Sie die WebHook URL aus den Moduleinstellungen in das Feld für die Webhook-Adresse.
3. Wählen Sie das Ereignis Payment capture completed (PAYMENT.CAPTURE.COMPLETED). Das Modul PayPal PLUS meldet zusätzlich Payment sale completed (PAYMENT.SALE.COMPLETED) an. Alternativ wählen Sie alle Ereignisse.
4. Speichern Sie. PayPal zeigt eine Erfolgsmeldung.

Im Modul PayPal PLUS können Sie mit WebHook Anfragen protokollieren die eingehenden Meldungen in eine Datei schreiben lassen; den absoluten Pfad zur Protokolldatei geben Sie darunter an.

Beachten Sie: Der Kunde muss im Bestellprozess seine vollständige Anschrift (Straße, Hausnummer, PLZ, Ort) angeben, weil sie an PayPal übergeben wird.

Sandbox

Testen Sie vor dem Livebetrieb alle Abläufe im Sandbox-Modus. Dafür benötigen Sie die Sandbox-Zugangsdaten Ihrer App (Umschalter Sandbox im Developer Dashboard) und ein Sandbox-Käuferkonto.

Häufige Fragen

Der Zahlungsstatus ändert sich nicht

Prüfen Sie, ob der WebHook angemeldet ist (im Modul PayPal im Kasten Verbindung zu PayPal) und ob die richtigen Ereignisse gewählt sind. Prüfen Sie außerdem, ob im Livebetrieb auch die Live-Zugangsdaten eingetragen sind.

Kann ich eine Client ID für mehrere Shops nutzen?

Ja. Dann laufen die Zahlungen aller Shops auf demselben PayPal-Konto zusammen. Sie müssen nicht jedem Shop eine eigene App zuordnen.

Muss ich bei einer Stornierung manuell erstatten?

Nein. Unter Stornierung bei Statuswechsel legen Sie fest, bei welchen Bestellstatus der Betrag automatisch über PayPal erstattet wird. Voreingestellt sind „zurückgezahlt“ und „storniert“. Wechselt eine mit PayPal bezahlte Bestellung in einen dieser Status, erstattet der Shop die Zahlung.