Führen Sie folgende Schritte, um Amazon Pay zu akzeptieren.
Wenn Sie mit |
Das MWS-Autorisierungs-Token ist ein geheimes Token, mit dem sich im Namen Ihres Shops mit Amazon verbinden kann. Es ist wichtig, dieses Token zu generieren und es in Ihrem Onboarding-Prozess an
zu geben.
Sschritte,um das MWS-Autorisierungs-Token zu generieren


Die Notify URL wird von Amazon für asynchrone Antworten an das für Vorgänge wie Buchungen und Gutschriften verwendet. Sie müssen die
Notify URL für Ihren Shop im Konto Amazon Seller Central einrichten, um diese Benachrichtungen zu empfangen.

Um sich bei für Amazon Pay anzumelden, geben Sie die folgenden Informationen an. Beachten Sie, dass die folgenden Informationen für jeden Markt erforderlich sind, in dem Sie präsent sind.
Stellen Sie die Schaltfläche Amazon Pay auf Ihre Checkout-Seite dar. Verwenden Sie den folgenden Codeausschnitt als Referenz.
Verwenden Sie die folgende Tabelle als Referenz für Schaltflächenparameter, die übergeben werden können, um die Schaltfläche nach Ihrem Bedarf darzustellen.
Parameter der Schaltfläche | CND | Beschreibung | Zulässige Werte |
|---|---|---|---|
merchantId | M | Von Amazon ausgestellte Verkäufer-ID | |
ledgerCurrency | M | Ihre Hauptbuchwährung. Für EU-Konten kann bei der Authentifizierung/Buchungeine andere Darstellungswährung verwendet werden. | Zulässige Werte:
|
publicKeyId | M | Von Amazon bereitgestellter Key | |
| placement | M | Platzierung der Schaltfläche | Zulässige Werte: Cart |
buttonColor | O | Der Parameter buttonColor definiert die Farbe der Schaltfläche | Zulässige Werte: Gold, LightGray, DarkGray Standardwert 'Gold' |
| productType | O | Der Parameter productType definiert, ob die Transaktion für physische oder digitale Güter erfolgt. PayAndShip ist Standard. | Zulässige Werte:
|
checkoutLanguage | O | Der Parameter checkoutLanguage dient optional zur Definition der Sprache des Checkout-Prozesses. Dies ist insbesondere in einer mehrsprachigen Shop-Umgebung hilfreich. Ohne Angabe des Parameters Language verwendet Amazon automatisch die am besten geeignete Sprache für den Checkout. | Zulässige Werte:
|
Integrieren Sie Ihr Backend mit der -Schnittstelle, um die Nutzlast abzurufen und die Checkout-Sitzung mit Amazon initialisieren zu können. Um eine Zahlung mit Amazon Pay zu initialisieren, verwenden Sie bitte folgende URL:
|
|
Verschlüsselte Parameter zum Initialisieren einer Zahlung mit Amazon Pay
Händler können Beschränkungen festlegen, ob Adressen, die der Beschränkungskonfiguration entsprechen, beschränkt werden sollen oder nicht.
Um eine Adressbeschränkung zu senden, verwenden Sie den Parameter addressRestriction – json base64-codiert. Nachfolgend finden Sie die Übersicht der Datenelemente und das Schema:
Key | Format | CND | Beschreibung |
|---|---|---|---|
type | string | C | Gibt an, ob Adressen, die der Einschränkungskonfiguration entsprechen, eingeschränkt werden sollen oder nicht. Unterstützte Werte:
|
restriction | <countryCode:restriction> | C | Einschränkungen auf Länderebene, die bestimmen, welche Adressen basierend auf dem Typparameter eingeschränkt werden sollen oder nicht. CountryCode ist eine Zeichenfolge, die den Ländercode der Adresse im ISO 3166-Format darstellt. statesOrRegions: Liste der länderspezifischen Bundesstaaten, die basierend auf dem Typparameter eingeschränkt werden sollen oder nicht zipCodes: Liste der länderspezifischen Postleitzahlen, die basierend auf dem Typparameter eingeschränkt werden sollen oder nicht |
Schema
|
Zwischen-Antwortparameter nach dem Initialisieren einer Zahlung mit Amazon Pay
Sobald Sie die Checkout-Sitzung mit Amazon Pay mit der erweiterten Nutzlast initialisiert haben, wird der Kunde zu Amazon weitergeleitet, um sich anzumelden und Zahlungsmethode und Versanddaten auszuwählen. Sobald der Kunde den Schritt abgeschlossen hat, sendet die Zahlungsmethode und die Versanddetails an die ShopUrl, die Sie in der ursprünglichen Anfrage übergeben haben. Verwenden Sie diese Daten, um die Überprüfungsseite in Ihrem Shop darzustellen.
|
Auf der Überprüfungsseite sollte der Kunde bei Bedarf seine Zahlungsmethode und Versanddetails aktualisieren können.
Verwenden Sie amazon.Pay.bindChangeAction(), um Klickereignisse an HTML-Elemente auf Ihrer Seite zu binden. Mit dem Parameter changeAction können Sie angeben, ob der Käufer die Versandadresseoder die Zahlungsmethode bearbeitet. Nachfolgend finden Sie die JavaScript-Beispiele zu Ihrer Information. Ausführliche Informationen finden Sie in der Amazon-Dokumentation.
Wenn es während der Überprüfung zu Betragsänderungen kommt, z. B. zu einer Betragsänderung aufgrund zusätzlicher Versandkosten, oder wenn Sie Warenkorb-Updates auf der Überprüfungsseite unterstützen, müssen die Informationen sowohl im als auch im Amazon-System aktualisiert werden.
Um den Betrag bei Amazon Pay zu ändern, verwenden Sie bitte folgende URL:
|
|
Parameter zum Ändern des Betrags einer Amazon-Pay-Zahlung
|
Antwort-Parameter zum Ändern des Betrags einer Amazon-Pay-Zahlung
Hinweis: Stellen Sie sicher, dass Sie die letzte Schaltfläche „Bezahlen“ erst darstellen oder aktivieren, wenn Sie eine erfolgreiche Antwort für das Ereignis „UpdateAuthorizeAmount“ erhalten haben.
Aktivieren Sie die letzte Schaltfläche „Bezahlen“, damit der Kunde die Kaufabwicklung bei Amazon abschließen kann. Nach erfolgreichem Abschluss gibt Ihnen das eine Antwort an URLSuccess/URLFailure und URLNotify. Nachfolgend finden Sie die Parameter dieser Antwort.
|
Finale Antwortparameter für eine Amazon-Pay-Zahlung
Mehrfache Teilbuchungen werden derzeit nicht unterstützt. |
Um eine autorisierte Zahlung mit Amazon Pay zu buchen, verwenden Sie bitte folgende URL:
|
Die folgenden Tabellen beschreiben die Übergabeparameter und Rückgabewerte, die über die Socket-Verbindung ausgetauscht werden. Der Ablauf der Server-zu-Server-Kommunikation ist im Handbuch Programmiergrundlagen beschrieben.
|
Verschlüsselte Parameter zur Buchung einer autorisierten Amazon-Pay-Zahlung
|
Antwort-Parameter nach Buchung einer autorisierten Amazon-Pay-Zahlung
Nach einer Buchung erhalten Sie eine Benachrichtigung an die angegebene URLNotify mit den folgenden Parametern:
|
Antwort-Parameter für URLNotify nach Buchung einer autorisierten Amazon-Pay-Zahlung
Um eine gebuchte Zahlung mit Amazon Pay wieder gutzuschreiben, verwenden Sie bitte folgende URL:
|
Die folgenden Tabellen beschreiben die Übergabeparameter und Rückgabewerte, die über die Socket-Verbindung ausgetauscht werden. Der Ablauf der Server-zu-Server-Kommunikation ist im Handbuch Programmiergrundlagen beschrieben.
|
Verschlüsselte Parameter zur Gutschrift einer Amazon-Pay-Zahlung
|
Antwort-Parameter nach Gutschrift einer autorisierten Amazon-Pay-Zahlung
Nach einer Gutschrift erhalten Sie eine Benachrichtigung an die angegebene URLNotify mit den folgenden Parametern:
|
Antwort-Parameter für URLNotify nach Gutschrift einer Amazon-Pay-Zahlung
Um eine komplette Bestellung mit Amazon Pay mit der Funktion „CancelOrderReference“ zu stornieren, verwenden Sie bitte folgende URL:
|
Die folgenden Tabellen beschreiben die Übergabeparameter und Rückgabewerte, die über die Socket-Verbindung ausgetauscht werden. Der Ablauf der Server-zu-Server-Kommunikation ist im Handbuch Programmiergrundlagen beschrieben.
|
Verschlüsselte Parameter zum Stornieren einer Amazon-Pay-Zahlung
|
Antwort-Parameter nach Stornierung einer Amazon-Pay-Zahlung
Um eine wiederkehrende Zahlung mit Amazon Pay einzurichten, übermitteln Sie zusätzlich zu der in Schritt 6 oben beschriebenen Standardanfrage die folgenden Daten.
Key | Format | CND | Beschreibung |
|---|---|---|---|
| RTF | ans1 | M | I = Anfangszahlung einer Serie |
| cycle | an..7 | M | Zyklus. Unterstützte Werte: 'Year', 'Month', 'Week', 'Day', 'Variable' |
| Value | n..4 | M | Anzahl der Frequenzeinheiten pro Abrechnungszyklus. Um beispielsweise einen wöchentlichen Zyklus anzugeben, legen Sie die Einheit auf Week und den Wert auf 1 fest. Wenn Sie eine variable Einheit verwenden, müssen Sie den Wert auf 0 setzen.
|
| InstallmentAmount | n..10 | C | Transaktionsbetrag – wählen Sie Null, wenn es sich nicht um einen festen Betrag handelt |
| Currency | a3 | C | Transaktionswährungscode im Format ISO 4217, zum Beispiel: EUR |
|