PayPal

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.

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.

Hinweis zur Datenübertragung an Shopware
Die PayPal-Erweiterung übermittelt einmal täglich die aggregierte Gesamtsumme aller PayPal-Bestellungen deines Shops an Shopware.
Es werden keine personenbezogenen Daten, keine Bestellnummern und keine Einzeltransaktionen übertragen.

Konfiguration Onboarding

Die Konfiguration für PayPal Checkout findest Du unter Einstellungen > Handel > Zahlungsarten.

• Sandbox aktivieren (1): 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.

• PayPal-Konto verbinden (2): Zur vollständigen Einrichtung von PayPal Checkout muss über diese Schaltfläche ein Onboarding durchgeführt werden. Ein Onboarding ist erforderlich, um:
  1. die Verknüpfung zum PayPal-Account des Händlers herzustellen (Händler-ID wird abgerufen),
  2. die Zugangsdaten (Client-ID & Secret) automatisch zu generieren [technischer Hintergrund: Für die API-Calls zu PayPal wird eine REST-App angelegt],
  3. Für Zahlarten wie erweiterte Kreditkarte oder Kauf auf Rechnung, die eine Freigabe benötigen, erfolgt eine automatische Sicherheitsüberprüfung.

• PayPal Sandbox-Konto verbinden / Anderes Sandbox-Konto verbinden (3): Mit dieser Schaltfläche kann das Onboarding für die Einrichtung der PayPal Sandboxdaten über die PayPal Seite durchgeführt werden. Die PayPal API-Sandboxzugangsdaten werden ebenfalls automatisch konfiguriert.

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

• Status der Zahlart (5): Der Status der Zahlungsart gibt Auskunft darüber, ob die Zahlungsart aktuell in deinem Shop verwendet werden kann oder nicht. Im Onboarding-Prozess sind folgende Status möglich: Onboarding benötigt, Autorisiert, Limitiert und Gesperrt.

• Details bearbeiten (6): Mit dieser Schaltfläche kann die Zahlungsart wie alle anderen Zahlungsarten bearbeitet werden und zum Beispiel mit einer Beschreibung oder einer Verfügbarkeitsregel konfiguriert werden.

• Zahlart aktivieren / deaktivieren (7): Über diese Schaltfläche kannst du die jeweilige Zahlungsart für deinen Shop aktivieren oder deaktivieren.

• Darstellungsreihenfolge im Bestellprozess ändern (8): Nach dem Klick auf diese Schaltfläche kannst du die Reihenfolge der verschiedenen Zahlungsarten für den Checkout in deiner Storefront per Drag&Drop festlegen.

• Einstellungen (9): Hierüber gelangst du zu den Einstellungen von PayPal Checkout. Näheres hierzu wird im Abschnitt Allgemeine Konfiguration erläutert.

PayPal Versandtracking

Seit 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 > Versand einen Standard Versanddienstleister bei der gewünschten Versandart 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.

Allgemeine Konfiguration

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

Alternativ zum Onboarding kannst du, sofern vorhanden, auch deine PayPal API-Zugangsdaten direkt eingeben. Diese Funktion findest du in den PayPal Einstellungen unter Einstellungen > Erweiterungen > PayPal.

• Live-API-Zugangsdaten (1): Über diesen Schalter aktivierst du die Nutzung der PayPal-Zugangsdaten für den Live-Betrieb.

• Client-ID (2): Hier trägst du die PayPal Client-ID der REST-API 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.

• Testen (5): Mithilfe dieser Schaltfläche kannst du die von dir eingetragenen Zugangsdaten testen. Das Ergebnis des Tests wird dir direkt in der Schaltfläche selbst und in der oberen rechten Ecke des Admins angezeigt.

• Sandbox-API-Zugangsdaten (6): Hier aktivierst du PayPal-Sandbox, um die Integration zu testen.

• Sandbox-Client-ID (7): 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 (8): An dieser Stelle trägst du die 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 (9): An dieser Stelle trägst du deine Sandbox-PayPal Händler-ID ein, um die neuen PayPal Checkout Funktion zu authentifizieren.

• Testen (10): Mithilfe dieser Schaltfläche kannst du die von dir eingetragenen Sandbox-Zugangsdaten testen. Das Ergebnis des Tests wird dir direkt in der Schaltfläche selbst und in der oberen rechten Ecke des Admins 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 Checkout gelten.

 

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

• Warenkorb übertragen (2): 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 (3): Du hast hier die Möglichkeit, einen eigenen Markennamen für die Anzeige auf der PayPal-Zahlungsseite zu definieren.

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

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

• Bestellnummer-Präfix (6): 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 (7): Hier kannst du bestimmen, welcher an die Bestellnummer angehängt wird, SW20001meinShop.

• Ausgeschlossene Produkte(8): Hier kannst du auswählen, welche Produkte nicht mit PayPal gekauft werden können.

• Ausgeschlossene dynamische Produktgruppen (9): Hier kannst du eine dynamische Produktgruppe hinterlegen. Diese Produktgruppen können nicht mit PayPal gekauft werden.

Vaulting (regelmäßige Zahlungen)

Das Vaulting steht dir ab der PayPal Version 8.0.0 und kann ab der Shopware Version 6.5 verwendet werden. 

Damit deine Kunden regelmäßig wiederkehrende Zahlungen, z. B. bei einem Abonnement, verwenden kann, muss das Vaulting für PayPal aktiviert werden.

Um das Vaulting für deinen Shop zu aktivieren, klicke auf die Schaltfläche Vaulting freischalten (1).

Du gelangst nun zum Login zu deinem PayPal-Händlerkonto.

 Dort meldest du dich mit deinen Zugangsdaten an und die Freischaltung wird durchgeführt.

Wenn du nun zurück in den Shop wechselst, sind die Schalter zum Aktivieren der Funktion erkennbar.

Mit dem Schalter Vaulting für PayPal-Zahlungen aktivieren (1) schaltest du die Funktion generell ein.

Über den Schalter Vaulting für Kredit- und Debitkarten-Zahlungen verwenden (2) kannst zu zusätzlich freischalten, ob deine Kunden über PayPal ihre Kredit- oder Debitkarte belasten können. Dies setzt jedoch voraus, dass du Zahlungen über Kredit- oder Debitkarten aktiviert hast. 

Der letzte Schalter kann aktiviert werden, um das Vaulting für Venmo-Zahlungen zu verwenden (3).

Kredit- oder Debitkarte

Das PayPal Checkout Plugin ermöglicht zwei verschiedene Formen von Kredit- und Debit-Karten-Zahlungen. Sofern die Freischaltung beim Onboarding für erweiterte Kredit- und Debit-Karten-Zahlungen erfolgreich ist (dies geschieht in Abhängigkeit des Landes sowie des Händler-Accounts), steht die Zahlungsart "unbranded" -- d.h. ohne Verweis auf PayPal als Zahlungsanbieter -- zur Verfügung. Kann keine Freigabe erteilt werden, wird die Zahlungsart als "branded" bereitgestellt, d.h. das Formular zur Eingabe der Karteninformationen beinhaltet einen Verweis auf PayPal als Anbieter.

PayPal prüft anhand der Kredit- oder Debitkarte, ob eine starke Kundenauthentifizierung per 3D-Secure erforderlich ist. Wenn die Option Zahlungen aus Nicht-3DS-Ländern blockieren aktiviert wird, kann die entsprechende Karte nicht zur Zahlung verwendet werden, wenn ein 3DS Check nicht möglich ist.  
3D-Secure ist ein Verfahren, welches die Sicherheit bei Kreditkartenzahlungen erhöht. 

Rechnungskauf

Mit dem Rechnungskauf können 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. Für PayPal Rechnungskauf wird das Onboarding unter Einstellungen > Handel > Zahlungsarten benötigt. 

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.

Storefront-Darstellung

Wenn du unter Einstellungen > Kunde > Anmeldung & Registrierung die Option Double-Opt-In bei Gast-Bestellungen aktiviert hast, werden in der Storefront keine Payment Buttons angezeigt.

PayPal Express Checkout Shortcut

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 Listingseiten (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, Weiß und Schwarz angeboten.

• Buttonform (7): Hier legst du die Form des PayPal-Express Buttons fest. Es kann zwischen Rund, Rechteckig mit spitzen Ecken und Rechteckig mit abgerundeten Ecken gewählt werden.

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

• 'Später Bezahlen' neben dem 'PayPal Checkout'-Button anzeigen (9): Hier kannst du definieren, ob die 'Später Bezahlen' Schaltfläche mit gleichem Design neben den 'Direkt zu PayPal' Buttons angezeigt werden soll.

Wenn die Telefonnummer im Checkout-Prozess als Pflichtfeld definiert ist, kann es bei der Nutzung von PayPal Express Checkout zu Problemen kommen. Standardmäßig übermittelt PayPal keine Telefonnummer. Dadurch kann der Checkout fehlschlagen.
Du kannst die Übermittlung der Telefonnummer jedoch in deinen Kontoeinstellungen aktivieren. Melde dich hierzu in PayPal unter diesem Link an und aktiviere die Option "On (required field)" im Bereich "Contact telephone number".

'Später Bezahlen'-Banner

Die PayPal-Erweiterung bietet dir die Möglichkeit, ein „Später Bezahlen“-Banner an verschiedenen Stellen in deinem Shop anzuzeigen. Das Banner kann die Konversionsrate erhöhen und stellt für dich als Händler kein finanzielles Risiko dar.

Das Banner wird bei Produkten angezeigt, die die Kriterien für die jeweilige PayPal-Zahlungsoption erfüllen. Damit deine Kunden die Zahlungsoption nutzen können, müssen sie im Checkout PayPal auswählen und sich mit ihrem PayPal-Konto anmelden.

Voraussetzungen

• 30 Tage später bezahlen: Diese Option steht ab einem Warenkorbwert von 1 Euro zur Verfügung. Der maximale Warenkorbwert beträgt 1.000 Euro.

• PayPal Ratenzahlung: Diese Option steht ab einem Warenkorbwert von 5 Euro zur Verfügung. Der maximale Warenkorbwert beträgt 5.000 Euro.

Weitere Informationen zur PayPal-Ratenzahlung findest du auf der PayPal-Website.

Konfiguration

Die Einstellungen für das „Später Bezahlen“-Banner findest du unter Einstellungen > Erweiterungen > PayPal.

Unter Darstellung kannst du das Erscheinungsbild des Banners an deinen Shop anpassen:

• Logo-Typ: Wähle den gewünschten PayPal-Logo-Typ aus.

• Textfarbe: Lege die Farbe des Bannertexts fest.

• Textgröße: Wähle die Größe des Bannertexts aus.

Auf der rechten Seite wird dir eine Vorschau des Banners mit den aktuell ausgewählten Einstellungen angezeigt.

Unter Seiten-Sichtbarkeit kannst du festlegen, auf welchen Seiten das Banner angezeigt wird. Aktiviere oder deaktiviere die Anzeige über den jeweiligen Schalter:

• Produktdetailseite: Zeigt das Banner auf den Detailseiten deiner Produkte an.
• Warenkorb: Zeigt das Banner auf der Warenkorbseite an.
• Off-Canvas-Warenkorb: Zeigt das Banner im Off-Canvas-Warenkorb an.
• Anmeldung: Zeigt das Banner auf der Anmeldeseite an.
• Footer: Zeigt das Banner im Footer deines Shops an.

Um das Banner an einer bestimmten Stelle anzuzeigen, aktiviere den entsprechenden Schalter. Wenn du das Banner an dieser Stelle nicht anzeigen möchtest, deaktiviere den Schalter.

Ansicht in der Storefront

Das Banner wird abhängig von den aktivierten Einstellungen an den ausgewählten Stellen in deinem Shop angezeigt.

Produktdetailseite:

Offcanvas-Warenkorb:

Warenkorb:

Footer:

Smart Payment Buttons

Konfiguration

• Smart Payment Buttons (1): Über den Schalter aktivierst bzw. deaktivierst du die Smart Payment Buttons.

• Aktiviert die alternativen Zahlungsarten der Smart Payment Buttons (2): Die alternativen Zahlungsarten sind Kredit- und Debitkarten und weitere.

• 'Später Bezahlen'-Button neben PayPal-Button anzeigen (3): Ist die Schaltfläche aktiviert, wird zusätzlich ein "PayPal Später Bezahlen" Button eingeblendet, welcher den Kunden direkt auf die PayPal-Option führt, den Betrag nach 30 Tagen zu bezahlen.  

• Buttonfarbe (4): Diese Option bietet dir einige Farben an, in denen der PayPal-Express Button ausgegeben werden kann. Es werden Gold, Blau, Silber, Weiß und Schwarz angeboten.

• Buttonform (5): Hier legst du die Form des PayPal-Express Buttons fest. Es kann zwischen Rund, Rechteckig mit spitzen Ecken und Rechteckig mit abgerundeten Ecken gewählt werden.

• Buttonsprache (6): 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 des normalen Checkout Button angezeigt:

PayPal Agentic Commerce

Mit dem Verkaufskanal PayPal Agentic Commerce kannst du deine Produkte für die Shopping-Assistenten von PayPal verfügbar machen. Deine Kunden können Produkte durchsuchen, ihren Warenkorb verwalten und Einkäufe über unterstützte KI-Plattformen abschließen. Der Verkaufskanal verbindet deinen Shopware-Produktkatalog und den Checkout mit den Agentic-Commerce-Diensten von PayPal. Bestellungen, die über einen KI-Shopping-Assistenten aufgegeben werden, werden in Shopware wie reguläre Bestellungen verarbeitet.

Voraussetzungen

Die PayPal-Erweiterung muss installiert und konfiguriert sein. Außerdem benötigst du ein für die Teilnahme berechtigtes PayPal-Geschäftskonto. Für die Nutzung musst du den Zugang bei PayPal beantragen und den Onboarding-Prozess abschließen.

PayPal Store Sync unterstützt derzeit ausschließlich physische Produkte, die an Kunden in den USA verkauft und in US-Dollar bezahlt werden. Digitale Produkte, Abonnements und Verkäufe an Kunden außerhalb der USA werden aktuell nicht unterstützt. Weitere Informationen findest du in den Anforderungen für PayPal Store Sync.

Es können nur Produkte verkauft werden, die in einem Storefront-Verkaufskanal verfügbar sind.

Verkaufskanal anlegen

Öffne den Dialog Verkaufskanal anlegen und klicke beim Typ PayPal Agentic Commerce auf Verkaufskanal anlegen.

Grundeinstellungen und Verkaufskanal

In den Grundeinstellungen vergibst du einen Namen für deinen Verkaufskanal. Über Verkaufskanal als Favorit markieren kannst du ihn optional als Favorit kennzeichnen.

Im Bereich Verkaufskanal nimmst du die Zuordnung zu deinem Storefront-Verkaufskanal vor:

• Verkaufskanal: Wähle den Storefront-Verkaufskanal aus, dessen Produkte du für PayPal Agentic Commerce verfügbar machen möchtest.
• Domain: Wähle die zugehörige Domain aus.

• Währung: Wähle US-Dollar aus, da PayPal Store Sync derzeit nur Zahlungen in dieser Währung unterstützt.

Außerdem werden in diesem Bereich die Sprache und die Kundengruppe angezeigt.

Produktexport und Status

Im Bereich Produktexport legst du fest, welche Produkte exportiert werden und wie der Export generiert wird.

• Varianten als eigene Produkte exportieren: Aktiviere diese Option, wenn Produktvarianten als separate Produkte exportiert werden sollen.
• Generierungsintervall: Wähle das Generierungsintervall (z. B. „Live“), um festzulegen, wie aktuell der Feed ist.
• Per Scheduler generieren: Aktiviere diese Option, um den Export automatisch zeitgesteuert durch das System erstellen zu lassen. Ist die Option deaktiviert, wird der Feed erst beim Aufruf der Feed-URL generiert, was beim ersten Aufruf nach Ablauf des Intervalls zu längeren Ladezeiten führen kann.
• Dynamische Produktgruppe: Wähle die dynamische Produktgruppe aus, deren Produkte du exportieren möchtest. Beachte dabei, dass nur Produkte verkauft werden können, die in einem Storefront-Verkaufskanal verfügbar sind.

Unter Zeitpunkt der letzten Generierung wird angezeigt, wann der Export zuletzt generiert wurde. Wenn noch kein Export erstellt wurde, erscheint ein entsprechender Hinweis.

Im Bereich Status aktivierst oder deaktivierst du die PayPal Agentic Commerce Integration für diesen Verkaufskanal über den Schalter Aktiv.

Klicke auf Speichern, um den Verkaufskanal anzulegen.

Produktexport nach dem Anlegen

Nach dem Anlegen wird im Bereich Produktexport zusätzlich der CLI-Befehl zur Erstellung des Produktexports angezeigt. Über das Kopiersymbol kannst du den angezeigten Befehl kopieren und zur Generierung des Exports über die Kommandozeile verwenden.

Webhook und Verkaufskanal löschen

Im Bereich Webhook wird der Status des Webhooks angezeigt. Die Registrierung erfolgt in den PayPal-Einstellungen. Der Webhook übermittelt die Daten, die für die Aktivierung und Nutzung des Verkaufskanals benötigt werden.

Über Verkaufskanal löschen kannst du den Verkaufskanal dauerhaft entfernen.

Achtung: Das Löschen des Verkaufskanals kann nicht rückgängig gemacht werden.

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 eigentliche 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.

Fortgeschritten

Webhook

Der Webhook ermöglicht die Kommunikation zwischen Shopware und PayPal. Ohne die Einrichtung dieses Webhooks ist ein Austausch von Bestellungen und relevanten Informationen nicht möglich. Mit der Schaltfläche Webhook aktualisieren kannst du den Webhook neu registrieren. 

Später bezahlen - Länderübergreifende Nachrichten 

Die "Später bezahlen - Länderübergreifende Nachrichten"-Funktion von PayPal ermöglicht es Kunden, Einkäufe sofort zu tätigen und später zu bezahlen, während sie gleichzeitig sicherstellen, dass alle Benachrichtigungen und Kommunikationsprozesse international und benutzerfreundlich gehandhabt werden. Dies erleichtert länderübergreifende Transaktionen und stellt sicher, dass Kunden in verschiedenen Ländern über ihre Zahlungen informiert und erinnert werden.

Um diese Funktion nutzen zu können, wende dich bitte an deinen Paypal-Ansprechpartner, da für die Funktion dein Händlerkonto freigeschaltet werden muss.

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-Konfliktfälle samt der wichtigsten Informationen – darunter die Fall-ID (mit Link zu den Falldetails), das Datum der letzten Aktualisierung, die Fälligkeit der nächsten Antwort, den aktuellen Status und das Stadium des Falls sowie den betroffenen Betrag.

• PayPal Konflikt Center (2): Über den Link neben jedem Konfliktfall gelangst du direkt zum entsprechenden Fall im PayPal-Lösungscenter.

• Aktualisieren (3): Über diese Schaltfläche 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 einmal 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ösungscenter 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.

Update

Um ein Update für die Erweiterung durchzuführen, gehst du auf  Erweiterungen > Meine Erweiterungen. In der Liste suchst du die Paypal Erweiterung und kannst im nächsten Schritt auf den Button Aktualisierung klicken. Im Hintergrund läuft nun das Update durch und wird die Seite automatisch neu laden. 

Alternativ kannst du das Update auch über die CLI starten, dafür gibst du in der Konsole folgenden Befehl ein:

php bin/console plugin:update SwagPayPal

Troubleshooting

Wenn du ein Update direkt über SFT/FTP gemacht hast, kann es zu Problemen im Admin kommen. Shopware 6 könnte durch das Verschieben von Dateien nicht mehr korrekt funktionieren. Auch die Erweiterung lässt sich dann nicht mehr im Admin aktualisieren. Wenn das der Fall ist, helfen folgende Punkte, den Fehler wieder zu bereinigen. Diese Punkte musst du schrittweise durchgehen:

• OPCache zurücksetzen (ein Neustart von php-fpm oder des gesamten Servers)

• Den Shop-Cache leeren (php bin/console cache:clear ausführen oder den var/cache-Ordner löschen)

• Das Plugin aktualisieren (php bin/console plugin:update SwagPayPal oder über die Administration)