PayPal

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

Installation

PayPal ist im Standard von Shopware enthalten und muss lediglich im Admin unter Erweiterungen > Meine Erweiterungen installiert werden. Hierzu klickst Du bei der PayPal Erweiterung auf App installieren. Du kannst die Erweiterung aber auch schon direkt bei der Installation von Shopware im Ersteinrichtungs-Assistenten beziehen und konfigurieren.

Allgemeine Konfiguration

Die Konfiguration von PayPal erfolgt im Admin unter Einstellungen > 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.

PayPal Checkout

PayPal Checkout ist die All-in-One-Lösung, mit der Du leistungsstarke und flexible Funktionen zur Zahlungsabwicklung anbieten kannst. Mit PayPal Checkout kannst Du Deinen Kunden, neben dem klassischen PayPal, die Bezahlung per Rechnung, Kreditkarte, Lastschrift und vielen anderen lokalen Zahlungsmethoden anbieten. PayPal Checkout ersetzt das Vorgängermodell PayPal PLUS. Für einige der Zahlungsarten, wie der Rechnungskauf, ist ein Onboarding erforderlich. Die initiale Einrichtung / das Onboarding startetest Du, indem Du auf dem Button Start des Onboarding klickst. Anschließend loggst Du Dich auf der PayPal Seite mit Deinem Account ein und befolgst die Anweisungen.  

Aktuell wird das Modul für Händlerkonten aus foldenden Ländern unterstützt: 

• Australien

• Belgien

• Bulgarien

• Kanada

• Zypern

• Tschechien

• Dänemark

• Estland

• Finnland

• Frankreich

• Deutschland

• Griechenland

• Ungarn

• Italien

• Lettland

• Liechtenstein

• Litauen

• Luxemburg

• Malta

• Niederlande

• Norwegen

• Polen

• Portugal

• Rumänien

• Slowakei

• Slowenien

• Spanien

• Schweden

• Vereinigtes Königreich

• USA

Konfiguration Onboarding

Start des Onboarding (1): Mit dem Button kann das Onboarding und die initiale Einrichtung der Integration über die PayPal Seite durchgeführt werden, dabei werden die PayPal API-Zugangsdaten automatisch konfiguriert. 

Sandbox-Zugangsdaten verwenden (2): Diese Option kann aktiviert werden, wenn Du die PayPal Integration testen möchtest. In diesem Fall werden keine echten Zahlungen getätigt. Bitte beachte hierbei, dass die Sandbox-Umgebung eigene Zugangsdaten hat. 

Name der Zahlart (3): PayPal Checkout stellt viele verschiedene Zahlungsarten zur Verfügung, unter dem Punkt ist die jeweilige Zahlungsart definiert.

Status der Zahlart (4): Der Status der Zahlungsart gibt Auskunft darüber, ob die Zahlungsart aktuell in Deinem Shop verwendet werden kann oder nicht. Der Status Onboarding benötigt und Autorisiert sind möglich.

Zahlart aktivieren / deaktivieren (5): Über diese Schaltfläche kannst Du die jeweilige Zahlungsart für Deinen Shop aktivieren oder deaktivieren. 

Konfiguration API-Zugangsdaten

Alternativ zum Onboarding kannst Du, sofern vorhanden, auch Deine PayPal API-Zugangsdaten direkt eingeben. 

Zeige API-Zugangsdaten (1): Über diese Schaltfläche kannst Du die Einstellungen für die API-Zugangsdaten ein- / ausblenden.

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

Client-Secret (3): 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.

PayPal-Händler-ID (4): An dieser Stelle trägst Du deine PayPal Händler-ID ein, um die neuen PayPal Checkout Funktion zu authentifizieren.

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

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.

Sandbox-PayPal-Händler-ID (8): An dieser Stelle trägst Du deine Sandbox PayPal Händler-ID ein, um die neuen PayPal Checkout Funktion zu authentifizieren.

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 selbst angezeigt.

PayPal Versandtracking

Mit der PayPal Version 5.3.0 ist es möglich, die Versandtracking-ID des Versanddienstleisters an PayPal zu übertragen. Diese Funktion steht aber nur nach erfolgreichem Checkout Onboarding zur Verfügung.

   

Danach kannst Du unter Einstellungen > Versandarten einen Standard Versanddienstleister hinterlegen. Eine Liste der möglichen Versanddienstleister findest Du hier.

 

Um die Versandtracking-ID an PayPal übertragen zu können, musst Du in Shopware noch die jeweilige Sendungsnummer eintragen. Füge diese in der Kundenbestellung in den Bestelldetails der jeweiligen Bestellung ein. Die hinzugefügten Informationen werden nach dem Eintrag automatisiert an PayPal weitergeleitet.

PayPal PLUS

Die Erweiterung PayPal 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.

Wenn Du die neuen PayPal Checkout Funktionen nutzen möchtest, solltest Du die PayPal PLUS Funktion deaktivieren, um die Anzeige von doppelten Zahlungsmethoden zu vermeiden. Die Deaktivierung der PayPal PLUS Funktion kann nicht rückgängig gemacht werden.

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.

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.

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.

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 Checkout 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 vor die ursprüngliche Bestellnummer gehängt wird, z.B. meinShopSW20001. Diese Option steht Dir erst zur Verfügung, wenn Du die vorherige Option "Bestellnummer an PayPal übertragen" aktiviert hast.

Bestellnummer-Suffix (8): Hier kannst Du bestimmen, welcher an die Bestellnummer angehängt wird, SW20001meinShop.

Protokollierung (9): Hiermit werden zusätzliche Daten des Bestellvorgangs protokolliert, um Fehler aufzuspüren. Die Option "Erweitert" sollte nur vorübergehend aktiviert werden.

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 Produktdetailseite 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 Produktdetailseite, dem (Offcanvas-) Warenkorb und beim Ändern der Zahlungsart im Bestellvorgang anzuzeigen. Dieser Banner wird bei den Produkten 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.

Voraussetzungen

• PayPal Ratenzahlung steht ab einem Warenkorb in Höhe von 5 Euro zur Verfügung. Der maximale Warenkorbwert beträgt 5.000 Euro.

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

Produktdetailseite:

Offcanvas-Warenkorb:

Warenkorb:

Rechnungskauf

Mit dem Rechnungskauf können mit PayPal Checkout sowie mit PayPal PLUS Deine Kunden die Bestellung als Kauf auf Rechnung tätigen. PayPal begleicht den Rechnungsbetrag an Dich als Shopbetreiber und der Kunde muss begleicht die Rechnung als Überweisung an PayPal / Ratepay.

Konfiguration

Über dieses Feld können für die Zahlungsart Rechnungskauf zusätzliche Informationen in Kunden E-Mails implementiert werden, dies können zum Beispiel Hinweise zur Zahlung sein.

Rechnungsdokument

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.

PayPal Checkout mit Smart Payment Buttons

Wenn Du unter Verhalten bei dem Händlerstandort "Anderer Händlerstandort" ausgewählt hast, werden Dir in Deinem Shop die Smart Payment Buttons im Checkout angezeigt (PayPal PLUS steht dann nicht mehr zur Verfügung). Für die Konfiguration dieser Smart Payment Buttons wird eine neue Konfigurationsmöglichkeit eingeblendet, sobald Du den Händlerstandort geändert hast.

Konfiguration

Später Bezahlen als eigenen Button anzeigen (1): Ist die Schaltfläche wird zusätzlich ein "PayPal Später Bezahlen" Button eingeblendet, welcher den Kunden direkt auf die PayPal Option führt den Betrag nach 30 Tage zu bezahlen.  

Buttonfarbe (2): 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 (3): Hier legst Du die Form des PayPal Express Buttons fest. Es kann zwischen Rund und Eckig gewählt werden.

Buttonsprache (4): 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.

Die Smart Payment Buttons werden anstelle des normalen Checkout Button angezeigt:
 

Paypal Rückerstattung

Wurde eine Bestellung bereits bezahlt und Du möchtest diese Bezahlung rückgängig machen bzw. erstatten, so ist dies über die eigentlche Bestellung möglich. Hierzu gibt es innerhalb der Bestellung den Reiter PayPal mit dem Punkt Rückerstattung.

Über den Punkt Rückerstattung öffnet sich ein neues Fenster, innerhalb dessen optionale Informationen wie zum Beispiel eine Rechnungsnummer oder ein Verwendungszweck angegeben werden kann.

Über Ausführen wird der Betrag erstattet und der Zahlstatus der Bestellung wird automatisch auf Erstattet gesetzt.

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. 

Fehlgeschlagene Zahlung

Fehlgeschlagene Zahlungen können aus unterschiedlichsten Gründen passieren. Mögliche Gründe und weitere Informationen findest Du hier.