Hinweis

Wenn du aktuell Probleme mit diesem Fehler hast, beachte bitte Punkt 7.5

1. Überblick Zahlungsablauf

2. Plugin-Setup

2.1 Plugin-Installation

2.2 Amazon Pay Account anlegen

2.3 Einrichtung in Sellercentral und Zugangsdaten

2.3.1 Login-Einstellungen

Wechsle hierfür in die Integration Central:
Ganz unten findest du die Möglichkeit, deine Client-IDs und Store-IDs zu verwalten. Lege dort eine neue Konfiguration an und fülle die vorhandenen Felder entsprechend deinen Anforderungen aus. Bitte beachte dabei, dass Name und Beschreibung für deine Kunden sichtbar sind. Zwei Angaben sind für die Integration mit plentymarkets obligatorisch, nämlich "Zulässige JavaScript-Ursprünge" und "Zulässige Rückleitungs-URLs". Diese sind entsprechend des folgenden Screenshots auszufüllen. Ersetze dafür www.domain.com mit deiner Shop-Domain:

Zulässige JavaScript-Ursprünge:

https://www.domain.com/

Zulässige Rückleitungs-URLs:

https://www.domain.com/amazon-login-processing/ https://www.domain.com/amazon-login-processing (mit und ohne den Slash am Ende, um Fehler bei veränderter Shop-URL-Konfiguration zu vermeiden) Wenn du weitere URL-Varianten in deinem Shop hast, die z.B. ein Kürzel für die Sprache enthalten, solltest du diese ebenfalls eingeben. Wenn du weißt, wie die Browser-Konsole zu benutzen ist, kannst du auch darüber die Rückleitungs-URL abfragen. Sie befindet sich in der JS-Variable amazonLoginAndPay.urls.amazonLoginProcessing:

Weitere Hilfe dazu gibt es in diesem Dokument von Amazon.

2.3.2 MWS Zugangsdaten

2.3.3 IPN (Sofortbenachrichtigung)

Die Einrichtung der IPN (Instant Payment Notification = Sofortbenachrichtigung) ermöglicht es, dass dein plentymarkets-System in Echtzeit über Statusänderungen einer Zahlung informiert wird. Wähle dazu den Menüpunkt Einstellungen » Integrationseinstellungen und hinterlege bei "Händler-URL" https://www.domain.com/amazon-ipn/ (www.domain.com bitte durch deine Shop-Domain ersetzen)

2.3.4 Zugangsdaten im plentymarkets-Plugin hinterlegen

Nachdem zu alles konfiguriert hast, findest du deine Zugangsdaten unter Integration » MWS Access Key. Diese sind entsprechend in die Plugin-Konfiguration zu kopieren. Bitte achte dabei darauf, dass du nicht versehentlich Leerzeichen am Anfang oder Ende mit kopierst.

2.4 Weitere Plugin-Konfiguration

2.4.1 Grundeinstellungen

Status

Erlaubt es, das Plugin vorübergehend zu deaktivieren

Sandbox

Schaltet das Plugin in den Sandbox-Modus. Dabei werden keine echten Zahlungen ausgelöst. Bitte beachte, dass es für den Sandbox-Modus in Sellercentral eigene Konfigurationsmöglichkeiten gibt und du zum Testen keine echten Amazon-Accounts verwenden kannst, sondern dir einen eigenen Testaccount in Sellercentral anlegen musst.

Buttons verstecken (debug)

Versteckt die Buttons im Frontend mit CSS (display:none), sodass du im Frontend testen kannst, ohne dass deine Kunden beeinträchtigt werden.

Wenn möglich Amazon-Login im Popup

Das Amazon-Login-Formular kann entweder in einem Popup präsentiert werden oder per Weiterleitung mit anschließender Rückleitung in deinen Shop.

Art der Autorisierung

Hiermit kannst du einstellen, wann die Autorisierung der Zahlung durchgeführt werden soll. Wenn du keine besonderen Anforderungen hast, solltest du es hier bei der Standard-Einstellung belassen. (siehe hierzu auch 1. und 3.1)
Bei Auswahl der Standard-Einstellung versucht das Plugin, die Zahlung bereits während des Checkouts zu autorisieren, um den Kunden im Fall einer eindeutigen Ablehnung zur Auswahl einer anderen Zahlungsart zu bewegen. In Ausnahmefällen kann es sein, dass die Autorisierungsanfrage nicht eindeutig beantwortet werden kann. Dann wird die Bestellung trotzdem abgeschlossen und das Autorisierungsergebnis nachgereicht.

Art des Zahlungseinzugs

Hiermit kannst du einstellen, wann der Zahlungseinzug durchgeführt werden soll. In den allermeisten Fällen ist der Einzug per Ereignisaktion zum Zeitpunkt des Versands die beste Möglichkeit (siehe 3.2).
Bei Download-Produkten empfiehlt sich der Einzug direkt nach Autorisierung.

Auftragsstatus nach erfolgreicher Autorisierung

Hier kannst du eine Status-ID hinterlegen (z.B. 5.0). Diese wird nach erfolgreicher Autorisierung gesetzt, um zu signalisieren, dass die Ware versendet werden kann. Um die Warenbestandsautomatik zu nutzen, kannst du hier auch "4/5" eintragen, damit der Status je nach Bestand auf 4.0 oder 5.0 gesetzt wird.

Auftragsstatus bei Ablehnung des Zahlungsmittels, Kundenaktion notwendig (vorläufig abgelehnte Zahlungen)

Hier kannst du eine Status-ID hinterlegen (z.B. 3.x). Diese wird nach Ablehnung des Zahlungsmittels gesetzt, um zu signalisieren, dass eine Aktion zur Problemlösung notwendig ist. Der Kunde kann z.B. durch Auswahl eines anderen Zahlungsmittels bei Amazon den Auftrag noch nachträglich bezahlen. (siehe hierzu auch 4.)

Auftragsstatus bei vollständiger Ablehnung der Zahlung mit Amazon Pay (endgültig abgelehnte Zahlungen)

Hier kannst du eine Status-ID hinterlegen (z.B. 3.x). Diese wird bei vollständiger Ablehnung der Zahlung gesetzt. In diesem Fall solltest du Kontakt mit dem Kunden aufnehmen, um einen alternativen Zahlungsweg z.B. per Überweisung anzubieten. (siehe hierzu auch 4.)

Amazon Pay Vorgang bei komplettem Zahlungseinzug abschließen

Wenn diese Einstellung aktiviert ist, wird der Zahlungsvorgang nach Zahlungseinzug geschlossen. Nach dem Schließen sind keine weiteren Abbuchungen mehr möglich.

E-Mail-Adresse für Versandadresse verwenden

Wenn diese Einstellung aktiviert ist, wird die E-Mail-Adresse des Kunden in die Versandadresse aufgenommen (z.B. zur Übergabe an Paketdienste)

2.4.2 Style

3. Ereignisaktionen

3.1 Amazon Pay Zahlung autorisieren

3.2 Vollständiger Einzug der Amazon Pay Zahlung

Diese Ereignisaktion muss unbedingt eingerichtet werden, damit die Zahlung auch tatsächlich eingezogen wird. Sinnvoll ist eine Kopplung an den Versand, also z.B. an den Statuswechsel auf "[7] Warenausgang gebucht".

Das könnte z. B. so aussehen:

3.3 Amazon Pay Vorgang schließen

3.4 Erstattung der Amazon Pay Zahlung

Um dem Kunden seine Zahlung im Fall einer Gutschrift zu erstatten, z.B. bei einer Retoure, solltest du diese Ereignisaktion z.B. für den Statuswechsel einer Gutschrift oder die Anlage des Gutschriftdokuments einrichten. Die Aktion veranlasst eine Rückzahlung in Höhe der Gutschrift, die du angelegt hast.

Das könnte z. B. so aussehen:

4. E-Mails

5. Content Container und ShopBuilder

5.1 Content Container

5.2 ShopBuilder

<div class="amzLoginButton"></div>

<div class="amzPayButton"></div>

6. Loslegen

7. Häufige Fehler

7.1 {"error":{"message":"Internal Server error"}} bei Checkout

7.2 Dem Auftrag wird eine andere Zahlungsart zugeordnet

7.3 "Die gewählte Zahlungsweise ist für diesen Einkauf nicht verfügbar. Wählen Sie eine andere Zahlungsweise"

7.4 Ereignisaktionen funktionieren nicht, obwohl sie ausgelöst wurden

7.5 "We have noticed that you've been inactive for a while. For safety reasons, we have signed you out."

Dieser Fehler kommt von blockierten Cookies. Bitte überprüfe die EInstellungen in Ceres und eventuellen Cookie-Plugins. Insbesondere in Ceres muss die Einstellung "Nicht akzeptierte Cookies blockieren" unbedingt deaktiviert werden.
Wenn du zusätzlich das Cookie Bar Plugin nutzt, ist auch dort in den Einstellungen unter Allgemeines die Checkbox "Nicht registrierte Cookies blockieren" zu deaktivieren.

8. FAQ

Warum werden Aufträge nicht als "bezahlt" markiert, wenn ein Kunde mit Amazon Pay kauft?

Warum sind die Adressfelder manchmal falsch befüllt? (z.B. Straße als Firmenname)