🔧PayPal

Zahlungsanbieter PayPal

Modul: ETRON onRetail v2 PayPal

Konfiguration -> E-Commerce -> Zahlungsanbieter -> PayPal

Konfiguration -> E-Commerce -> Zahlungsanbieter -> PayPal

Mit dem Zahlungsanbieter PayPal können Zahlungen via PayPal, eps Sofortüberweisung und Debit-/Kreditkarte durchgeführt werden.

Für die Zahlung via eps Sofortüberweisung und Debit-/Kreditkarte benötigt der Kunde kein PayPal-Konto.

Zahlungsanbieter PayPal im Checkout des Onlineshops: unterstützt die Zahlung über PayPal, eps uind Debit-/Kreditkarte

Die über einen Zahlungsanbieter durchgeführten Zahlungen sind unter E-Commerce -> Onlineshop - Zahlungstransaktionen protokolliert.

Konfiguration des Zahlungsanbieters PayPal

Zahlungsanbieter Paypal, Reiter: Anmeldedaten

​Um die Zahlungsmethode PayPal einzurichten, müssen im Reiter Anmeldedaten folgende Felder ausgefüllt werden:

Die PayPal Client ID und das PayPal Client Secret können im PayPal-Geschäftskonto im PayPal Developer Dashboard eingesehen werden: Den Bereich „Apps & Credentials“ öffnen, App auswählen oder neue App erstellen. In der App werden Client ID und Client Secret angezeigt.

Paypal E-Mail

Die E-Mail-Adresse des PayPal-Kontos wird in diesem Feld eingegeben.

PayPal Client-ID

Die PayPal Client-ID des PayPal-Kontos wird in diesem Feld eingegeben.

PayPal Client-Secret

Das PayPal Client-Secret des PayPal-Kontos wird in diesem Feld eingegeben.

PayPal Webhook ID / Webhook generieren

Eine eingehende Webhook-Nachricht wird nur akzeptiert, wenn eine PayPal Webhook ID hinterlegt ist. Ohne diese wird die Nachricht grundsätzlich verworfen, ohne die betroffene Transaktion zu ändern. Ist eine Webhook-ID vorhanden, wird die Nachricht zusätzlich direkt bei PayPal zur Bestätigung eingereicht (Signaturprüfung). Bestätigt PayPal die Echtheit nicht, wird die Nachricht ebenfalls verworfen.

Wofür wird beim Zahlungsanbieter PayPal ein Webhook benötigt?

Bei PayPal wird der Zahlungsvorgang bereits direkt im Checkout abgeschlossen: Sobald der Kunde die Zahlung im PayPal-Fenster bestätigt, ruft ETRON onRetail synchron die PayPal-API auf, um die Zahlung einzuziehen, und aktualisiert die Transaktion sofort. Für den normalen Kaufvorgang ist der Webhook daher nicht erforderlich.

Der Webhook dient ausschließlich als Absicherung für den Fall, dass diese synchrone Bestätigung PayPal-seitig verzögert oder nachträglich anders ausfällt – etwa wenn eine Bestellung bei PayPal als abgeschlossen (COMPLETED) oder genehmigt (APPROVED) markiert wird, ohne dass ETRON onRetail dies über den regulären Weg mitbekommen hat. Ohne eingerichteten Webhook fehlt diese zusätzliche Absicherung.

Welche Ereignisse verarbeitet werden

Von den vielen Ereignistypen, die PayPal grundsätzlich versendet, verarbeitet diese Instanz gezielt nur zwei Ereignisse, die sich auf eine Bestellung beziehen:

• Bestellung abgeschlossen.

• Bestellung genehmigt.

Alle anderen Ereignistypen, die PayPal an den Webhook sendet, werden ignoriert.

Einrichtung des PayPal Webhooks

Der PayPal Webhook kann über den Button erstellt werden. Der Button wird nur angezeigt, wenn PayPal Client ID und PayPal Client Secret bereits hinterlegt sind.

Bei Auswahl des Buttons wird bei PayPal ein Webhook registriert, der auf die Adresse der ETRON onRetail-Instanz zeigt. Die von PayPal vergebene Webhook-ID wird automatisch in das Feld PayPal Webhook ID eingetragen. Ist bereits eine Webhook-ID hinterlegt, wird angezeigt, dass der Webhook bereits eingerichtet ist. Ein zweiter Webhook wird nicht angelegt.

Status

Legt den Status der Zahlungsmethode fest:

• Deaktiviert

Der Zahlungsanbieter ist nicht für die Zahlung verfügbar.

• Aktiviert

Der Zahlungsanbieter ist für die Zahlung verfügbar.

Die Zahlungsmethode muss zusätzlich veröffentlicht werden, damit sie im Onlineshop sichtbar ist.

• Testmodus

Der Zahlungsanbieter ist im Testmodus verfügbar. Wenn die PayPal-Integration mit einem PayPal-Sandbox-Account getestet werden soll, sollte der Status der Bezahlmethode auf Testmodus gestellt werden.

Veröffentlichen

Der Zahlungsanbieter kann durch Auswahl des Buttons auf die Sichtbarkeit umgeschalten werden und umgekehrt.

Nur veröffentlichte Zahlungsmethoden werden im Onlineshop angezeigt.

Zahlungsanbieter Paypal, Reiter: Konfiguration

Angezeigt als

Ein frei wählbarer Text, der dem Kunden im Checkout anstelle des Anbieternamens „PayPal" angezeigt wird. Bleibt das Feld leer, erscheint der Anbietername selbst.

Unterstützte Zahlungssymbole

Es können diverse Symbole hinterlegt werden, die im Checkout unter der PayPal-Option angezeigt werden, um dem Kunden zu zeigen, welche Karten/Zahlungsarten darüber akzeptiert werden.

Zahlungsmethode mit Anzeige der Zahlungsymbole im Checkout des Onlineshops

Beim Zahlungsanbieter PayPal ist dieses Feld rein informativ für die Anzeige: es wird nicht automatisch mit dem tatsächlichen Funktionsumfang des PayPal-Kontos abgeglichen. Die Liste ist manuell an das zu pflegen, was das Konto wirklich akzeptiert. Ein Symbol zu entfernen oder hinzuzufügen ändert nichts daran, welche Karten das hinterlegte PayPal-Konto tatsächlich abwickelt, sondern nur, was im Checkout angezeigt wird.

Höchstbetrag

Der maximale Zahlungsbetrag, für den PayPal im Checkout als Option angeboten wird. Bleibt das Feld leer, gilt keine Obergrenze.

Länder

Die Länder, in denen PayPal als Zahlungsoption zur Verfügung steht. Bleibt das Feld leer, ist PayPal in allen Ländern verfügbar.

Wichtige PayPal Einstellungen

Im PayPal-Konto müssen unter Menü -> Kontoeinstellungen -> Produkte und Dienstleistungen/Website-Zahlungslösungen -> Website-Einstellungen -> Aktualisieren die folgenden Einstellungen vorgenommen werden:

• Automatische Rückleitung für Websitezahlungen: Ein Die Rückleitungs-URL muss auf https://<Shop-Domain>/shop/confirmation gesetzt werden.

• Übertragung der Zahlungsdaten: Ein

Verschlüsselte Websitezahlungen

PayPal -> Kontoeinstellungen -> Website-Zahlungslösungen -> Website-Einstellungen

Die Funktion "Verschlüsselte Websitezahlungen" muss deaktiviert werden.

Zeichencodierung für die Website einstellen

Damit die Kommunikation zwischen PayPal und onRetail reibungslos funktioniert, muss im PayPal-Business-Konto das Encoding von „Windows-1252” auf „UTF-8” geändert werden!

Schritte im PayPal-Business-Konto

1. Anmeldung im PayPal-Business-Konto unter paypal.com.

2. Den Profilnamen oben rechts und anschließend Kontoeinstellungen auswählen.

3. Öffnen des Bereichs Verkaufstools (je nach Ansicht auch Tools für den Verkauf genannt).

4. Zu Weitere Verkaufstools scrollen und PayPal-Schaltflächen – Sprach- und Zeichencodierung auswählen. Die Seite Sprache und Zeichencodierung wird geöffnet.

5. Überprüfung, ob die Einstellung Sprache der Website korrekt gesetzt ist.

6. Weitere Optionen auswählen.

7. Im Dropdown "UTF-8" für die Daten auswählen, die von der Website an PayPal gesendet werden.

8. Festlegung der Zeichencodierung auf "Ja" für Daten, die von PayPal an die Website zurückgesendet werden.

9. Speichern auswählen, um die Einstellungen zu übernehmen.

Die Auswahl von Abbrechen führt zurück zur vorherigen Seite. Änderungen an den Zeichencodierungsoptionen werden dabei nicht gespeichert.

Quelle: https://developer.paypal.com/