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.
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
.Wählen Sie in der Liste E-Commerce-Anbieter oder Integrationstyp den Eintrag Oxid (CV2).
Wählen Sie Anleitung anzeigen.
Unter Anleitung für OXID erscheint die Schaltfläche Leitfaden für Oxid (CV2).Wählen Sie unter Client-IDs/Store-IDs verwalten den Link Client-ID/Store-ID erstellen.
Um eine Store-ID anzulegen, speichern Sie unter Store-ID hinzufügen die folgenden Daten:
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 Shopnamen ein, den Sie unter erfasst haben.
URL der Datenschutzrichtlinie: Geben Sie die URL der Datenschutzrichtlinie ein, die Sie unter angelegt haben (beispielsweise https://meinshop.de/Datenschutz).
Navigieren Sie zurück zur Seite Integration Central
Die Store-ID und die Händler-ID werden in den gleichnamigen Anzeigefeldern angezeigt.Wählen Sie unter API-Schlüssel erstellen die Schaltfläche Schlüssel erstellen.
Das Dialogfenster API-Schlüssel erzeugen erscheint.Stellen Sie sicher, dass der Auswahlknopf API-Anmeldeinformationen generieren markiert ist.
Geben Sie im Feld API-Schlüssel benennen einen Namen (ohne Sonderzeichen) ein, beispielsweise OXIDeShopSandbox.
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.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
Unter API-Anmeldedaten angezeigt:
Store-ID
Händler-ID
Unter Vorhandene API keys angezeigt: ID des öffentlichen Schlüssels
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.
Geben Sie die Zugangsdaten in die folgenden Eingabefelder ein:
Eingabefeld Privater Schlüssel: 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: Public Key-ID wie angzeigt auf der Integration central-Seite.
Eingabefeld Händler-ID: Händler-ID wie angzeigt auf der Integration central-Seite.
Eingabefeld Amazon-Client-ID: Store-ID wie angzeigt auf der Integration central-Seite.
Speichern Sie Ihre Einstellungen.
Resultat
Ihre Eingaben werden geprüft, das Modul ist aktiv.
Im Anzeigefeld IPN-Endpunkt wird der Webhook angezeigt.
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
.Wählen Sie unter Sofortbenachrichtigungseinstellungen die Schaltfläche Bearbeiten.
Fügen Sie die URL aus dem Feld IPN-Endpunkt in das Eingabefeld Händler-URL ein.
Wählen Sie Aktualisieren.
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.
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.
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.