s360_amazon_lpa_shop4

JTL Shop ab V.4.02

Open

Funktionsübersicht

„Amazon Pay und Login mit Amazon“ ermöglicht es Ihren Kunden, mithilfe ihrer in Amazon gespeicherten Adress- und Zahlungsdaten in Ihrem Shop einzukaufen. So nutzen Sie die Vertrautheit des Benutzers mit Amazon, um Ihre Conversion-Rate zu verbessern und den Bestellvorgang zu beschleunigen.

Das Plugin besteht aus den zwei Modulen „Login mit Amazon“ und „Amazon Pay“:

„Login mit Amazon“ erlaubt es dem Kunden, sich mit seinen Amazon-Zugangsdaten sowohl im Shop zu registrieren, als auch sich als wiederkehrender Kunde auf diese Weise einzuloggen.

• Übernahme der Amazon-Adressdaten in die Rechnungs-Adresse des Kunden

• Pflichtangaben, die Amazon nicht mitliefert, werden explizit vom Kunden abgefragt

• Automatische Passwortgenerierung im JTL-Shop

• Automatischer Abgleich mit existierenden Shop-Konten

„Amazon Pay“ ist ein eigener Checkout-Prozess, in dem der Kunde sowohl die Lieferadresse, als auch die Zahlungsweise aus seinen in Amazon gespeicherten Daten auswählen kann. Dabei wird für den Kunden optional ein Kundenkonto angelegt, insofern es noch nicht vorhanden ist.

• eigener Checkout-Prozess (keine „klassische“ Zahlungsart)

• verkürzter Checkout durch Auswahl von Lieferadresse, Versandart und Zahlungsart auf einer Seite (im Idealfall nur 3 Klicks vom Warenkorb zum Bestellabschluss)

Bei Amazon Pay werden an Amazon keine Informationen über den Warenkorb-Inhalt übermittelt. Lediglich der Gesamtwert des Warenkorbs wird zur Zahlungsabwicklung übermittelt.

Das Plugin unterstützt die Zahlung in folgenden Währungen:

• Australische Dollar (AUD)

• Japanische Yen (JPY)

• Euro (EUR)

• Britische Pfund (GBP)

• Südafrikanische Rand (ZAR)

• Schweizer Franken (CHF)

• Norwegische Kronen (NOK)

• Dänische Kronen (DKK)

• Schwedische Kronen (SEK)

• Neuseeländische Dollar (NZD)

• Hong Kong Dollar (HKD)

• US Dollar (USD)

Vorzüge des Plugins

„Amazon Pay und Login mit Amazon“ bietet sowohl dem Kunden als auch Ihnen als Händler folgende Vorteile:

• Kunde kann vertraute Amazon-Widgets nutzen

• Keine Weitergabe von Warenkorbinhalten an Amazon (lediglich der Gesamtwert zur Zahlungsabwicklung)

• Automatisierte Steuerung des Bezahlvorgangs mit Amazon über die gewohnten Verarbeitungsschritte in der JTL-Wawi

• Backend zur Übersicht über Status von Amazon Pay-Zahlungen, sowie Möglichkeiten zum manuellen Eingriff

• Login in den Shop für den Kunden über gewohnte Amazon-Masken

• Erstellung von Kundenkonten erleichtert durch Abfrage nur relevanter und benötigter Daten vom Kunden

• Anpassbares Design

Weitere Informationen zu Amazon Pay

Das Plugin selbst ist kostenlos. Für Sie als Händler fallen lediglich die Transaktionsgebühren von Amazon Pay an.

Gebühren: Bitte entnehmen Sie die zu zahlenden Gebühren den von Amazon bereitgestellten Informationen.

• Aus Kundensicht: Sicheres Bezahlen (Einkäufe unterliegen dem A-bis-z-Garantie-Schutz)

• Aus Kundensicht: Schnelles Einkaufen (Zurückgreifen auf bei Amazon hinterlegte Versand- und Zahlungsweisen)

• Aus Kundensicht: Einfacher Login (kein weiteres Passwort erforderlich)

• Aus Anbietersicht: Anbieten einer vertrauten und geläufigen Login- und Checkout-Methode

• Aus Anbietersicht: Schutz vor Zahlungsausfällen

• Aus Anbietersicht: Inline-Checkout

Wichtiger Hinweis: Amazon empfiehlt, dass Sie als Verkäufer innerhalb von 7 Tagen nach Autorisierung den Versand durchführen und bestätigen. Ab 7 Tage nach Autorisierung dauert der Zahlungseinzug deutlich länger und hat eine erhöhte Wahrscheinlichkeit, fehlzuschlagen, wobei technisch ein Zahlungseinzug bis 30 Tage nach Autorisierung möglich ist. Bitte klären Sie das im Einzelnen aber mit Ihrem Amazon Ansprechpartner.

Systemvoraussetzungen und Hinweise

Systemvoraussetzungen

• JTL Shop 4

• JTL Warenwirtschaft ab V.0.9.9.923

• PHP-Version mindestens 5.3

• jQuery Version mind. 1.10.2

• aktiviertes SEO-Modul

• Apache Webserver (sonst sind zusätzliche Anpassungen in der Konfiguration Ihres Webservers notwendig!)

Wichtig für 1&1- und Strato-Kunden

Falls Sie bei 1&1 oder Strato gehostet sind, müssen Sie die php.ini in folgende Ordner kopieren und ggf. den Server neustarten (oder warten, bis er nachts neugestartet wird):

(xxx bitte durch die höchste installierte Version des Plugins ersetzen)

/includes/plugins/s360_amazon_lpa_shop4/version/xxx/adminmenu/

/includes/plugins/s360_amazon_lpa_shop4/version/xxx/adminmenu/php/

/includes/plugins/s360_amazon_lpa_shop4/version/xxx/frontend/

/includes/plugins/s360_amazon_lpa_shop4/version/xxx/frontend/ajax/

Amazon Pay-Konto einrichten

Voraussetzungen und Anforderungen

Um Amazon Pay nutzen zu können, benötigen Sie einen Amazon Pay Advanced Account.

Zum Beantragen eines Amazon Seller Central Accounts für Amazon Pay sind folgende Nachweise zu erbringen:

• E-Mail-Adresse (noch für keinen anderen ASC Account verwendet)

• Ausweiskopie Vorder- und Rückseite von allen wirtschaftlich Berechtigten (für die Eintragung der vollen Namen, inkl. zweiter, dritter Vornamen und bei Heirat sollte auch angegeben werden z.B. „Maria Mustermann, geb. Müller“

• Adressnachweis von allen wirtschaftlich Berechtigten (nicht älter als drei Monate)

• Kontoverbindung für mögliche Einzüge und Auszahlungen

• Gründungsdatum wie auf Handelsregisterauszug oder Gewerbeschein vermerkt (nicht das Datum möglicher Umfirmierungen, sondern das der Ersteintragung)

• Handelsregisterauszug oder Gewerbeschein, nicht älter als 3 Monate

• Firmenname, wie im Handelsregister vermerkt

• Umsatzsteuernummer

• Telefonnummer für Kundenanfragen

Für Amazon Advanced Payment registrieren

Damit Sie „Amazon Pay und Login mit Amazon“ nutzen können, müssen Sie zunächst für einen entsprechenden Account bei Amazon Pay registrieren. Rufen Sie dazu bitte das Registrierungsformular unter https://sellercentral-europe.amazon.com/hz/me/sp/redirect?spId=A2EMAQC31RHCFG&language=de_DE&source=SPPD auf und folgen den Anweisungen.

Fahren Sie mit der weiteren Konfiguration erst fort sobald Ihre Registrierung seitens Amazon bestätigt wurde.

Bitte beachten Sie, dass für die Nutzung von Amazon Pay ein eigenständiger und neuer Account erforderlich ist. Sollten Sie also bereits einen Account haben, den allerdings bereits für den Verkauf Ihrer Artikel auf dem Amazon Marketplace verwenden, müssen Sie dennoch einen neuen Account beantragen.

Auch der für das „alte“ JTL Amazon Pay Plugin verwendete Checkout-by-Amazon-Account kann nicht verwendet werden.

Nochmals: Sie benötigen zwingend einen Amazon Advanced Payment Account!

Im Zweifel und bei Rückfragen wenden Sie sich bitte an den Support bei Amazon Pay https://payments.amazon.de/business/contactsales.

Tipp: Besteht ein "alter" Checkout-by-Amazon Account wird Amazon in aller Regel die Aktivierung eines neuen Amazon Pay Accounts verweigern, da bei Angabe derselben URL der Website, die ja auch im alten Account genutzt wurde aufgrund der Amazon Richtlinien kein zweites Konto angelegt werden darf. Es empfiehlt sich, mit etwas längerer Wartezeit bis zur Aktivierung des neuen Accounts zu rechnen da man sich hier erst mit dem Amazon Kundenservice verständigen muss. Die Alternative ist die Deaktivierung des alten Plugins verbunden mit der Änderung der im alten Account hinterlegten URL und erst anschließenden Registrierung eines Amazon Payment Accounts.

Grundlegende Konfiguration des Amazon Pay Kontos

Melden Sie sich über den Loginbereich an: https://sellercentral.amazon.de

Open

Suchen Sie nun den Menüpunkt „MWS Access Key“ im Reiter „Integration“ auf

Open

Erstellen Sie ein Amazon Marketplace Web Service Konto (MWS)

Open

Nachdem Sie auf den Link „hier“ klicken, werden Sie zur erneuten Passworteingabe für Ihren Seller Central Account aufgefordert.

Markieren Sie den Auswahlpunkt „Ich möchte MWS für mein eigenes Amazon Verkäuferkonto freischalten.“ und bestätigen Sie durch Klick auf den Weiter-Button.

Open

Bestätigen Sie die Kenntnisnahme der Lizenzvereinbarungen durch ein Häkchen in der Check-Box und das Betätigen des Weiter-Buttons.

Open

Ihr Amazon Verkäuferkonto ist für die Nutzung von MWS freigeschaltet. Bitte notieren Sie sich die Daten des folgenden Bildschirms oder drucken sich diese Ansicht aus.

Open

Im Seller Central oben rechts im Dropdown auf „Login with Amazon“ wechseln.

Open

„Register new application“ Schaltfläche betätigen.

Open

Füllen Sie die folgende Maske aus.

Name: Name der dem Kunden bei der Verwendung von „Login und Bezahlen mit Amazon“ als Empfänger der Zahlung angezeigt wird (z.B. Domain)

Description: Untertitel, d.h. kurze prägnante Beschreibung des Online-Shops

Privacy Notice URL: Deeplink zu den eigenen Datenschutzbestimmungen

Logo Image: optional kann hier eine Bild-Datei mit dem eigenen Logo hochgeladen werden

Open

Bestätigen Sie Ihre Eingaben durch „Save“.

Klappen Sie die „Web Settings“ durch Klick auf das grüne Icon aus.

Open

Open

An dieser Stelle verlassen wir vorübergehend das MWS Konto und setzen die Konfiguration in JTL Wawi und JTL Shop4 fort.

Lassen Sie das Fenster bzw. den Tab zum Seller Central jedoch im Browser geöffnet.

Konfiguration in der JTL Wawi

Zahlungsart einrichten

Auch wenn „Amazon Pay und Login mit Amazon“ keine Zahlungsart im klassischen Sinn darstellt und im JTL Shop4 Backend ja auch nicht als solches betrachtet wird, ist es notwendig in der JTL Wawi die Zahlungsart „Amazon Payments“ oder „Amazon Pay“ anzulegen. Seit 22.2.2017 ist der offizielle Name „Amazon Pay“.

Wichtig:

Bitte achten Sie darauf, „Auslieferung vor Zahlungseingang möglich“ zu aktivieren!

Die hier konfigurierte Zahlungsart muss mit dem Namen übereinstimmen, der im Plugin-Backend ausgewählt ist! Aus Abwärtskompatibilitätsgründen, ist der initial eingestellte Name im Plugin ggf. noch „Amazon Payments“.

Falls Sie den Namen „Amazon Payments“ in der Wawi nutzen, beachten Sie: Hat man zuvor bereits das JTL Amazon Payment Plugin verwendet oder über eazyAuction auf dem Amazon Marketplace verkauft, so wird auch die Zahlungsart „Amazon Payment“ (ohne s am Ende) existieren, daher ist zu beachten, dass die neue Zahlungsart unbedingt auf „s“ endet.

Open

Open

Web-Shop-URL prüfen

Wenn Ihr Web-Shop vollständig unter https läuft, sollten Sie Ihre Webshop-URL in den Webshop-Einstellungen ebenfalls auf https:// stellen – sonst kann es beim Abgleich mit aktiviertem Amazon Pay Plugin zu einer Fehlermeldung der Wawi kommen.

Einrichtung des Plugins

Installation via FTP

Entpacken Sie die heruntergeladene Archiv-Datei des Plugins und kopieren Sie sämtliche Inhalte in den Serverpfad „includes/plugins“. Anschließend muss das Plugin in der Pluginverwaltung des JTL Shops auftauchen.

Hinweise zum HTACCESS-Schutz

Das Plugin beinhaltet im Hauptordner eine .htaccess-Datei. Diese ist so gehalten, dass sie auf möglichst vielen Server-Konfigurationen funktioniert. Sollten Sie jedoch Ihren Server auf einem nginx betreiben statt auf einem Apache2 oder sollte es andere Probleme mit der HTACCESS geben, so stellen Sie bitte manuell folgende Punkte sicher:

Die folgenden Dateien müssen zugreifbar sein:

check_mws_access.php
update_frontend_links.php
backup_tables.php
migrate_tables.php
ipn.php
cron.php
lpa_ajax_*.php

Außerdem leitet die .htaccess-Datei automatisch Anfragen an die IPN-URL immer an die aktuellste IPN-URL um, so dass bei Plugin-Updates im Normalfall keine Anpassung der Händler-URL in der Seller Central erfolgen muss.

Installation des Plugins im JTL-Shop 4

In der Plugin-Verwaltung ihres JTL Shop Backends taucht nun unter Verfügbare (nicht installierte) Plugins das Solution 360 „Amazon Pay und Login mit Amazon“ Plugin auf. Installieren Sie dieses durch markieren der Checkbox und Betätigung der Schaltfläche Installieren.

Open

Migration von Amazon Login & Pay für JTL-Shop 3

Allgemeine Hinweise

Achten Sie darauf, in der Seller Central Ihre Händler-URL (die auf ipn.php endet) auf den neuen Pfad zum Shop 4 Plugin umzustellen! Sie finden die korrekte Händler-URL im Reiter „Einstellungen Account“ im Shop 4-Plugin-Backend.

Datenmigration

Das Plugin bietet die Möglichkeit, bestimmte Daten aus dem Shop 3-Plugin automatisch zu übernehmen. Das sind insbesondere die Bestellinformationen und die Account-Zuordnungen zwischen Amazon und Ihrem Shop.

Ohne diese Daten kann das Plugin alte Bestellungen nicht automatisiert verarbeiten und Kunden, die sich schon ein Mal per Login mit Amazon eingeloggt haben, müssen zwangsläufig ihr Shop-Passwort eingeben, wenn sie sich erneut mit Login mit Amazon einloggen wollen.

Daher wird dringend empfohlen, die Migration der Daten aus dem alten Plugin durchzuführen, wenn Sie Ihren Shop von Version 3 auf 4 updaten!

Voraussetzung:

• Sie haben das Shop 3 Plugin noch nicht deinstalliert

• Sie haben noch keine Bestellungen/Kundendaten vom Shop 4 Plugin in der Datenbank (dieser Punkt ist optional, es wäre aber besser, wenn die Shop 4 Plugin-Tabellen noch leer sind)

Vorgehen:

• Deaktivieren Sie das Shop 3 Plugin (nicht Deinstallieren!)

• Installieren/Aktivieren Sie das Shop 4 Plugin, insofern noch nicht geschehen

• Im Plugin-Backend vom Shop 4 Plugin:

  • Öffnen Sie den Reiter „Erweiterte Funktionen“

  • Betätigen Sie den „Import Shop3-Plugin-Daten“-Button

  • Das Plugin importiert die Daten aus dem Shop 3 Plugin und liefert entsprechende Meldungen zurück.

  • Betätigen Sie den „Frontendlinks aktualisieren“-Button. In dem Schritt werden die SEO-Links vom alten Plugin deaktiviert, indem sie den Suffix _OLD erhalten. (Bei der Deinstallation des Shop 3 Plugins werden diese dann automatisch gelöscht, dies dient nur der Kollisionsvermeidung mit den SEO-Links vom neuen Plugin.)

  • Prüfen Sie, ob im Reiter „Bestellungen“ jetzt die Bestellungen zu sehen sind. (ggf. müssen Sie dafür das Plugin-Backend nochmals öffnen, damit die Daten geladen werden; beachten Sie außerdem, dass die angezeigten Bestellungen vom Pluginmodus (Sandbox vs. Produktion) abhängen)

• Sie können das Shop 3 Plugin jetzt deinstallieren (müssen dies aber nicht tun)

Open

Frontendlinks aktualisieren

Dieser Schritt sollte bei der Erstinstallation und nach jedem Update des Plugins ausgeführt werden!

Öffnen Sie im Plugin-Backend den Tab „Erweiterte Funktionen“ und betätigen Sie den Button „Frontendlinks aktualisieren“.

Das Plugin legt daraufhin automatisch eine Linkgruppe „hidden“ an, falls diese noch nicht existiert, und verschiebt die Plugin-Links in diese Gruppe.

Hinweis: Es ist zwingend erforderlich, die Gruppe „hidden“ zu nennen (Kleinschreibung beachten!), da die Links zu den Seiten sonst im Mobile Template auf der Info-Seite und im Desktop-Template auf der 404-Seite auftauchen könnten. Falls Sie bereits eine Linkgruppe „Hidden“ (großgeschrieben) haben, legt das Plugin keine neue Linkgruppe an, sondern nutzt diese. Aufgrund der Groß-Schreibung sind die Links in dieser Gruppe aber nicht wirklich versteckt. Sie sollten die Linkgruppe in diesem Fall manuell in „hidden“ umbenennen.

Open

Manuelle Account-Konfiguration (Alternative 1)

Open

Befüllen Sie die Felder durch Übernahme der Daten aus den Web Settings im Seller Central. Achten Sie beim Kopieren auf eventuelle Leerzeichen am Anfang und Ende der Kennungen.

Das Client Secret erscheint in den Web Settings als Popup nach Klick auf den Button „Show Secret“.

Es ist absolut notwendig, dass Sie die Daten aus dem Backend des Plugins sowie die Daten aus den Amazon Web Settings gegeneinander abgleichen. Die folgenden beiden Screenshots sollen dies noch einmal veranschaulichen.

Beachten Sie, dass Sie in der Seller Central drei verschiedene Ansichten haben: Amazon Pay (Sandbox), Amazon Pay (Production) und Login mit Amazon. Sie können diese Ansichten oben rechts im Dropdown wechseln.

Open

Übernehmen Sie die Merchant-ID, MWS Access Key, MWS Secret Key, Client ID und Client Secret aus der Seller Central ins Plugin-Backend.

Open

Übertragen Sie zudem die Return-URLs und den JavaScript Origin, die Ihnen im Plugin-Backend angezeigt werden, in die Web Settings in der Seller Central. Weitere URLs lassen sich durch „Add another“ hinzufügen. Speichern Sie die Web Settings mit „Save“.

!!!Bitte beachten Sie, dass die URLs nicht optional sind, sondern in jedem Fall eingetragen werden müssen!!!

Nach Eingabe aller erforderlichen Daten können Sie diese nun im Plugin-Backend überprüfen.

Open

Ausgabe bei erfolgreicher Prüfung:

Open

Wenn erfolgreich geprüft wurde, drücken Sie auf Speichern. Bitte stellen Sie sicher, dass der Shop Ihnen auch das erfolgreiche Speichern bestätigt. In manchen Fällen kann es passieren, dass das Speichern beim ersten Klick fehlschlägt. Wiederholen Sie dann einfach die Eingabe und drücken Sie erneut auf Speichern.

Beispielhafte Ausgabe im Falle eines Fehlers:

Open

IPN-URL konfigurieren

(IPN = Instant Payment Notifications)

Suchen Sie nun die Integrationseinstellungen unter Einstellungen (äußerst rechter Punkt, oben im Seller Central Fenster) auf. Achten Sie darauf, dass Sie sich in der Ansicht „Amazon Pay“ befinden. Sie müssen die IPN-URL sowohl für Sandbox, als auch für Production konfigurieren.

Open

Übernehmen Sie die Händler-URL aus dem Plugin-Backend in das Feld Händler-URL im MWS. Die Eingabe in das Feld Integrator-URL bleibt leer. Speichern Sie die Eingaben sowohl im JTL Backend als auch in Ihrem Seller Central Account.

Open

Wichtig: Wechseln Sie von der Sandbox- in die Produktionsansicht (oder umgekehrt) und wiederholen Sie den Vorgang! Die Händler-URL muss in beiden Ansichten identisch eingetragen werden.

Automatische Konfiguration (Alternative 2)

Ab Plugin-Version 1.03 unterstützt das Plugin die automatische Konfiguration über Amazon Pay. Sie können die Funktion nutzen, um direkt die Registrierung bei Amazon Pay durchzuführen, aber auch, um die Konfiguration der Seller Central zu automatisieren.

Klicken Sie zum Beginnen auf die Schaltfläche „Amazon Pay Account registrieren“. Dies können Sie auch dann tun, wenn Sie bereits einen Account haben.

Open

Folgen Sie dann den Anweisungen auf der Amazon Pay-Seite.

Das Plugin übermittelt die URLs, die Sie sonst manuell in der Seller Central eintragen müssten in diesem Schritt automatisch an Amazon Pay.

Wenn Sie mit der Konfiguration in der Seller Central fertig sind, finden Sie dort in der Amazon Pay-Ansicht unter Integration -> MWS Access Key einen Button „Zugangsdaten kopieren“. Wenn Sie den Button betätigen, öffnet sich ein Pop-Up mit Ihren JSON-kodierten Daten.

Open

Kopieren Sie den gesamten Inhalt des Pop-Up Fensters und fügen Sie diesen im Plugin-Backend ein.

Klicken Sie danach auf „Daten übernehmen“.

Open

Danach sollten im Plugin Ihre Zugangsdaten eingerichtet sein. Betätigen Sie zur Sicherheit nochmal den „Account-Daten prüfen“-Button und speichern Sie die Einstellungen.

IPN-URL testen

Nachdem Sie die Konfiguration in der Seller-Central vorgenommen haben, sollten Sie prüfen, ob Ihre IPN-URL (bzw. Händler-URL) korrekt auf dem Shop-Server aufgerufen werden kann.

Rufen Sie dazu die Händler-URL, wie sie im Backend angezeigt wird mit dem zusätzlichen Parameter ?lpacheck auf. Also zum Beispiel:

https://<Ihre Shop-Domain>/includes/plugins/s360_amazon_lpa_shop4/version/108/frontend/ipn.php?lpacheck

Dann sollten Sie eine Text-Ausgabe sehen:

„IPN is reachable.“ Sowieso dahinter den Pfad zur aufgerufenen ipn.php. (Durch Redirects im Plugin kann hier die Versionsnummer im Pfad von der eingegebenen URL abweichen.)

Außerdem sollten Sie sicherstellen, dass Ihr Browser das SSL-Zertifikat als sicher ansieht (also keine entsprechende Warnmeldung auftaucht).

Ob auch Amazon die URL korrekt aufruft, erkennen Sie daran, dass die Zahlungseingänge nach dem Versand automatisch in Shop und Wawi gesetzt werden. Ist das nicht der Fall, stimmt zumeist etwas nicht mit der Händler-URL-Konfiguration.

Daher ist eine Testbestellung mit einem Durchspielen des kompletten Bestell-, Versand- und Zahlungsablaufs unbedingt durchzuführen.

Überprüfung im Sandbox-Modus im Shop

Open

Überprüfen Sie nun, ob „Amazon Pay und Login mit Amazon“ in Ihrem Shop angezeigt wird. Erweitern Sie dazu zunächst ihr Shop-URL um „/?lpa-show“. Bitte beachten Sie, dass die Buttons solange versteckt (und nur mithilfe des Parameters sichtbar) bleiben, solange die Option „Hidden-Button-Modus“ auf „ein“ steht.

An folgenden Stellen sollten die Elemente jetzt standardmäßig sichtbar sein:

• Im Anmelden-Dropdown

• Auf der Anmelden-Seite

• Im Warenkorb (insofern ein Artikel im Warenkorb liegt; keiner der Artikel per Funktionsattribut „exclude_amapay“ ausgeschlossen ist und der Mindestbestellwert erreicht ist)

• Auf der Accountauswahl-Seite im Standard-Bestellvorgang

• Auf der Zahlungsartauswahl-Seite im Standard-Bestellvorgang

Wo die Elemente genau erscheinen, hängt von Ihrem Template und den ggf. angepassten Einstellungen im Backend des Plugins ab.

Plugin-Konfiguration "Einstellungen Allgemein"

Gehen Sie im Plugin in den Bereich „Einstellungen Allgemein“. Die Abbildungen zeigen nicht die Default-Einstellungen, sondern bereits angepasste Einstellungen für den Livebetrieb in einem speziellen Onlineshop.

Beachten Sie die Tooltips zu den einzelnen Punkten, die Sie sehen können, wenn Sie mit der Maus auf das Fragezeichen neben der Einstellung zeigen.

Plugin-Konfiguration "Einstellungen Sonstiges"

Versandarten-Ausschluss

Hier können Sie auswählen, welche Versandarten generell gar nicht im Amazon Pay-Checkout zur Verfügung stehen sollen.

Sprachvariablen

Die Sprachvariablen können Sie bei Bedarf in der Pluginverwaltung einsehen und ggf. anpassen.

Open

Testbestellung

An dieser Stelle empfiehlt sich die eine oder andere Testbestellung. Amazon Testkonten lassen sich einfach in der Sandbox-Ansicht im Seller Central anlegen:

Open

E-Mail-Vorlagen

Open

Die E-Mail-Vorlagen finden Sie im JTL Shop Backend unter Inhalte. Fordern Sie sich Testmails an und stimmen die Darstellung der E-Mail-Vorlagen auf Ihre CI ab.

Produktiv-Modus aktivieren

Wenn alles ausreichend getestet wurde, kann von Sandbox- in Produktivmodus gewechselt werden.

Open

Abschließend können Sie den Hidden-Button-Modus in den Allgemein-Einstellungen des Plugins deaktivieren.

Open

„Amazon Pay und Login mit Amazon“ steht jetzt allen Kunden in Ihrem Shop zur Verfügung.

Updates

Die folgenden Schritte sind nur bei einem Update des vorher bereits installierten Plugins durchzuführen:

Installation

Laden Sie den aktuellen Code des Plugins wie in Kapitel 4 beschrieben hoch.

Kopieren Sie ggf. selbst erstellte custom-Dateien in den entsprechenden Unterordner der aktuellsten Version („/includes/plugins/s360_amazon_lpa_shop4/version/<höchste Nummer>/frontend/…“).

Hinweis: Wenn Sie selbst angepasste Templates nutzen, müssen Sie ggf. Änderungen der Basis-Templates manuell nachziehen.

Wechseln Sie in die Pluginverwaltung – hier sollte nun wie gewohnt der Hinweis stehen, dass ein Update für das Plugin verfügbar ist. Führen Sie das Update aus.

Wechseln Sie ins Backend des Plugins in den Tab „Erweiterte Funktionen“ und betätigen Sie den Button „Frontendlinks aktualisieren“.

Wenn diese Schritte fehlerfrei durchgeführt worden sind, ist das Plugin nun auf dem neuesten Stand. Führen Sie eine Testbestellung im Sandbox-Modus durch, um die korrekte Installation zu verifizieren.

Sie können auch optional die Händler-URL in der Seller Central anpassen. Durch die im Plugin mitgelieferte .htaccess-Datei werden Anfragen an die alte URL aber auch automatisch an die neueste Plugin-Version-URL umgeleitet.

Hinweis zu Shop-Version 4.05: Beachten Sie, dass sich im EVO-Template der Shop-Version 4.05 die Selektoren für die Bezahlbuttons geändert haben. Sie können die korrekten Default-Selektoren entweder der info.xml des Plugins entnehmen oder im FAQ-Bereich dieses Dokuments unter Warum wird seit dem Shop-Update auf V4.05 kein Button mehr im Warenkorb angezeigt? finden.

Update von Shop 3 auf Shop 4 Plugin

Beachten Sie bitte die Hinweise im Kapitel zur Migration der Shop 3 Plugin-Daten.

Tracking

Da Amazon Pay einen eigenen Checkout-Prozess darstellt, müssen Sie Ihre Trackingeinstellungen ggf. anpassen.

Google PageView-Tracking

Um den Bestellvorgang im Amazon Pay-Plugin zu tracken, sind folgende beiden Links für die Konfiguration in Ihrem Google-Account für Sie relevant:

www.ihrshop.de/lpacheckout - dies sind die beiden Bestellvorgangsseiten

www.ihrshop.de/lpacomplete - dies ist die Bestellabschlussseite, die der Kunde nur sieht, wenn er die Bestellung erfolgreich abgesendet hat (entspricht also der bestellabschluss.php-Seite des JTL-Shops)

Falls Sie Logins über „Amazon Pay und Login mit Amazon“ tracken wollen, ist der folgende Link von Interesse:

www.ihrshop.de/lpalogin

Template-Anpassungen

Das „Amazon Pay und Login mit Amazon“-Plugin ist weitestgehend so ausgelegt, dass Sie die Templates an Ihre Wünsche anpassen können. Sie finden die relevanten Dateien in den Ordern .../version/<xxx>/frontend/template/ und …/version/<xxx>/frontend/css/.

Wichtig: Editieren Sie möglichst nie die Dateien, die direkt mit dem Plugin geliefert werden, sondern legen Sie analog zu JTL-Template-Anpassungen Kopien (oder eigene Dateien) mit dem Suffix _custom.tpl (für Templates) oder _custom.css (für CSS-Dateien, bitte beachten Sie, dass hier im Gegensatz zum Shop 3 Plugin nun ein Unterstrich genutzt wird) an.

TPL-Dateien

Die folgenden Template-Dateien werden von *_custom.tpl- Dateien überschrieben, wenn sie vorhanden sind:

lpa_alternate_checkout_snippet.tpl

Das ist die Box, die im JTL-Standard-Bestellvorgang angezeigt wird (mit dem Hinweistext und dem Button „Amazon Pay“)

lpa_checkout.tpl

Das ist die Checkout-Seite. Sie beinhaltet sowohl den ersten Teil, in dem der Kunde die Lieferadresse, Versandart und Zahlungsart auswählt, als auch die Bestellübersicht und den Kaufen-Button.

lpa_checkout_complete.tpl

Das ist die Bestellbestätigungsseite nach erfolgreichem Absenden der Bestellung.

lpa_create.tpl

Das ist ein Eltern-Template, in dem das Account-Anlegen-Formular eingebettet ist.

lpa_create_account_form.tpl

Das ist das Formular zum Anlegen eines Accounts, wenn sich der Kunde mit Amazon einloggt und es zu seiner E-Mail-Adresse noch kein Konto im JTL-Shop gibt. Im Gegensatz zum Standard-Formular zur Account-Anlage, werden hier nur Pflichtdaten abgefragt. Außerdem erfolgt die Eingabe von Name und Adresse direkt über die Auswahl im Amazon-Widget und es wird kein Passwort abgefragt.

Die Passwortgenerierung erfolgt je nach Einstellung des Plugins ggf. automatisch im Hintergrund, um den Kunden nicht unnötig lange an diesem Schritt aufzuhalten. Loggt sich der Kunde später wieder mit Amazon ein, wird er auch nicht nach dem Passwort gefragt, sondern kommt direkt in den Shop-Account. (Falls der Kunde sich jedoch zukünftig direkt und ohne Amazon in den Shop einloggen will, muss er bei einem generierten Passwort die Passwort vergessen-Funktion nutzen.)

lpa_login.tpl

Das ist das übergeordnete Template für den Login mit Amazon – hier wird ggf. das Formular zur Account-Anlage oder zur Account-Bestätigung (Merge) eingebettet.

lpa_merge.tpl

Das ist ein Eltern-Template, in dem das Account-Merge-Formular eingebettet ist.

lpa_merge_account_form.tpl

Das ist das Formular für den Account-Merge, wenn sich ein Kunde in Amazon einloggt und es zu seiner E-Mail-Adresse bereits ein Konto im JTL-Shop gibt. Dieses Formular wird dann einmalig angezeigt und fordert den Kunden dazu auf, durch Passworteingabe zu bestätigen, dass er der Besitzer des Shop-Accounts ist. (Wenn der Kunde dies einmal erfolgreich getan hat ODER bereits vor dem Login mit Amazon im Shop eingeloggt ist, taucht dieses Formular nicht mehr auf.)

lpa_shipping_method_selection_snippet.tpl

Das ist das Formular zur Auswahl der Versandart unter dem Adress- und Zahlungsart-Widget im Amazon-Checkout.

CSS-Dateien

Die folgenden CSS-Dateien können durch *_custom.css-Dateien ersetzt werden. Ab Shop-Version 4.03 werden die vom Plugin mitgelieferten .css-Dateien vollständig ersetzt. Sie müssen also deren Inhalte in jedem Fall in Ihre eigene _custom.css-Datei kopieren, wenn Sie eine _custom.css-Datei anlegen.

Hinweis bis einschließlich Shop 4.02: Die Plugin-Dateien werden bis Shop-Version 4.02 nicht überschrieben, sondern ergänzt. Da das *_custom.css aber nach der *.css geladen wird, überschreiben Anpassungen die Standard-Werte.

lpa-checkout.css

Enthält Styles für den Checkout-Prozess, inkl. dem Overlay beim Absenden der Bestellung.

lpa-checkout-mobile.css

Enthält Styles für den Checkout-Prozess im Mobile Template.

lpa-login-button.css

Enthält Styles für den „Login mit Amazon“-Button.

lpa-login-button-mobile.css

Enthält Styles für den „Login mit Amazon“-Button im Mobile Template.

lpa-pay-button.css

Enthält Styles für den „Amazon Pay“-Button.

lpa-pay-button-mobile.css

Enthält Styles für den „Amazon Pay“-Button im Mobile Template.

lpa-tooltip.css

Enthält die Styles für den Tooltip, der angezeigt wird, wenn der Nutzer auf den „Amazon Pay“-Button zeigt.

lpa-tooltip-mobile.css

Enthält die Styles für den Tooltip im Mobile Template.

lpa-shop3-compatibility.css

Enthält Styles (im Wesentlichen bootstrap-Styles), damit die DOM-Struktur des Plugins auch in einem Tiny Template (oder anderem Shop3-Template ohne Bootstrap) korrekt gestyled wird. Diese CSS-Datei wird nur im Shop3-Kompatibilitätsmodus geladen.

Bestellungsverwaltung

JTL Wawi

Nach erfolgreicher Autorisierung der Zahlung durch Amazon wird die Bestellung an die Wawi übertragen. Dort kommt diese jedoch erstmal mit dem Zahlungsstatus „NICHT bezahlt“ an.

Ist die Autorisierung nicht erfolgreich, so wird die Bestellung auch nicht vom Webshop an die Warenwirtschaft übermittelt. Bestellungen werden erst dann vom Shop an die Wawi übertragen, wenn sie von Amazon autorisiert worden sind. Dies kann einen Moment dauern. Wird eine Bestellung dauerhaft nicht an die Wawi übertragen, liegt das mit großer Wahrscheinlichkeit daran, dass Amazon die Zahlung nicht autorisiert hat. Sie erkennen eine solche Ablehnung im Pluginbereich des „Amazon Pay und Login mit Amazon“ am Bestellstatus „Suspended“ und am Autorisierungsstatus „Declined“, jeweils mit der Anmerkung „InvalidPaymentMethod“. Im Backend Ihres JTL4-Shops wird direkt mit Ablehnung der Zahlung eine E-Mail versandt mit der der Kunde aufgefordert wird sich bei Amazon einzuloggen und seine Zahlungsweise zu aktualisieren. Wenn dies geschehen ist und die Zahlung seitens Amazon autorisiert wurde, wird die Bestellung mit dem nächsten Webshopabgleich an die Wawi übertragen.

Im Feld „Hinweis“ wird dem Wawi-Auftrag die Amazon-Order-Referenz übergeben. Dies erleichtert die Zuordnung des Auftrags zur entsprechenden Bestellung im Seller Central Account.

Die Zahlungsfreigabe und somit die Verbuchung des Zahlungseingangs erteilt Amazon erst mit erfolgtem Versand der Bestellung (% Geliefert = 100).

Geben Sie daher die Bestellung zum Versand frei, Sie müssen nichts weiter tun.

Sollte es notwendig sein, dass Sie eine Bestellung stornieren, reicht es aus, dies in der JTL Wawi zu machen. Die Schnittstelle übernimmt den Rest in Kommunikation mit Ihrem Seller Central Account.

JTL Shop4-Plugin

Open

Die standardmäßig angezeigte Seite im Backend des Plugins ist die Bestellübersicht. Hier sehen Sie sämtliche mit Amazon Pay aufgegebene Bestellungen.

Amazon Pay Zahlungsobjekte

„Amazon Pay und Login mit Amazon“ bedient sich einiger Begriffe, die sich an der Amazon-Nomenklatur orientieren und Ihnen ggf. nicht bekannt sind. Im Folgenden werden die Tabellen und die Inhalte genauer beleuchtet.

Bestellung (Order Reference): Das ist das Hauptobjekt, um das sich alles bei der Zahlungsabwicklung mit Amazon Pay dreht. Die Order Reference entspricht einer Bestellung eines Kunden. Die Spalten haben folgende Bedeutung:

• Nummer (Shop): Das ist die vom Shop vergebene Bestellnummer der Bestellung. Diese findet sich wie gewohnt auch in der JTL-Wawi wieder und dient der Zuordnung zwischen Bestellungen in JTL und den entsprechenden Order References in Amazon.

• Status (Shop): Das ist der gewohnte JTL-interne Verarbeitungsstatus der Bestellung.

• Order-Referenz (Amazon): Die von Amazon vergebene Identifikation der Bestellung. Mithilfe dieser ID können Sie die Bestellung auch im Backend der Amazon Seller Central wiederfinden.

• Order-Status (Amazon): Der Status der Bestellung, bzw. Zahlungsabwicklung, aus Sicht von Amazon Pay. Dieser Status kann Open (typischerweise), Closed, Canceled oder Suspended sein.

• Betrag: Das ist der Gesamtwarenkorbwert, der an Amazon übermittelt wurde und per Zahlung vom Kunden eingezogen wird.

• Sandbox: Amazon Pay unterscheidet zwischen Bestellungen, die im Sandbox- (Ja) und im Produktionsmodus (Nein) durchgeführt worden sind.

• Ablaufdatum: Jede Order Reference hat eine Gültigkeit von 6 Monaten. Spätestens nach dieser Zeit geht die Order Reference automatisch in den Status Closed über.

• Aktion: Hier können Sie, abhängig von dem aktuellen Status der Order Reference verschiedene Aktionen manuell auslösen. Wichtig ist hier vor allem der „Refresh“-Button, über den Sie proaktiv von Amazon die aktuellsten Daten zu der Bestellung abfragen können. Dadurch werden auch die Informationen zu allen zugehörigen Objekten (Autorisierungen, Zahlungseinzüge und Erstattungen) aktualisiert!

Klicken Sie auf eine Order Reference, um alle Autorisierungen, die zu ihr gehören, anzuzeigen!

Autorisierung (Authorization): Eine Autorisierung ist die Bestätigung von Amazon, dass ein Zahlungseinzug (Capture) über den autorisierten Betrag erfolgen kann. Die Autorisierung wird automatisch direkt nach der Bestellung (ggf. auch während der Bestellung, im synchronen Modus) angefragt. Jeder Zahlungsvorgang setzt sich aus einer Autorisierung und darauf ausgeführten Zahlungseinzügen zusammen. Hier gibt es die folgenden Spalten:

• ID (Amazon): Die von Amazon vergebene Identifikation der Autorisierung. Diese dient Ihnen ggf. als Referenz.

• Status (Amazon): Der Status der Autorisierung. Autorisierungen können die Status Pending, Open, Declined oder Closed haben. Bitte beachten Sie die FAQ, wenn Sie Fragen zu bestimmten Status haben.

• Betrag (autorisiert): Das ist der gegen Amazon autorisierte Betrag, der eingezogen werden soll. Im Normalfall entspricht dieser Wert dem Betrag der Bestellung, kann bei manuellem Eingriff aber auch davon abweichen.

• Betrag (eingezogen): Das ist der Betrag, der bereits durch Zahlungseinzüge (Captures) durch Amazon vom Kunden abgebucht und Ihnen gutgeschrieben wurde.

• Sandbox: wie bei Bestellung

• Ablaufdatum: Jede Autorisierung hat eine Gültigkeit von 30 Tagen. Innerhalb dieser Zeit müssen Zahlungseinzüge durchgeführt werden, sonst muss eine neue Autorisierung erfolgen. Sie sollten möglichst vermeiden, Autorisierungen auslaufen zu lassen.

• Aktion: Hier können Sie, abhängig vom aktuellen Status der Autorisierung, verschiedene Aktionen manuell auslösen.

Klicken Sie auf eine Autorisierung, um die zugehörigen Zahlungseinzüge anzuzeigen!

Zahlungseinzug (Capture): Der Zahlungseinzug ist der Schritt, bei dem tatsächlich Geld vom Kunden über dessen gewählte Zahlungsart eingezogen und Ihnen von Amazon gutgeschrieben wird. Der Zahlungseinzug erfolgt im Normalfall nachdem Sie die Bestellung in der Wawi versandt haben und einen Webshopabgleich durchgeführt haben. (Anders verhält es sich, wenn Sie den sofortigen Zahlungseinzug aktiviert haben. Dazu müssen Sie aber von Amazon explizit berechtigt worden sein!) Die Spalten hier haben folgende Bedeutung: