PayPal

Die PayPal Erweiterung bietet Dir die Möglichkeit Deinen Kunden die gängigen PayPal-Zahlungsarten zur Verfügung zu stellen.

Installation

Die Installation der PayPal Erweiterungen ist über verschiedene Wege möglich.

Zum einen kannst Du die Erweiterung direkt bei der Installation von Shopware im Ersteinrichtungs-Assistenten beziehen und konfigurieren.
 

Zum anderen kannst Du im Admin unter Erweiterungen > Store den Shopware Store aufrufen und dort nach der aktuellen PayPal Erweiterungen suchen und dies im Anschluss in Deinem Shop installieren. Alternativ kannst Du auch direkt im Shopware Store unter store.shopware.com die PayPal Erweiterung herunterladen.

Allgemeine Konfiguration

Die Konfiguration von PayPal erfolgt im Admin unter Erweiterungen > Meine Erweiterungen, indem Du dort auf PayPal klickst.

Verkaufskanäle

In diesem Drop-Down-Menü kannst Du auswählen, für welchen Deiner Verkaufskanäle die Einstellungen vorgenommen werden sollen. Du kannst hier zwischen Alle Verkaufskanäle oder einzelne Verkaufskanäle auswählen.

Über die Schaltfläche Setze PayPal als Standard kannst Du PayPal im ausgewählten Verkaufskanal aktivieren und als Standardzahlungsart setzen.

Konfiguration der API-Einstellungen

Im nächsten Schritt musst Du Deine von PayPal erhaltenen Zugangsdaten für PayPal eintragen. 

Client-ID (1): Hier trägst Du die PayPal REST-ID ein. Diese verwendet die Erweiterung, um sich mit der PayPal-API zu authentifizieren.

Client-Secret (2): An dieser Stelle trägst Du das REST-API Client-Secret ein, welches die Erweiterung ebenfalls dazu verwendet, um sich mit der PayPal-API zu authentifizieren.

Hole API-Zugangsdaten (3): Über diese Schaltfläche kannst Du über ein Pop-Up-Fenster von PayPal neue API-Zugangsdaten anfordern.

API-Zugangsdaten testen (4): Mit Hilfe dieser Schaltfläche kannst Du die von Dir eingetragenen Zugangsdaten testen. Das Ergebnis des Tests wird Dir direkt in dem Button Speichern angezeigt.

Sandbox aktivieren (5): Setze hier den Haken, wenn Du die PayPal Integration lediglich testen möchtest. Bitte beachte hierbei, dass die Sandbox-Umgebung eigene Zugangsdaten hat.

Sandbox-Client-ID (6): Hier trägst Du die PayPal Sandbox REST-ID ein. Diese verwendet die Erweiterung, um sich mit der PayPal-API zu authentifizieren.

Sandbox-Client-Secret (7): An dieser Stelle trägst Du das Sandbox REST-API Client-Secret ein, welches die Erweiterung ebenfalls dazu verwendet, um sich mit der PayPal-API zu authentifizieren.

Hole Sandbox-API-Zugangsdaten (8): Über diese Schaltfläche kannst Du über ein Pop-Up-Fenster von PayPal neue Sandbox-API-Zugangsdaten anfordern.

Sandbox-API-Zugangsdaten testen (9): Mit Hilfe dieser Schaltfläche kannst Du die von Dir eingetragenen Zugangsdaten testen. Das Ergebnis des Tests wird Dir direkt in dem Button Speichern angezeigt.

Verhalten

Unter Verhalten kannst Du grundlegende Einstellungen für die Erweiterung vornehmen, welche sich nicht nur auf das klassische PayPal beziehen, sondern auch für den Express Checkout und für PayPal PLUS gelten.
 

Händlerstandort (1): Hier kannst Du Deinen Händlerstandort angeben.

Zahlungsabschluss (2): Hier wird festgelegt, wann die Zahlung eingezogen - also abgeschlossen - wird.

Warenkorb übertragen (3): Hier kannst Du auswählen, ob der Warenkorb des Kunden, also die genauen Positionen der Bestellung an PayPal übertragen werden dürfen. Ist diese Option deaktiviert, wird nur die Gesamtsumme übertragen.

Eigener Markenname auf der PayPal-Seite (4): Du hast hier die Möglichkeit einen eigenen Markennamen für die Anzeige auf der PayPal-Zahlungsseite zu definieren.

PayPal-Landingpage (5): Hier kannst Du auswählen, ob die PayPal-Landingpage das Registrierungsformular oder zum Login-Screen anzeigen soll.

Bestellnummer übertragen (6): Aktiviere diese Option, wenn Du die Bestellnummer nach Abschluss an PayPal übermitteln möchtest.

Bestellnummer-Präfix (7): Hier kannst Du bestimmen, welcher Text an die ursprüngliche Bestellnummer angehängt wird, z.B. meinShopSW20001. Diese Option steht Dir erst zur Verfügung, wenn Du die vorherige Option "Bestellnummer an PayPal übertragen" aktiviert hast.
 

 

Klassisches PayPal

Mit dem Eintragen der API-Zugangsdaten nutzt Du das klassische PayPal für Deinen Shop. Somit sind Deine Kunden in der Lage mit ihrem PayPal-Konto Ihre Bestellungen zu bezahlen.
 

PayPal Express Checkout

Die PayPal Erweiterung bietet auch die Möglichkeit des Express-Checkouts. Hierüber muss sich Dein Kunde für seine Bestellung nicht im Shop registrieren. Die Bestellung wird somit allein anhand seines PayPal-Kontos abgewickelt.

 

Konfiguration

'Direkt zu PayPal' auf Detailseite (1): Hier kannst Du definieren, ob der PayPal Express Button auf der Artikeldetailseite angezeigt wird.

'Direkt zu PayPal' im Warenkorb (2): Hier wird angegeben, ob der PayPal Express Button im Warenkorb eingeblendet werden soll.

'Direkt zu PayPal' im Off-Canvas Warenkorb (3): Aktivierst Du diese Option, wird der Express Checkout Button in dem Off-Canvas/Modal-Warenkorb angezeigt.

'Direkt zu PayPal' auf Loginseite (4): Hier kannst Du festlegen, ob der PayPal Express Button auf der Loginseite angeboten wird.

'Direkt zu PayPal' auf Listing Seiten (5): Wenn Du diese Option aktivierst, wird der Express Checkout Button auf Listing-Seiten angezeigt.

Buttonfarbe (6): Diese Option bietet Dir einige Farben an, in denen der PayPal Express Button ausgegeben werden kann. Es werden Gold, Blau, Silber und Schwarz angeboten.

Buttonform (7): Hier legst Du die Form des PayPal Express Buttons fest. Es kann zwischen Rund und Eckig gewählt werden.

Warenkorb übertragen (8): Hier kannst Du auswählen, ob der Warenkorb des Kunden, also die genauen Positionen der Bestellung an PayPal übertragen werden dürfen. Ist diese Option deaktiviert, wird nur die Gesamtsumme übertragen.

Buttonsprache (9): In diesem Feld kannst Du abweichende Shop-Sprachen für den Express Checkout Button eintragen. Wenn das Feld leer ist, wird die Verkaufskanal-Sprache verwendet.
Es ist wichtig, dass Du hier den sog. "Locale Code" einträgst, wie bspw. en_GB. Eine Liste über verfügbare Sprachencodes findest Du auf der PayPal-Seite. Du kannst die Seite auch öffnen, indem Du auf die Verlinkung "hier" klickst.
 

   

Ratenzahlung

Die PayPal Erweiterung bietet Dir die Möglichkeit, ein Banner für die neue Ratenzahlung auf der Artikeldetailseite, dem (Offcanvas-) Warenkorb und beim Ändern der Zahlungsart im Bestellvorgang anzuzeigen. Dieser Banner wird bei den Artikeln angezeigt, die den Kriterien für die Ratenzahlung entsprechen.

Damit Deine Kunden die neue Ratenzahlung in Deinem Shop nutzen können, müssen diese im Checkout die Zahlungsart PayPal auswählen und sich mit ihrem PayPal-Account anmelden. Anschließend können Deine Kunden prüfen, ob die Zahlungsart Ratenzahlung angezeigt wird.

Weitere Informationen zur PayPal Ratenzahlung findest Du hier.

Konfiguration

Unter Ratenzahlung hast Du die Möglichkeit, die Option für den Ratenzahlungsbanner aktivieren. Dies funktioniert ausschließlich mit Deiner Live Client-ID (nicht mit der Sandbox Client-ID).

 

Ansicht in der Storefront

 

Artikeldetailseite:

 

Offcanvas-Warenkorb:

Warenkorb:
 

Zahlungsart ändern:
 

 

PayPal PLUS

Die Erweiterung schließt eine direkte Integration von PayPal Plus ein, mit der Du Deinen Kunden die Zahlungsarten SEPA-Lastschrift, Kreditkarte und Kauf auf Rechnung zusätzlich zu dem klassischen PayPal anbieten kannst.
 

Voraussetzungen

• PayPal Plus ist aktuell nur für Händler in Deutschland verfügbar. Deinen Händlerstandort kannst Du, wie weiter oben erwähnt, unter Verhalten angeben.
• PayPal Ratenzahlung steht ab einem Warenkorb in Höhe von 199 Euro zur Verfügung. Der maximale Warenkorbwert beträgt 5.000 Euro.

Beachte bei dem Händlerstandort, dass dieser für PayPal PLUS "Deutschland" sein muss. Ansonsten werden die Smart Payment Buttons von PayPal angezeigt. Weitere Informationen zur Konfiguration und der Ansicht in der Storefront findest Du im Abschnitt PayPal Checkout mit Smart Payment Buttons.
 

Konfiguration

Für die Konfiguration von PayPal PLUS musst Du lediglich die Option PayPal PLUS aktivieren im Admin aktivieren.
 

Rechnungsdokument bei Zahlung mit PayPal Rechnungskauf

Wenn Deine Kunden ihre Bestellung mit dem PayPal Rechnungskauf durchführen, wird die Rechnung durch PayPal an Dich als Shopbetreiber beglichen. Dies bedeutet aber für Deine Kunden, dass sie den Rechnungsbetrag der Bestellung an PayPal direkt überweisen müssen. Hierzu wird Deinen Kunden automatisch die richtige Bankverbindung nach der Bestellung angezeigt.
 

Ebenso werden diese Zahlungsinformationen automatisch in der Rechnung angezeigt, wenn Du diese unter "Belege" für diese Bestellung erzeugst.

 

Ansicht in der Storefront

Der Bestellvorgang kann wie gewohnt durchgeführt werden, wenn man die Bezahlmöglichkeiten von PayPal Plus nutzen möchte. Dabei werden PayPal, Lastschrift, Kreditkarte und Kauf auf Rechnung per iFrame in der Zahlart-Auswahl im Checkout eingeblendet. Voraussetzung hierfür ist, dass der Kunde in seinem Account PayPal als Zahlungsart ausgewählt hat.

 

 

PayPal Checkout mit Smart Payment Buttons

Wenn Du unter Verhalten bei dem Händlerstandort "Anderer Standort" ausgewählt hast, steht Dir in Deinem Shop der PayPal Checkout mit Smart Payment Buttons statt PayPal PLUS zur Verfügung. Für die Konfiguration dieser Smart Payment Buttons wird eine neue Konfigurationsmöglichkeit eingeblendet, sobald Du den Händlerstandort geändert und abgespeichert hast.

Konfiguration

Smart Payment Buttons aktivieren (1): Hier kannst Du die Smart Payment Buttons aktivieren bzw. deaktivieren.

Aktiviert die alternativen Zahlungsarten der Smart Payment Buttons (2): Hier kannst Du die alternativen Zahlungsarten wie SEPA, Kreditkarte, etc. aktivieren.

Buttonfarbe (3): Diese Option bietet Dir einige Farben an, in denen der PayPal Express Button ausgegeben werden kann. Es werden Gold, Blau, Silber und Schwarz angeboten.

Buttonform (4): Hier legst Du die Form des PayPal Express Buttons fest. Es kann zwischen Rund und Eckig gewählt werden.

Buttonsprache (5): In diesem Feld kannst Du abweichende Shop-Sprachen für den Express Checkout Button eintragen. Wenn das Feld leer ist, wird die Verkaufskanal-Sprache verwendet.
Es ist wichtig, dass Du hier den sog. "Locale Code" einträgst, wie bspw. en_GB. Eine Liste über verfügbare Sprachencodes findest Du auf der PayPal-Seite. Du kannst die Seite auch öffnen, indem Du auf die Verlinkung "hier" klickst.

 

Ansicht in der Storefront

Die Smart Payment Buttons werden anstelle der PayPal PLUS Zahlungsarten im Checkout angezeigt:

 

PayPal Konflikte

Wenn Kunden mit PayPal bei Dir bezahlen können, kann es natürlich auch dazu kommen, dass Konfliktfälle bei PayPal eröffnet werden, auf die Du reagieren musst. Dies können beispielsweise unvollständige oder mangelhafte Lieferungen sein. 

Ab der Version 2.1.1 bietet Dir die PayPal Erweiterung die Möglichkeit, alle offenen PayPal Konfliktfälle in Deinem Shopware Admin anzuzeigen. 

Übersicht

Du findest die offenen Fälle in Deinem Shopware Admin unter Kunden > PayPal Konflikte.

Übersicht (1): In der Übersicht findest Du alle offenen PayPal Konflikt Fälle und die wichtigsten Informationen. Zum Einen die Fall-ID, über die Du die Fall Details öffnen kannst. Des Weiteren die letzte Aktualisierung, die Fälligkeit der nächsten Antwort den aktuellen Status, das aktuelle Stadium des Konflikts und den Betrag um welchen es in dem Konfliktfall geht. 
PayPal Konflikt Center (2): Über diesen Link, neben jedem Konflikt, gelangst Du direkt zum PayPal Lösungs Center zum jeweiligen Fall. 
Aktualisieren (3): Über diesen Button kannst Du die Ansicht der Konflikte aktualisieren. 
Filter (4): Im Filter hast Du die Möglichkeit die angezeigten Konfliktfälle nach dem Konfliktstatus und nach dem Verkaufskanal zu filtern. 

Für das Filtern nach Verkaufskanälen ist es notwendig, dass für jeden Verkaufskanal eine eigene API genutzt wird.

Fall-Details

Über die Fall-ID in der Übersicht gelangst Du zu den Fall-Details. Hier hast Du noch ein mal alle Details zu dem Fall aufgelistet.

Details (1): Hier findest Du alle Details zu dem offenen Fall. 
Links (2): Über die Links am oberen Rand gelangst Du zum Einen direkt zum PayPal Lösungs Center zum jeweiligen Fall um den Fall dort bearbeiten zu können. Zum Anderen findest Du einen Link zur betroffenen Bestellung. (Dieser wird aktuell nur bei Bestellungen angezeigt, die über PayPal Express erzeugt wurden)
Rohdaten (3): Im Feld Rohdaten findest Du einen JSON String, welcher alle Informationen enthält, welche Shopware von PayPal zu dem Fall erhalten hat.