tfm_amazon_payments_v2

Das Plugin “tfm_amazon_payments_v2 ” erlaubt Ihnen, die Zahlungsart Amazon Pay (ehemals “Login und Bezahlen mit Amazon”) in Ihren xt:Commerce Shop zu integrieren.

Sie können das Plugin kostenlos unter folgender URL im xt:Commerce Shop herunterladen:

https://shop.4tfm.de/xtcommerce-plugins/amazon-pay

Sollten Sie Probleme mit der Installation haben, nutzen Sie unseren Amazon Pay Installationsservice

Funktionen

  • Kunden können sich mit Ihrem Amazon-Konto im Shop anmelden und die Zahlung mit den im Amazon-Konto hinterlegten Zahlungsarten durchführen
  • Die Adressen aus dem Amazon-Konto können bequem als Versandadressen ausgewählt werden
  • tfm_amazon_payments_v2 ist mit allen gängigen Zahlungsplugins für xt:Commerce (einschließlich PayPal-Plus) kompatibel.
  • Den Versand an Paketstationen können Sie deaktivieren, wenn Sie dieses nicht anbieten
  • Bei erfolgreicher Zahlung erfolgt über die Schnittstelle eine Meldung an Ihren Shop, der Bestellstatus wird entsprechend der Konfiguration angepasst
  • Zahlungsgebühren können identisch zu anderen xt:Commerce Zahlungsarten erhoben werden.
  • Kompatibel mit tfm_payment_disable (Zahlungsarten für bestimmte Produkte deaktivieren)
  • *Neu in V2* Wenn Sie (mit dem Plugin xt_ship_and_track) die Sendungsnummer im Shop hinterlegen, wird der Kunde per Voice über Alexa über den Status der Bestellung auf dem laufendem gehalten.
  • *Neu in V2* Reduzierung der Schritte, die Kunden durchlaufen müssen um einen Kauf abzuschließen
  • *Neu in V2* Verbessertes Pasing der Adressdaten
  • *Neu in V2* Amazon Pay lässt sich nun auch im normalen Checkout(, nachdem sich der Kunde bereits im Shop registriert hat) als Zahlungsart auswählen.

Die Umstellung von Version 1 auf Version 2 geht im Handumdrehen:

Systemvoraussetzungen

  • Mindestens xt:Commerce 5.0.00
  • Ein gültiger Amazon Merchant Account (zur Registrierung), der für “Amazon Pay” aktiviert wurde.
  • Ihre Domain muss über ein SSL-Zertifikat verfügen.
  • Mindestens php-Version 5.6, sowie eine aktuelle Version des IonCube Loaders
YouTube

Mit dem Laden des Videos akzeptieren Sie die Datenschutzerklärung von YouTube.
Mehr erfahren

Video laden

Frank Thelen – 35% Steigerung der Conversion-Rate mit Amazon Pay

Screenshots von Amazon Pay in xt:Commerce

In xt:Commerce 6

Amazon Pay - Loginbox
Amazon Pay - Registrierseite
Amazon Pay - Warenkorb Button
Amazon Pay - Anmelden bei Amazon
Amazon Pay - Zahlungsart bei Amazon wählen
Amazon Pay - Bestellbestätigung

Neue Features

Amazon Pay - Schnellkauf via Produktseite

Kunden können bequem über den Schnellkauf von den Produktseiten aus die Produkte per Amazon kaufen.

Amazon Pay - Alternative Auswahl im normalen Checkout

Nun können Ihre Kunden auch ohne sich in den Shop mit Amazon einzuloggen Ihre Bestellung per Amazon bezahlen.

Integration

Vorbereitungen in der Seller Central:

Amazon Pay Checkou v2 Public/Private Key Pair generieren

Erstellen Sie sich einen Amazon Seller Central-Konto bzw. loggen Sie sich in Ihr bestehendes Konto ein.

Für den Fall, dass Sie sich ein neues Konto erstellt haben, folgen Sie zunächst den Anweisungen zur Freischaltung des Kontos auf der Startseite.

Danach gehen Sie wie folgt vor:

  1. Wählen Sie oben mittig im Auswahlfeld “Amazon Pay (Produktionsansicht)” aus.
  2. Navigieren Sie in Integration > Integration Central
  3. Wählen Sie unter “Wählen Sie Ihre E-Commerce-Lösung aus” “xt:Commerce”
  4. Klicken Sie unter “API-Schlüssel erstellen” auf “Schlüssel erstellen”
  5. Lassen Sie “API-Anmeldeinformationen generieren” ausgewählt und geben Sie dem API-Schlüssel eine sinnvolle Bezeichnung.
  6. Wenn Sie dieses mit einem Klick auf “Schlüssel erstellen” bestätigen, wird eine “.pem”-Datei heruntergeladen. Speichern Sie die Datei für einen späteren Schritt.
  7. Klicken Sie danach unter “Vorhandene API-Schlüssel” auf den Knopf “Details anzeigen” bei dem Schlüssel den Sie zuvor erstellt haben.
  8. Laden Sie die zweite Datei mit den Zugangsdaten mit einem Klick auf “JSON-Datei herunterladen” herunter.

Diese beiden Dateien werden später beim Plugin-Setup im Shop benötigt. Speichern Sie diese daher temporär.

Hinweis: In Multishop-Installationen benötigen Sie je Installation in der Amazon Pay aktiviert werden soll je eine .pem-Datei, sowie eine JSON-Datei.

Videoanleitung

Amazon Pay Checkou v2 Public/Private Key Pair generieren

YouTube

Mit dem Laden des Videos akzeptieren Sie die Datenschutzerklärung von YouTube.
Mehr erfahren

Video laden

Plugin Installation:

Laden Sie das 4TFM Amazon-Payments-Plugin im xt:Commerce Store herunter und entpacken Sie die Dateien.

Danach können Sie das Plugin wie gewöhnlich in Ihrem xt:Commerce Shop installieren. Eine generell gültige Anleitung finden Sie hier.

Aktivieren Sie das Plugin mit der Option “Status” und nutzen Sie die Plugin-Option “Aktiviert für diesen Shop” und “Amazon Login für Shop aktivieren”, um das Plugin für die jeweiligen Mandanten zu aktivieren. Laden Sie danach den Adminstrationsbereich “xtAdmin” mit der F5 -Taste neu

Navigieren Sie danach im xt:Commerce Backend in Plugins -> Amazon Payments V2.

Auf der Seite müssen für jeden Mandanten jeweils die API-Schlüssel-Datei hochladen und die API-Daten einfügen:

Hier finden Sie eine Anleitung zum finden der API-Daten bzw. zum generieren der API-Schlüssel-Datei

1. API-Schlüssel-Datei:

Klicken Sie auf “API-Private Key hochladen” und wählen Sie die .pem-Datei aus, die Sie in der Sellercentral generiert haben.

2. API-Daten einfügen:

Klicken Sie auf “Einstellungen konfigurieren” und kopieren Sie den Json-Konfigurationsstring in das Feld und speichern Sie.

(Hinweis: Diesen Daten können Sie auch alternativ in Einstellungen -> Zahlungsarten -> tfm_amazon_payments_v2(bearbeiten) hinterlegen)

Name in xt:CommerceName in der Sellercentral
Store ID"Store-ID"
Public key"Public Key-ID"
Merchant ID"Händler-ID"

Händler-URL

Wählen Sie oben mittig in der Auswahl “Amazon Pay (Produktionsansicht) – EUR” aus.

Navigieren Sie dann in der SellerCentral nach “Einstellungen (oben rechts) => Integrationseinstellungen“. Hier finden Sie die Option “Händler-URL“. Hinterlegen Sie hier die URL mit dem Postfix “/index.php?page=callback&page_action=tfm_amazon_payments_v2“.

Beispiel:

Sollte Ihr Shop unter der URL https://mystore.com/ installiert sein, hinterlegen Sie “https://mystore.com/index.php?page=callback&page_action=tfm_amazon_payments_v2“, damit Amazon den Shop über den Status der Zahlung benachrichtigen kann.

Hinweis: In Multishop-Installationen hinterlegen Sie bitte die URL des primären Mandanten.

Amazon Payment Konfiguration

Prüfen Sie alle Optionen der Zahlungsweise und setzen Sie die gewünschten Werte:

Alle Optionen des Amazon Pay Plugins im Überblick

NameHinweis
ShopnameHinterlegen Sie hier einen Wert, der den Kunden Ihren Shop identifizieren lässt, z.B.: "mein-shop.de - Mustermann GmbH" (Der Wert wird im Login-Fenster bei Amazon angezeigt)
Cart Button SelectorIn dem Feld, muss ein CSS-Selector hinterlegt werden, der den "In den Warenkorb"-Knopf auf der Produktdetail-Seite erfasst. In den meisten xt_responsive-basierten designs sollte "form[name^=product] button[type='submit']" (inkl. Anführungszeichen) funktionieren, welches wir auch als Standard hinterlegt haben. (Sollten Sie "Amazon Knopf in Produkt Details" deaktivieren, spielt die Option keine Rolle)
Amazon Knopf in Produkt DetailsIst die Option aktiv, wird der Express-Kauf-Knopf in den Produktdetails Ihres Shops angezeigt.
Knopf DesignMit der Option können Sie das Aussehen der Amazon-Knöpfe bestimmen.
Sandbox Mode:

Sie können die Integration im Sandbox Modus testen ohne echte Buchungen vorzunehmen.

Wichtig:

Bitte beachten Sie, dass Sie hierzu vorher einen Test-Kundenaccount in der Sellercentral erstellen müssen. (Siehe auch: "Amazon Integration testen") Wenn Sie diesen Wert ändern, d.h. vom Sandbox in den Live-Modus wechseln oder umgekehrt, müssen Sie sich aus dem FE Ihres Shops ausloggen und den lokalen Browser-Cache leeren (STRG+F5)

Lieferungen an Packstationen im Checkout ablehnen:Sollten Sie diese Option aktivieren, kann der Kunde keine Lieferadresse verwenden, die das Wort "Packstation" (oder Variationen) enthält.
Region:Wählen Sie mit dieser Option aus, ob ein Britisches oder Deutsches Amazon Merchant-Konto verwendet wird.
Bestellstatus - openDen hier hinterlegten Bestellstatus erhalten die Bestellungen beim Bestellvorgang, die per Amazon bezahlt wurden.
Bestellstatus - Zahlung komplettAuf diesen Status wird die Bestellung geändert, wenn die Zahlung erfolgreich eingezogen wurde.
Bestellstatus - Zahlung autorisierung angestoßenDen hier hinterlegten Bestellstatus erhalten die Bestellungen beim Bestellvorgang, wenn die Autorisierung bei Amazon angefragt wurde
Bestellstatus - Zahlung abgeschlossenDen hier hinterlegten Bestellstatus erhalten die Bestellungen beim Bestellvorgang, wenn Zahlung erhalten wurde
Bestellstatus - Zahlung abgebrochenDen hier hinterlegten Bestellstatus erhalten die Bestellungen beim Bestellvorgang, wenn die Zahlung vom Kunden abgebrochen wurde
Bestellstatus- Zahlung abgelehntDen hier hinterlegten Bestellstatus erhalten die Bestellungen beim Bestellvorgang, wenn die Zahlung von Amazon abgelehnt wurde
Bestellstatus - Zahlung gescheitertDen hier hinterlegten Bestellstatus erhalten die Bestellungen beim Bestellvorgang, wenn die Zahlung gescheitert ist
Store IDAmazon API-Daten
Public keyAmazon API-Daten
Merchant IDAmazon API-Daten

Amazon Pay Template Integration

Hinweis: Bei folgenden Anweisungen gehen wir davon aus, dass Sie ein Template mit dem Name “xt_responsive” nutzen. Sollte der Name Ihres Designs abweichen, müssen Sie die Anpassungen natürlich in dem gleichnamigen Ordner vornehmen.

1. Login-Button in Login Box:

(Die Anpassung ist nur bei xt:Commerce 5.1 und kleiner notwendig, ab 6.0 ist diese bereits in Ihrem Template enthalten)

Öffnen Sie die Datei “templates/xt_responsive/xtCore/boxes/box_loginbox.html

Suchen Sie das letzte schließende “div” ( </div> ), fügen Sie davor folgenden Code ein:

Erklärung: Durch diesen Hook-Punkt wird in der Login-Box von xt:Commerce ebenfalls der “Login mit Amazon”-Knopf angezeigt. Nicht jedes Shop-Template nutzt diese Box und nicht jeder Shop-Betreiber will diese Möglichkeit anbieten, daher ist dieser Schritt optional und Sie können entscheiden, ob Sie es durchführen wollen. (Sie haben ebenfalls die Möglichkeit, den Hook an einer beliebigen anderen Stelle in Ihrem Template zu integrieren, um den Knopf an anderen Stellen anzuzeigen.)

2. Login-Button in Login Seite:

(Die Anpassung ist nur bei xt:Commerce 6.2 und kleiner notwendig, ab 6.3 ist diese bereits in Ihrem Template enthalten)

Öffnen Sie die Datei “/templates/xt_responsive/xtCore/pages/login.html

Suchen Sie den Text “{$message}”, fügen Sie danach folgenden Code ein:

Erklärung: Durch diesen Hook-Punkt wird auf der Login & Registrieren-Seite von xt:Commerce die Möglichkeit hinzugefügt, sich direkt mit seinem Amazon-Konto im Shop zu registrieren bzw. einzuloggen.

3. xt_ship_and_track & Alexa Integration

Wenn Sie xt_ship_and_track nutzen, kann Amazon den Kunden per Alexa über den Status seiner Bestellung informieren.

Damit dieses geschieht, müssen Sie nur den folgenden Code in das HTML-Template der E-Mail “tracking_links” einfügen.

Wichtig: Fügen Sie den Code in die HTML-Version jeder Sprache in den Loop ein:

Der komplette Loop in der E-Mail sollte dann so aussehen:

4. Amazon Pay Logos einbinden

4.1 Damit Amazon Pay im Checkout mit Logo dargestellt wird, kopieren Sie die Datei tfm_amazon_payments_v2/images/amazon_payments.png (Plugin-Download) in den Ordner /media/payment/ in Ihren Shop.

4.2 Damit Amazon Pay in der Payment-Logo-Box (Footer bzw. Produktdetails) Angezeigt wird, kopieren Sie die Datei tfm_amazon_payments_v2/images/tfm_amazon_payments_v2.png (Plugin-Download) in den Ordner /templates/ihr-template/img/payments/  in den jeweiligen Ordner der Sprachen die in Ihrem Shop aktiviert sind.

D.h. wenn Sie das Design “xt_responsive” verwenden, und Ihr Shop in Deutsch und Englisch betrieben wird, in folgende Ordner:

  • /templates/xt_responsive/img/payments/de/
  • /templates/xt_responsive/img/payments/en/

5. Alexa Integration mit xt_ship_and_track einrichten

Öffnen Sie im Administrationsbereich Ihres Shops die Seite Plugins > Amazon Versender Mapping.

Prüfen Sie, ob der von Ihnen verwendete Versender korrekt zugeordnet ist, falls nicht holen Sie dieses nach.

(Ist alles korrekt eingestellt, erhält Amazon beim Versenden der xt_ship_and_track-E-Mails ggf. die Benachrichtigung den Kunden via Alexa zu informieren. Sie müssen Ihren Arbeitsablauf dahingehend nicht verändern.)

Alexa Integration mit Amazon Pay

Individuelle Amazon-Buttons implementieren

Wichtig:

  • Bei einer normalen Amazon-Pay Installation müssen Sie diesen Schritt nicht ausführen. Die Info wendet sich an Entwickler, die an individuellen Stellen in Ihren Programmierungen einen Amazon-Pay-Knopf einbinden wollen.
  • Die Funktion ist ab der Version 3.0.1 verfügbar.

Sie können die beiden Knöpfe mit dem einbinden von folgenden Codes nutzen:

Für Amazon-Login-Button:

Für Amazon-Checkout-Button:

Funktion:

Der “Login”-Button (siehe Parameter des Hooks) erlaubt es Kunden sich per Amazon einzuloggen. Beim Klick werden Sie zu Amazon weitergeleitet, loggen sich dort ein, und kommen danach zurück zum Shop auf die Seite auf der Sie zuvor auf den Knopf geklickt haben. (Der Knopf funktioniert im grunde identisch wie der “normale” Login-Knopf im Login-Modal vom xt:Commerce Shop)

Der “checkout”-Button (siehe Parameter des Hooks) erlaubt es Kunden sich per Amazon einzuloggen und dann die Zahlung vorzubereiten, also die Zahlungsart auszuwählen. Danach wird der Kunde auf die Bestellbestätigungsseite des Shops geleitet, auf der er die Bestellung abschließen kann.

Changelog

VersionRelease dateChanges
4.0.110.2023
  • Enfternen von error-Log-Funktion, die versehentlich im Plugin behalten wurde
  • Korrigieren von Funktion, die zum Logging eines Fehlers bei Bestellungen mit bereits erhaltenen Callbacks von Amazon geführt hat.
4.0.009/2023
  • Update Frameworks: Axios, Amazon Pay SDK
  • Implementierung von "APB-Flow": Es wird bei Kunden die sich zuvor im xt:Commerce-Shop angemeldet haben nun die Adresse direkt aus dem Shop verwendet
  • Div. kleinere Fehlerbehebungen
  • Support für php 8.2 hinzugefügt
3.1.206/2023
  • Update des Amazon SDK (Durch einen Fehler im von uns verwendeten Amazon SDK (Update mit 3.1.1) ist es bei einigen Shops nach dem Login oder dem Bestellabschluss zu einer weißen Seite gekommen.)
3.1.101/2023
  • Bugfix: In einigen Fällen wurden die Adressen einer Bestellung nicht im Kundenkonto angelegt
  • Kompatibilität mit xt:Commerce 6.5 hergestellt
3.0.811/2022
  • Encoding für php 8.1
3.0.608/2022
  • Detail-Daten zur Zahlung werden nun von Amazon an den Shop übertragen und in der Tabeller "xt_orders" im Feld "amazon_payments_v2_payment_descriptor" im Shop gespeichert. Die Daten können dementsprechend in Mails, Bestellhistorie etc. angezeigt werden. Im Amazon Checkout werden die Daten bereits auf der Checkout-Confirmation-Seite angezeigt
3.0.4
  • Mehrere kleinere (kosmetische) Fehlerbehebungen, die aus den letzten Anpassungen entstanden sind
3.0.106/2022
  • Implementieren von Hook, um Custom-Buttons in externe Plugins zu implementieren
  • "Shopname (Option der Zahlungsart)" wird nun auf 49 Zeihen beschnitten um keinen Fehler zu Verursachen
3.0.0
  • Implementierung verschiedener Anpassungen, damit die neue Zahlungsart "Zahlung per Finanzierung" (via Amazon) genutzt werden kann.
  • Implementieren von besseren Fallback auf EN, falls Shopsprache nicht von Amazon Pay unterstützt wird
2.6.0
  • reorganisation der Adressgenerierung bei Kunden-Login & Kunden-Checkout;
  • Einbinden div. Hooks
  • Deaktivieren von Cache auf Amzon-Checkout-Confirmation-Seite
  • Hinzufügen von .md-File
2.3.316.06.2021
  • Verbesserung des Callback-Response-Code’s
2.3.106.05.2021
  • Erweitertetes Error-Reporting jetzt initial deaktiviert
2.3.031.03.2021
  • XT-924 - Logging ist jetzt deaktivierbar
  • XT-926 - Knopf in Produktdetails ignoriert nicht mehr allow_add_to_cart
  • XT-923 - Capture bei "on_shipping" funktioniert jetzt ordnungsgemäß
  • XT-896 - Versandarten Blacklisting wird nun unterstützt
  • XT-914 - Logging erweitert um eine extrem selten auftretende Ungereimtheit besser untersuchen zu können.
2.2.004.11.2020
  • Fehlerbehebung: Adresse-Ändern-Knopf in Checkout-Confirmation-Seite funktioniert bei komplett digitalen Warenkörben jetzt korrekt
  • Textanpassungen
  • SQL-Fehler bei der Verwendung von älteren PPP-Versionen behoben
2.1.619.10.2020

Release-Version des Plugins