PayPal-Plugin installieren und konfigurieren
Mit der Komplettlösung PayPal Checkout können Sie Ihren Kunden anbieten, mit PayPal, „Später bezahlen“-Optionen oder Rechnungskauf (falls für Ihr Unternehmen verfügbar), Lastschrift sowie mit Debit- und Kreditkarten zu bezahlen. Zudem bietet PayPal Checkout viele weitere lokale Zahlarten für Ihre internationalen Verkäufe an.
PayPal Checkout installieren (ab JTL-Shop 5.1.2)
Ihre Aufgabe/Ausgangslage
Voraussetzungen/Einschränkungen
Installation im Shop-Backend vornehmen
Plugins werden in JTL-Shop 5 über den Extension Store bezogen. Hier werden die Installation bei einem neuen und bei einem bestehenden JTL-Shop beschrieben.
Plugin bei neuen Shops installieren
- Aktivieren Sie im Einrichtungsassistenten von JTL-Shop bei Schritt 4 im Abschnitt Wir empfehlen die Checkbox PayPal Checkout.
- Sie können das Plugin jetzt im Backend von JTL-Shop unter Plugins > Installierte Plugins > JTL PayPal Checkout konfigurieren.
Plugin bei bestehenden Shops installieren
- Buchen Sie das Plugin über den JTL-Extension Store. Lesen Sie mehr zum Thema hier: Erweiterungen im JTL-Extension Store buchen.
- Klicken Sie im Backend von JTL-Shop auf Plugins > Meine Käufe.
- Das PayPal-Plugin befindet sich in der Liste der ungebundenen Lizenzen. Klicken Sie auf die Schaltfläche An diesen Onlineshop binden.
- Das Plugin wandert dadurch in den Bereich Gebundene Lizenzen. Klicken Sie in der Spalte Status auf die Schaltfläche Installieren.
Das Plugin ist jetzt installiert. Sie können es unter Plugins > Installierte Plugins > JTL PayPal Checkout weiter konfigurieren.
Konfiguration durchführen (Vorgänger-Plugin bereits vorhanden)
Nachdem Sie das Plugin installiert haben, müssen Sie Ihr PayPal-Konto mit JTL-Shop verbinden. Anschließend können Sie alle nötigen Einstellungen vornehmen, um Optik, Anzeigeorte und verfügbare Zahlungsarten festzulegen. Wenn Sie bereits den Vorgänger von PayPal Checkout verwenden, müssen Sie einige Dinge bei der Konfiguration des neuen Plugins beachten, um einen reibungslosen Wechsel sicherzustellen.
Schritt 1: PayPal-Konto mit JTL-Shop verbinden
Über das Onboarding von PayPal können Sie JTL-Shop schnell und einfach mit Ihrem PayPal-Konto verbinden.
- Navigieren Sie im Backend von JTL-Shop zu Plugins > Installierte Plugins und klicken Sie auf JTL PayPal Checkout.
- Deaktivieren Sie den Testmodus für die Nutzung des produktiven Systems und klicken Sie auf die Schaltfläche JTL-Shop jetzt mit PayPal verbinden.
- Geben Sie im sich öffnenden Dialogfenster die E-Mail-Adresse Ihres Händlerkontos und das Land oder die Region ein. Falls Sie noch kein Konto besitzen, können Sie es an dieser Stelle anlegen.
- Geben Sie das Passwort Ihres Händlerkontos ein und klicken Sie auf die Schaltfläche Einloggen.
- Führen Sie die nötigen Authentifizierungen durch und erteilen Sie über die Schaltfläche Zustimmen und verbinden die Genehmigung, Konto und JTL-Shop miteinander zu verknüpfen.
Die Seite wird automatisch aktualisiert. Dies kann einen kurzen Moment dauern.
Sollte es zu Problemen beim Login kommen, haben Sie die Möglichkeit, die Verbindung manuell herzustellen, wenn Sie Ihre Zugangsdaten kennen. Wenn Sie die Zugangsdaten nicht finden können, wenden Sie sich bitte an den PayPal Händlersupport.
- Klicken Sie auf Zugangsdaten manuell hinterlegen.
- Geben Sie Merchant ID, Client ID und Client Secret ein.
- Speichern Sie die Eingabe.
Schritt 2: Deaktivieren der Zahlungsarten in PayPal Checkout
Damit Ihre Kunden im Onlineshop keine PayPal-Zahlungsarten mehrfach sehen, können Sie die Zahlungsarten und Banner des neuen Plugins deaktivieren.
- Navigieren Sie im Backend von JTL-Shop zu Plugins > Installierte Plugins > JTL PayPal Checkout > Einstellungen.
- Deaktivieren Sie in den Registerkarten Expresskauf und „Später bezahlen“-Banner jeweils die Zahlungsart und das Banner.
- Bestätigen Sie Ihre Angaben über die Schaltfläche Speichern.
Schritt 3: Einstellungen vornehmen
In der Registerkarte Einstellungen können Sie verfügbare Zahlungsarten und Banner konfigurieren sowie allgemeine und zahlungsartspezifische Einstellungen vornehmen. Eine detaillierte Beschreibung der einzelnen Funktionen und Einstellungsmöglichkeiten lesen Sie hier: Detailbeschreibung: JTL PayPal Checkout.
Apple Pay aktivieren
In diesem Bereich können Sie die Domain Ihres Shops registrieren, um Ihren Kunden Apple Pay als Zahlungsart zur Verfügung zu stellen. Die Vorgehensweise ändert sich in Abhängigkeit davon, ob Ihr Shop direkt über die Domain läuft, bspw. sportbedarf-sommer.de, oder ob Ihr Shop in einem Unterverzeichnis liegt, bspw. sportbedarf-sommer.de/shop. Nachfolgend lesen Sie die jeweiligen Vorgehensweisen:
Shop läuft direkt über Domain
- Klicken Sie auf den Link Zahlungsquelle einrichten oder navigieren Sie in Ihrem PayPal-Händlerkonto zu Kontoeinstellungen > Zahlungsquellen und klicken dort auf die Schaltfläche Apple Pay verwalten.
- Klicken Sie auf die Schaltfläche Domain hinzufügen. Das Dialogfenster Registrieren Ihrer Website bei Apple Pay öffnet sich.
- Tragen Sie im Feld 1. Fügen Sie Ihre Website hinzu die Domain Ihres Shops, bspw. sportbedarf-sommer.de, ein und klicken Sie auf die Schaltfläche Domain registrieren.
Ihre Domain ist jetzt registriert. Die Schritte 2 und 3 werden automatisch ausgeführt.
- Wechseln Sie zurück in das Backend von JTL-Shop und wählen Sie in dem Dropdown-Menü Wurde die Registrierung Ihrer Shop-Domain erfolgreich durchgeführt? die Option Ja aus und bestätigen Sie Ihre Angaben über die Schaltfläche Speichern. Apple Pay steht Ihren Kunden jetzt als Zahlungsart zur Verfügung.
Shop liegt im Unterverzeichnis
- Klicken Sie auf den Link Zahlungsquelle einrichten oder navigieren Sie in Ihrem PayPal-Händlerkonto zu Kontoeinstellungen > Zahlungsquellen und klicken dort auf die Schaltfläche Apple Pay verwalten.
- Klicken Sie auf die Schaltfläche Domain hinzufügen. Das Dialogfenster Registrieren Ihrer Website bei Apple Pay öffnet sich.
- Tragen Sie im Feld 1. Fügen Sie Ihre Website hinzu die Domain Ihres Shops, bspw. sportbedarf-sommer.de/shop, ein.
- Laden Sie anschließend die Domain-Zuordnungsdatei herunter.
- Hosten Sie die Domain-Zuordnungsdatei unter der angegebenen Adresse.
- Klicken Sie auf die Schaltfläche Domain registrieren. Ihre Domain ist jetzt registriert.
- Wechseln Sie zurück in das Backend von JTL-Shop und wählen Sie in dem Dropdown-Menü Wurde die Registrierung Ihrer Shop-Domain erfolgreich durchgeführt? die Option Ja aus und bestätigen Sie Ihre Angaben über die Schaltfläche Speichern. Apple Pay steht Ihren Kunden jetzt als Zahlungsart zur Verfügung.
Schritt 4: PayPal Zahlungsarten mit Versandarten verknüpfen
Nachdem Sie in Schritt 3 alle Einstellungen Ihren Anforderungen entsprechend vorgenommen haben, können Sie jetzt im Backend von JTL-Shop zu Ihren Versandarten die entsprechenden PayPal-Zahlungsarten hinzufügen.
- Klicken Sie im Backend von JTL-Shop auf Administration > Versand > Versandarten. Die Seite Versandarten öffnet sich.
- Öffnen Sie die Versandart über das Stift-Symbol für die Bearbeitung.
- Fügen Sie im Bereich Akzeptierte Zahlungsarten über die jeweiligen Checkboxen PayPal Checkout (PayPal) und/oder Rechnungskauf mit Ratepay (PayPal) zur Versandart hinzu.
- Geben Sie gegebenenfalls einen festen oder prozentualen Aufpreis oder Rabatt für diese Zahlungsart an.
- Bestätigen Sie Ihre Angaben über die Schaltfläche Speichern.
Schritt 5: Übermittlung von Versandinformationen einrichten
Sie können Ihren Kunden Informationen zum Versand von Bestellungen, die mit PayPal abgewickelt wurden, zugänglich machen. Diese Informationen umfassen Tracking-ID, Versandart und Versanddatum und werden in JTL-Wawi gepflegt. Ihr Kunde kann sie in seinem PayPal-Konto einsehen. Damit die korrekten Informationen übermittelt werden, müssen Sie Ihre Versandarten aus JTL-Wawi mit den von PayPal gelisteten Versanddienstleistern verknüpfen.
- Navigieren Sie zur Registerkarte Versandinformationen Ihres Plugins.
- Aktivieren Sie die Option Versandinformationen übermitteln.
- Geben Sie im Feld Frequenz (Stunden) an, in welchen Abständen die Versanddaten übertragen werden sollen und legen Sie eine Startzeit fest.
- Schließen Sie das Dialogfenster über die Schaltfläche Speichern.
- Wählen Sie eine Versandart aus und klicken Sie auf das Bearbeiten-Symbol oder klicken Sie auf die Schaltfläche Neue Zuordnung.
- Wählen Sie im Dropdown-Menü Versandart in JTL-Wawi die Versandart aus und ordnen Sie ihr im Dropdown-Menü Versanddienstleister bei PayPal den korrekten Dienstleister zu. Beispiel: DHL-Paket (10k g) – Deutsche Post.
- Falls in der Liste der PayPal-Versanddienstleister der benötigte Dienstleister nicht vorhanden ist, wählen Sie Sonstige.
Schritt 6: Vorgänger Plugin deaktivieren
Nachdem Sie jetzt alle wichtigen Einstellungen getroffen haben, können Sie das Vorgänger Plugin deaktivieren.
- Öffnen Sie im Backend von JTL-Shop Plugins > Plugin-Manager die Übersicht Ihrer Plugins.
- Suchen Sie das Vorgänger Plugin JTL PayPal in der Übersicht und wählen Sie es über die Checkbox vor dem Plugin-Namen aus.
- Klicken Sie auf die Schaltfläche deaktivieren. Das Plugin ist jetzt deaktiviert.
Schritt 7: Neue Zahlungsarten aktivieren
Sie können jetzt die zuvor in PayPal Checkout deaktivierten neuen Zahlungsarten wieder aktivieren.
- Navigieren Sie zu Installierte Plugins > JTL PayPal Checkout > Einstellungen.
- Klicken Sie nacheinander die Registerkarten Expresskauf und „Später bezahlen“-Banner und aktivieren Sie wieder alle gewünschten Zahlungsarten sowie Banner.
- Bestätigen Sie Ihre Angaben über die Schaltfläche Speichern.
Schritt 8: Vorgänger Plugin deinstallieren
Plugins, die Sie nicht mehr verwenden, können unter Umständen Fehler verursachen. Deshalb sollten Sie das Vorgänger PayPal Plugin aus JTL-Shop entfernen, sobald Sie sicher sind, dass PayPal Checkout einwandfrei funktioniert.
- Öffnen Sie im Backend von JTL-Shop Plugins > Plugin-Manager die Übersicht Ihrer Plugins.
- Suchen Sie das Vorgänger Plugin JTL PayPal in der Übersicht und wählen Sie es über die Checkbox vor dem Plugin-Namen aus.
- Klicken Sie auf die Schaltfläche deinstallieren. Das Plugin ist jetzt deinstalliert.
Sie haben die Grundkonfiguration des Plugins erfolgreich abgeschlossen.
Konfiguration durchführen (Vorgänger-Plugin nicht vorhanden)
Nachdem Sie das Plugin installiert haben, müssen Sie Ihr PayPal-Konto mit JTL-Shop verbinden. Anschließend können Sie alle nötigen Einstellungen vornehmen, um Optik, Anzeigeorte und verfügbare Zahlungsarten festzulegen.
Schritt 1: PayPal-Geschäftskonto und Sandbox-Account anlegen
Sie benötigen ein PayPal-Geschäftskonto. Wenn Sie noch kein PayPal-Geschäftskonto angelegt haben, können Sie dies hier tun: www.paypal.de/haendler. Zudem benötigen Sie ein PayPal-Sandbox-Konto. Weitere Details zur Erstellung lesen Sie hier: Sandbox-Account bei PayPal anlegen (nur auf Englisch verfügbar).
Schritt 2: PayPal-Konto mit JTL-Shop verbinden
Über das Onboarding von PayPal können Sie JTL-Shop schnell und einfach mit Ihrem PayPal-Konto verbinden.
- Navigieren Sie im Backend von JTL-Shop zu Plugins > Installierte Plugins und klicken Sie auf JTL PayPal Checkout.
- Deaktivieren Sie den Testmodus für die Nutzung des produktiven Systems und klicken Sie auf die Schaltfläche JTL-Shop jetzt mit PayPal verbinden.
- Geben Sie im sich öffnenden Dialogfenster die E-Mail-Adresse Ihres Händlerkontos und das Land oder die Region ein. Falls Sie noch kein Konto besitzen, können Sie es an dieser Stelle anlegen.
- Geben Sie das Passwort Ihres Händlerkontos ein und klicken Sie auf die Schaltfläche Einloggen.
- Führen Sie die nötigen Authentifizierungen durch und erteilen Sie über die Schaltfläche Zustimmen und verbinden die Genehmigung, Konto und JTL-Shop miteinander zu verknüpfen.
Die Seite wird automatisch aktualisiert. Dies kann einen kurzen Moment dauern.
Sollte es zu Problemen beim Login kommen, haben Sie die Möglichkeit, die Verbindung manuell herzustellen, wenn Sie Ihre Zugangsdaten kennen. Wenn Sie die Zugangsdaten nicht finden können, wenden Sie sich bitte an den PayPal Händlersupport.
- Klicken Sie auf Zugangsdaten manuell hinterlegen.
- Geben Sie Merchant ID, Client ID und Client Secret ein.
- Speichern Sie die Eingabe.
Schritt 3: Einstellungen vornehmen
In der Registerkarte Einstellungen können Sie verfügbare Zahlungsarten und Banner konfigurieren sowie allgemeine und zahlungsartspezifische Einstellungen vornehmen. Eine detaillierte Beschreibung der einzelnen Funktionen und Einstellungsmöglichkeiten lesen Sie hier: Detailbeschreibung: JTL PayPal Checkout.
Apple Pay aktivieren
In diesem Bereich können Sie die Domain Ihres Shops registrieren, um Ihren Kunden Apple Pay als Zahlungsart zur Verfügung zu stellen. Die Vorgehensweise ändert sich in Abhängigkeit davon, ob Ihr Shop direkt über die Domain läuft, bspw. sportbedarf-sommer.de, oder ob Ihr Shop in einem Unterverzeichnis liegt, bspw. sportbedarf-sommer.de/shop. Nachfolgend lesen Sie die jeweiligen Vorgehensweisen:
Shop läuft direkt über Domain
- Klicken Sie auf den Link Zahlungsquelle einrichten oder navigieren Sie in Ihrem PayPal-Händlerkonto zu Kontoeinstellungen > Zahlungsquellen und klicken dort auf die Schaltfläche Apple Pay verwalten.
- Klicken Sie auf die Schaltfläche Domain hinzufügen. Das Dialogfenster Registrieren Ihrer Website bei Apple Pay öffnet sich.
- Tragen Sie im Feld 1. Fügen Sie Ihre Website hinzu die Domain Ihres Shops, bspw. sportbedarf-sommer.de, ein und klicken Sie auf die Schaltfläche Domain registrieren.
Ihre Domain ist jetzt registriert. Die Schritte 2 und 3 werden automatisch ausgeführt.
- Wechseln Sie zurück in das Backend von JTL-Shop und wählen Sie in dem Dropdown-Menü Wurde die Registrierung Ihrer Shop-Domain erfolgreich durchgeführt? die Option Ja aus und bestätigen Sie Ihre Angaben über die Schaltfläche Speichern. Apple Pay steht Ihren Kunden jetzt als Zahlungsart zur Verfügung.
Shop liegt im Unterverzeichnis
- Klicken Sie auf den Link Zahlungsquelle einrichten oder navigieren Sie in Ihrem PayPal-Händlerkonto zu Kontoeinstellungen > Zahlungsquellen und klicken dort auf die Schaltfläche Apple Pay verwalten.
- Klicken Sie auf die Schaltfläche Domain hinzufügen. Das Dialogfenster Registrieren Ihrer Website bei Apple Pay öffnet sich.
- Tragen Sie im Feld 1. Fügen Sie Ihre Website hinzu die Domain Ihres Shops, bspw. sportbedarf-sommer.de/shop, ein.
- Laden Sie anschließend die Domain-Zuordnungsdatei herunter.
- Hosten Sie die Domain-Zuordnungsdatei unter der angegebenen Adresse.
- Klicken Sie auf die Schaltfläche Domain registrieren. Ihre Domain ist jetzt registriert.
- Wechseln Sie zurück in das Backend von JTL-Shop und wählen Sie in dem Dropdown-Menü Wurde die Registrierung Ihrer Shop-Domain erfolgreich durchgeführt? die Option Ja aus und bestätigen Sie Ihre Angaben über die Schaltfläche Speichern. Apple Pay steht Ihren Kunden jetzt als Zahlungsart zur Verfügung.
Schritt 4: Verknüpfen mit Versandarten im Shop
Nachdem Sie in Schritt 3 alle Einstellungen Ihren Anforderungen entsprechend vorgenommen haben, können Sie jetzt im Backend von JTL-Shop zu Ihren Versandarten die entsprechenden PayPal-Zahlungsarten hinzufügen.
- Klicken Sie im Backend von JTL-Shop auf Administration > Versand > Versandarten. Die Seite Versandarten öffnet sich.
- Öffnen Sie die Versandart über das Stift-Symbol für die Bearbeitung.
- Fügen Sie im Bereich Akzeptierte Zahlungsarten über die jeweiligen Checkboxen PayPal Checkout (PayPal) und/oder Rechnungskauf mit Ratepay (PayPal) zur Versandart hinzu.
- Geben Sie gegebenenfalls einen festen oder prozentualen Aufpreis oder Rabatt für diese Zahlungsart an.
- Bestätigen Sie Ihre Angaben über die Schaltfläche Speichern.
Schritt 5: Übermittlung von Versandinformationen einrichten
Sie können Ihren Kunden Informationen zum Versand von Bestellungen, die mit PayPal abgewickelt wurden, zugänglich machen. Diese Informationen umfassen Tracking-ID, Versandart und Versanddatum und werden in JTL-Wawi gepflegt. Ihr Kunde kann sie in seinem PayPal-Konto einsehen. Damit die korrekten Informationen übermittelt werden, müssen Sie Ihre Versandarten aus JTL-Wawi mit den von PayPal gelisteten Versanddienstleistern verknüpfen.
- Navigieren Sie zur Registerkarte Versandinformationen Ihres Plugins.
- Aktivieren Sie die Option Versandinformationen übermitteln.
- Geben Sie im Feld Frequenz (Stunden) an, in welchen Abständen die Versanddaten übertragen werden sollen und legen Sie eine Startzeit fest.
- Schließen Sie das Dialogfenster über die Schaltfläche Speichern.
- Wählen Sie eine Versandart aus und klicken Sie auf das Bearbeiten-Symbol oder klicken Sie auf die Schaltfläche Neue Zuordnung.
- Wählen Sie im Dropdown-Menü Versandart in JTL-Wawi die Versandart aus und ordnen Sie ihr im Dropdown-Menü Versanddienstleister bei PayPal den korrekten Dienstleister zu. Beispiel: DHL-Paket (10k g) – Deutsche Post.
- Falls in der Liste der PayPal-Versanddienstleister der benötigte Dienstleister nicht vorhanden ist, wählen Sie Sonstige.
Allgemeine Informationen
Zahlungsart-Matching
Bei der Abholung von Bestellungen wird eine Zahlungsart gesucht, die in JTL-Wawi vorhanden ist und die gleiche Bezeichnung wie die übermittelte (Shop-)Zahlungsart trägt. Verwenden Sie deshalb für die Namen der Zahlungsarten in JTL-Wawi exakt die Namen, wie sie unter Installierte Plugins > JTL PayPal Checkout > Infos in der Spalte JTL-Wawi Zahlartname angegeben sind.
Lesen Sie hier nach, wie Sie Zahlungsarten in JTL-Wawi anlegen beziehungsweise bearbeiten.
Kundenformularfelder für Auslandsversand
Wenn Sie Auslandsversand anbieten, müssen Sie sicherstellen, dass Sie in Ihren Kundenformularen im Shop die Felder Land und Bundesland anzeigen. Wählen Sie dazu in den Dropdown-Menüs unter Darstellung > Standardansichten > Registrierung die Option Ja. PayPal erwartet für diverse Länder neben dem Ländercode einen State-Code. Dieser wird nur übertragen, wenn die entsprechenden Kundenfelder im Formular abgefragt werden.
Kundenformularfelder für Rechnungskauf mit Ratepay
Wenn Sie den Rechnungskauf mit Ratepay anbieten möchten, müssen die Adressfelder Telefonnummer und Geburtsdatum mindestens optional im Formular abgefragt werden. Wählen Sie dazu in den Dropdown-Menüs unter Darstellung > Standardansichten > Registrierung die Option Ja.