Plugin: PayPal

Allgemeines

Das PayPal Plugin ermöglicht es Dir, neben der direkten Online-Bezahlung (optional per Express Checkout) auch Ratenzahlung, Kauf auf Rechnung und weitere Zahlungsarten anzubieten.

Diese weiteren Zahlungsarten werden Dir über zwei verschiedene Produkte des Unternehmens PayPal zur Verfügung gestellt, welche Du im PayPal Plugin findest. Die neue Variante für die Bereitstellung weiterer Zahlungsarten heißt PayPal Checkout. Damit Du PayPal Checkout nutzen kannst, musst Du einmalig freigeschaltet werden. Weitere Informationen hierzu findest Du im Abschnitt Konfiguration der API-Einstellungen unter dem Punkt Autorisieren.
Die alte Variante heißt PayPal Plus, allerdings ist eine Freischaltung hierfür nicht mehr möglich.
Das Plugin PayPal Express wird nicht separat benötigt. Die dortige Funktionalität ist hier im Plugin mit enthalten.

Installation

Diese Erweiterung findest Du in unserem Shopware Store. Der einfachste Weg, ein bestimmtes Plugin zu finden, ist die Suchleiste.
Nachdem Du den Bestellvorgang abgeschlossen hast, logge Dich in das Backend Deines Shops ein. Jetzt gehst Du zu Konfiguration > Plugin-Manager >Meine Einkäufe. Du musst Dich einloggen und auf die Schaltfläche Aktualisieren klicken. Die neue Erweiterung ist nun aufgelistet und kann installiert werden. Nach der Installation der Erweiterung gehst Du auf den Menüpunkt Installiert und aktualisierst die Übersicht. Jetzt kannst Du die Erweiterung aktivieren. Abschließend löscht Du unter Einstellungen > Cache/Performance > Shop-Cachelöschen den Cache und aktualisierst das Backend.

Nach der Installation des PayPal Plugins findest Du im Backend unter Kunden > Zahlungen > PayPal die zum Plugin gehörenden Module Bestellungen und Einstellungen.

Kompatibilität zu vorherigen PayPal Plugins

Das Plugin PayPal bietet Dir die Möglichkeit alte Bestellungen ins neue Bestellübersichtsmodul zu überführen. Auf diese Weise werden alle Deine PayPal Bestellungen in der Bestellübersicht des neuen Plugins angezeigt und Du kannst Dich von den alten PayPal Plugins trennen.

Die Bestellungen, die mit den bisherigem PayPal bzw. PayPal Plus Plugin verarbeitet wurden, tauchen dann in der neuen Bestellübersicht auf und werden der korrekten Zahlungsart zugeordnet. Wie Du sehen kannst, werden migrierte Bestellungen mit dem Zusatz "(alt)" ergänzt. Zusätzlich ist ein Hinweis auf diesen Kompatibilitätsmodus in den Bestelldetails zu finden, da nicht alle Informationen dargestellt werden, die z.B. bei einer Bestellung vorhanden sind, die über das PayPal Plugin abgewickelt wurde. Hierzu zählt z.B. die Transaktionshistorie.

Um Deine Bestellungen zu übernehmen, musst Du zuerst die bisherigen PayPal-Plugins deinstalliert halten. Anschließend kannst Du die Bestellübersicht öffnen: Alle bisher vorhandenen Bestellungen sind nun bereits hinterlegt, weitere Schritte sind zur Übernahme nicht erforderlich.

Bitte denke unbedingt daran, diese Schritte im Voraus auf einem Testsystem einmal zu prüfen und in jedem Fall eine Datensicherung zu machen, bevor die Übernahme durchgeführt wird. Auf diese Weise kann in einem eventuellen Fehlerfall schnell reagiert werden.

Übernommene Bestellungen können wie gewohnt zurückerstattet werden, im Zahlungsverlauf wird jedoch immer nur der aktuelle Status angezeigt.

Es werden nur Transaktionen des Typs "Sale" unterstützt. In den Einstellungen des bisherigen PayPal Plugins entspricht dies der Option "Zahlung sofort abschließen (Sale)" zum Zahlungsabschluss.

Das aktuelle PayPal Plugin ist mit keinem der bisherigen PayPal Plugins kompatibel! Es kann also nicht mit PayPal Express, PayPal Plus oder PayPal Ratenzahlung parallel betrieben werden. Bitte achte also darauf, diese Plugins beim Einsatz des aktuellen PayPal Plugins zunächst zu deinstallieren. Bitte kontrolliere, ob alle Bestellungen übernommen wurden, bevor Du die alten PayPal Plugins komplett löschst. Auf diese Weise kann ein möglicher Datenverlust vermieden werden.

Ersteinrichtung

Nachdem Du das Plugin installiert hast, kannst Du die Konfiguration im PayPal Modul unter Einstellungen vornehmen.

Übersicht

Das Konfigurationsmodul des PayPal Plugins ist in vier Bereiche eingeteilt, welcher jeweils über einen Tab am oberen Rand des Fensters erreichbar ist:

• Grundeinstellungen (1)
• PayPal Express Checkout Integration (2)
• PayPal Plus Integration (6)
• PayPal Pay Kauf auf Rechnung Integration (4)
• PayPal Advanced Credit Debit Card Integration (5)
• PayPal Plus Integration (6)

In dem Tab Grundeinstellungen kannst Du neben den allgemeinen Einstellungen zum Verhalten und des Errorhandlings des Plugins auch die API-Einstellungen für PayPal hinterlegen.

Aktivierung und Shopauswahl

Die PayPal Einstellungen lassen sich pro Shop über das Dropdown-Menü Shop wählen (1) oben rechts konfigurieren. Somit hast Du die Möglichkeit abweichende Einstellungen für Subshops und Sprachshops zu definieren.
Damit PayPal in Deinem Shop genutzt werden kann, musst Du PayPal mittels der Checkbox Für diesen Shop aktivieren (2) aktivieren.

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 das Plugin, um sich mit der PayPal-API zu authentifizieren.

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

PayPal-Händler-ID (3): Die ID wird für die Optionen PayPal Pay Upon Invoice Integration und PayPal Advanced Credit Debit Card Integration benötigt. Die genaue ID findest Du in Deinem Account.

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

Autorisieren (5): Hier wirst Du direkt zur Anmelde-Seite von PayPal weitergeleitet, um automatisiert Client-ID, Client-Secret und PayPal-Händler-ID zu erhalten.

API-Einstellungen testen (6): Mit Hilfe dieser Schaltfläche kannst Du die von Dir eingetragenen Zugangsdaten testen. Das Ergebnis des Tests wird Dir direkt mittels einer Nachricht am oberen Bildschirmrand im Backend angezeigt.

Webhook registrieren (7): Die Registrierung der Webhooks kann an dieser Stelle manuell angestoßen werden.
Im Normalfall werden Webhooks automatisch übermittelt und eingerichtet, sodass dieser Schritt nur in Ausnahmefällen notwendig sein sollte. Weitere Informationen zu Webhooks findest Du im Abschnitt Konfiguration der Webhooks.

Konfiguration der Webhooks

Webhooks sind eine Web-Technologie, die Push-Notifications ähneln. Hiermit kann PayPal auch im Nachhinein Updates zu Deinen Transaktionen an Deinen Shopware-Shop übermitteln.

Seit der Ablösung von PayPal Plus durch PayPal Checkout, wird auf das Empfangen von Webhooks in der Plugin-Implementierung verzichtet. Sofern Du kein PayPal Plus mehr verwendest, kannst Du den folgenden Abschnitt überspringen.

Geh bitte auf die Website developer.paypal.com und logge Dich mit Deinem PayPal-Account ein. Dort findest Du im Bereich "Dashboard" den Menüpunkt "My Apps & Credentials". Wenn Du aus den dort hinterlegten REST API Apps Deine App auswählst, gelangst Du zu dem Bereich der Webhooks. Um den Webhook hinzuzufügen, klickst Du auf "Add Webhook".

Die Webhook-URL muss folgendes Format besitzen: https://example.com/PaypalUnifiedWebhook/execute

Hierbei handelt es sich um Deine Domain mit Shop-Zusatz, falls vorhanden. Diese URL entspricht der Notify-URL, unterscheidet sich dabei aber in dem Zusatz "webhook". Bezüglich der Schreibweise kannst Du sowohl "CamelCase" als auch "snake_case" verwenden. Bei der Einstellung "Event Types" muss darüber hinaus "All Events" aktiviert werden.

Klassisches PayPal

Mit dem Eintragen der API-Daten und der Aktivierung in dem Tab Grundeinstellungen, nutzt Du das klassische PayPal, d.h. PayPal als bekannte Zahlungsart, in Deinem Shop. Somit sind Deine Kunden in der Lage mit ihrem PayPal-Konto Ihre Bestellungen zu bezahlen.
Darüber hinaus bietet PayPal weitere Zahlungsarten an, beispielsweise den PayPal Shortcut (Express Checkout), aber auch weitere Zahlungsarten wie Kredikarte oder Kauf auf Rechnung. Die Gesamtheit an Zahlungsarten wird unter dem Begriff PayPal Checkout (und früher PayPal Plus) zusammengefasst.

Beachte hierbei, dass sich einige Einstellungen in dem Tab Grundeinstellungen nicht nur auf das klassische PayPal beziehen, sondern auch auf PayPal Checkout und den Vorgänger PayPal Plus oder den Express Checkout, wenn diese aktiviert sind. 

​Konfiguration

Unter Verhalten in dem Tab Grundeinstellungen konfigurierst Du folgende Einstellungen:
 

Zahlungsabschluss (1): 

• (CAPTURE) Zahlung sofort abschließen: Zahlung wird automatisch sofort eingezogen
• (AUTHORIZE) Zeitverzögerter Zahlungseinzug: Die Zahlung wird nur genehmigt. Der Einzug muss seperat erfolgen.

Markenname auf der PayPal-Seite (2): Der hier hinterlegte Text wird auf der PayPal-Zahlungsseite als Markenname angezeigt.

Warenkorb übertragen (3): Hier kannst Du auswählen, ob der Warenkorb an PayPal übertragen werden soll. Dies wird dringend empfohlen, um PayPals Risikoeinschätzung zu verbessern.

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

Logo in der Sidebar darstellen (5): Wenn Du diese Option aktivierst, wird das PayPal-Logo in der Sidebar Deiner Storefront dargestellt.

Bitte beachte, dass folgende Voraussetzungen für die Anzeige Deines Logos auf der PayPal-Seite gegeben sein müssen:

• Das Bild muss von extern erreichbar sein
• Das Bild muss unter HTTPS erreichbar sein
• Das Bild muss eines der folgenden Dateitypen sein: .gif, .jpg, oder .png

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

Smart Payment Buttons verwenden (7): Ab der Plugin Version 4.1.3 kann man die von Paypal bereitgestellten Smart Buttons nutzen. Mit dem Aussehen und der Funktionsweise der Buttons kannst Du Dich hier vertraut machen.

Errorhandling

Das PayPal Plugin ermöglicht Dir über das Errorhandling etwaige Fehlermeldungen auszugeben und das Logging zu aktivieren.

Fehlermeldung ausgeben (1): Die Aktivierung der Option bewirkt, dass die Kommunikationsfehlermeldung im Shop ausgegeben werden.

Logging (2): An dieser Stelle definierst Du, wie streng dieses Logging sein darf. Du hast hier die Auswahl nur Fehler in das Log aufzunehmen (Option "Normal") oder auch alle Arten protokollieren zu lassen (Option "Erweitert"). Alle Arten bedeutet in diesem Zusammenhang, dass neben Fehlern auch normale Ereignisse und Warnungen mit in das Log aufgenommen werden.

Die Log-Dateien Deiner Shopware-Installation kannst Du Im Verzeichnis /var/log finden. Für dieses Plugin werden die Log-Einträge in der Datei abgelegt, die mit "plugin_production-" beginnt. Jeden Tag wird eine neue Logdatei angelegt.

Anzeige im Frontend

Wenn Du PayPal aktiviert hast, werden Deine Kunden u.A. folgende Zahlungsart im Bestellprozess vorfinden:

Die Seite zum Bestellabschluss bleibt wie von Dir in Shopware gewohnt. Jedoch wird der Kunde nach seinem Klick zu PayPal weitergeleitet. Hier kann der Kunde sich anschließend mit seinem PayPal-Konto anmelden.

Nachdem der Kunde sich angemeldet und die Bestellung seitens PayPal ebenfalls bestätigt hat, ist die Bestellung abgeschlossen. Der Kunde sieht dann folgende Seite:

Hier kann der Kunde die Transaktionsnummer (1) seiner Bestellung finden, über die PayPal seine Bestellung identifizieren kann. Entsprechend erscheint die Bestellung mit dieser Nummer und dem Zahlungsstatus "Komplett bezahlt" (1) in der Bestellübersicht im Backend Deines Shops:

Anzeige im Backend

Hier gibt es einen Button, welcher zu PayPal weiterleitet wo man dann die Tracking-ID eintragen kann.

  

PayPal Versandtracking

Mit der PayPal Version 6.0.0 ist es möglich, die Versandtracking-ID des Versanddienstleister an Paypal zu übertragen. Der Kunde kann dann über seinen PayPal Account den Versand seiner Bestellung verfolgen. 
Nach erfolgreichem Onboarding findest Du in Deinen Versandmethoden unter Freitextfelder die Möglichkeit, einen Standard Versanddienstleister zu hinterlegen. 

Eine vollständige Liste der möglichen Versanddienstleister findest Du hier. 
Wenn Du jetzt in den Details der Bestellung eine Tracking ID des Versanddienstleisters hinterlegst, wird diese automatisch in den PayPal Account des Kunden übertragen. Dort kann dieser dann den Versand der Bestellung überwachen. 
 

Bestellübersicht

Das PayPal Plugin bietet neben einer Anzeige im Standard-Bestellmodul auch eine eigene Übersicht für die Bestellungen, die über das Plugin verarbeitet wurden. Du findest diese Bestellübersicht unter Kunden > Zahlungen > PayPal > Bestellungen. Du kannst hier einsehen, welche Bestellungen mit welchem PayPal-Typ getätigt wurden (Standard, Express Checkout, Plus, Ratenzahlung).

In der rechten Hälfte des Fensters werden die Daten angezeigt, die PayPal zur jeweiligen Transaktion vorliegen. Sie sind strukturiert in die Bereiche Bestellung, PayPal Transaktion und Zahlungsverlauf. 

Rückerstattung

Wenn Du eine Rückerstattung über PayPal durchführen musst, kannst Du dies im Tab Zahlungsverlauf (1) mittels der Schaltfläche Eine neue Rückerstattung durchführen (2) erledigen.

Sobald eine Rückerstattung durchgeführt wurde, ändert sich auch der Zahlungsstatus der Bestellung im Bestell-Modul im Backend.
Die Änderung des Zahlungsstatus der Bestellung ändert sich bei einer Rückerstattung wie folgt:

1. Wenn der komplette Betrag erstattet wird, wird der Zahlungsstatus automatisch auf "Wiedergutschrift" geändert.

2. Wenn nur ein Teil des Betrages erstattet wird, wird der Zahlungsstatus automatisch auf "Teilweise bezahlt" gesetzt.

 

Express Checkout

Das Plugin bietet auch die Möglichkeit des Express-Checkouts. Hierüber muss sich Dein Kunde für seine Bestellung nicht im Shop registrieren und vor allem keine Adresse eingeben, die Bestellung wird somit allein anhand seines PayPal-Kontos abgewickelt. 

Die Express-Funktion gilt nicht für ESD-Produkte. Diese können nur mit einem Kundenkonto gekauft werden.

Konfiguration

Die Konfiguration des Express-Checkouts ist in dem eigenen Tab PayPal Express Checkout Integration in den Einstellungen des Plugins zu finden. Im Folgenden siehst Du die einzelnen Konfigurationsmöglichkeiten:
 

'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/Modal-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.

Buttongröße (8): Über diese Option kannst Du bestimmen, wie groß der PayPal Express Button dargestellt werden soll. Es stehen die Auswahlmöglichkeiten Klein, Mittel, Groß und Responsiv zur Wahl.

Warenkorb übertragen (9): 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.

Anzeige im Frontend

Der Ablauf des Bestellvorgangs über PayPal Express ähnelt dem klassischen PayPal-Bestellvorgang. Der Unterschied besteht darin, dass Dein Kunde für die Bestellung kein Kundenkonto in Deinem Shop anlegen muss. Stattdessen kann er sich über einen Button direkt bei PayPal anmelden und die Bestellung so abschließen. Dieser PayPal Express Button kann sich je nach Konfiguration im Warenkorb auf der Anmeldungs- und auf der Artikeldetailseite befinden.

Der Express-Button im Offcanvas-Warenkorb sieht so aus:

Wenn Dein Kunde seinen Warenkorb bearbeitet, sieht die Ansicht so aus:

Wenn sich Dein Kunde in seinem Bestellvorgang anmelden möchte, kann auch ein Express-Button genutzt werden:

Schlussendlich kann der Artikel selbst über einen Express-Button auf seiner Detailseite direkt per PayPal bestellt werden:

PayPal Plus

Das Plugin PayPal schließt eine direkte Integration von PayPal Plus ein: So kannst Du Deinen Kunden die vier beliebtesten Bezahlmethoden deutscher Konsumenten aus einer Hand bieten. Neben dem klassischen PayPal können Deine Kunden auf diese Weise zwischen SEPA-Lastschrift, Kreditkarte und Kauf auf Rechnung wählen.

Bitte beachte, dass PayPal Plus nicht mehr für neue Freischaltungen zur Verfügung steht und der Rechnungskauf hierüber aus PSD2-rechtlichen Gründen abgeschaltet wurde. Mit dem Nachfolger PayPal Checkout ist dies natürlich möglich.

Voraussetzungen

Das Produkt „PayPal Plus“ muss für jeden Händler individuell freigeschaltet werden. Sofern noch nicht geschehen, beantrage die Freischaltung hier.
Bitte beachte, dass Du den Kauf per Rechnung ebenfalls separat freischalten lassen musst.
PayPal Plus ist aktuell nur für Händler in Deutschland verfügbar.

Konfiguration

Die Konfiguration von PayPal Plus kannst Du in den Plugin Einstellungen im Tab PayPal Plus Integration vornehmen. Folgende Konfigurationsoptionen stehen Dir zur Verfügung:

PayPal Plus aktivieren (1): Setze den Haken, um die PayPal Plus Integration für Deinen ausgewählten Shop zu aktivieren.

Zahlungsabschluss (2): Wie bereits bei den anderen beiden Integrationen kann hier entschieden werden, wann die Zahlung eingezogen - also komplett abgeschlossen - wird.

Zahlartauswahl neu gestalten (3): An dieser Option kannst Du festlegen, ob Du die Zahlartauswahl in Shopware- oder PayPal-typischer Gestaltung wünschst. Dies wird im Abschnitt Erscheinung der Zahlartauswahl detailliert erklärt.

Zeige andere Zahlungsarten im iFrame (4): Aktivierst Du diese Option, werden in der Payment Wall iFrame Drittanbieterzahlungsarten angezeigt. Wähle die Zahlungsarten, die Du dort anzeigen möchtest, unter Einstellungen > Zahlungsarten > Freitextfelder > Zeige im PayPal Plus iFrame aus.

Zahlungsart-Bezeichnung überschreiben (5): Hier kannst Du eine andere Zahlungsart-Bezeichnung für das Frontend hinterlegen, falls gewünscht.

Zahlungsart-Beschreibung ergänzen (6): Hier kann die Zahlungsart-Beschreibung im Frontend ergänzt werden. Die Beschreibung wird in der Zahlungsartauswahl z.B. im Account unter der Zahlungsart-Bezeichnung ausgegeben.

Anzeige im Frontend

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.

Sofern der Kunde bereits PayPal als aktive Zahlart gesetzt hat, wird der iFrame auch auf der Bestätigungsseite des Checkouts angezeigt.

Erscheinung der Zahlartauswahl

Wie im Abschnitt Konfiguration bereits erwähnt, kann das Aussehen der PayPal Plus Zahlartauswahl im PayPal Plugin angepasst werden. Genauer gesagt ist es möglich, das Styling des iFrames der PayPal Plus Zahlungsarten auf die komplette Zahlartauswahl zu übertragen. Bei Aktivierung der Einstellung Zahlartauswahl neu gestalten (3) wird die Zahlartauswahl also wie folgt dargestellt:

Wenn diese Option aktiv ist, wird zudem eine weitere Konfigurationsmöglichkeit eingeblendet: Zeige andere Zahlungsarten im iFrame (4).
Wenn Du Dich für diese Option entscheidest, können sich die in Shopware vorhandenen Standardzahlungsarten und auch Drittanbieter-Zahlungsarten innerhalb des iFrames der PayPal Plus Zahlungsarten befinden, wenn dies entsprechend eingerichtet wird. Hierzu muss in den gewünschten Zahlungsarten unter Einstellungen > Zahlungsarten im Tab Freitextfelder ein Häkchen in dem Feld Zeige im PayPal Plus iFrame gesetzt werden:

Im Frontend sieht es dann wie folgt aus:

Es gibt Zahlungsarten welche direkt in der Zahlartauswahl weitere Felder benötigen (z.B. die Angaben der Daten bei SEPA-Lastschrift). In diesem Fall ist diese Zahlungsart nicht mit der Einstellung Zeige andere Zahlungsarten im iFrame kompatibel. Wird eine solche Zahlungsart in den iFrame integriert, werden dessen Zusatzfelder nicht eingeblendet und Zahlungen sind damit nicht mehr möglich.

Anpassung der Dokumentenvorlage

Bietest Du in Deinem Shop PayPal Plus an, wird nicht der Standard Footer genutzt, sondern der PayPal_Unified_Instructions_Footer, welcher zunächst angepasst werden muss. 
 

Anpassen kannst Du dies unter Grundeinstellungen > Shopeinstellungen > PDF-Belegerstellung. Wähle hier das Dokument Rechnung aus und öffne auf der rechten Seite im Bereich Elemente über das Dropdown Menü das Element PayPal_Unified_Instructions_Footer. 
Anschließend öffnet sich ein Editor, in welchem Du den Inhalt des Footers anpassen kannst. 

Die PayPal Bankdaten werden automatisch über das Element PayPal_Unified_Instructions_Content hinzugefügt. Somit ist hierfür keine Anpassung durch Dich notwendig. Deine Kunden bekommen automatisch nach Abschluss der Bestellung sowie bei Zusendung der Rechnung die richtigen PayPal Bankdaten angezeigt.

Später Bezahlen

In dem Tab Später Bezahlen kannst Du das Banner für die Ratenzahlung aktivieren. Sobald das Banner aktiviert ist, wird die Option Später Bezahlen via PayPal beworben. Dies funktioniert ausschließlich mit Deiner Live Client-ID (nicht mit der Sandbox Client-ID). Der Banner wird in Deinem Shop dann unterhlab des PayPal und des PayPal Express Buttons angezeigt.
 

In der Später Bezahlen Konfiguration kannst Du bestimmen, an welchen Stellen Deines Shops Infos zum Später Bezahlen angeboten werden sollen. 
Ratenrahlung Banner (1): Dieses Banner wird im Standard Responsive Theme am linken Bildrand angezeigt. 
Zeige Später bezahlen am PayPal Button (2): Wenn Du diese Checkbox aktivierst, wird der Später Bezahlen Button unterhalb des PayPal Button im Checkout. 
Zeige Später bezahlen unter Express Button (3): Wenn Du diese Checkbox aktivierst, wird der Später Bezahlen Button unterhalb des PayPal Express Button, beispielsweise auf der Produktdetailseite angezeigt.
 

Anzeige im Frontend

Es ist erforderlich, dass die Cookies der Kategorie "Technisch erforderlich" akzeptiert werden, damit der PayPal Später Bezahlen Banner angezeigt wird. Wurden die Cookies in der Vergangenheit akzeptiert und erst später Später Bezahlen aktiviert, so müssen die Cookies erneut akzeptiert werden, damit die Cookies für PayPal Ratenzahlung ebenfalls gesetzt werden.

Die Anzeige des Banners im Frontend, welches angeklickt werden kann:
 

Damit Deine Kunden die 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 zu der PayPal Ratenzahlung findest Du bei PayPal.
 

Nach dem Klick auf das Banner wird der Kunde aufgefordert sich in Paypal anzumelden. Ihm wird dann  die Berechnung der Raten angezeigt:
 

Damit Deine Kunden die 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 zu der PayPal Ratenzahlung findest Du bei PayPal.
 

PayPal Pay Upon Invoice Integration (Kauf auf Rechnung)

Bitte beachte, dass Dein PayPal-Konto hierfür zugelassen sein muss, damit diese Zahlungsmethode für Deine Kunden verfügbar ist. Du kannst Dein Konto im PayPal-Einstellungsmodul autorisieren.

Mit dieser Funktion kannst Du den Rechnungskauf für Deinen Shop aktivieren. 

Bitte prüfe unter Einstellungen > Zahlungsarten, dass die Zahlungsart für den PayPal Rechnungskauf mit dem Namen SwagPaymentPayPalUnifiedPayUponInvoice aktiv ist, wenn Du Rechnungskauf anbieten möchtest. Desweiteren ist es notwendig unter Einstellungen > Versandkosten > Zahlart Auswahl den Rechnungskauf als Ausgewählt bei allen Versandarten zu ergänzen, bei denen der Shopkunde per PayPal Rechnungskauf bezahlen kann.

PayPal Advanced Credit Debit Card Integration (Kredit- und Debitkarte)

Bitte beachte, dass Dein PayPal-Konto hierfür zugelassen sein muss, damit diese Zahlungsmethode für Deine Kunden verfügbar ist. Du kannst Dein Konto im PayPal-Einstellungsmodul autorisieren.

In diesem Reiter kannst Du die Kreditkarten-/ Debitkartenzahlung aktivieren.

Ansicht im Frontend

Tipps und Tricks

"Direkt zu PayPal" Button für bestimmte Artikel ausblenden

Wenn Du den PayPal Express Button für bestimmte Artikel ausblenden möchtest, kannst Du dies über eine individuelle Lösung erreichen. Wir zeigen Dir hier einen möglichen Lösungsweg auf, den Du in Deinem Shop umsetzen kannst.

Dieser Lösungsweg funktioniert aktuell bis einschließlich Version 2.6.5 der PayPal Erweiterung.

Sowohl das Bare Theme als auch das Responsive Theme sind Standard Templates, die nie geändert werden sollten, da Änderungen bei einem Update überschrieben werden. Daher muss immer korrekt in Deinem eigenen Theme abgeleitet werden.

Lege Dir vor der Durchführung ein Backup an, sodass Du dieses im Zweifel zurückspielen kannst. Beachte, dass es sich hier um Anpassungen von Shopware handelt und der Inhalt dieses Tutorials daher nicht offiziell supportet wird!

1. Im ersten Schritt solltest Du Dir ein neues Theme anlegen und zuweisen, welches vom aktuell genutzten Theme im Theme Manager erbt.
In diesem Beispiel leiten wir das Theme direkt vom Responsive Theme ab und nennen es "overwritepaypal".

2. Anschließend erstellst Du ein neues Artikel-Freitextfeld mit dem Spaltentyp Checkbox.
Hier haben wir das Artikel-Freitextfeld "disablepaypal" genannt.
 

3. Nun editierst Du in Deinem zuvor erstellten Theme die theme.php (hier unter /themes/frontend/overwritepaypal) und schreibst folgendes hinein:

protected $injectBeforePlugins = false;

Das sollte in etwa so aussehen:

class Theme extends \Shopware\Components\Theme 
{ 
... 

protected $injectBeforePlugins = false; 

... 
   } 
}

4. Anschließend legst Du die Datei buy.tpl im Verzeichnis /frontend/detail Deines zuvor erstellten Themes (in unserem Beispiel unter /themes/frontend/overwritepaypal/frontend/detail/buy.tpl) mit folgendem Inhalt an: 

{extends file="parent:frontend/detail/buy.tpl"} 

    {block name='frontend_detail_buy_button_paypal_unified_installments'} 
        {if !($sArticle.sConfigurator && !$activeConfiguratorSelection) && $paypalUnifiedEcDetailActive && !$sArticle.disablepaypal} 
            {include file='frontend/paypal_unified/express_checkout/button_detail.tpl'} 
        {/if} 
    {/block}

Anschließend musst Du den Cache im Cache Modul leeren. Der PayPal Button wird nun bei allen Artikeln bzw. Varianten mit dem Attribut "disablepaypal" ausgeblendet.

Damit der PayPal Express Button auch im Offcanvas-Warenkorb ausgeblendet wird, musst Du noch weitere Anpassungen in Deinem Theme vornehmen.

Hierfür muss die Datei ajax_cart.tpl im Verzeichnis /frontend/checkout Deines zuvor erstellten Themes mit folgendem Inhalt erstellt werden:

{extends file="parent:frontend/checkout/ajax_cart.tpl"} 

    {block name='frontend_checkout_ajax_cart_button_container_inner_paypal_unified_ec_button'} 
       {foreach $sBasket.content as $item} 
          {if $item.additional_details.disablepaypal} 
              {assign var="disablepaypal" value="1"} 
          {/if} 
    {/foreach} 
    {if $paypalUnifiedEcOffCanvasActive && $paypalUnifiedUseInContext !== null && !$disablepaypal} 
           {include file='frontend/paypal_unified/express_checkout/button_cart.tpl' paypalEcAjaxCart = true} 
    {/if} 
{/block}

Um den Button grundsätzlich im Warenkorb auszublenden, muss die Datei cart.tpl im gleichen Verzeichnis Deines Themes erstellt werden. Diese füllst Du mit folgendem Inhalt:

{extends file="parent:frontend/checkout/cart.tpl"}
 
    {block name='frontend_checkout_cart_table_actions_paypal_unified_ec_button'} 
       {foreach $sBasket.content as $item} 
          {if $item.additional_details.disablepaypal} 
             {assign var="disablepaypal" value="1"} 
          {/if} 
       {/foreach} 
    {if $paypalUnifiedEcOffCanvasActive && $paypalUnifiedUseInContext !== null && !$disablepaypal} 
        {include file='frontend/paypal_unified/express_checkout/button_cart.tpl' paypalEcAjaxCart = true} 
    {/if} 
{/block}

Nach der Durchführung der Änderungen musst Du erneut den Cache im Cache Modul leeren.

Zusätzliche Beschreibung ab der Version 2.8.1

Unter Einstellungen > Zahlungsarten lassen sich die in Shopware verwendeten Zahlungsarten hinzufügen, bearbeiten, aktivieren oder deaktivieren. Weitere Information zu dieser Option findest Du hier. 

Für PayPal ist hierfür im Reiter Generell eine zusätzliche Beschreibung für das Frontend hinterlegt, welche JavaScript mit einer Verlinkung enthält.

In der Version 2.8.1 haben wir den Text in der zusätzlichen Beschreibung für die PayPal Zahlungsart geändert, weil sich ursprünglich ein JavaScript (zur Weiterleitung nach PayPal) darin befunden hat. Da dieser Beschreibungstext standardmäßig auch in die Bestellbestätigungsmail eingefügt werden würde, konnte dies dazu führen, dass die Bestätigungsmail von manchen Mailprovidern als Spam oder als Unsicher markiert wurde und somit nicht beim Endkunden ankam.

Dieser JavaScript Teil wurde in der Version 2.8.1 nun ersetzt. Damit eventuelle eigene Texte aber nicht überschrieben werden, bleibt der Text beim Update des Plugins bestehen. Nur wenn Du das Plugin komplett neu installierst, wird der neue Text übernommen. 

Wenn Du das Plugin nicht neu installierst und einfach das Update ausführst, kannst Du die Zusätzliche Beschreibung auch manuell anpassen. Füge dazu folgenden Text in die zusätzliche Beschreibung ein:
 

<!-- PayPal Logo --><a onclick="window.open(this.href, 'olcwhatispaypal','toolbar=no, location=no, directories=no, status=no, menubar=no, scrollbars=yes, resizable=yes, width=400, height=500'); return false;" href="https://www.paypal.com/de/cgi-bin/webscr?cmd=xpt/cps/popup/OLCWhatIsPayPal-outside" target="_blank"><img src="
{link file='frontend/_public/src/img/sidebar-paypal-generic.png' fullPath}
" alt="Logo 'PayPal empfohlen'"></a><br><!-- PayPal Logo -->Bezahlung per PayPal - einfach, schnell und sicher.

Rechnungsdaten auslesen

Wenn über PayPal ein Rechnungskauf erfolgt, werden die dazugehörigen Rechnungsdaten in der Tabelle swag_payment_paypal_unified_payment_instruction gespeichert.
Um diese Informationen leichter auslesen zu können, werden sie auch im Backend ausgegeben. Du findest Sie unter Kunden > Bestellungen in den jeweiligen Bestelldetails. Dort wird er im Tab Kommunikation im Feld Interne Kommunikation abgelegt. 

Der JSON String sieht in etwa so aus:

{"jsonDescription":"Pay Upon Invoice Payment Instructions","orderNumber":"20030","bankName":"Deutsche Bank","accountHolder":"PayPal Europe","iban":"DE12345678901234567890","bic":"DEUTABCDEFG","amount":"26.97","dueDate":"2021-02-19","reference":"8L723597GH9483894"}