Konfiguration
Machen Sie Amazon Pay betriebsbereit.
Grundsätzliches Vorgehen
Stellen Sie die Verbindung zu Ihrem Amazon-Händlerkonto her und aktivieren Sie das Modul.
Stellen Sie unter Betriebsmodus sicher, dass zum Konfigurieren und Testen Sandbox gewählt ist.
Die Betriebsart Sandbox ist nach dem Aktivieren standardmäßig eingestellt.Legen Sie unter Platzierung fest, wo Sie Amazon Pay-Schaltfläche anzeigen wollen.
Stellen Sie unter Performance sicher, dass Sie Amazon Pay nur für solche Produkte verwenden, die von Amazon zugelassen sind.
Prüfen Sie unter Zahlungsbereich und Zahlungsbereich die Konfiguration Ihrer Währungen und Lieferländer.
Optional: Konfigurieren Sie bei Bedarf unter Capture-Typ, dass Zahlungen verzögert ausgelöst werden sollen (beispielsweise bei Geschäftskunden).
Verknüpfen Sie Amazon Pay mit Ihren Versandarten und Versandkostenregeln und führen Sie Testzahlungen in der Amazon-Sandbox aus.
Wenn Sie Ihre Tests abgeschlossen haben, wechseln Sie unter Betriebsmodus in die Betriebsart Produktion.
Verbindung zum Amazon-Händlerkonto herstellen
Amazon-Zugangsdaten generieren
Generieren Sie die Amazon-Zugangsdaten, um Ihren OXID eShop mit Amazon zu verbinden.
Voraussetzungen
Sie haben ein Händler- oder Entwickler-Konto angelegt.
Wenn Sie bereits ein Amazon-Händler-Konto, können Sie darin ein Sandbox-Konto anlegen.
Wenn Sie mit einem Entwickler-Konto anfangen, können Sie Ihr Amazon-Händler-Konto später registrieren.
Weitere Informationen über das Registrieren eines Händler-Kontos oder eines Entwickler-Kontos finden Sie unter Register for Amazon Pay (developer.amazon.com/de/docs/amazon-pay-checkout/get-set-up-for-integration.html#1-register-for-amazon-pay).
Vorgehen
Melden Sie sich unter sellercentral-europe.amazon.com bei Seller Central an.
Wählen Sie Abb.: Integration Central wählen).
(Wählen Sie in der Liste E-Commerce-Anbieter oder Integrationstyp den Eintrag Oxid (CV2) (Abb.: Anleitung für OXID anzeigen, Pos. 1).
Wählen Sie Anleitung anzeigen (Abb.: Anleitung für OXID anzeigen, Pos. 2).
Unter Anleitung für OXID erscheint die Schaltfläche Leitfaden für Oxid (CV2), das heißt, Ihre Einstellungen stimmen (Abb.: Anleitung für OXID anzeigen, Pos. 3).Wählen Sie unter Client-IDs/Store-IDs verwalten den Link Client-ID/Store-ID erstellen (Abb.: Link Client-ID/Store-ID erstellen, Pos. 1).
Um eine Store-ID anzulegen, geben Sie unter Neue Amazon Pay Client-ID-/Store ID-Konfiguration erstellen (Abb.: Neue Amazon Pay Client-ID-/Store ID-Konfiguration erstellen) die folgenden Daten ein:
Name der App oder des Shops: Geben Sie einen öffentlich sichtbaren Namen Ihres OXID eShops ein.
Typischerweise geben Sie Ihren Firmennamen ein.Beschreibung: Geben Sie den Namen Ihres Oxid eShops ein, den Sie unter erfasst haben.
URL der Datenschutzrichtlinie: Geben Sie die URL der Datenschutzrichtlinie ein, die Sie unter angelegt haben (beispielsweise https://myshop.de/Datenschutz).
Wählen Sie Änderungen speichern.
Navigieren Sie zurück zur Seite Integration Central
Die Store-ID und die Händler-ID werden in den gleichnamigen Anzeigefeldern angezeigt (Abb.: Store-ID und Händler-ID anzeigen, Pos. 1, 2).Wählen Sie unter API-Schlüssel erstellen die Schaltfläche Schlüssel erstellen (Abb.: Store-ID und Händler-ID anzeigen, Pos. 3).
Das Dialogfenster API-Schlüssel erzeugen erscheint (Abb.: Dialogfenster API-Schlüssel erzeugen).Stellen Sie sicher, dass der Auswahlknopf API-Anmeldeinformationen generieren markiert ist (Abb.: Dialogfenster API-Schlüssel erzeugen, Pos. 1).
Geben Sie im Feld API-Schlüssel benennen (Abb.: Dialogfenster API-Schlüssel erzeugen, Pos. 2) einen Namen ein, beispielsweise Sandbox.
Möglich sind Buchstaben und Zahlen, aber keine Sonderzeichen (beispielsweise Leerzeichen).
Der API-Schlüssel-Name kann Ihnen helfen, API-Schlüssel zu unterscheiden, wenn Sie mehrere benutzen.
Beispiel: Um einen besseren Überblick über die Zahlungsvorgänge zu haben, legen Sie separate API-Schlüssel für Ihre verschiedenen Subshops an.Tip
Wenn Sie ein Entwicklerkonto benutzen, machen Sie das im Namen des API-Schlüssels kenntlich, damit Sie Verwechslungen vermeiden.
Wählen Sie Schlüssel erstellen.
Ein Schlüsselpaar wird erzeugt und der Private Key wird in einer PEM-Datei automatisch heruntergeladen (Abb.: PEM-Dateim im Download-Verzeichnis).Speichern Sie die PEM-Datei.
Resultat
Sie haben die Daten, die Sie im Folgenden zum Erstellen des Webhooks benötigen werden :
PEM-Datei mit privatem Schlüssel (Abb.: PEM-Dateim im Download-Verzeichnis)
Unter API-Anmeldedaten angezeigt:
Store-ID (Abb.: Daten zum Erstellen des Webhooks anzeigen, Pos. 1)
Händler-ID (Abb.: Daten zum Erstellen des Webhooks anzeigen, Pos. 2)
Unter Vorhandene API keys angezeigt: ID des öffentlichen Schlüssels (Abb.: Daten zum Erstellen des Webhooks anzeigen, Pos. 3)
Amazon Pay aktivieren
Aktivieren Sie das Amazon Pay - Online-Bezahldienst-Modul in jedem Subshop, in dem Sie das Modul nutzen wollen.
Vorgehen
Wählen Sie
.Wählen Sie das Modul OXPS :: Amazon Pay - Online-Bezahldienst und wählen Sie .
Resultat
Unter Amazon Pay als aktiv gekennzeichnet.
ist die ZahlungsartAmazon Pay-Webhook generieren
Generieren Sie mit Ihren Amazon-Zugangsdaten in Ihrem OXID eShop einen Webhook.
Voraussetzungen
Sie haben die bei Seller Central die Zugangsdaten erzeugt (siehe Amazon-Zugangsdaten generieren).
Vorgehen
Wählen Sie
.Stellen Sie sicher, dass Sie vor dem Testen unter Betriebsmodus die Betriebsart Sandbox eingestellt haben (Abb.: Daten zum Erstellen des Webhooks eingeben, Pos. 1).
Geben Sie die Zugangsdaten in die folgenden Eingabefelder ein:
Eingabefeld Privater Schlüssel (Abb.: Daten zum Erstellen des Webhooks eingeben, Pos. 2): Schlüssel aus der heruntergeladenen PEM-Datei
Note
Achten Sie darauf, auch Präfix und Suffix einzugeben (beispielsweise
-----BEGIN PRIVATE KEY-----
).Eingabefeld ID des öffentlichen Schlüssels (Abb.: Daten zum Erstellen des Webhooks eingeben, Pos. 3): Public Key-ID wie angezeigt auf der Integration central-Seite (Abb.: Daten zum Erstellen des Webhooks anzeigen, Pos. 3)
Eingabefeld Händler-ID (Abb.: Daten zum Erstellen des Webhooks eingeben, Pos. 4): Händler-ID wie angezeigt auf der Integration central-Seite (Abb.: Daten zum Erstellen des Webhooks anzeigen, Pos. 2)
Eingabefeld Amazon-Client-ID (Abb.: Daten zum Erstellen des Webhooks eingeben, Pos. 5): Store-ID wie angezeigt auf der Integration central-Seite (Abb.: Daten zum Erstellen des Webhooks anzeigen, Pos. 1)
Speichern Sie Ihre Einstellungen.
Resultat
Ihre Eingaben werden geprüft, das Modul ist aktiv.
Im Anzeigefeld IPN-Endpunkt wird der Webhook angezeigt (Abb.: IPN-Endpunkt anzeigen, Pos. 1).
IPN-Endpunkt bei Amazon registrieren
Registrieren Sie den Webhook Ihres OXID eShops in Ihrem Amazon-Händlerkonto oder Amazon-Entwickler-Konto.
Voraussetzungen
Sie haben einen Webhook generiert (siehe Amazon Pay-Webhook generieren).
Unter IPN-Endpunkt eine URL angezeigt.
wird im Feld
Attention
Ausbleibende Statusmeldungen
Wenn Sie die Funktionen von Amazon Pay auf einem dedizierten Testsystem getestet haben, dann ist die als IPN-Endpunkt angezeigte URL eine andere als die Ihres Produktionssystems.
Im Produktions-Betrieb würde Ihr OXID eShop mit dem IPN-Endpunkt des Testsystems keine Meldungen über den Status von Zahlungen der Kunden erhalten. Sie müssten den Status in Amazon Seller Central manuell prüfen.
Wenn Sie auf Produktions-Betrieb umstellen, stellen Sie sicher, dass Sie den IPN-Endpunkt Ihres Produktionssystems registrieren.
Vorgehen
Melden Sie sich unter sellercentral-europe.amazon.com bei Seller Central an.
Wählen Sie Abb.: Integrationseinstellungen wählen).
(Wählen Sie unter Sofortbenachrichtigungseinstellungen die Schaltfläche Bearbeiten (Abb.: Bearbeiten wählen).
Fügen Sie die URL aus dem Feld IPN-Endpunkt in das Eingabefeld Händler-URL ein (Abb.: IPN-Endpunkt registrieren, Pos. 1).
Wählen Sie Aktualisieren (Abb.: IPN-Endpunkt registrieren, Pos. 2).
Resultat
Ihr Amazon-Webhook ist registriert.
Note
Um zu prüfen, ob das Empfangen von Nachrichten über den Status von Zahlungsvorgängen funktioniert, müssen Sie Testzahlungen machen.
Währungen und Länder prüfen
Prüfen Sie, welche Währungen und Lieferländer Ihre Kunden zur Auswahl haben, wenn Sie Ihren Kunden Amazon Pay anbieten.
Zahlungsbereich
Passen Sie bei Bedarf die Konfiguration Ihrer Währungen oder Ihrer Zahlungsarten an.
Hintergrund
Im unten folgenden Konfigurationsschritt Optional: Korrekte Währungseinstellungen sicherstellen werden Sie sicherstellen, dass die Währungen, die Ihr OXID eShop unterstützt, übereinstimmen mit den Währungen, die Amazon Pay unterstützt.
Unter Zahlungsbereich wird das Ergebnis angezeigt. Das sind diejenige Währungen, die gleichzeitig von Amazon Pay unterstützt werden und die Sie in den Grundeinstellungen Ihres Oxid eShops konfiguriert haben.
Attention
Konversion gefährdet
Beispiel: Sie haben in Ihrem OXID eShop ungarische Forint als zulässige Währung konfiguriert.
Amazon Pay unterstützt den ungarischen Forint nicht. Wenn Ihr Kunde Forint als Währung wählt, wird deshalb die Amazon Pay-Schaltfläche nicht angezeigt.
Wenn es keine alternative Zahlungsart zum Bezahlen gibt, springt Ihr Kunde ab.
Passen Sie die Konfiguration Ihrer Währungen oder Ihrer Zahlungsarten an.
Vorgehen
Wenn Ihr Oxid eShop Währungen unterstützt, die Amazon Pay nicht unterstützt, dann haben Sie folgende Möglichkeiten:
Stellen Sie unter Amazon Pay die nötigen alternativen Zahlungsarten anbieten.
sicher, dass Sie neben
Um Ihren ausländischen Kunden das Bezahlen in lokaler Währung zu ermöglichen, könnten Sie beispielsweise Rechnungskauf anbieten.Entfernen Sie unter Amazon Pay unterstützt werden.
die Währungen, die nicht von
Kunden beispielsweise in Ungarn müssten mit Amazon Pay in Euro bezahlen.
Lieferbereich
Prüfen Sie, ob Amazon Pay die Länder unterstützt, in die Sie zu liefern bereit sind.
Stellen Sie bei Bedarf alternative Zahlungsarten bereit.
Attention
Konversion gefährdet
Unter
haben Sie konfiguriert, in welche Länder Ihr Oxid eShop liefern soll.Unter Lieferbereich wird angezeigt, welche Länder Sie in Ihrem Oxid eShop als mögliche Lieferländer konfiguriert haben und die gleichzeitig von Amazon Pay unterstützt werden (siehe Unterstützte Länder).
Das heißt: Von den Lieferadressen, die Ihr Kunde bei Amazon hinterlegt hat, werden Ihrem Kunden beim Bezahlen mit Amazon Pay nur diejenigen zur Auswahl angeboten, die in den Ländern liegen, die unter Lieferbereich angezeigt werden.
Es kann also passieren, dass die Amazon Pay-Schaltfläche angezeigt wird, aber der Kunde kann keine Lieferadresse wählen.
Um mit Amazon Pay bezahlen zu können müsste Ihr Kunde eigens eine andere Lieferadresse bei Amazon Adresse hinterlegen. Die Konversion ist gefährdet.
Stellen Sie deshalb alternative Zahlungsarten bereit, wenn Sie auch solche Kunden beliefern wollen, deren Lieferadressen in Ländern liegen, die nicht von Amazon Pay unterstützt werden.
Vorgehen
Wenn Sie wollen, dass Ihr Oxid eShop Lieferländer unterstützt, die von Amazon Pay nicht unterstützt werden, dann tun Sie Folgendes:
Wählen Sie
.Stellen Sie sicher, dass Sie neben Amazon Pay alternative Zahlungsarten anbieten, z.B. Rechnungskauf.
Speichern Sie Ihre Einstellungen.
Amazon Pay konfigurieren
Konfigurieren Sie Amazon Pay.
Platzierung: Amazon Pay-Schaltfläche anzeigen
Legen Sie fest, wo die Amazon Pay-Schalfläche erscheinen soll.
Um die Checkout-Seite müssen Sie sich nicht kümmern, dort steht die Amazon Pay-Schaltfläche Ihren Kunden immer zu Auswahl.
Vorgehen
Tun Sie Folgendes:
Wenn die Amazon Pay-Schalfläche auf den Produktdetailseiten erscheinen soll, markieren Sie das Kontrollkästchen Produktdetailseite.
Wenn die Amazon Pay-Schalfläche im Warenkorb sowie in der Warenkorb-Vorschau erscheinen soll, markieren Sie das Kontrollkästchen Warenkorb + Warenkorb-PopUp.
Speichern Sie Ihre Einstellungen.
Performance: Compliance sicherstellen
Stellen Sie sicher, dass Ihre Kunden keine Produkte mit Amazon Pay bezahlen, die bestimmten Beschränkungen unterliegen.
Verbotene Inhalte führen dazu, dass Amazon Ihr Amazon-Händler-Konto sperrt.
Standardmäßig geht Amazon davon aus, dass Ihre Produkte keinen Beschränkungen unterliegen.
Hintergrund
Amazon prüft, ob die Produkte, die Sie verkaufen, Sicherheits- und Konformitätsanforderungen erfüllen oder Beschränkung unterliegen.
In Deutschland gelten Beschränkungen beispielsweise für Zigaretten, Waffen oder Produkte, die den Nationalsozialismus verherrlichen.
Würden Kunden solche Produkte in Ihrem eShop kaufen und mit Amazon Pay bezahlen, dann würden diese Produkte in der Bestellhistorie der Amazon-Kunden erscheinen.
Wegen der möglichen Verletzung von Compliance-Regeln, könnten sich daraus für Amazon rechtliche Schwierigkeiten ergeben, für die Sie in Mithaftung gezogen werden könnten.
Prüfen Sie deshalb, ob einige Ihrer Produkte solchen Beschränkungen unterliegen, und schließen Sie diese Produkte von der Bezahlung mit Amazon Pay aus.
Note
Performance-Verminderung
Wenn Sie einzelne Produkte von der Bezahlung mit Amazon Pay ausschließen, dann führt Ihr OXID eShop bei jedem Seitenaufruf eine Datenbankabfrage durch.
Dadurch wird das Laden aller Seiten Ihres OXID eShops um einige Millisekunden verzögert.
Vorgehen
Wenn Sie das Gefühl haben, dass einige Ihrer Produkte zur Kategorie der verbotenen Produkte oder Inhalte gehören könnten, prüfen Sie Amazons Richtlinien zur akzeptablen Nutzung.
Wenn einige Ihrer Produkte tatsächlich nicht mit den Richtlinien von Amazon übereinstimmen, fahren Sie fort mit Schritt 2.Um Produkte oder Kategorien von der Bezahlung mit Amazon Pay ausschließen zu können, markieren Sie unter Performance das Kontrollkästchen „Amazon Pay ausschließen“ nutzen.
Speichern Sie Ihre Einstellungen.
Wählen Sie unter Amazon Pay ausschließen wollen.
oder den Artikel oder eine Kategorie, die Sie von der Bezahlung mit
Auf der Registerkarte Stamm finden Sie dazu das Kontrollkästchen Amazon Pay ausschließen.Markieren Sie das Kontrollkästchen Amazon Pay ausschließen.
Stellen Sie sicher, dass dem Produkt oder der Kategorie andere Zahlungsarten zugeordnet sind.Speichern Sie Ihre Einstellungen.
Resultat
Die Amazon Pay-Schaltfläche wird für das Produkt oder die Kategorie nicht angezeigt, Ihre Kunden müssen eine andere Zahlungsart wählen.
Capture-Typ: Reservierung festlegen
Legen Sie fest, ob für den eShop Zahlungen sofort eingezogen werden sollen, oder ob die Zahlungen nur reserviert werden sollen.
Beispiel
Typischerweise wird das Geld sofort eingezogen.
In bestimmten Fällen ist es sinnvoll, dass die Zahlung erst durch die Auslieferung ausgelöst wird:
Sie vertreiben bestimmte individualisierte Produkte, die Sie erst nach Eingang der Bestellung herstellen, in Auftrag geben oder bestellen.
Sie haben einen eShop für Geschäftskunden. Hier sind die Liefermengen und Zahlungsbeträge größer als bei Privatkunden.
Im Fall eines Fehler wäre das Retourenmanagement entsprechend schwieriger.
Deshalb wollen Sie sicherstellen, dass die Zahlung nur ausgelöst wird, wenn die Ware da oder auf dem Weg zum Versand ist.
Vorgehen
Sie haben unter Capture-Typ folgende Möglichkeiten:
Um Zahlungen direkt auszulösen, wählen Sie Einstufig.
Um die Zahlung nur zu reservieren und später auszulösen, wählen Sie Zweistufig.
Stellen Sie sicher, dass Sie die den individualisierten Produkten in Ihrem eShop nur die Zahlungsart Amazon Pay zugeordnet haben.
Die verzögerte Zahlung für Zahlungen mit Amazon Pay greift für alle Artikel in Ihrem eShop, denen Sie diese Zahlungsart zugeordnet haben.Speichern Sie Ihre Einstellungen.
Resultat
Wenn Sie für Zahlung mit Amazon Pay den Wert Zweistufig gewählt haben, wird die Zahlung ausgelöst,
automatisch: sobald Sie in Ihrem eShop den bestellten Artikel auf den Status Geliefert gesetzt haben
manuell: wenn Sie die Zahlung in Ihrem Seller Central-Händlerkonto unter
bestätigen
Optional: Korrekte Währungseinstellungen sicherstellen
Stellen Sie sicher, dass die Währungen, die Ihr OXID eShop unterstützt, übereinstimmen mit den Währungen, die Amazon Pay unterstützt.
Schiefgehen kann allerdings nichts: Bei Währungen, die Amazon Pay nicht unterstützt, wird lediglich die Amazon Pay-Schaltfläche nicht angezeigt.
Amazon Pay unterstützt folgende Währungen:
AUD
GBP
DKK
EUR
HKD
JPY
NZD
NOK
ZAR
SEK
CHF
USD
Vorgehen
Wählen Sie
.Expandieren Sie auf der Registerkarte Einstell. den Bereich Weitere Einstellungen.
Prüfen Sie in dem Eingabefeld für Währungen, ob Sie Währungen hinzufügen oder entfernen wollen.
Um eine saubere Konfiguration sicherzustellen, stellen Sie für die Zahlungsart Amazon Pay auf der Registerkarte Länder sicher, dass nur solche Länder zugeordnet sind, welche die von Amazon Pay unterstützten Währungen haben.
Resultat
Unter Zahlungsbereich werden diejenigen Währungen angezeigt, die gleichzeitig von Ihrem eShop und von Amazon Pay unterstützt werden (siehe Zahlungsbereich).
Amazon Pay testen und Live-Betrieb aktivieren
Testen Sie Amazon Pay in der Amazon Pay-Sandbox und passen Sie die Konfiguration an, bis alle Zahlungsprozesse nach Ihren Vorstellungen funktionieren.
Führen Sie dazu Testzahlungen in der Amazon Pay-Sandbox aus.
Empfehlung: Nutzen Sie zum Testen ein dediziertes Testsystem.
Wenn die Testzahlungen wunschgemäß funktionieren, schalten Sie in den Livebetrieb um.
Voraussetzungen
Wenn Sie Amazon Pay mit Ihrem Sandbox-Konto auf Ihrem Produktionssystem getestet haben, dann haben Sie Ihr Sandbox-Konto zu einem Amazon-Händler-Konto erweitert.
Dazu haben Sie in Ihrem Amazon-Sandbox-Konto unter den Link Schließen Sie Ihre Kontoregistrierung ab gewählt und die Registrierung abgeschlossen.Wenn Sie auf einem Testsystem getestet haben und Amazon Pay jetzt auf dem Produktionssystem in Betrieb nehmen, haben Sie mit Ihrem Amazon-Händler-Konto die folgenden Zugangsdaten generiert:
PEM-Datei mit privatem Schlüssel
Store-ID
Händler-ID
ID des öffentlichen Schlüssels
Weitere Informationen finden Sie unter Amazon-Zugangsdaten generieren.
Vorgehen
Attention
Ausbleibende Statusmeldungen
Wenn Sie die Funktionen von Amazon Pay auf einem dedizierten Testsystem getestet haben, dann ist die als IPN-Endpunkt angezeigte URL eine andere als die Ihres Produktionssystems.
Im Produktions-Betrieb würde Ihr OXID eShop mit dem IPN-Endpunkt des Testsystems keine Meldungen über den Status von Zahlungen der Kunden erhalten. Sie müssten den Status in Amazon Seller Central manuell prüfen.
Wenn Sie auf Produktions-Betrieb umstellen, stellen Sie sicher, dass Sie den IPN-Endpunkt Ihres Produktionssystems registrieren.
Konfigurieren Sie das Modul und testen Sie es.
Schalten Sie unter Betriebsmodus auf Produktion um.
Wenn Sie auf einem Testsystem getestet haben und Amazon Pay jetzt auf dem Produktionssystem in Betrieb nehmen, geben Sie die Zugangsdaten Ihres Amazon-Händler-Kontos ein.
Wiederholen Sie dazu die Schritte in Kapitel Amazon Pay-Webhook generieren.
Wenn Sie Ihr Sandbox aus einem bestehenden Händlerkonto generiert oder das Händlerkonto nachträglich registriert haben, dann müssen Sie die Zugangsdaten nicht neu eingeben.Wenn Sie auf einem Testsystem getestet haben und Amazon Pay jetzt auf dem Produktionssystem in Betrieb nehmen, registrieren Sie den IPN-Endpunkt Ihres produktiven OXID-eShops.
Wiederholen Sie dazu die Schritte in Kapitel IPN-Endpunkt bei Amazon registrieren.
Wenn Sie Amazon Pay mit Ihrem Sandbox-Konto auf Ihrem Produktionssystem getestet haben, dann müssen Sie den IPN-Endpunkt nicht erneut registrieren.
Stellen Sie trotzdem in jedem Fall sicher, dass der IPN-Endpunkt Ihres Produktionssystems bei Amazon registriert ist.Speichern Sie Ihre Einstellungen.
Resultat
Ihr Produktionssystem erhält von Amazon die Statusmeldungen über die Zahlungsvorgänge Ihrer Kunden.