Das Plugin join/paypal Shop-Paypal bietet dem Betreiber der Brandbox die Möglichkeit, den Shop um Bezahlarten von PayPal zu erweitern.
Konfiguration
joinShop/paypal Paypal enthält eine Konfigurationstabelle.
Bezeichnung | Attribut | Beschreibung | |
|---|---|---|---|
Aktiv | payPalActive | Boolescher Wert. | |
PayPal PLUS verwenden | payPalPlus | Boolescher Wert. Nur in Kombination mit "Aktiv" gültig. | |
PayPal Express verwenden | isActivePayPalExpress | Boolescher Wert. Unabhängig von "Aktiv". | |
Beschreibung | Attribut | ||
Sandbox-Modus verwenden | payPalSandboxMode | Boolescher Wert. | |
Zeige "Zahlung auf Rechnung (PUI) in Sandbox | payPalShowPuiOnSandbox | Boolescher Wert. Definiert ob die Zahlungsart "Zahlung auf Rechnung" über PayPal PLUS angeboten wird. | |
App ID | payPalAppID | Zeichenkette. Bei PayPal erstelltDer Sandbox Modus ist zum Testen der Anwendung. | payPalSandboxMode |
App ID | Von PayPal bereitgestellt. Identifiziert den Verkäufer. | payPalAppID | |
App Secret | payPalAppSecret | Zeichenkette. Bei PayPal erstelltVon PayPal bereitgestellt. Geheimer Schlüssel, der den Verkäufer authentifiziert. | payPalAppSecret |
App ID Sandbox | payPalSandboxAppID | Zeichenkette. Bei PayPal erstelltVon PayPal bereitgestellt. Identifiziert den Verkäufer. (nur zum Testen notwendig) | payPalSandboxAppID |
App Secret Sandbox | payPalSandboxAppSecret | Zeichenkette. Bei PayPal erstelltVon PayPal bereitgestellt. Geheimer Schlüssel, der den Verkäufer authentifiziert. |
Verwendung
Um PayPal oder PayPal Plus zu verwenden, müssen in der Konfigurationstabelle "payPalSettings" die nötigen Werte eingetragen werden (siehe "Konfiguration").
(nur zum Testen notwendig) | payPalSandboxAppSecret | |
Button Höhe | Stellt die höhe der Buttons ein. | payPalButtonHeight |
Verwendung
Wie man eine Zugangsdaten für einen PayPal Client erstellt, ist hier nachzulesen: https://developer.paypal.com/docs/integration/admin/manage-apps/. Die ClientID und das Secret des Verkäufers müssen in der Tabelle Konfiguration hinterlegt werden.
Möchte man die Integration vorerst ausprobieren, sollte der Sandbox-Modus aktiviert werden. Um eine Zahlung über PayPal im Sandbox-Modus zu tätigen, wird ein Sandbox-Account benötigt (https://developer.paypal.com/docstools/classic/lifecycle/sandbox/accounts/). Es müssen keine neuen Zugangsdaten erstellt werden, um den Sandbox-Modus zu aktivieren.
Nun werden die Zahlsmöglichkeiten von PayPal im letzten Schritt des Bestellvorgangs angezeigt.
Verwenden Sie eigene Bilder
Wurde ein Bild bei der Zahlungsform definiert, das gewissen Parametern entspricht (siehe unten), so legt "join/paypal" dieses Bild in einem öffentlichen Verzeichnis ab (.../temp/synced-cache/...), sodass das Bild bei den Zahlungsmöglichkeiten von PayPal Plus angezeigt wird.
Parameter:
Dateiformat: GIF, JPG, PNG
Größe: <= 50 KB
Breite: <= 750 px
Höhe: <= 90 px
...
PayPal Express & "PayPal Direkt"
...
Konfiguration der Bezahlmethoden
Die einzelnen Bezahlmethoden werden in der Zahlungsformen Tabelle angelegt. Durch Erweiterung Shop-Paypal erscheint ein neuer Tab PayPal in den Zahlungsformen. In diesem Tab können Sie angeben, welche PayPal Bezahlmethode, diese Zahlungsform darstellen soll.
Folgende Bezahlmethoden stehen zur Verfügung:
PayPal
Kreditkarte
SEPA Lastschrift
PayPal Express
PayPal Express
Die Besonderheit bei PayPal Express ist, dass die Zahlungsform deaktiviert werden muss. Sobald die Methode gepflegt wurde erscheint ein PayPal Button auf der Artikel Detailseite und im Willkommensschritt des Checkouts.
Sichtbar sind die Buttons nur unter den folgenden Voraussetzungen:
PayPal Express ist aktiv.
Sowohl ClientID als auch Secret sind hinterlegt.
Der Preis für einen Artikel muss größer als 0 sein. Da PayPal keine Werte akzeptiert, die kleiner oder gleich 0 sind, werden die Buttons gar nicht erst angezeigt, solange diese Voraussetzung nicht erfüllt ist.
Man muss ein Gast/anonymer Nutzer sein (nicht Authentifiziert oder anonymer Nutzer).
Funktionale Cookies müssen akzeptiert sein.
Klickt man auf einen PayPal Express Button, wird ein Fenster geöffnet, in dem man sich bei PayPal anmelden kann. Meldet sich ein Nutzer an und wählt eine Zahlungsart, werden die Daten brandbox übermittelt, sodass die Adressdaten gemappt werden können. Der Nutzer wird durch den Bestellvorgang geführt, wo er nochmals seine Adressdaten kontrollieren kann.
Bei Abschluss der Bestellung wird die Bestellung bei PayPal aktualisiert (z.B. Preisänderung durch Versandkosten) und abgeschlossen.