Bezahlen über Amazon Implementierungshandbuch

22.02.2013 - aws-key-pair. Befolgen Sie diese Schritte, um die Signatur ...... (Belgien, Dänemark, Frankreich. (Festland), Deutschland, Irland,. Luxemburg ...
383KB Größe 2 Downloads 39 Ansichten
Bezahlen über Amazon Implementierungshandbuch XML-basierter Button-Code und Einkaufswagen

DE Version 09.05.2013

| Inhalt | 3

Inhalt Tabellenverzeichnis......................................................................................................................... 5 Bezahlen über Amazon im Überblick...........................................................................................7

Wer sollte dieses Dokument lesen?..................................................................................................................... 7 Voraussetzungen................................................................................................................................................... 7 Ihre Aufgaben bei der Verwendung von Bezahlen über Amazon....................................................................... 7 Letzte Änderungen in diesem Dokument.............................................................................................................8

Kapitel 1: "Bezahlen über Amazon"-Konto konfigurieren................................. 9

Registrierung bei Bezahlen über Amazon..........................................................................................................10 Bei Ihrem "Bezahlen über Amazon"-Konto anmelden...................................................................................... 10 Melden Sie sich bei Seller Central an....................................................................................................10 Ihre Sandbox- und Produktiv-Einstellungen...................................................................................................... 10 Zwischen Produktiv-Modus und Sandbox-Modus umschalten..............................................................12 Ihr Konto und Ihre Informationen und Richtlinien............................................................................................12 Ihre Kontoeinstellungen einrichten.........................................................................................................12 Ihre Informationen und Richtlinien konfigurieren................................................................................. 13 Ihre Einstellungen zum Bestellprozess...............................................................................................................14 Rückgabe-URLs einstellen..................................................................................................................... 14 Einkaufswagen-Sicherheit aktivieren..................................................................................................... 15 Integration-URLs festlegen.....................................................................................................................15 Bestellbericht: Art und Häufigkeit einstellen.........................................................................................15 Grundeinstellungen für Versandarten und Werbeaktionen in Seller Central.....................................................16 Versandkosten in Seller Central einstellen.............................................................................................16 Werbeaktionen in Seller Central konfigurieren..................................................................................... 16 Benutzerberechtigungen für Ihr Seller-Central-Konto einstellen.......................................................................17 Erster Schritt: Der Konto-Administrator sendet eine Einladung........................................................... 18 Zweiter Schritt: Der Benutzer erhält den Bestätigungscode.................................................................. 18 Dritter Schritt: Der Benutzer loggt sich bei Seller Central ein und generiert ein Konto........................18 Vierter Schritt: Der Kontoadministrator legt die Benutzerberechtigungen fest..................................... 18 E-Mail-Whitelist einrichten................................................................................................................................ 18 Whitelist konfigurieren........................................................................................................................... 19 MWS-Keys erhalten............................................................................................................................................19 Ihre MWS-Keys erhalten........................................................................................................................19 Käuferkonto konfigurieren..................................................................................................................................19 Käuferkonto konfigurieren......................................................................................................................20

Kapitel 2: Bezahlen über Amazon integrieren.................................................... 21

Schritte zur Integration von Bezahlen über Amazon in Ihre Website............................................................... 22 Berührungspunkte bei der Integration................................................................................................................22 Sandbox einrichten..............................................................................................................................................23 Aktuelles XML-Schema herunterladen.................................................................................................. 23 Sandbox-Einkaufswagen mittels XML...................................................................................................23 Einkaufswagen signieren........................................................................................................................ 24 Einkaufswagen base64-kodieren.............................................................................................................25 Signatur zum Einkaufswagen-Code hinzufügen.................................................................................... 27 Sandbox-Button-Code in Ihre Testseite einfügen.................................................................................. 28 Sandbox-Button mittels Testbestellung testen....................................................................................... 29 Produktiv-Modus einrichten............................................................................................................................... 30

| Inhalt | 4

Einkaufswagen für den Produktiv-Modus mittels XML erzeugen........................................................ 30 Einkaufswagen signieren........................................................................................................................ 31 Einkaufswagen base64-kodieren.............................................................................................................32 Signatur zum Einkaufswagen-Code hinzufügen.................................................................................... 34 Produktiv-Button-Code in Ihre Testseite einfügen................................................................................ 34 Produktiv-Button mittels Testbestellung testen......................................................................................36 Im Produktiv-Modus aufgegebene Bestellung stornieren...................................................................... 36 Produktiv-Button-Code in Ihre Website einfügen..................................................................................37 Zusätzliche Tipps zur Einrichtung..................................................................................................................... 38

Kapitel 3: Abrechnungen verarbeiten.................................................................. 41 Kapitel 4: Nach der Einrichtung.......................................................................... 43

Abschlusskriterien............................................................................................................................................... 44 Zehn Testtransaktionen-Typen........................................................................................................................... 44 Bestelloptionen für Testtransaktionen................................................................................................................ 44

Kapitel 5: Einkaufswagen und Button anpassen.................................................45 Einkaufswagen-Überschreibungen nutzen..........................................................................................................46 Versandkosten überschreiben................................................................................................................. 46 Werbeaktionen überschreiben.................................................................................................................51 Flexible Versandoptionen................................................................................................................................... 55 Darstellung bei Ihrem Kunden............................................................................................................... 55 Bestellungen aus Händlersicht................................................................................................................55 Service-Ebenen und benutzerdefinierte Versandoptionen......................................................................57 Flexible Versandoptionen bei XML-basierten Einkaufswagen nutzen.................................................. 58 Flexible Versandoptionen und die Instant Order Processing Notification API..................................... 59 Flexible Versandoptionen mit der Callback-API nutzen....................................................................... 59 Button-Stile anpassen..........................................................................................................................................59 Zusätzliche Funktionen von Bezahlen über Amazon........................................................................................ 59

Anhang A: Code-Beispiele..................................................................................... 61

Bestellmanagement über den Amazon Marketplace Web Service (MWS)....................................................... 62 Callback-API....................................................................................................................................................... 62 Instant Order Processing Notification API........................................................................................................ 62

Anhang B: Button-Stile..........................................................................................63 Weißer Hintergrund............................................................................................................................................ 64 Heller Hintergrund.............................................................................................................................................. 64 Dunkler Hintergrund...........................................................................................................................................65

Anhang C: XML-Schema und Definitionen........................................................ 67

Definitionstabelle................................................................................................................................................ 68

| Tabellenverzeichnis | 5

Tabellenverzeichnis Tabelle 1: In der Sandbox und im Produktiv-Modus verfügbare Funktionen................................ 11 Tabelle 2: Einfache HTML-Einkaufswagen-Elemente...................................................................23 Tabelle 3: Tags, die bei der Erzeugung eines singierten Einkaufswagen-Codes genutzt werden... 24 Tabelle 4: Signatur-Werte und Keywords...................................................................................... 27 Tabelle 5: Einfache HTML-Einkaufswagen-Elemente...................................................................30 Tabelle 6: Tags, die bei der Erzeugung eines singierten Einkaufswagen-Codes genutzt werden... 31 Tabelle 7: Signatur-Werte und Keywords...................................................................................... 34

Bezahlen über Amazon im Überblick Willkommen zum Standard-Bestellprozess-XML-Implementierungshandbuch Dieser Abschnitt beschreibt, wer dieses Handbuch lesen sollte, wie das Handbuch aufgebaut und gibt außerdem einen Überblick über andere zu Bezahlen über Amazon gehörende Hilfsmittel.

Wer sollte dieses Dokument lesen? Dieses Dokument enthält alle Informationen, die Sie benötigen, um Bezahlen über Amazon in Ihre Website zu integrieren. Bevor Sie mit der Integration beginnen, müssen Sie sich für eine Integrationsmethode entscheiden: Möchten Sie über die "Button generieren"-Seite in Seller Central einen einzelnen Button generieren, oder möchten Sie HTML- oder XML-basierten Code für die Generierung eines Einkaufswagens verwenden? • • •

Falls Sie die "Button generieren"-Seite für die Integration von Bezahlen über Amazon nutzen möchten, dann lesen Sie bitte das Handbuch Standard-Integration: "Bezahlen über Amazo"n-Button generieren Falls Sie Bezahlen über Amazon integrieren möchten, indem Sie Ihren eigenen HTML-basierten Code erzeugen, dann lesen Sie bitte das Handbuch Standard-Integration: HTML-Implementatierungshandbuch. Falls Sie Bezahlen über Amazon integrieren möchten, indem Sie Ihren eigenen XML-basierten Code erzeugen, dann fahren Sie bitte fort, dieses Dokument zu lesen.

Voraussetzungen Dieses Handbuch setzt voraus, dass Sie oder Ihr Entwickler-Team mit der Nutzung von HTML und XML in einer Programmentwicklungsumgebung vertraut sind. Bevor Sie Bezahlen über Amazon nutzen können, müssen Sie die folgenden Voraussetzungen erfüllen: •

• • •

Sie müssen einen Einkaufswagen auf Ihrer Seite haben und ihn für eine Verarbeitung mittels XML verfügbar machen. (D.h., ganz egal, welche Software/Programmiersprache Sie verwenden, um Ihren Einkaufswagen zu erzeugen, müssen Sie in der Lage sein, die Daten des Einkaufswagen für die Verarbeitung via XML zu versenden.) Sie müssen mit der Nutzung von JavaScript vertraut sein. (Es gibt verschiedene erforderliche JavaScriptCodebausteine, die Sie in Ihre Einkaufswagen-Programmierung einfügen müssen, um die Standard-Integration durchzuführen) Ihr Einkaufswagen-XML-Code muss die XMLNS namens http://payments.amazon.com/checkout/2009-05-15 verwenden, wenn er für die Verarbeitung abgeschickt wird. Sie müssen die order.xsd mit dem Dateidatum 2009-05-15 oder neuer verwenden. (Diese Version hier herunterladen.)

Ihre Aufgaben bei der Verwendung von Bezahlen über Amazon Sie müssen vier grundlegende Aufgaben erledigen, wenn Sie Bezahlen über Amazon auf Ihrer Website verwenden: 1. 2. 3. 4.

Konfigurieren Sie Ihr "Bezahlen über Amazon"-Konto. Vervollständigen Sie Ihre Einstellungen in Seller Central. Integrieren Sie Bezahlen über Amazon in Ihre Website. Testen Sie Ihre Integration und geben Sie diese frei.

Dieses Dokument erklärt Ihnen, wie Sie diese Aufgaben bewältigen können.

| Bezahlen über Amazon im Überblick | 8

Letzte Änderungen in diesem Dokument Letzte Änderungen Version Datum

Änderungen

1.7.5

2013-02-22

Hinweis zu Einkaufswagen für den ProduktivModus mittels XML erzeugen auf Seite 30 and Sandbox-Einkaufswagen mittels XML auf Seite 23 hinzugefügt, dass / (Schrägstrich) im Item Title-Wert nicht erlaubt ist.

1.5

04.10.2011

Abschnitt "Bekannte Probleme" hinzugefügt

1.4.1

05.11.2010

Link zur order.xsd in Abschnitt Aktuelles XMLSchema herunterladen auf Seite 23 geändert.

1.3

15.09.2010

Überarbeitung wegen geänderter BestellprozessFunktionalität

1.1

30.06.2010

Überarbeitung wegen geänderter Funktionalität der Website von Amazon Payments

1.0

14.02.2010

Dokument erstmalig veröffentlicht

Copyright © 2010-2012 Amazon.de GmbH oder Partner.

Kapitel

1

"Bezahlen über Amazon"-Konto konfigurieren Themen: • • • • • •

• • • •

Registrierung bei Bezahlen über Amazon Bei Ihrem "Bezahlen über Amazon"-Konto anmelden Ihre Sandbox- und ProduktivEinstellungen Ihr Konto und Ihre Informationen und Richtlinien Ihre Einstellungen zum Bestellprozess Grundeinstellungen für Versandarten und Werbeaktionen in Seller Central Benutzerberechtigungen für Ihr Seller-Central-Konto einstellen E-Mail-Whitelist einrichten MWS-Keys erhalten Käuferkonto konfigurieren

Wenn Sie Ihr "Bezahlen über Amazon" in Seller Central einrichten, sollten Sie sechs erforderliche Aufgaben ausführen (sowie drei optionale, aber empfohlene Aufgaben). In diesem Abschnitt erfahren Sie alles über die folgenden erforderlichen Aufgaben: 1. 2. 3. 4. 5. 6.

"Bezahlen über Amazon"-Konto registrieren. Zwischen Sandbox- und Produktiv-Modus wechseln. Ihre Informationen und Richtlinien konfigurieren. Ihre Einstellungen zum Bestellprozess konfigurieren. Grundeinstellungen für Versandkosten und Werbeaktionen festlegen. Käuferkonto registrieren.

Sie finden außerdem Informationen zu den folgenden optionalen, aber empfohlenen Aufgaben: 1. Rollenbasierte Berechtigungen einrichten. 2. Die Whitelist Ihres E-Mail-Programms konfigurieren, so dass Sie E-Mails von Amazon Payments immer empfangen können. 3. Ihre MWS Security Keys für signierte Einkaufswagen herunterladen.

| "Bezahlen über Amazon"-Konto konfigurieren | 10

Registrierung bei Bezahlen über Amazon Damit Sie Bezahlen über Amazon in Ihre Website integrieren können, müssen Sie ein eigenes "Bezahlen über Amazon"-Konto registrieren. Falls Sie sich noch nicht bereits bei Bezahlen über Amazon registriert haben, dann lesen Sie bitte das Handbuch Erste Schritte mit Bezahlen über Amazon (PDF). Es enthält alle Informationen, die Sie für die Registrierung benötigen.

Bei Ihrem "Bezahlen über Amazon"-Konto anmelden Nachdem Sie sich bei Bezahlen über Amazon registriert haben, können Sie Ihre Konto-Zugangsdaten (E-MailAdresse und Passwort) verwenden, um sich bei Seller Central zur Verwaltung Ihres Kontos anzumelden. Seller Central ist die "Homepage" Ihres Kontos. Hier richten Sie die Grundeinstellungen für Ihr Konto ein, wie z. B. Ihre Informationen und Richtlinien oder Ihren Bestellprozess. In Seller Central können Sie die folgenden Aktionen durchführen: • • • •

Zwischen Sandbox- und Produktiv-Modus wechseln Bestellungen einsehen und abwickeln Ihre Zahlungen einsehen Ihre Kontoeinstellungen ändern

Melden Sie sich bei Seller Central an Sie melden sich bei Seller Central an, wenn Sie Ihre Bestellungen verwalten, Ihre Berichte einsehen oder Ihre Kontoeinstellungen verwalten möchten. Hinweis: Sie können außerdem eine Programmiersprache verwenden, um Ihre Bestellungen zu verwalten oder Ihre Berichte auszuwerten. Für weitere Informationen dazu lesen Sie bitte Bestellungen verwalten. Befolgen Sie diese Schritte, um sich bei Seller Central anzumelden: 1. Öffnen Sie https://sellercentral-europe.amazon.com in Ihrem Browser. Sie sehen die Anmeldeseite für Seller Central: Abbildung 1: Seller-Central-Anmeldeseite 2. Geben Sie Ihre Zugangsdaten für Seller Central ein (die E-Mail-Adresse und das Passwort, die Sie bei der Registrierung für Bezahlen über Amazon angegeben haben). 3. Klicken Sie auf Anmelden. Sie sehen die Startseite von Seller Central: Abbildung 2: Seller Central Startseite Für weitere Informationen zur Nutzung von Seller Central lesen Sie bitte Seller Central verwenden.

Ihre Sandbox- und Produktiv-Einstellungen Nachdem Sie sich bei Seller Central angemeldet haben, können Sie Ihre Kontoeinstellungen ändern. Bevor Sie mit der Einrichtung Ihres Kontos beginnen, ist es wichtig, dass Sie den Unterschied zwischen dem Sandbox-Modus und dem Produktiv-Modus verstehen. •

Sie nutzen die Sandbox, um Ihre Einrichtung und Ihren Code zu testen. Nichts, was Sie in der Sandbox tun, generiert bezahlte Bestellungen.

| "Bezahlen über Amazon"-Konto konfigurieren | 11

Sie nutzen den Produktiv-Modus, um Bestellungen zu generieren. Alles, was Sie im Produktiv-Modus tun, wird wie eine normale Bestellung behandelt - Sie müssen diese innerhalb von 30 Tagen entweder versenden oder stornieren.



Der Hauptunterschied zwischen Sandbox und Produktiv-Modus besteht darin, dass alles, was Sie in der Sandbox machen, keine Bestellung generieren kann und dass Ihre Zahlungsarten in der Sandbox nie belastet werden. Das bedeutet: Sie können im Sandbox-Modus einen Artikel "kaufen", aber die Zahlungsart, die Sie dafür verwenden, wird niemals für diesen Kauf belastet. Wenn Sie einen Artikel im Produktiv-Modus kaufen, dann geben Sie eine echte Bestellung auf, die Sie entweder verschicken oder stornieren müssen. Wichtig: Sie können nicht Ihr Händlerkonto verwenden (das Konto, das Sie für den Login in Seller Central nutzen), um eine Bestellung im Produktiv-Modus aufzugeben. Falls Sie Bestellungen im Produktiv-Modus aufgeben möchten, um den Bestell- und Versandprozess zu testen, müssen Sie ein gesondertes Käuferkonto anlegen. Lesen Sie Käuferkonto konfigurieren auf Seite 19 für weitere Informationen zur Einrichtung und Nutzung eines Käuferkontos. Diese Tabelle illustriert die Funktionen, die in der Sandbox und im Produktiv-Modus verfügbar sind. Tabelle 1: In der Sandbox und im Produktiv-Modus verfügbare Funktionen Funktion

Sandbox

Produktiv

Hinweise

Bestellungen generieren

Ja

Ja

Funktionelle* "Bezahlen über Amazon"-Buttons generieren

Ja

Ja

* "Funktionell" bedeutet, dass Sie den Button anklicken können und durch den Bestellprozess geleitet werden.

Bestellung unter Nutzung einer Zahlungsart generieren

Ja

Ja

Sie können auch in der Sandbox eine Zahlungsart nutzen, diese wird allerdings nie belastet.

Bestellungen einsehen

Ja

Ja

Alle im Sandbox-Modus aufgegebenen Bestellungen werden als "Ausstehend" markiert.

Bestellungen versenden

Nein

Ja

Alle im Sandbox-Modus aufgegebenen Bestellungen werden als "Ausstehend" markiert. Ausstehende Bestellungen können nicht verschickt werden.

Feedback zu einer Bestellung abgeben

Nein

Ja

Bestellung als Käufer stornieren

Ja

Ja

Bestellung als Händler stornieren

Nein

Ja

Zahlungsart für die Bestellung belasten lassen

Nein

Ja

Bestellberichte einsehen und herunterladen

Nein

Ja

Wenn Sie Ihr Konto einrichten, müssen Sie die Einstellungen für die Sandbox und den Produktiv-Modus gesondert vornehmen. Dazu müssen Sie zwischen dem Produktiv-Modus und dem Sandbox-Modus in Seller Central umschalten. Hinweis:

| "Bezahlen über Amazon"-Konto konfigurieren | 12

Wenn Sie Ihr "Bezahlen über Amazon"-Konto zum ersten Mal einrichten, befinden Sie sich automatisch im Produktiv-Modus. Sie müssen explizit in den Sandbox-Modus wechseln. Der von Ihnen gewählte Modus (Produktiv oder Sandbox) ist fest eingestellt, d.h., wenn Sie einen Modus wählen, sich bei Seller Central abmelden und später wieder anmelden, ist der zuvor gewählte Modus unverändert eingestellt.

Zwischen Produktiv-Modus und Sandbox-Modus umschalten Befolgen Sie diese Schritte, um zwischen dem Produktiv-Modus und dem Sandbox-Modus umzuschalten. 1. Suchen Sie die Website-Drop-down-Box links oben. Abbildung 3: Die Website-Drop-down-Box 2. Klicken Sie auf die Website-Drop-down-Box, um die verfügbaren Websites anzuzeigen: Abbildung 4: Die Website-Drop-down-Box mit der Ansicht der verfügbaren Websites. 3. Um den Produktiv-Modus zu wählen, klicken Sie auf payments.amazon.de. 4. Um den Sandbox-Modus zu wählen, klicken Sie auf payments-sandbox.amazon.de.

Ihr Konto und Ihre Informationen und Richtlinien Für Ihr "Bezahlen über Amazon"-Konto gibt es zwei verschiedene Kontoeinstellungen, die Sie einrichten sollten, bevor Sie Ihre ersten Bestellungen akzeptieren. • •

Ihre Kontoeinstellungen: Wird verwendet, um Ihre Kontoeinstellungen zu konfigurieren, die wir nutzen, um Transaktionen durchführen zu können, wie z.B. Ihr Firmenname oder Ihre Bankkontoinformationen. Ihre Informationen und Richtlinien: Wird benutzt, um die Informationen über Ihr Unternehmen zu konfigurieren, die Ihre Kunden sehen, wie z.B. Ihr Widerrufsrecht. Hinweis: Stellen Sie sicher, dass Sie in den korrekten Modus wechseln, bevor Sie diese Einstellungen vornehmen. Um mehr über den Wechsel zwischen den verschiedenen Modi zu erfahren, lesen Sie bitte den Abschnitt Ihre Sandbox- und Produktiv-Einstellungen.

Ihre Kontoeinstellungen einrichten Auf der Seite Kontoinformationen können Sie die folgenden Einstellungen ändern: Benachrichtigungseinstellungen • • • • •

Bestellbenachrichtigungen Benachrichtigung über ausverkaufte Artikel Aktualisierung der Geschäftsdaten Benachrichtigungen über Ansprüche (E-Mail-Adresse) Technische Benachrichtigungen (E-Mail-Adresse)

Geschäftsdaten • • • • •

Ihr angezeigter Geschäftsname Ihr rechtlicher Geschäftsname E-Mail-Adresse Kundenservice Antwort-E-Mail-Adresse Kundenservice Telefonnummer Kundenservice

| "Bezahlen über Amazon"-Konto konfigurieren | 13

Geschäftsprofil • • • • • •

Art des Unternehmens Geschäftskategorie URL der Website Gründungsdatum Voraussichtlicher Umsatz/Monat Durchschnittliche Transaktionssumme

Bankkontoinformationen Wichtig: Es ist erforderlich, dass Sie Ihre Bankkontoinformationen auf Ihrer Kontoeinstellungen-Seite im Produktiv-Modus eingeben - wir können Sie nicht bezahlen, wenn Sie kein Bankkonto eintragen. Wichtig: Amazon Payments kann verlangen, dass Sie ein Mindestguthaben (bzw. eine Rücklage) auf dem Konto haben, damit Sie Ihren Zahlungsverpflichtungen nachkommen können. Lesen Sie bitte das Hilfethema zu den Rücklagerichtlinien von Amazon Payments für weitere Informationen dazu, wie diese Rücklage berechnet und verwaltet wird. Hinweis: Wenn Sie Ihre Bankkontoinformationen ändern, werden alle Auszahlungen automatisch für 14 Tage ausgesetzt. Lesen Sie auch Wie oft bekomme ich die Auszahlungen? für weitere Informationen. Kreditkarten-Informationen (auswählen oder aktualisieren) Hinweis: Sie können die Informationen im Bereich Kreditkarten zwar einsehen, aber nicht ändern. Falls Sie Ihre Kreditkarten-Informationen ändern oder eine neue Kreditkarte hinzufügen möchten, dann öffnen Sie die folgende Seite und befolgen Sie die Anweisungen: https://www.amazon.de/gp/css/account/cards/view.html Befolgen Sie diese Schritte, um Ihre Kontoinformationen zu konfigurieren: 1. Prüfen Sie, ob Sie den korrekten Modus ausgewählt haben: Sandbox oder Produktiv. Hinweis: Stellen Sie sicher, dass Sie in den korrekten Modus wechseln, bevor Sie diese Einstellungen vornehmen. Um mehr über den Wechsel zwischen den verschiedenen Modi zu erfahren, lesen Sie bitte den Abschnitt Ihre Sandbox- und Produktiv-Einstellungen. 2. Klicken Sie in Seller Central auf Einstellungen > Kontoinformationen. Die Seite Kontoinformationen wird angezeigt: Abbildung 5: Die Seite Kontoinformationen 3. Prüfen Sie, ob die Informationen zu Ihrem Unternehmen, Ihr Geschäftsprofil, Ihre Bankkontoinformationen und Ihre Kreditkarten-Informationen korrekt sind. Um die Informationen zu ändern, klicken Sie auf den Ändern-Button im jeweiligen Bereich, machen die notwendigen Änderungen und klicken auf Aktualisieren.

Ihre Informationen und Richtlinien konfigurieren Auf der "Ihre Informationen und Richtlinien"-Seite können Sie die folgenden Informationen über Ihr unternehmen ändern. Diese Informationen werden im Bestellprozess angezeigt: Seitenlink

Verwendet für

Impressum & Info zum Verkäufer

Erzählen Sie Ihren Kunden etwas über sich selbst.

Firmenlogo

Fügen Sie Ihr Firmenlogo in einer Größe von 120 x 30 Pixel hinzu (GIF, JPG oder PNG).

Widerrufsrecht

Hinterlegen Sie Ihr Widerrufsrecht.

Versand

Standardmäßig wird die Seite "Versand" mit Ihren Versandkosten im Bestellprozess angezeigt. Die Versandkosten werden dabei von der "Seller Central"Seite "Versandkosteneinstellungen" übernommen.

| "Bezahlen über Amazon"-Konto konfigurieren | 14

Seitenlink

Verwendet für Zusätzlich können Sie diese Seite nutzen, um Ihre Versandrichtlinien zu erklären.

Datenschutzrichtlinie

Hinterlegen Sie Ihre Datenschutzrichtlinie.

Häufig gestellte Fragen

Tragen Sie alle häufig gestellten Fragen und die zugehörigen Antworten ein.

Benutzerdefinierte Hilfeseiten

Fügen Sie beliebige zusätzliche Hilfeseiten ein, die Sie Ihren Kunden anzeigen möchten, um ihnen weitere Informationen zum Bestellprozess zu geben.

Wichtig: Änderungen, die Sie auf den Seiten unter "Ihre Informationen und Richtlinien" vornehmen, werden in ca. 24 Stunden veröffentlicht. Befolgen Sie diese Schritte, um Ihre Informationen und Richtlinien zu konfigurieren: 1. Prüfen Sie, ob Sie den korrekten Modus ausgewählt haben: Sandbox oder Produktiv. Hinweis: Stellen Sie sicher, dass Sie in den korrekten Modus wechseln, bevor Sie diese Einstellungen vornehmen. Um mehr über den Wechsel zwischen den verschiedenen Modi zu erfahren, lesen Sie bitte den Abschnitt Ihre Sandbox- und Produktiv-Einstellungen. 2. Klicken Sie in Seller Central auf Einstellungen > Ihre Informationen und Richtlinien. Die "Ihre Informationen und Richtlinien"-Seite wird angezeigt: Abbildung 6: Die "Ihre Informationen und Richtlinien"-Seite. 3. Klicken Sie auf die Seiten, die Sie ändern möchten, nehmen Sie Ihre Änderungen vor und klicken Sie anschließend auf Speichern. Beachten Sie: Wenn Sie eine Seite anlegen möchten, die noch nicht existiert, dann können Sie diese unter "Benutzerdefinierte Hilfeseiten" erstellen.

Ihre Einstellungen zum Bestellprozess Mit Bezahlen über Amazon können Sie die folgenden Einstellungen zum Bestellprozess festlegen: • • • • •

URL für erfolgreiche Bezahlungen eintragen (die Seite, die Ihr Kunde angezeigt bekommt, nachdem er die Bestellung abgeschlossen hat). URL für stornierte Bezahlungen eintragen (die Seite, die Ihr Kunde angezeigt bekommt, wenn er den Bestellvorgang vorzeitig abbricht). URL für die Kontoinformationen Ihres Kunden eintragen (die Seite, auf der Sie Ihren Kunden die Informationen zu deren Konto anzeigen). Festlegen, ob nur signierte Einkaufswagen akzeptiert werden (das sind Einkaufswagen-Codes mit einer zuvor berechneten Signatur). URL für die Instant Order Processing Notifications eintragen (nützlich, wenn Sie die IOPN-API nutzen, lesen Sie dazu auch dasHandbuch zur Instant Order Processing Notification API.

Rückgabe-URLs einstellen Befolgen Sie diese Schritte, um die drei Rückgabe-URLs einzustellen. Hinweis: Die Rückgabe-URL Ihres Kontos zeigt auf eine Seite Ihrer Website, auf der Sie Ihren Kunden die Informationen zu ihren Konten anzeigen. Kunden können auf der Seite Mein Konto bei Amazon Payments (https://payments.amazon.de/overview) ihren Bestellstatus für alle Bestellungen, die über Bezahlen über Amazon vorgenommen wurden, einsehen. 1. Klicken Sie in Seller Central auf Einstellungen > Einstellungen zum Bestellprozess.

| "Bezahlen über Amazon"-Konto konfigurieren | 15

2. 3. 4. 5. 6.

Die Seite "Einstellungen zum Bestellprozess" wird angezeigt. Klicken Sie auf den ersten Ändern-Button auf der Seite (der Button, der neben der Überschrift "Einstellungen zum Bestellprozess" zu sehen ist). Geben Sie im Feld URL zur Weiterleitung nach Abschluss des Bestellprozesses die URL der Seite ein, auf die Ihre Kunden weitergeleitet werden sollen, nachdem Sie die Zahlung erfolgreich abgeschlossen haben. Geben Sie im Feld URL zur Weiterleitung bei Abbruch des Bestellvorgangs die URL der Seite ein, auf die Ihre Kunden weitergeleitet werden sollen, nachdem Sie die Zahlung abgebrochen haben. Geben Sie im Feld URL zur Weiterleitung auf "Mein Konto"die URL der Seite ein, zu der Sie Ihre Kunden schicken wollen, wenn diese auf ihre Konten zugreifen möchten. Klicken Sie auf Aktualisieren.

Einkaufswagen-Sicherheit aktivieren Befolgen Sie diese Schritte, um die Einkaufswagen-Sicherheit zu aktivieren. Hinweis: Sie können sich immer dafür entscheiden, nur signierte Einkaufswagen zu akzeptieren, ganz egal, ob Sie einen einzelnen "Bezahlen über Amazon"-Button in Seller Central generiert haben, oder ob Sie HTML- oder XML-basierten Einkaufswagen-Code verwenden. Für weitere Informationen zum Signieren von "Bezahlen über Amazon"-Buttons, lesen Sie bitte Einkaufswagen signieren auf Seite 24. 1. Klicken Sie in Seller Central auf Einstellungen > Einstellungen zum Bestellprozess. Die Seite "Einstellungen zum Bestellprozess" wird angezeigt. 2. Klicken Sie auf den ersten Ändern-Button auf der Seite (der Button, der neben der Überschrift "Einstellungen zum Bestellprozess" zu sehen ist). 3. Klicken Sie neben "Einkaufswagensicherheit" auf Nur digital signierte Einkaufswagen akzeptieren, um die Einkaufswagensicherheit zu aktivieren (Häkchen gesetzt) oder zu deaktivieren (Häkchen entfernt). 4. Klicken Sie auf Aktualisieren.

Integration-URLs festlegen Falls Sie (oder Ihr Integrationsdienstleister/Entwickler) die Instant Order Processing Notifications nutzen, müssen Sie festlegen, wohin diese Benachrichtigungen gesendet werden sollen. Sie können diese entweder zu Ihrer eigenen Website, oder zur Website Ihres Integrationsdienstleisters senden lassen. Hinweis: Wählen Sie entweder Ihre eigene Website oder die Ihres Integrationsdienstleisters, aber nicht beide, sonst erhalten Sie mehrfache IOPN-Benachrichtigungen. 1. Klicken Sie in Seller Central auf Einstellungen > Einstellungen zum Bestellprozess. Die Seite "Einstellungen zum Bestellprozess" wird angezeigt. 2. Klicken Sie auf den ersten Ändern-Button auf der Seite (der Button, der neben der Überschrift "Einstellungen zum Bestellprozess" zu sehen ist). a) Geben Sie im Feld Händler-URL die URL auf Ihrer Website ein, an die Sie die Benachrichtigungen gesendet haben möchten. b) Oder geben Sie im Feld URL des Integrationsdienstleisters die URL auf der Website Ihres Integrationsdienstleisters ein, an die Sie die Benachrichtigungen gesendet haben möchten. 3. Klicken Sie auf Aktualisieren.

Bestellbericht: Art und Häufigkeit einstellen Sie können den Bestellbericht-Typ und die Sendehäufigkeit in Seller Central einstellen und diese Daten somit an Ihre Bedürfnisse anpassen. 1. Klicken Sie in Seller Central auf Einstellungen > Einstellungen zum Bestellprozess. Die Seite "Einstellungen zum Bestellprozess" wird angezeigt.

| "Bezahlen über Amazon"-Konto konfigurieren | 16

2. Klicken Sie auf den zweiten Ändern-Button auf der Seite (der Button, der neben der Überschrift "Einstellungen für Bestellberichte" zu sehen ist). Die Seite "Einstellungen für Bestellberichte" wird angezeigt. 3. Klicken Sie neben Bestellungsberichttyp den Berichttyp an, den Sie einstellen möchten. Falls Sie mit einem Integrationsdienstleister zusammenarbeiten, wird er Ihnen mitteilen, welche Option gewünscht ist. 4. Wählen Sie neben Bestellbericht-Zeitplan die gewünschte Frequenz aus. 5. Klicken Sie auf Aktualisieren.

Grundeinstellungen für Versandarten und Werbeaktionen in Seller Central Sie können für Ihr "Bezahlen über Amazon"-Konto Seller Central verwenden, um die Grundeinstellungen für die Versandkosten und Werbeaktionen festzulegen. Die Gebühren und Einstellungen, die Sie in Seller Central festlegen, kommen bei Käufen über Bezahlen über Amazon zum Einsatz. Wenn Sie diese Werte nicht anderweitig neu definieren (entweder, indem Sie diese in Ihrem ButtonCode überschreiben, oder indem Sie Callbacks einsetzen), werden diese Werte verwendet, um die Versandkosten und Werberabatte zu berechnen. Bezahlen über Amazon verfügt über einige wenige Standardeinstellungen, mit denen Ihr neues "Bezahlen über Amazon"-Konto angelegt wird. Es ist sinnvoll, diese Einstellungen zu prüfen, damit sie wissen, was auf Sie zukommt, wenn Sie Bestellungen über den "Bezahlen über Amazon"-Button akzeptieren. Wichtig: Wenn Sie planen, diese Gebühren und Einstellungen mithilfe einer Programmiersprache zu verwalten (indem Sie Einstellungen überschreiben, Callbacks oder eine Einkaufswagenlösung eines Drittanbieters verwenden), ist es ebenfalls sinnvoll, diese Einstellungen zu prüfen, denn wenn Bezahlen über Amazon Ihre per Programmiersprache vorgenommenen Einstellungen nicht verarbeiten kann, werden automatisch die Standard-Einstellungen aus Seller Central verwendet.

Versandkosten in Seller Central einstellen Führen Sie die nachfolgenden Schritte aus, um in Seller Central die Versandkosten zu prüfen und zu ändern. 1. Klicken Sie in Seller Central auf Einstellungen > Versandeinstellungen. Die Versandeinstellungen-Seite wird mit den aktuellen Einstellungen angezeigt. 2. Sie können die folgenden Einstellungen ändern: • • •

Legen Sie Ihr Versand-Modell fest (basierend auf Gewicht pro Artikel oder gestaffelter Preis) Stellen Sie Ihre Versandregionen und Versandoptionen fest. Legen Sie Ihre Versandkosten fest. Tipp: Vollständige Informationen zu den Versandkosten finden Sie unter Versandkosten und Einschränkungen konfigurieren in Seller Central. Hinweis: Wenn Sie die Versandkosten detaillierter definieren möchten, können Sie diese mithilfe einer Programmiersprache überschreiben oder Callbacks verwenden. Versandkosten, die Sie mithilfe einer Programmiersprache überschreiben oder durch Callbacks festlegen, ersetzen die Versandkosten, die in Seller Central eingestellt wurden.

Werbeaktionen in Seller Central konfigurieren Führen Sie die nachfolgenden Schritte aus, um in Seller Centrall die Werberabatte zu prüfen und zu ändern. 1. Klicken Sie in Seller Central auf Einstellungen > Werbeaktionen verwalten. Die Seite "Werbeaktionen verwalten" wird mit einer Übersicht über die aktuellen Werbeaktionen angezeigt. 2. Sie können die folgenden Einstellungen ändern:

| "Bezahlen über Amazon"-Konto konfigurieren | 17

• • • • •

Werberabatt mit einem festen Rabattbetrag hinzufügen. Werberabatt mit einem prozentualen Rabattwert hinzufügen. Werbeaktion mit kostenlosem Versand hinzufügen. Werberabatte mit gestaffelten Preisen festlegen. Werberabatt mit einer festen Preisreduzierung festlegen. Tipp: Vollständige Informationen zu "Werbeaktionen verwalten" finden Sie unter Werbeaktionen anbieten in Seller Central. Hinweis: Sie können Werbeaktionen in Seller Central, unter Nutzung Ihres eigenen Codes, oder mithilfe von Callbacks einstellen. Auch eine Kombination aus allen drei Optionen ist möglich. Die Einstellungen, die Sie per eigenem Code oder Callbacks vornehmen, sind zusätzliche Einstellungen zu den Optionen, die Sie in Seller Central einstellen. Das bedeutet: Wenn Sie eine existierende Werbeaktion in Seller Central haben und noch eine Aktion in Ihrem Code festlegen und beide auf dieselbe Bestellung zutreffen, dann werden beide Aktionen angewandt und Sie gewähren somit einen doppelten Rabatt.

Benutzerberechtigungen für Ihr Seller-Central-Konto einstellen Wenn Sie Ihr Seller-Central-Konto zum ersten Mal einrichten, kann nur der ursprünglich registrierte Benutzer auf die Funktionen von Seller Central zugreifen. Im Laufe der Zeit möchten Sie allerdings vielleicht anderen ebenfalls einen Zugriff auf Ihr Konto ermöglichen. Wenn Sie zum Beispiel möchten, dass ein Kollege Ihre Bestellungen verwaltet oder sich um die Versandbestätigungen kümmert. Um Benutzer hinzufügen oder Benutzerberechtigungen zu ändern, können Sie die Benutzerberechtigungen-Funktion nutzen. Seller Central benutzt ein Einladungsmodell, um Benutzerkonten zu verwalten. Zuerst werden Benutzer dazu eingeladen, ein Konto bei Seller Central anzulegen, damit sie auf Ihren Händlershop zugreifen können, und anschließend konfiguriert der Konto-Administrator die Berechtigungen für diesen Benutzer. Indem Sie Benutzer einladen und deren Berechtigungen anpassen, können Sie sicherstellen, dass die Benutzer die korrekten Berechtigungen erhalten. Das Einladungsmodell hilft Ihnen außerdem dabei, die Benutzerkonten vollständig zu administrieren, ohne dass Sie die Hilfe von einem Amazon-Payments-Administrator in Anspruch nehmen müssen. Um Benutzer anzulegen, muss der Konto-Administrator zunächst mittels des "Bezahlen über Amazon"Registrierungsprozesses die Konten registrieren. Anschließend stellt der Konto-Administrator eine Liste der Personen zusammen, die auf das System zugreifen können und legt fest, welche Benutzerrechte sie bekommen. Danach ist der Konto-Administrator bereit, neue Benutzer zu Seller Central einzuladen. Der Einladungsprozess besteht aus drei Schritten: 1. Der Konto-Administrator sendet Einladungen mit einem Link zu Seller Central per E-Mail an alle Benutzer. 2. Die Benutzer klicken auf den Link und geben den eindeutigen Bestätigungscode ein. Der Benutzer ist jetzt mit dem Status "Ausstehender Benutze"r eingetragen. 3. Der Benutzer gibt den Bestätigungscode ein und legt damit das Konto an. Der Benutzer ist jetzt mit dem Status "Aktueller Benutze"r eingetragen. Nachdem der Einladungsprozess vollständig abgeschlossen ist, hat der Benutzer einen Benutzernamen und ein Passwort für den Zugriff auf das System. Der letzte Schritt für den Konto-Administrator besteht darin, dem Benutzer die entsprechenden Benutzerrechte zuzuweisen. Hinweis: Benutzername und Passwort ergeben in der Kombination ein eindeutiges Benutzerkonto. Beispiel: [email protected] + passwort1 und [email protected] + passwort2 sind zwei verschiedene Benutzerkonten.

| "Bezahlen über Amazon"-Konto konfigurieren | 18

Erster Schritt: Der Konto-Administrator sendet eine Einladung Der erste Schritt besteht darin, den Benutzer einzuladen. 1. Klicken Sie unter Einstellungen auf Benutzerberechtigungen. Die Benutzerberechtigungen-Seite wird angezeigt. 2. Geben Sie die E-Mail-Adresse des Benutzers, den Sie einladen möchten, in das Feld E-Mail-Adresse des neuen Benutzers eingeben ein. 3. Klicken Sie auf Einladung senden. Die Einladung wird per E-Mail an die von Ihnen eingetragene E-Mail-Adresse geschickt. Eine Bestätigungsnachricht wird angezeigt. 4. Klicken Sie auf Weiter.

Zweiter Schritt: Der Benutzer erhält den Bestätigungscode Nachdem der eingeladene Benutzer auf den Link in der Einladungs-E-Mail geklickt hat, wird er gefragt, ob er sich mit einem existierenden Amazon-Konto anmelden oder ein neues Konto registrieren möchte. Nachdem er sich entweder angemeldet oder registriert hat, erscheint eine Seite mit einem Bestätigungscode. Der Benutzer zeigt oder sendet diesen Bestätigungscode an den Kontoadministrator, der den Benutzer freischaltet und die Benutzerberechtigungen vergibt.

Dritter Schritt: Der Benutzer loggt sich bei Seller Central ein und generiert ein Konto Nachdem der Kontoadministrator den Benutzer bestätigt hat, kann der Benutzer sich unter https://sellercentraleurope.amazon.com/ anmelden.

Vierter Schritt: Der Kontoadministrator legt die Benutzerberechtigungen fest Nachdem der Benutzer angelegt wurde, kann der Kontoadministrator die Benutzerberechtigungen bearbeiten und die gewünschten Funktionen somit freischalten. 1. Klicken Sie unter Einstellungen auf Benutzerberechtigungen. Die Benutzerberechtigungen-Seite wird angezeigt. 2. Klicken Sie auf der Benutzerberechtigungen-Seite neben dem gewünschten Benutzer auf Ändern. Die Seite "Benutzer anlegen oder ändern" wird angezeigt. 3. Klicken Sie auf der "Benutzer anlegen oder ändern"-Seite auf den Button neben der Funktion, auf die Ihr Benutzer zugreifen darf. 4. Klicken Sie auf Weiter, sobald Sie damit fertig sind. Eine Bestätigungsnachricht wird angezeigt. Hinweis: Der originale Kontobesitzer - derjenige, der sich als erstes registriert hat - ist immer der Kontoadministrator. Der Kontoadministrator kann immer Rechte für andere Benutzer gewähren. Der Kontoadministrator selbst kann weder gelöscht noch geändert werden.

E-Mail-Whitelist einrichten E-Mail ist die wichtigste Kommunikationsschnittstelle zwischen Amazon Payments und Ihnen. Sie erhalten zum Beispiel jedes Mal eine Benachrichtigung per E-Mail, wenn ein Käufer eine Bestellung aufgibt. Außerdem senden wir E-Mails bei Unstimmigkeiten zu einer Transaktion. Auch in vielen weiteren Fällen bezüglich Ihrer Transaktionen oder Ihres Kontos erhalten Sie E-Mails von Amazon Payments. Weil E-Mail in der Kommunikation so wichtig ist, ist es von hoher Wichtigkeit, dass Sie alle E-Mails von Amazon Payments erhalten. Um sicherzustellen, dass Sie diese E-Mails erhalten, können Sie Ihr E-Mail-Programm so einstellen, dass es E-Mails von Amazon Payments immer akzeptiert. Fügen Sie dazu einfach den Absender (amazon.de) zur sogenannten Whitelist hinzu. (Eine Whitelist ist eine Liste von E-Mail-Adressen, die als vertrauenswürdig eingestuft wurden und die immer zugestellt werden, ganz egal, welche Inhalte sie enthalten.)

| "Bezahlen über Amazon"-Konto konfigurieren | 19

Whitelist konfigurieren Befolgen Sie diese allgemeinen Schritte, um die Whitelist Ihres E-Mail-Programms zu konfigurieren. Hinweis: Diese Schritte beziehen sich auf Microsoft Outlook 2010. Falls Sie ein anderes E-Mail-Programm benutzen, sollten Sie die Online-Hilfe des Programms nutzen, um herauszufinden, wie Sie eine Whitelist anlegen können. 1. Klicken Sie in Microsoft Outlook 2010 auf Start > Junk-E-Mail und wählen Sie Junk-E-Mail-Optionen Das Fenster "Junk-E-Mail-Optionen" erscheint. 2. Klicken Sie auf Sichere Empfänger und dort auf Hinzufügen. Geben Sie @amazon.de ein und klicken Sie auf OK. Ihre Liste "Sicherer Empfänger" sieht ähnlich aus wie diese: Abbildung 7: Junk-E-Mail-Whitelist in Outlook 2010. 3. Klicken Sie auf OK.

MWS-Keys erhalten Die MWS-Keys werden für die Signierung Ihrer Einkaufswagen (Bestellungen) verwendet und sind für Ihr Konto eindeutig. Sie erhalten (und nutzen) zwei verschiedene MWS-Keys: • •

Ihre MWS Access Key ID (öffentlich) Ihr MWS Secret Access Key (geheim)

Für weitere Informationen zum Signieren von Einkaufswagen, lesen Sie bitte Einkaufswagen signieren auf Seite 24.

Ihre MWS-Keys erhalten Wichtig: Bewahren Sie Ihren Secret Access Key an einer sicheren Stelle auf - teilen Sie diesen nicht mit unautorisierten Leuten und fügen Sie ihn niemals in eine E-Mail-Nachricht oder in Ihren Code ein. Nutze Sie den Secret Access Key nur, um Bestellungen zu signieren. Befolgen Sie diese Schritte, um Ihre MWS-Keys zu erhalten 1. Klicken Sie in Seller Central auf Integration > MWS Access Key. Die Access-Key-Seite mit Ihrer Access Key ID und einem Platzhalter für Ihren Secret Access Key erscheint. 2. Klicken Sie auf Show, um Ihren Secret Access Key einzusehen. Ihr Secret Access Key wird angezeigt.

Käuferkonto konfigurieren Bevor Sie damit anfangen, Bestellungen auf Ihrer Website zu akzeptieren, sollten Sie Ihre Bestellverwaltungssystem testen, um sicherzustellen, dass Sie zuverlässig Bestellungen akzeptieren und versenden können. Wenn Sie Testbestellungen aufgeben, müssen Sie dafür ein separates Konto nutzen und nicht Ihr Händlerkonto. Hinweis: Für weitere Informationen zum Testprozess lesen Sie bitte Nach der Einrichtung auf Seite 43. Beachten Sie, dass im Produktiv-Modus aufgegebene Bestellungen entweder vom Händler versendet oder über das Käuferkonto storniert werden müssen. Weitere Informationen finden Sie im Abschnitt Im ProduktivModus aufgegebene Bestellung stornieren auf Seite 36.

| "Bezahlen über Amazon"-Konto konfigurieren | 20

Käuferkonto konfigurieren Wichtig: Verwenden Sie für Ihr Käuferkonto nicht dieselbe E-Mail-Adresse wie für Ihr Verkäuferkonto. Amazon Payments akzeptiert nur ein Konto pro E-Mail-Adresse. Das heißt, wenn Sie [email protected] für Ihr Verkäuferkonto nutzen, können Sie nicht dieselbe E-Mail-Adresse verwenden, wenn Sie Ihr Käuferkonto registrieren. Hinweis: Falls Sie bereits ein separates Käuferkonto haben (das sich von dem Konto unterscheidet, dass Sie für die Registrierung bei Bezahlen über Amazon verwendet haben), das Sie für den Einkauf bei Amazon.de verwenden, dann können Sie diese Schritte überspringen. Befolgen Sie diese Schritte, um Ihr Käuferkonto einzurichten: 1. Öffnen Sie die Website von Amazon Payments unter https://payments.amazon.de/ 2. Klicken Sie auf Privatkunden. Die Seite "Privatkunden" wird angezeigt:

3. 4.

5. 6. 7.

Abbildung 8: Die Seite "Privatkunden". Klicken Sie auf der rechten Seite auf Konto erstellen. Die Amazon-Anmeldeseite wird angezeigt. Geben Sie Ihre E-Mail-Adresse ein, wählen Sie die Option Ich bin ein neuer Kunde und klicken Sie anschließend auf Weiter (über den Sicherheitsserver). Die Seite "Neu bei Amazon.de?" wird angezeigt. Falls Sie diese Seite nicht sehen, dann klicken Sie bitte auf den Zurück-Button Ihres Browsers und stellen Sie sicher, dass Sie eine E-Mail-Adresse eingeben, die Sie noch nicht bei Amazon.de verwendet haben. Füllen Sie die erforderlichen Felder aus und klicken Sie auf Weiter. Die Seite "Melden Sie sich für ein Amazon Payments-Konto an" wird angezeigt Füllen Sie die erforderlichen Felder aus und klicken Sie auf Weiter. Wenn Sie dazu aufgefordert werden, können Sie weitere Services aktivieren, oder auf Überspringen klicken.

Nachdem Sie sich für ein neues Konto registriert haben, senden wir eine E-Mail mit weiteren Informationen zur Bestätigung Ihres neuen Kontos an die angegebene E-Mail-Adresse.

Kapitel

2

Bezahlen über Amazon integrieren Themen: •

• • • •

Schritte zur Integration von Bezahlen über Amazon in Ihre Website Berührungspunkte bei der Integration Sandbox einrichten Produktiv-Modus einrichten Zusätzliche Tipps zur Einrichtung

Die Integration von Bezahlen über Amazon in Ihre Website setzt voraus, dass Sie die Buttons sowohl im Sandbox-Modus, als auch im Produktiv-Modus generieren und testen. Der folgende Abschnitt ist eine Schritt-für-Schritt-Anleitung zur Generierung von funktionierenden "Bezahlen über Amazon"-Buttons für den ProduktivModus.

| Bezahlen über Amazon integrieren | 22

Schritte zur Integration von Bezahlen über Amazon in Ihre Website Hier sehen Sie die notwendigen Schritte für die Integration von Bezahlen über Amazon: 1. XML-Schema herunterladen (order.xsd). 2. Einkaufswagen-Code mit Sandbox-URLs erzeugen. 3. Einkaufswagen-Code signieren (optional). 4. Einkaufswagen-Code base64-kodieren. 5. Optionale Signatur zum Sandbox-Standard-Bestellprozess-Widget hinzufügen. 6. Sandbox-Standard-Bestellprozess-Widget zur Testseite hinzufügen. 7. Sandbox-Bestellung mittels Käuferkonto testen (Bestellung im Sandbox-Modus abschließen). 8. Einkaufswagen-Code mit Produktiv-URLs erzeugen. 9. Einkaufswagen-Code signieren (optional). 10. Einkaufswagen-Code base64-kodieren. 11. Optionale Signatur zum Produktiv-Standard-Bestellprozess-Widget hinzufügen. 12. Produktiv-Standard-Bestellprozess-Widget zur Testseite hinzufügen. 13. Produktiv-Bestellung mittels Käuferkonto testen (Bestellung im Produktiv-Modus abschließen). 14. Produktiv-Bestellung auf der Amazon-Payments-Seite mittels Käuferkonto stornieren. 15. Produktiv-Standard-Bestellprozess-Widget zur Website hinzufügen. Hinweis: Das Standard-Bestellprozess-Widget rendert den "Bezahlen über Amazon"-Button. Lesen Sie das Widget-Referenz-API-Handbuch für Details zur Nutzung des Standard-Bestellprozess-Widgets und für Informationen zur Einrichtung der Widgets auf Ihrer Website.

Berührungspunkte bei der Integration Dieses Bild illustriert den Integrationspfad und die Berührungspunkte zwischen dem Händler und Amazon Payments. Abbildung 9: Berührungspunkte bei der Integration Im Bestellprozess gibt es die folgenden drei Hauptschritte: 1. Der Kunde gibt eine Bestellung auf. 2. Der Händler verarbeitet die Bestellung unter Nutzung von Bezahlen über Amazon. Dieser Schritt beinhaltet den Versand der Bestellung. Wenn die Bestellung als "verschickt" markiert wurde, wird der Rechnungsbetrag vom Konto des Kunden abgebucht. 3. Der Händler verwaltet die Zahlung in seinem Händlerkonto. Während dieses Prozesses werden verschiedene Schritte durchgeführt: 1. 2. 3. 4. 5. 6.

Wenn der Kunde eine Bestellung aufgibt, wird eine Bestellprozess-Anfrage an Amazon Payments gesendet. Dies generiert eine Callback-Anfrage an den Händler (wenn Callbacks aktiviert sind). Der Händler schickt die Callback-Antwort mit den angeforderten Daten zurück. Amazon Payments zeigt Ihrem Kunden eine vorher festgelegte "Vielen Dank"-Seite an. Amazon Payments sendet eine Benachrichtigung über eine neue Bestellung. Wenn die vom Kunden gewählte Zahlungsart verarbeitet wurde, sendet Amazon Payments eine "Bestellung versandbereit"-Benachrichtigung. 7. Der Händler lädt den Bestellbericht herunter. 8. Der Händler informiert Amazon Payments, dass die Bestellung verschickt wurde. An dieser Stelle zieht Amazon Payments den Rechnungsbetrag vom Konto des Käufers ein. 9. Amazon Payments überweist den Rechnungsbetrag auf das Konto des Händlers.

| Bezahlen über Amazon integrieren | 23

10. Der Händler lädt den Zahlungsbericht herunter.

Sandbox einrichten Aktuelles XML-Schema herunterladen Für einen XML-basierten Einkaufswagen müssen Sie die aktuelle order.xsd-Schemadatei herunterladen und verwenden. Die aktuelle Schemaversion lautet 2009-05-15. Befolgen Sie diese Schritte, um das aktuelle Schema herunterzuladen: Laden Sie die folgende Datei herunter: http://amazonpayments.s3.amazonaws.com/documents/order.xsd

Sandbox-Einkaufswagen mittels XML Mittels eines Sandbox-Einkaufswagens können Sie Testbestellungen erzeugen. Ein einfacher XML-basierter Einkaufswagen enthält die unten im Beispiel aufgelisteten Elemente. Tabelle 2: Einfache HTML-Einkaufswagen-Elemente Elementname

Beschreibung

Pflichtfeld

XPath

Order

Beschreibt das Order-Schema

Ja

Root (\Order)

Cart

Container für die Einträge im Einkaufswagen

Ja

\Order\Cart

Items

Container für Artikel-Einträge

Ja

\Order\Cart\Items

Item

Container für Elemente der Bestellung

Ja

\Order\Cart\Items\Item

1-999 Artikeleinträge pro Einkaufswagen SKU

SKU (Stockkeeping Unit ID) des Artikels. 1-250 Zeichen.

Ja. Falls Sie Versand durch Amazon verwenden, müssen Sie eine SKU eintragen.

\Order\Cart\Items\Item\SKU

MerchantId

Alphanumerischer String mit 14 Zeichen

Ja

\Order\Cart\Items\Item\MerchantId

Sie können die Händlernummer unter Einstellungen > Kontoinformationen > Einstellungen zum Bestellprozess auslesen.

| Bezahlen über Amazon integrieren | 24

Elementname

Beschreibung

Pflichtfeld

XPath

Titel

Artikelname

Ja

\Order\Cart\Items\Item\Title

Maximal 80 Alphanumerische Zeichen Price

Container für den Preis und den Währungscode

Ja

\Order\Cart\Items\Item\Price

Amount

Artikelpreis

Ja

\Order\Cart\Items\Item\Price\Amount

CurrencyCode

Währung

Ja

\Order\Cart\Items\Item\Price \CurrencyCode

Nur "EUR" wird akzeptiert.

Hier sehen Sie ein Beispiel eines einfachen Sandbox-Einkaufswagens in XML: ABC123 AEIOU1234AEIOU Roter Fisch 19.99 EUR 1

Einkaufswagen signieren Zum Generieren der Signatur benötigen Sie ein Set von Signatur-Key-Paaren. Standardmäßig stellt Bezahlen über Amazon ein Set von MWS Access Keys zur Verfügung, die Access Key ID (öffentlicher Schlüssel) und den Secret Access Key (geheimer Schlüssel). Lesen Sie MWS-Keys erhalten auf Seite 19 für die notwendigen Schritte zum Auslesen Ihres MWS Access Keys. Hinweis: Sie können außerdem ein X.509-Zertifikat verwenden, das mit Ihrem "Bezahlen über Amazon"Konto verknüpft wurde. Sobald Sie Ihre Signatur-Key-Paare haben, können Sie eine RFC2104-fähige HMAC-Signatur der miteinander verknüpften Einkaufswagen-Code-Werte berechnen. Es ist keine feste Form erforderlich. Die folgende Tabelle listet die Signaturytpen und Ihre HTML-Darstellung im Einkaufswagen-Code auf. Tabelle 3: Tags, die bei der Erzeugung eines singierten Einkaufswagen-Codes genutzt werden Name

Beschreibung

Einkaufswagen-Typ

Typ

Einer der folgenden:

Alle Typen

| Bezahlen über Amazon integrieren | 25

Name

Beschreibung

Einkaufswagen-Typ

merchant-signed-order/awsaccesskey/1 (für MWS Access Key Signaturen) merchant-signed-order/awskeypair/1 (für MWS X.509 KeyPaar-Signaturen) unsigned-order order

Base64-kodierte Bestellung

Alle Typen

signature

Signature, die dem Typ entsprechend merchant-signed-order/awsberechnet wurde. accesskey/1 merchant-signed-order/aws-keypair/1

aws-access-key-id

MWS Access Key ID, die in Seller Central ausgelesen wurde

merchant-signed-order/awsaccesskey/1

certificate

X.509-MWS-Zertifikat

merchant-signed-order/aws-keypair/1

Befolgen Sie diese Schritte, um Ihren XML-Einkaufswagen-Code zu signieren: 1. Besorgen Sie sich Ihre MWS Access Keys oder X.509-Zertifikate. 2. Besorgen Sie sich den XML-Einkaufswagen-Code. Beachten Sie, dass der zu signierende XML-Code mit dem Code, den Sie im späteren Schritt "EinkaufswagenCode mittels base64 kodieren" verwenden, inhaltlich und von der Code-Formatierung her identisch sein muss. 3. Nutzen Sie die Programmiersprache Ihrer Wahl, um den XML-Code mit Ihrem MWS- oder X.509-Private-Key zu signieren. 4. Nutzen Sie die Programmiersprache Ihrer Wahl, um die daraus entstandene Signatur mittels base64 zu signieren. Der so kodierte Code sieht ähnlich aus wie in diesem Beispiel: 0nppbXTktfoV80Kh41GK7ruUhq8=

Einkaufswagen base64-kodieren Nachdem Sie den XML-Code für Ihren Einkaufswagen erhalten haben, müssen Sie diesen mittels der Programmiersprache Ihrer Wahl base64-kodieren. Wenn Sie nur signierte Einkaufswagen zulassen, müssen Sie außerdem die Signatur base64-kodieren, bevor Sie diese zu Ihrem Einkaufswagen-Code hinzufügen. Beachten Sie, dass Sie die Signatur erst dann hinzufügen können, nachdem Sie den Einkaufswagen-Code signiert und base64-kodiert haben. Hier sehen Sie ein Beispiel eines signierten Einkaufswagen, das mittels MWS-Access-Key-Paar signiert wurde (die Zeilenumbrüche wurden für eine bessere Lesbarkeit eingefügt): ... ... ...
new CBA.Widgets.StandardCheckoutWidget({

| Bezahlen über Amazon integrieren | 26

merchantId:'AEIOU1234AEIOU', orderInput: {format: "XML", value: "type:merchant-signed-order/awsaccesskey/1;order:PD94bWwgdmVyc2lvb

j0nMS4wJyBlbmNvZGluZz0nVVRGLTgnPz48T3JkZXIgeG1sbnM9J2h0dHA6Ly9wYXltZW50cy5hbWF6b24uY29t 2NoZWNrb3V0LzIwMDgtMTEtMzAvJz48Q2FydD48SXRlbXM +PEl0ZW0+PFNLVT5BQkMxMjM8L1NLVT48TWVyY2hhb nRJZD5BMUVKTjJKSUcxMEs2NzwvTWVyY2hhbnRJZD48VGl0bGU +UmVkIEZpc2g8L1RpdGxlPjxQcmljZT48QW1vd W50PjE5Ljk5PC9BbW91bnQ +PEN1cnJlbmN5Q29kZT5VU0Q8L0N1cnJlbmN5Q29kZT48L1ByaWNlPjxRdWFudGl0e T4xPC9RdWFudGl0eT48RnVsZmlsbG1lbnROZXR3b3JrPk1FUkNIQU5UPC9GdWxmaWxsbWVudE5ldHdvcms +PC9Jd GVtPjwvSXRlbXM+PC9DYXJ0PjwvT3JkZXI +;signature:0nppbXTktfoV80Kh41GK7ruUhq8= ;aws-access-key-id:19G7E7X2QE2V45LET"}, buttonSettings: {size:'large',color:'orange',background:'white'} }).render("cbaButton1"); ... Hier sehen Sie ein Beispiel eines unsignierten Einkaufswagens: ... ... ...
new CBA.Widgets.StandardCheckoutWidget({ merchantId:'AEIOU1234AEIOU', orderInput: {format: "XML", value:"type:unsignedorder;order:PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPE9yZG VyIHhtbG5zPSJodHRwOi8vcGF5bWVudHMuYW1hem9uLmNvbS9jaGVja291dC8yMDA4LTA2LTE1LyI +CiAgPENsaWVud

FJlcXVlc3RJZD5PcmRlci0yNDwvQ2xpZW50UmVxdWVzdElkPgogIDxFeHBpcmF0aW9uRGF0ZT4yMDA4LTEyLTEy

eHBpcmF0aW9uRGF0ZT4KICA8QFydD4KICAgIDxJdGVtcz4KICAgICAgPEl0ZW0+CiAgICAgICAgPFNLVT5UU0hJ MDAxPC9TS1U+CiAgICAgICAgPE1lcmNoYW50SWQ +PC9NZXJjaGFudElkPgogICAgICAgIDxUaXRsZT5BbWF6b24gUGF 5bWVudHMgVC1TaGlydDwvVGl0bGU +CiAgICAgICAgPFByaWNlPgogICAgICAgICAgPEFtb3VudD45Ljk1PC9BbW91bn Q +CiAgICAgICAgICA8Q3VycmVuY3lDb2RlPlVTRDwvQ3VycmVuY3lDb2RlPgogICAgICAgIDwvUHJpY2U +CiAgICAgI

CAgPFF1YW50aXR5PjE8L1F1YW50aXR5PgogICAgICA8L0l0ZW0+CiAgICA8L0l0ZW1zPgogIDwvQ2FydD4KPC9P cj4K"}, buttonSettings: {size:'large',color:'orange',background:'white'}}).render("cbaButton1");

| Bezahlen über Amazon integrieren | 27

... Befolgen Sie diese Schritte, um Ihren Einkaufswagen-Code mittels base64 zu kodieren: 1. Besorgen Sie sich Ihre MWS Access Keys oder X.509-Zertifikate. 2. Besorgen Sie sich den Einkaufswagen-Code. Beachten Sie, dass der zu signierende XML-Code mit dem Code, den Sie im vorhergehenden Schritt "Einkaufswagen signieren" verwendet haben, inhaltlich und von der Code-Formatierung her identisch sein muss. 3. Nutzen Sie die Programmiersprache Ihrer Wahl, um den XML-Code mit Ihrem MWS- oder X.509-Private-Key zu signieren. 4. Nutzen Sie die Programmiersprache Ihrer Wahl, um die daraus entstandene Signatur mittels base64 zu signieren. Der so kodierte Code sieht ähnlich aus wie in diesem Beispiel: 0nppbXTktfoV80Kh41GK7ruUhq8=

Signatur zum Einkaufswagen-Code hinzufügen Sie können eine von zwei verschiedenen Signaturtypen zu Ihrem Einkaufswagen-Code hinzufügen. Tabelle 4: Signatur-Werte und Keywords Signaturtypen

Wert-Eingabe

Keyword-Eingabe

MWS Access Keys

value="type:merchant-signed-order/ aws-accesskey/1

aws-access-key-id

X.509-Zertifikat

value="type:merchant-signed-order/ aws-keypair/1

aws-key-pair

Befolgen Sie diese Schritte, um die Signatur zum HTML-Formular hinzuzufügen. Fügen Sie zu dem orderInput-Tag die folgenden Werte hinzu: value="type:merchant-signed-order/aws-accesskey/1; ... signature: [Signatur];aws-access-key-id:[AWS Access Key ID] Ihr HTML-Formular sollte wie im untenstehenden Beispiel aussehen (Zeilenumbrüche wurden für eine bessere Übersicht eingefügt): new CBA.Widgets.StandardCheckoutWidget({ merchantId:'AEIOU1234AEIOU', orderInput: {format: "XML", value: "type:merchant-signed-order/aws-accesskey/1; order:PD94bWwgdmVyc2lvbj0nMS4wJyBlbmNvZGluZz0nVVRGL TgnPz48T3JkZXIgeG1sbnM9J2h0dHA6Ly9wYXltZW50cy5hbWF6 b24uY29tL2NoZWNrb3V0LzIwMDgtMTEtMzAvJz48Q2FydD48SXR lbXM+PEl0ZW0+PFNLVT5BQkMxMjM8L1NLVT48TWVyY2hhbnRJZD 5BMUVKTjJKSUcxMEs2NzwvTWVyY2hhbnRJZD48VGl0bGU+UmVkI EZpc2g8L1RpdGxlPjxQcmljZT48QW1vdW50PjE5Ljk5PC9BbW91 bnQ+PEN1cnJlbmN5Q29kZT5VU0Q8L0N1cnJlbmN5Q29kZT48L1B yaWNlPjxRdWFudGl0eT4xPC9RdWFudGl0eT48RnVsZmlsbG1lbn ROZXR3b3JrPk1FUkNIQU5UPC9GdWxmaWxsbWVudE5ldHdvcms+P C9JdGVtPjwvSXRlbXM+PC9DYXJ0PjwvT3JkZXI+;signature: 0nppbXTktfoV80Kh41GK7ruUhq8= ;aws-access-key-id:19G7E7X2QE2V45LET"},

| Bezahlen über Amazon integrieren | 28

buttonSettings: {size:'large',color:'orange',background:'white'} }).render("cbaButton1");

Sandbox-Button-Code in Ihre Testseite einfügen Nachdem Sie den XML-Code für den Einkaufswagen erzeugt, signiert und sowohl Code als auch Signatur base64kodiert haben, fügen Sie das Ergebnis zu einem HTML-Formular hinzu, das den "Bezahlen über Amazon"-Button beinhaltet. Der Code könnte zum Beispiel wie folgt aussehen (Zeilenumbrüche wurden für eine bessere Lesbarkeit eingefügt): ... new CBA.Widgets.StandardCheckoutWidget({ merchantId:'AEIOU1234AEIOU', orderInput: {format: "XML", value: "type:merchant-signed-order/aws-accesskey/1; order:PD94bWwgdmVyc2lvbj0nMS4wJyBlbmNvZGluZz0nVVRGLT gnPz48T3JkZXIgeG1sbnM9J2h0dHA6Ly9wYXltZW50cy5hbWF6b2 4uY29tL2NoZWNrb3V0LzIwMDgtMTEtMzAvJz48Q2FydD48SXRlbX M+PEl0ZW0+PFNLVT5BQkMxMjM8L1NLVT48TWVyY2hhbnRJZD5BMU VKTjJKSUcxMEs2NzwvTWVyY2hhbnRJZD48VGl0bGU+UmVkIEZpc2 g8L1RpdGxlPjxQcmljZT48QW1vdW50PjE5Ljk5PC9BbW91bnQ+PE N1cnJlbmN5Q29kZT5VU0Q8L0N1cnJlbmN5Q29kZT48L1ByaWNlPj xRdWFudGl0eT4xPC9RdWFudGl0eT48RnVsZmlsbG1lbnROZXR3b3 JrPk1FUkNIQU5UPC9GdWxmaWxsbWVudE5ldHdvcms+PC9JdGVtPj wvSXRlbXM+PC9DYXJ0PjwvT3JkZXI+;signature:0nppbXTktfo V80Kh41GK7ruUhq8=;aws-access-key-id:19G7E7X2QE2V45LET"}, buttonSettings: {size:'large',color:'orange',background:'white'} }).render("cbaButton1"); ... Die vollständige Seite könnte zum Beispiel so aussehen: ... ... ...
new CBA.Widgets.StandardCheckoutWidget({ merchantId:'AEIOU1234AEIOU', orderInput: {format: "XML", value: "type:merchant-signed-order/aws-accesskey/1; order:PD94bWwgdmVyc2lvbj0nMS4wJyBlbmNvZGluZz0nVVRGLT gnPz48T3JkZXIgeG1sbnM9J2h0dHA6Ly9wYXltZW50cy5hbWF6b2 4uY29tL2NoZWNrb3V0LzIwMDgtMTEtMzAvJz48Q2FydD48SXRlbX M+PEl0ZW0+PFNLVT5BQkMxMjM8L1NLVT48TWVyY2hhbnRJZD5BMU VKTjJKSUcxMEs2NzwvTWVyY2hhbnRJZD48VGl0bGU+UmVkIEZpc2 g8L1RpdGxlPjxQcmljZT48QW1vdW50PjE5Ljk5PC9BbW91bnQ+PE N1cnJlbmN5Q29kZT5VU0Q8L0N1cnJlbmN5Q29kZT48L1ByaWNlPj xRdWFudGl0eT4xPC9RdWFudGl0eT48RnVsZmlsbG1lbnROZXR3b3 JrPk1FUkNIQU5UPC9GdWxmaWxsbWVudE5ldHdvcms+PC9JdGVtPj

| Bezahlen über Amazon integrieren | 29

wvSXRlbXM+PC9DYXJ0PjwvT3JkZXI+;signature:0nppbXTktfo V80Kh41GK7ruUhq8=;aws-access-key-id:19G7E7X2QE2V45LET"}, buttonSettings: {size:'large',color:'orange',background:'white'} }).render("cbaButton1"); ... Platzieren Sie anschließend diesen Code auf einer Website, auf der Sie den "Bezahlen über Amazon"-Sandbox-Button testen möchten. Hinweis: Ihr "Bezahlen über Amazon"-Button und Einkaufswagen-Code müssen die im obenstehenden Beispiel angezeigten JavaScript-Zeilen enthalten. Für eine komplette Liste der Button-Stile lesen Sie bitte den Abschnitt Button-Stile. Vermischen Sie keine Sandbox-Buttons und Produktiv-Buttons auf einer Seite.

Sandbox-Button mittels Testbestellung testen Nachdem Sie einen "Bezahlen über Amazon"-Button für den Sandbox-Modus generiert und auf einer Test-Website eingefügt haben, sind Sie bereit, ihn zu testen. Hinweis: Denken Sie daran, dass Sie auch im Sandbox-Modus ein Käuferkonto benötigen, um den Kauf von Artikeln zu testen. Hinweis: Bestellungen, die Sie im Sandbox-Modus aufgeben, werden nie abgerechnet. Das bedeutet, dass Ihr Käuferkonto keine E-Mail-Bestätigung erhalten wird und auch Ihr Verkäuferkonto wird keinerlei Benachrichtung über die Bestellung erhalten. Sie können allerdings alle Sandbox-Bestellungen in Seller Central einsehen, indem Sie nach "Ausstehende Bestellungen" suchen. Lesen Sie Bestellungen verwalten für weitere Informationen. Wenn Sie einen Sandbox-Button testen, sollten Sie darauf achten, dass die folgenden Punkte zutreffen: • • • •

Sie starten den Bestellprozess, indem Sie auf den "Bezahlen über Amazon"-Button klicken. Wenn Sie sich mit Ihrem Test-Käuferkonto anmelden, können Sie den kompletten Bestellprozess ohne Fehler durchlaufen. Wenn Sie auf der Bestellübersichtsseite auf den Bestell-Button klicken, erhalten Sie die Nachricht, dass die Bestellung aufgeben wurde. Indem Sie sich mit Ihrem Verkäuferkonto bei Seller Central anmelden, können Sie die ausstehende Bestellung unter Bestellungen verwalten einsehen.

Befolgen Sie diese Schritte, um eine Bestellung im Sandbox-Modus aufzugeben: 1. Öffnen Sie Ihren Internet-Browser und geben Sie die URL Ihrer Test-Website ein. 2. Klicken Sie auf den "Bezahlen über Amazon"-Sandbox-Button, den Sie zuvor angelegt hatten. 3. Melden Sie sich mit Ihrem Käuferkonto an, wenn Sie dazu aufgefordert werden. In einigen Fällen werden Sie ggf. nicht dazu aufgefordert, sich anzumelden, und zwar dann, wenn sie kürzlich auf demselben Computer mit Ihrem Testkonto eine Testbestellung aufgegeben haben. 4. Wählen Sie die Lieferadresse und Zahlungsart aus, wenn Sie dazu aufgefordert werden. Abhängig von den Einstellungen in Ihrem Käuferkonto werden Sie dazu ggf. nicht aufgefordert. 5. Prüfen Sie die eingegebenen Informationen auf der Bestellübersichtsseite, um sicherzustellen, dass sie korrekt sind. Stellen Sie sicher, dass die Versandkosten und Werbeaktionen korrekt berechnet wurden. 6. Klicken Sie auf Bestellung aufgeben, um die Sandbox-Bestellung abzuschließen. Denken Sie daran, dass Sie keine Bestellbenachrichtung per E-Mail erhalten, obwohl Sie eine Bestellbestätigung auf der Website sehen. Sandbox-Bestellungen sind keine echten Bestellungen.

| Bezahlen über Amazon integrieren | 30

Produktiv-Modus einrichten Einkaufswagen für den Produktiv-Modus mittels XML erzeugen Mittels eines Einkaufswagens im Produktiv-Modus können Sie echte Bestellungen generieren, d.h. Bestellungen, die verarbeitet, bezahlt und versendet werden. Ein einfacher XML-basierter Einkaufswagen enthält die unten im Beispiel aufgelisteten Elemente. Tabelle 5: Einfache HTML-Einkaufswagen-Elemente Elementname

Beschreibung

Pflichtfeld

XPath

Order

Beschreibt das Order-Schema

Ja

Root (\Order)

Cart

Container für die Einträge im Einkaufswagen

Ja

\Order\Cart

Items

Container für Artikel-Einträge

Ja

\Order\Cart\Items

Item

Container für Elemente der Bestellung

Ja

\Order\Cart\Items\Item

1-999 Artikeleinträge pro Einkaufswagen SKU

SKU (Stockkeeping Unit ID) des Artikels. 1-250 Zeichen.

Ja. Falls Sie Versand durch Amazon verwenden, müssen Sie eine SKU eintragen.

\Order\Cart\Items\Item\SKU

MerchantId

Alphanumerischer String mit 14 Zeichen

Ja

\Order\Cart\Items\Item\MerchantId

Ja

\Order\Cart\Items\Item\Title

Sie können die Händlernummer unter Einstellungen > Kontoinformationen > Einstellungen zum Bestellprozess auslesen. Titel

Artikelname Maximal 80 Alphanumerische Zeichen

Price

Container für den Preis und den Währungscode

Ja

\Order\Cart\Items\Item\Price

Amount

Artikelpreis

Ja

\Order\Cart\Items\Item\Price\Amount

| Bezahlen über Amazon integrieren | 31

Elementname

Beschreibung

Pflichtfeld

XPath

CurrencyCode

Währung

Ja

\Order\Cart\Items\Item\Price \CurrencyCode

Nur "EUR" wird akzeptiert.

Hier sehen Sie ein Beispiel eines einfachen Einkaufswagens für den Produktiv-Modus in XML: ABC123 AEIOU1234AEIOU Roter Fisch 19.99 EUR 1 Hinweis: Verwenden Sie kein /-Zeichen (Schrägstrich) vor dem Item Title- Wert.

Einkaufswagen signieren Zum Generieren der Signatur benötigen Sie ein Set von Signatur-Key-Paaren. Standardmäßig stellt Bezahlen über Amazon ein Set von MWS Access Keys zur Verfügung, die Access Key ID (öffentlicher Schlüssel) und den Secret Access Key (geheimer Schlüssel). Lesen Sie MWS-Keys erhalten auf Seite 19 für die notwendigen Schritte zum Auslesen Ihres MWS Access Keys. Hinweis: Sie können außerdem ein X.509-Zertifikat verwenden, das mit Ihrem "Bezahlen über Amazon"Konto verknüpft wurde. Sobald Sie Ihre Signatur-Key-Paare haben, können Sie eine RFC2104-fähige HMAC-Signatur der miteinander verknüpften Einkaufswagen-Code-Werte berechnen. Es ist keine feste Form erforderlich. Die folgende Tabelle listet die Signaturytpen und Ihre HTML-Darstellung im Einkaufswagen-Code auf. Tabelle 6: Tags, die bei der Erzeugung eines singierten Einkaufswagen-Codes genutzt werden Name

Beschreibung

Einkaufswagen-Typ

Typ

Einer der folgenden:

Alle Typen

merchant-signed-order/awsaccesskey/1 (für MWS Access Key Signaturen) merchant-signed-order/awskeypair/1 (für MWS X.509 KeyPaar-Signaturen) unsigned-order order

Base64-kodierte Bestellung

Alle Typen

| Bezahlen über Amazon integrieren | 32

Name

Beschreibung

Einkaufswagen-Typ

signature

Signature, die dem Typ entsprechend merchant-signed-order/awsberechnet wurde. accesskey/1 merchant-signed-order/aws-keypair/1

aws-access-key-id

MWS Access Key ID, die in Seller Central ausgelesen wurde

merchant-signed-order/awsaccesskey/1

certificate

X.509-MWS-Zertifikat

merchant-signed-order/aws-keypair/1

Befolgen Sie diese Schritte, um Ihren XML-Einkaufswagen-Code zu signieren: 1. Besorgen Sie sich Ihre MWS Access Keys oder X.509-Zertifikate. 2. Besorgen Sie sich den XML-Einkaufswagen-Code. Beachten Sie, dass der zu signierende XML-Code mit dem Code, den Sie im späteren Schritt "EinkaufswagenCode mittels base64 kodieren" verwenden, inhaltlich und von der Code-Formatierung her identisch sein muss. 3. Nutzen Sie die Programmiersprache Ihrer Wahl, um den XML-Code mit Ihrem MWS- oder X.509-Private-Key zu signieren. 4. Nutzen Sie die Programmiersprache Ihrer Wahl, um die daraus entstandene Signatur mittels base64 zu signieren. Der so kodierte Code sieht ähnlich aus wie in diesem Beispiel: 0nppbXTktfoV80Kh41GK7ruUhq8=

Einkaufswagen base64-kodieren Nachdem Sie den XML-Code für Ihren Einkaufswagen erhalten haben, müssen Sie diesen mittels der Programmiersprache Ihrer Wahl base64-kodieren. Wenn Sie nur signierte Einkaufswagen zulassen, müssen Sie außerdem die Signatur base64-kodieren, bevor Sie diese zu Ihrem Einkaufswagen-Code hinzufügen. Beachten Sie, dass Sie die Signatur erst dann hinzufügen können, nachdem Sie den Einkaufswagen-Code signiert und base64-kodiert haben. Hier sehen Sie ein Beispiel eines signierten Einkaufswagen, das mittels MWS-Access-Key-Paar signiert wurde (die Zeilenumbrüche wurden für eine bessere Lesbarkeit eingefügt): ... ... ...
new CBA.Widgets.StandardCheckoutWidget({ merchantId:'AEIOU1234AEIOU', orderInput: {format: "XML", value: "type:merchant-signed-order/aws-accesskey/1; order:PD94bWwgdmVyc2lvbj0nMS4wJyBlbmNvZGluZz0nVVRGLT gnPz48T3JkZXIgeG1sbnM9J2h0dHA6Ly9wYXltZW50cy5hbWF6b2 4uY29tL2NoZWNrb3V0LzIwMDgtMTEtMzAvJz48Q2FydD48SXRlbX M+PEl0ZW0+PFNLVT5BQkMxMjM8L1NLVT48TWVyY2hhbnRJZD5BMU VKTjJKSUcxMEs2NzwvTWVyY2hhbnRJZD48VGl0bGU+UmVkIEZpc2 g8L1RpdGxlPjxQcmljZT48QW1vdW50PjE5Ljk5PC9BbW91bnQ+PE N1cnJlbmN5Q29kZT5VU0Q8L0N1cnJlbmN5Q29kZT48L1ByaWNlPj xRdWFudGl0eT4xPC9RdWFudGl0eT48RnVsZmlsbG1lbnROZXR3b3

| Bezahlen über Amazon integrieren | 33

JrPk1FUkNIQU5UPC9GdWxmaWxsbWVudE5ldHdvcms+PC9JdGVtPj wvSXRlbXM+PC9DYXJ0PjwvT3JkZXI+;signature:0nppbXTktfo V80Kh41GK7ruUhq8=;aws-access-key-id:19G7E7X2QE2V45LET"}, buttonSettings: {size:'large',color:'orange',background:'white'} }).render("cbaButton1"); ... Hier sehen Sie ein Beispiel eines unsignierten Einkaufswagens: ... ... ...
new CBA.Widgets.StandardCheckoutWidget({ merchantId:'AEIOU1234AEIOU', orderInput: {format: "XML", value:"type:unsigned-order;order:PD94bWwgdmV yc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPE9 yZGVyIHhtbG5zPSJodHRwOi8vcGF5bWVudHMuYW1hem9 uLmNvbS9jaGVja291dC8yMDA4LTA2LTE1LyI+CiAgPEN saWVudFJlcXVlc3RJZD5PcmRlci0yNDwvQ2xpZW50UmV xdWVzdElkPgogIDxFeHBpcmF0aW9uRGF0ZT4yMDA4LTE yLTEyPC9FeHBpcmF0aW9uRGF0ZT4KICA8QFydD4KICAg IDxJdGVtcz4KICAgICAgPEl0ZW0+CiAgICAgICAgPFNL VT5UU0hJUlQwMDAxPC9TS1U+CiAgICAgICAgPE1lcmNo YW50SWQ+PC9NZXJjaGFudElkPgogICAgICAgIDxUaXRs ZT5BbWF6b24gUGF5bWVudHMgVC1TaGlydDwvVGl0bGU+ CiAgICAgICAgPFByaWNlPgogICAgICAgICAgPEFtb3Vu dD45Ljk1PC9BbW91bnQ+CiAgICAgICAgICA8Q3VycmVu Y3lDb2RlPlVTRDwvQ3VycmVuY3lDb2RlPgogICAgICAg IDwvUHJpY2U+CiAgICAgICAgPFF1YW50aXR5PjE8L1F1 YW50aXR5PgogICAgICA8L0l0ZW0+CiAgICA8L0l0ZW1z PgogIDwvQ2FydD4KPC9PcmRlcj4K"}, buttonSettings: {size:'large', color:'orange', background:'white'}}).render("cbaButton1"); ... Befolgen Sie diese Schritte, um Ihren Einkaufswagen-Code mittels base64 zu kodieren: 1. Besorgen Sie sich Ihre MWS Access Keys oder X.509-Zertifikate. 2. Besorgen Sie sich den Einkaufswagen-Code. Beachten Sie, dass der zu signierende XML-Code mit dem Code, den Sie im vorhergehenden Schritt "Einkaufswagen signieren" verwendet haben, inhaltlich und von der Code-Formatierung her identisch sein muss. 3. Nutzen Sie die Programmiersprache Ihrer Wahl, um den XML-Code mit Ihrem MWS- oder X.509-Private-Key zu signieren. 4. Nutzen Sie die Programmiersprache Ihrer Wahl, um die daraus entstandene Signatur mittels base64 zu signieren.

| Bezahlen über Amazon integrieren | 34

Der so kodierte Code sieht ähnlich aus wie in diesem Beispiel: 0nppbXTktfoV80Kh41GK7ruUhq8=

Signatur zum Einkaufswagen-Code hinzufügen Sie können eine von zwei verschiedenen Signaturtypen zu Ihrem Einkaufswagen-Code hinzufügen. Tabelle 7: Signatur-Werte und Keywords Signaturtypen

Wert-Eingabe

Keyword-Eingabe

MWS Access Keys

value="type:merchant-signed-order/ aws-accesskey/1

aws-access-key-id

X.509-Zertifikat

value="type:merchant-signed-order/ aws-keypair/1

aws-key-pair

Befolgen Sie diese Schritte, um die Signatur zum HTML-Formular hinzuzufügen. Fügen Sie zu dem orderInput-Tag die folgenden Werte hinzu: value="type:merchant-signed-order/aws-accesskey/1; ... signature: [Signature]; aws-access-key-id:[AWS Access Key ID] Ihr HTML-Formular sollte wie im untenstehenden Beispiel aussehen (Zeilenumbrüche wurden für eine bessere Übersicht eingefügt): new CBA.Widgets.StandardCheckoutWidget({ merchantId:'AEIOU1234AEIOU', orderInput: {format: "XML", value: "type:merchant-signed-order/aws-accesskey/1; order:PD94bWwgdmVyc2lvbj0nMS4wJyBlbmNvZGluZz0nVVRGL TgnPz48T3JkZXIgeG1sbnM9J2h0dHA6Ly9wYXltZW50cy5hbWF6 b24uY29tL2NoZWNrb3V0LzIwMDgtMTEtMzAvJz48Q2FydD48SXR lbXM+PEl0ZW0+PFNLVT5BQkMxMjM8L1NLVT48TWVyY2hhbnRJZD 5BMUVKTjJKSUcxMEs2NzwvTWVyY2hhbnRJZD48VGl0bGU+UmVkI EZpc2g8L1RpdGxlPjxQcmljZT48QW1vdW50PjE5Ljk5PC9BbW91 bnQ+PEN1cnJlbmN5Q29kZT5VU0Q8L0N1cnJlbmN5Q29kZT48L1B yaWNlPjxRdWFudGl0eT4xPC9RdWFudGl0eT48RnVsZmlsbG1lbn ROZXR3b3JrPk1FUkNIQU5UPC9GdWxmaWxsbWVudE5ldHdvcms+P C9JdGVtPjwvSXRlbXM+PC9DYXJ0PjwvT3JkZXI+;signature: 0nppbXTktfoV80Kh41GK7ruUhq8= ;aws-access-key-id:19G7E7X2QE2V45LET"}, buttonSettings: {size:'large',color:'orange',background:'white'} }).render("cbaButton1");

Produktiv-Button-Code in Ihre Testseite einfügen Nachdem Sie den XML-Code für den Einkaufswagen erzeugt, signiert und sowohl Code als auch Signatur base64kodiert haben, fügen Sie das Ergebnis zu einem HTML-Formular hinzu, das den "Bezahlen über Amazon"-Button beinhaltet. Der Code könnte zum Beispiel wie folgt aussehen (Zeilenumbrüche wurden für eine bessere Lesbarkeit eingefügt): ... new CBA.Widgets.StandardCheckoutWidget({ merchantId:'AEIOU1234AEIOU',

| Bezahlen über Amazon integrieren | 35

orderInput: {format: "XML", value: "type:merchant-signed-order/aws-accesskey/1; order:PD94bWwgdmVyc2lvbj0nMS4wJyBlbmNvZGluZz0nVVRGL TgnPz48T3JkZXIgeG1sbnM9J2h0dHA6Ly9wYXltZW50cy5hbWF6 b24uY29tL2NoZWNrb3V0LzIwMDgtMTEtMzAvJz48Q2FydD48SXR lbXM+PEl0ZW0+PFNLVT5BQkMxMjM8L1NLVT48TWVyY2hhbnRJZD 5BMUVKTjJKSUcxMEs2NzwvTWVyY2hhbnRJZD48VGl0bGU+UmVkI EZpc2g8L1RpdGxlPjxQcmljZT48QW1vdW50PjE5Ljk5PC9BbW91 bnQ+PEN1cnJlbmN5Q29kZT5VU0Q8L0N1cnJlbmN5Q29kZT48L1B yaWNlPjxRdWFudGl0eT4xPC9RdWFudGl0eT48RnVsZmlsbG1lbn ROZXR3b3JrPk1FUkNIQU5UPC9GdWxmaWxsbWVudE5ldHdvcms+P C9JdGVtPjwvSXRlbXM+PC9DYXJ0PjwvT3JkZXI+;signature: 0nppbXTktfoV80Kh41GK7ruUhq8= ;aws-access-key-id:19G7E7X2QE2V45LET"}, buttonSettings: {size:'large',color:'orange',background:'white'} }).render("cbaButton1"); ... Die vollständige Seite könnte zum Beispiel so aussehen: ... ... ...
new CBA.Widgets.StandardCheckoutWidget({ merchantId:'AEIOU1234AEIOU', orderInput: {format: "XML", value: "type:merchant-signed-order/aws-accesskey/1; order:PD94bWwgdmVyc2lvbj0nMS4wJyBlbmNvZGluZz0nVVRGLT gnPz48T3JkZXIgeG1sbnM9J2h0dHA6Ly9wYXltZW50cy5hbWF6b2 4uY29tL2NoZWNrb3V0LzIwMDgtMTEtMzAvJz48Q2FydD48SXRlbX M+PEl0ZW0+PFNLVT5BQkMxMjM8L1NLVT48TWVyY2hhbnRJZD5BMU VKTjJKSUcxMEs2NzwvTWVyY2hhbnRJZD48VGl0bGU+UmVkIEZpc2 g8L1RpdGxlPjxQcmljZT48QW1vdW50PjE5Ljk5PC9BbW91bnQ+PE N1cnJlbmN5Q29kZT5VU0Q8L0N1cnJlbmN5Q29kZT48L1ByaWNlPj xRdWFudGl0eT4xPC9RdWFudGl0eT48RnVsZmlsbG1lbnROZXR3b3 JrPk1FUkNIQU5UPC9GdWxmaWxsbWVudE5ldHdvcms+PC9JdGVtPj wvSXRlbXM+PC9DYXJ0PjwvT3JkZXI+;signature:0nppbXTktfo V80Kh41GK7ruUhq8=;aws-access-key-id:19G7E7X2QE2V45LET"}, buttonSettings: {size:'large', color:'orange', background:'white'} }).render("cbaButton1"); ... Platzieren Sie anschließend diesen Code auf einer Website, auf der Sie den "Bezahlen über Amazon"-Button testen möchten. Hinweis: Ihr "Bezahlen über Amazon"-Button und Einkaufswagen-Code müssen die im obenstehenden Beispiel angezeigten JavaScript-Zeilen enthalten. Für eine komplette Liste der Button-Stile lesen Sie bitte den Abschnitt Button-Stile.

| Bezahlen über Amazon integrieren | 36

Vermischen Sie keine Sandbox-Buttons und Produktiv-Buttons auf einer Seite.

Produktiv-Button mittels Testbestellung testen Nachdem Sie einen "Bezahlen über Amazon"-Button für den Produktiv-Modus generiert und auf einer Test-Website eingefügt haben, sind Sie bereit, ihn zu testen. Hinweis: Denken Sie daran, dass Sie ein Käuferkonto benötigen, um Artikel zu kaufen. Hinweis: Bestellungen, die Sie im Produktiv-Modus aufgeben, werden immer abgerechnet. Das bedeutet, dass Ihr Käuferkonto eine E-Mail-Bestätigung erhalten wird und Ihr Verkäuferkonto wird eine Benachrichtigung erhalten, dass eine Bestellung aufgegeben wurde. Bestellungen im Produktiv-Modus sehen Sie in Seller Central, mittels Bestellberichte oder via IOPN. Lesen Sie Bestellungen verwalten für weitere Informationen. Wichtig: Denken Sie daran, Ihre Testbestellung zu stornieren, nachdem Sie diese aufgegeben haben, andernfalls wird die Zahlungsart Ihres Käuferkontos belastet. Beachten Sie außerdem, dass Sie als Verkäufer verpflichtet sind, alle Bestellungen innerhalb von 30 Tagen zu versenden oder zu stornieren, auch dann, wenn Sie diese über Ihr eigenes Test-Käuferkonto aufgegeben habe. Wenn Sie einen Produktiv-Button testen, sollten Sie darauf achten, dass die folgenden Punkte zutreffen: • • • • • •

Der Bestellprozess wird gestartet, wenn Sie auf den "Bezahlen über Amazon"-Button klicken. Wenn Sie sich mit Ihrem Test-Käuferkonto anmelden, können Sie den kompletten Bestellprozess ohne Fehler durchlaufen. Wenn Sie auf der Bestellübersichtsseite auf den Bestell-Button klicken, erhalten Sie die Nachricht, dass die Bestellung aufgeben wurde. Nachdem Sie die Bestellung aufgegeben haben, erhält Ihr Käuferkonto eine E-Mail-Bestätigung von Amazon Payments. Indem Sie sich mit Ihrem Käuferkonto auf der Website von Amazon Payments (https://payments.amazon.de) anmelden, können Sie die Bestellung auf der Seite "Mein Konto" einsehen. Indem Sie sich mit Ihrem Verkäuferkonto bei Seller Central anmelden, können Sie die Bestellung unter Bestellungen verwalten einsehen.

Befolgen Sie diese Schritte, um eine Bestellung im Produktiv-Modus aufzugeben: 1. Öffnen Sie Ihren Internet-Browser und geben Sie die URL Ihrer Test-Website ein. 2. Klicken Sie auf den "Bezahlen über Amazon"-Button, den Sie zuvor angelegt hatten. 3. Melden Sie sich mit Ihrem Käuferkonto an, wenn Sie dazu aufgefordert werden. In einigen Fällen werden Sie ggf. nicht dazu aufgefordert, sich anzumelden, und zwar dann, wenn sie kürzlich auf demselben Computer mit Ihrem Testkonto eine Testbestellung aufgegeben haben. 4. Wählen Sie die Lieferadresse und Zahlungsart aus, wenn Sie dazu aufgefordert werden. Abhängig von den Einstellungen in Ihrem Käuferkonto werden Sie dazu ggf. nicht aufgefordert. 5. Prüfen Sie die eingegebenen Informationen auf der Bestellübersichtsseite, um sicherzustellen, dass sie korrekt sind. Stellen Sie sicher, dass die Versandkosten und Werbeaktionen korrekt berechnet wurden. 6. Klicken Sie auf Bestellung aufgeben, um die Bestellung abzuschließen. Sie sehen eine Bestätigungsnachricht und Ihr Käuferkonto erhält eine Bestätigung per E-Mail.

Im Produktiv-Modus aufgegebene Bestellung stornieren Nachdem Sie eine Testbestellung im Produktiv-Modus aufgegeben haben, sollten Sie diese innerhalb von 15 Minuten wieder stornieren. Hinweis: Sie müssen die Testbestellung allerdings nicht stornieren, wenn Sie diese nutzen möchten, um den kompletten Versandprozess zu testen.

| Bezahlen über Amazon integrieren | 37

Alle Bestellungen, die nicht vom Käufer storniert wurden, müssen vom Händler innerhalb von 30 Tagen entweder verschickt oder storniert werden. Bestellungen, die nicht innerhalb dieses Zeitraums bearbeitet werden, werden von Amazon Payments automatisch storniert. Ihre Stornierungsrate fließt in die Händlerstatistik ein, eine hohe vom Händler ausgehende Stornierungsrate kann dazu führen, dass Ihr Konto von Amazon Payments überprüft wird. Befolgen Sie diese Schritte, um eine Bestellung in Ihrem Käuferkonto zu stornieren. 1. Öffnen Sie die Website von Amazon Payments unter https://payments.amazon.de/ 2. Klicken Sie auf Mein Konto. 3. Melden Sie sich mit den Zugangsdaten Ihres Käuferkontos an, wenn Sie dazu aufgefordert werden. Sie werden eventuell nicht dazu aufgefordert sich anzumelden, wenn Sie sich bereits bei Amazon oder einer anderen Seite, die Amazon Payments nutzt, mit diesen Zugangsdaten angemeldet haben.

4. 5. 6. 7.

Tipp: Prüfen Sie den Namen in der rechten oberen Ecke. Falls es nicht Ihr Name ist, klicken Sie bitte auf "Abmelden" und klicken Sie erneut auf "Mein Konto". Suchen Sie die Testbestellung, die Sie aufgegeben haben. Klicken Sie auf den Link Details neben der Testbestellung. Die Bestelldetailsseite wird angezeigt. Klicken Sie auf Möchten Sie diese Bestellung stornieren? Klicken Sie auf Bestellung stornieren. Die Bestellung wurde storniert.

Produktiv-Button-Code in Ihre Website einfügen Nachdem Sie den "Bezahlen über Amazon"-Button in Seller Central generiert und anschließend getestet haben, platzieren Sie den base64-kodierten HTML-Button-Code auf Ihrer Website, damit Ihre Kunden den Button verwenden können, um echte Bestellungen aufzugeben. Hier sehen Sie ein Beispiel einer vollständigen HTML-Seite (Zeilenumbrüche wurden für eine bessere Übersichtlichkeit eingefügt): ... ... ...
new CBA.Widgets.StandardCheckoutWidget({ merchantId:'AEIOU1234AEIOU', orderInput: {format: "XML", value: "type:merchant-signed-order/awsaccesskey/1;order:PD94bWwgdmVyc2lvbj0nMS4wJyBlbmNvZGluZz0nVVRGLT

gnPz48T3JkZXIgeG1sbnM9J2h0dHA6Ly9wYXltZW50cy5hbWF6b24uY29tL2NoZWNrb3V0LzIwMDgtMTEtMzAvJ M +PEl0ZW0+PFNLVT5BQkMxMjM8L1NLVT48TWVyY2hhbnRJZD5BMUVKTjJKSUcxMEs2NzwvTWVyY2hhbnRJZD48VGl +UmVkIEZpc2 g8L1RpdGxlPjxQcmljZT48QW1vdW50PjE5Ljk5PC9BbW91bnQ +PEN1cnJlbmN5Q29kZT5VU0Q8L0N1cnJlbmN5Q29kZT48L1ByaWNlPj

xRdWFudGl0eT4xPC9RdWFudGl0eT48RnVsZmlsbG1lbnROZXR3b3JrPk1FUkNIQU5UPC9GdWxmaWxsbWVudE5ld +PC9JdGVtPj wvSXRlbXM+PC9DYXJ0PjwvT3JkZXI+;signature:0nppbXTktfoV80Kh41GK7ruUhq8=

| Bezahlen über Amazon integrieren | 38

;aws-access-key-id:19G7E7X2QE2V45LET"}, buttonSettings: {size:'large',color:'orange',background:'white'} }).render("cbaButton1"); ... ... Platzieren Sie anschließend diesen Code auf der Website, auf der Sie den "Bezahlen über Amazon"-Button anzeigen möchten. Hinweis: Ihr "Bezahlen über Amazon"-Button und Einkaufswagen-Code müssen die im obenstehenden Beispiel angezeigten JavaScript-Zeilen enthalten. Für eine komplette Liste der Button-Stile lesen Sie bitte den Abschnitt Button-Stile. Vermischen Sie keine Sandbox-Buttons und Produktiv-Buttons auf einer Seite.

Zusätzliche Tipps zur Einrichtung Hier sind einige zusätzliche Tipps zur Einrichtung, die hilfreich sein können, um besser mit Bezahlen über Amazon arbeiten zu können. Platzieren Sie Ihre "Bezahlen über Amazon"-Buttons in der Liste der Zahlungsarten an erster Stelle. Ihre Kunden werden Ihrer Seite mehr vertrauen und größere Bestellungen aufgeben, wenn Sie die vertrauenswürdige Amazon Payments Marke auf Ihrer Website sehen. Abbildung 10: Tragen Sie Amazon Payments an erster Stelle ein. Platzieren Sie die Amazon Payments Button oberhalb und unterhalb Ihrer Bestelldetailinformationen. Ihre Kunden können die Buttons somit einfach nutzen, ohne nach oben oder nach unten scrollen zu müssen. Abbildung 11: Amazon Payments Button-Platzierung Befolgen Sie die Beispiel im Marketing-Toolkit, wenn Sie die Amazon Payments Buttons, Bilder, und Produktinformationen auf Ihrer Website platzieren. Ihre Kudnen werden dieselben Buttons und Bilder sehen, die sie auch auf anderen Seiten sehen, die Amazon Payments nutzen. Die Nutzung vertrauter Amazon Payments Marken hilft, das Vertrauen Ihrer Kunden in Ihre Website zu erhöhen. Lesen Sie die Seite Marketing-Toolkit für weitere Informationen. Beschränken Sie die Beschreibung auf 200 oder weniger Zeichen. Nur die ersten 200 Zeichen der Beschreibung werden durch das Bestellsystem geschickt, deshalb ist eine Bestellung einfacher zu finden, wenn Sie die relevanten Details an erster Stelle aufschreiben. Schließen Sie die Reserve-Richtlinie in Ihre Geschäftspläne mit ein. Die Reserve-Richtlinie beeinflusst, wie Sie die Zahlungen für Ihre Verkäufe erhalten. Stellen Sie sicher, dass Sie die Konsequenzen durch die Einbindung der Reserve-Richtlinie verstehen, wenn Sie Ihren Geschäftsplan schreiben. Beachten Sie, dass Sie abhängig von Ihrer Kategorie ggf. unterschiedliche Beschränkungen haben.

| Bezahlen über Amazon integrieren | 39

Schulen Sie Ihren Kundenservice bezüglich der Bearbeitung von Anfragen zu Amazon Payments. Erhöhen Sie das Vertrauen Ihrer Kunden in Ihre Website, indem Sie Ihre Kundenservice-Mitarbeiter intensiv schulen, damit diese alle Fragen zum Einsatz von Amazon Payments auf Ihrer Website beantworten können. Planen Sie, welche Schritte Sie durchführen werden, wenn Sie eine Kontaktanfrage eines Kunden erhalten. Schreiben Sie die zu befolgenden Schritte auf und schulen Sie Ihren Kundenservice entsprechend. Teilen Sie Ihren Kunden mit, dass Sie Amazon Payments akzeptieren. Mittels Amazon Payments können Ihre Kunden die Zahlungsarten in ihren Amazon-Konten verwenden, um auf Ihrer Website einfach, schnell und sicher einzukaufen. Eine Beispiel-E-Mail finden Sie im Marketing-Toolkit.

Kapitel

3

Abrechnungen verarbeiten Sobald der Zahlungsbetrag erfolgreich für die vom Käufer ausgewählte Zahlungsart reserviert wurde, wird für die Bestellung der Status "versandbereit" angegeben. Sie müssen warten, bis der Bestellstatus "versandbereit" lautet, bevor Sie diese versenden können. Sie können die Bestellbenachrichtigungen verwenden, um über jede Statusänderung informiert zu werden. Bitte lesen Sie das Handbuch zur Instant Order Processing Notification API, um weitere Informationen zu den Bestellbenachrichtigungen zu erhalten. Sobald die Bestellung versandbereit ist, müssen Sie die folgenden Aktionen durchführen: • •

Sie müssen diese vollständig bearbeiten (versenden und als versandt markieren) oder Sie müssen diese stornieren (falls es sich um Testbestellungen handelt, ist es einfacher, wenn Sie diese mit Ihrem Käufer-(Test)-Konto stornieren).

Die Zahlungsart des Kunden wird nur dann belastet, wenn Sie die Bestellung versendet haben. Sie müssen alle Aktionen bezüglich einer Bestellung innerhalb von 30 Tagen nach Bestelleingang durchführen, andernfalls wird Bezahlen über Amazon die Bestellung automatisch stornieren. Bitte lesen Sie das Handbuch zur Instant Order Processing Notification API für weitere Informationen zum Versand oder zur Stornierung von Bestellungen, zur Erstattung durchgeführter Bestellungen oder anderen Bestellverwaltungsfunktionen.

Kapitel

4

Nach der Einrichtung Themen: • • •

Abschlusskriterien Zehn Testtransaktionen-Typen Bestelloptionen für Testtransaktionen

Nachdem Sie Ihre Integration abgeschlossen und getestet haben, sollten Sie die folgenden Schritte durchführen, um sicherzustellen, dass Sie Ihre Website mit Bezahlen über Amazon veröffentlichen können.

| Nach der Einrichtung | 44

Abschlusskriterien Hier sind die Abschlusskriterien für die erfolgreiche Integration von Bezahlen über Amazon auf Ihrer Website. Nutzen Sie diese Checkliste um sicherzustellen, dass die Integration korrekt funktioniert, bevor Sie Ihre Website veröffentlichen. 1. Die Buttons funktionieren im Sandboy-Modus (Testmodus) und Produktiv-Modus (hier kann der Bestellprozess komplett abgeschlossen werden). 2. Eine im Produktiv-Modus vorgenommene Bestellung erscheint auf der Website von Amazon Payments im Kundenkonto des Käufers. 3. Außerdem wird diese Bestellung in Seller Central im Konto des Händlers (unter Bestellungen verwalten) angezeigt. 4. Sie können alle Testbestellungen mit Ihrem Käufer-(Test)-Konto auf der Website von Amazon Payments stornieren.

Zehn Testtransaktionen-Typen Nutzen Sie diese zusätzlichen Transaktionstypen um Ihre Integration von Bezahlen über Amazon vollständig zu testen: 1. 2. 3. 4. 5. 6. 7. 8. 9.

Einfacher Einzelartikel (1-item) Artikel mit Varianten Artikel, die weniger als 1 Euro kosten Artikel, die mehr als 50 Euro kosten Artikel, die in höherer Stückzahl bestellt werden Artikel, die per Standardversand an eine Inland-Adresse verschickt werden Artikel, die per Expressversand an eine Inland-Adresse verschickt werden Artikel, die per Standardversand an eine internationale Adresse verschickt werden Eine Bestellung im Produktiv-Modus vollständig abwickeln

Bestelloptionen für Testtransaktionen Wenn Sie Ihre vollständige Implementation von Bezahlen über Amazon auf Ihrer Seite bauen und testen, sollten Sie in Betracht ziehen, Transaktionen mit den folgenden Conditionstypen zu bauen: 1. 2. 3. 4. 5. 6.

Artikel mit einer Werbeaktion Artikel mit mehreren Werbeaktionen Artikel mit Versandkosten pro Artikel und pro Paket Artikel mit bestellwertabhängigen Versandkosten Bestellungen, die via Expressbestellprozess aufgegeben wurden. Bestellungen, die via Standardbestellprozess aufgegeben wurden.

Kapitel

5

Einkaufswagen und Button anpassen Themen: • • • •

EinkaufswagenÜberschreibungen nutzen Flexible Versandoptionen Button-Stile anpassen Zusätzliche Funktionen von Bezahlen über Amazon

Sie können Ihre Integration von Bezahlen über Amazon mit den folgenden Funktionen erweitern: 1. Verwenden Sie Einkaufswagen-Überschreibungen, um Versandkosten und Werbeaktionen einzustellen. 2. Passen Sie die "Bezahlen über Amazon"-Buttons an, indem Sie den Button-Stil verändern. 3. Integrieren Sie Bezahlen über Amazon fest in Ihre Website und Systeme, indem Sie Callbacks und Instant Order Processing Notifications nutzen. Die folgenden Abschnitte beschreiben, wie Sie EinkaufswagenÜberschreibungen nutzen und wie Sie das Erscheinungsbild Ihrer Buttons ändern können. Außerdem finden Sie dort Links zu zusätzlichen Dokumentationen für Callbacks und Instant Order Processing Notifications. Bitte lesen Sie Grundeinstellungen für Versandarten und Werbeaktionen in Seller Central auf Seite 16 für wichtige Informationen zur Einrichtung und Prüfung der Standardeinstellungen für Versandkosten und Werbeaktionen.

| Einkaufswagen und Button anpassen | 46

Einkaufswagen-Überschreibungen nutzen Sie können bestimmte Werte für Versandkosten und Werbeaktionen im jeweiligen Einkaufswagen überschreiben und somit die existierenden Einstellungen in Seller Central umgehen. Wenn Sie zum Beispiel die Versandkosten überschreiben, wird Amazon Payments die Versandkosten aus Ihrem Einkaufswagen-Code verwenden und nicht die Versandkosten, die Sie in Seller Central eingestellt hatten. Beachten Sie, dass Werbeaktionen im Gegensatz zu Versandkosten nicht komplett überschrieben, sondern zusätzlich angelegt werden. Das bedeutet, dass Bestellungen, für die es Werbeaktionen gibt, die sowohl in Seller Central als auch in Ihrem Einkaufswagen festgelegt wurden, doppelt berücksichtigt werden. In manchen Fällen ist dieses Verhalten durchaus gewünscht (zum Beispiel "Sparen Sie 10% bei Ihrem Einkauf" und "Kostenloser Versand"), deshalb sollten Sie diese Besonderheit berücksichtigen und die Werbeaktionen entsprechend planen.

Versandkosten überschreiben Mittels der Überschreibung von Versandkosten können Sie innerhalb Ihres individuellen Einkaufswagen-Codes Versandkosten festlegen und zur Verarbeitung an Amazon Payments senden. Das Hinzufügen von Versandkosten-Überschreibungen besteht aus zweiTeilen: 1. Sie fügen die Überschreibung zum Item-Tag hinzu, um die gewünschten Versandkosten für diesen Artikel zu definieren. 2. Fügen Sie die passenden Tags und Definitionen hinzu, um Höhe der Versandkosten festzulegen. Diese Tabellen listen die XML-Tags auf, die Sie nutzen können, um Versandkostenüberschreibungen im Einkaufswagen zu nutzen. Amount (Shipment-based) Erklärung

Die Kosten für den Versand. Zum Beispiel 3,99 Euro pro Lieferung.

Pflichtfeld

Ja

Typ

Preis

Werte/Rang

0.01-99999.99

XPath

/Order/ShippingMethods/ShippingMethod/Rate/ShipmentBased/Amount

Amount (Weight-based) Erklärung

Die Kosten für den Versand. Gewichtbasierte Versandkosten werden wie folgt berechnet: Stückzahl x Gewicht eines Artikels.

Pflichtfeld

Ja

Typ

Preis

Werte/Rang

0.01-99999.99

XPath

/Order/ShippingMethods/ShippingMethod/Rate/WeightBased/Amount

CountryCode Erklärung

Die ISO-Abkürzung für das Land (2 Buchstaben).

Pflichtfeld

Ja

Typ

String, 2 Zeichen

| Einkaufswagen und Button anpassen | 47

Werte/Rang

ISO-Standard

XPath

/Order/ShippingMethods/ShippingMethod/ExcludedRegions/ExcludedRegion/WorldRegion/ CountryCode

CurrencyCode Erklärung

Währung der gewichtsbasierten oder paketbasierten Kosten. Nur EUR wird akzeptiert.

Pflichtfeld

Ja

Typ

String, 3 Zeichen

Werte/Rang

EUR

XPath

Order/ShippingMethods/ShippingMethod/Rate/ShipmentBased/CurrencyCode /Order/ShippingMethods/ShippingMethod/Rate/WeightBased/CurrencyCode

DisplayableShippingLabel Erklärung

Die Beschreibung (oder Abkürzung) der Versandart. Zum Beispiel DHL.

Pflichtfeld

Nein

Typ

String, 40 Zeichen

XPath

/Order/ShippingMethods/ShippingMethod/DisplayableShippingLabel

ExcludedRegion Erklärung

Ein Container für die Liste der Regionen, in die Sie nicht versenden möchten.

Pflichtfeld

Nein

XPath

/Order/ShippingMethods/ShippingMethod/ExcludedRegions/ExcludedRegion

ExcludedRegions Erklärung

Ein Container für die Regionen, in die Sie nicht versenden möchten.

Pflichtfeld

Nein

XPath

/Order/ShippingMethods/ShippingMethod/ExcludedRegions

FulfillmentNetwork Erklärung

Die Methode, die Sie für die Versandabwicklung verwenden.

Pflichtfeld

Ja, wenn Sie Versand durch Amazon nutzen.

Typ

String, 40 Zeichen

Werte/Rang

MERCHANT | AMAZON_EU

XPath

/Order/Cart/Items/Item/FulfillmentMethod

IncludedRegion

| Einkaufswagen und Button anpassen | 48

Erklärung

Ein Container für die Liste der Regionen, in die Sie versenden möchten.

Pflichtfeld

Ja, wenn Sie ShippingMethods nutzen.

Typ

String, 40 Zeichen

Werte/Rang

PreDefinedRegion | USStateRegion | USZipRegion | WorldRegion

XPath

/Order/ShippingMethods/ShippingMethod/IncludedRegions/IncludedRegion

IncludedRegion Erklärung

Ein Container für die Regionen, in die Sie versenden möchten.

Pflichtfeld

Ja, wenn Sie ShippingMethods nutzen.

XPath

/Order/ShippingMethods/ShippingMethod/IncludedRegions

PostalRegion Erklärung

Die ISO-Abkürzung für das Land (2 Buchstaben).

Pflichtfeld

Nein

Typ

String, 2 Zeichen

Werte/Rang

ISO-Standard

XPath

Order/ShippingMethods/ShippingMethod/IncludedRegions/IncludedRegion/WorldRegion/ PostalRegion /Order/ShippingMethods/ShippingMethod/ExcludedRegions/ExcludedRegion/WorldRegion/ PostalRegion

PredefinedRegion Erklärung

Eine vordefinierte Versandregion. (Kein Staat, US-Postleitzahl oder spezielle Weltregion)

Pflichtfeld

Nein

Typ

String, 40 Zeichen

Werte/Rang

USContinental48States | USFull50States | USAll | WorldAll (USAll enthält alle Staaten und alle Regionen im Besitz der USA, wie z.B. Puerto Rico, Guam und die Kanalzone. Außerdem enthalten sind Feldpostadressen des amerikanischen Militärs).

XPath

/Order/ShippingMethods/ShippingMethod/IncludedRegions/ IncludedRegion/PreDefinedRegion /Order/ShippingMethods/ShippingMethod/ExcludedRegions/ ExcludedRegion/ PreDefinedRegion

Rate Erklärung

Der Container für die Definition der Versandkosten für ShippingMethod.

Pflichtfeld

Nein

XPath

/Order/ShippingMethods/ShippingMethod/Rate

| Einkaufswagen und Button anpassen | 49

ServiceLevel Erklärung

Der Name der Service-Ebene, die Sie in Ihrer Versandart definiert haben. Dieser Text erscheint im Bestellprozess des Käufers. Zum Beispiel Inland.

Pflichtfeld

Nein

Typ

String, 40 Zeichen

Werte/Rang

Domestic | Expedited Domestic

XPath

/Order/ShippingMethods/ShippingMethod/ServiceLevel

ShipmentBased Erklärung

Ein Container für die Gebühren, die für einen individuellen Versand berechnet werden.

Pflichtfeld

Nein

XPath

/Order/ShippingMethods/ShippingMethod/Rate/ShipmentBased

ShippingMethod Erklärung

Ein Container für die Gebühren, die für einen individuellen Versand berechnet werden.

Pflichtfeld

Ja

XPath

/Order/ShippingMethods/ShippingMethod

ShippingMethods Erklärung

Ein Container für ein Set von Versandregeln.

Pflichtfeld

Ja

XPath

/Order/ShippingMethods

ShippingMethodId Erklärung

Der Name der Versandart, die Sie mit dem Artikel verknüpfen möchten.

Pflichtfeld

Nein

Typ

String, 40 Zeichen

XPath

/Order/Cart/Items/Item/ShippingMethodIds/ShippingMethodId /Order/ShippingMethods/ShippingMethod/ShippingMethodId

ShippingMethodIds Erklärung

Container für die IDs der Versandarten, die auf den Artikel anwendbar sind.

Pflichtfeld

Nein

XPath

/Order/Cart/Items/Item/ShippingMethodIds

WeightBased

| Einkaufswagen und Button anpassen | 50

Erklärung

Ein Container für die Gebühr, die für den individuellen Versand eines gewichtsbasierten Artikesl berechnet wird. Das Gesamtgewicht wird wie folgt berechnet: Stückzahl x Gewicht eines Artikels.

Pflichtfeld

Nein

XPath

/Order/ShippingMethods/ShippingMethod/Rate/WeightBased

WorldRegion Erklärung

Ein Container für eine Weltregion oder einen Staat. WorldRegion muss entweder PostalRegion oder CountryCode enthalten.

Pflichtfeld

Ja

Typ

Typ

XPath

/Order/ShippingMethods/ShippingMethod/IncludedRegions/IncludedRegion/WorldRegion /Order/ShippingMethods/ShippingMethod/ExcludedRegions/ExcludedRegion/WorldRegion Hinweis: Wenn Sie eine ShippingMethodId oder einen ShippingMethod-Bereich festlegen, dann werden die Einstellungen zu den Versandkosten in Seller Central nicht für die Bestellverarbeitung über Amazon Payments verwendet. Sie sind für den Versand Ihrer Bestellungen verantwortlich, auch dann, wenn Sie keine Versandkosten in Seller Central oder in Ihrem Einkaufswagen zuweisen. Wenn Sie eine ShippingMethod festlegen, müssen Sie auch Rate und IncludedRegion festlegen. Rate kann ShipmentBased mit WeightBased oder itemQuantityBased enthalten. Rate kann allerdings nicht sowohl WeightBased als auch itemQuantityBased gleichzeitig enthalten. Rate kann nur die folgenden Werte enthalten: ShipmentBased, WeightBased oder ItemQuantityBased; ShipmentBased und WeightBased; oder ShipmentBased und ItemQuantityBased Die Regionen, die Sie im ShippingMethod-Bereich festlegen, werden verwendet, um herauszufinden, ob ein Käufer Ihre Artikel kaufen kann. Wenn IncludedRegions und ExcludedRegions dazu führen, dass die Versandadresse des Käufers nicht verwendet werden kann, dann erhält der Käufer im Bestellprozess die Nachricht, dass Sie nicht an diese Adresse liefern können. Der Käufer kann in diesem Fall entweder eine andere Versandadresse auswählen, oder die Bestellung stornieren. Sie erhalten keine Benachrichtigung, wenn Käufer versuchen, eine Bestellung aufzugeben und die Bestellung aufgrund der Versandadresse nicht abschließen können.

Code-Beispiele für Versandkostenüberschreibungen Hier sehen Sie ein Code-Beispiel für einen Einkaufswagen, der sowohl gewichtbasierte, als auch mengenbasierte Versandkosten enthält. ABC123/SKU> AEIOU1234AEIOU Roter Fisch 19.99 EUR 1 1 kg item-shipping-method-1 item-shipping-method-2 item-shipping-method-3 MERCHANT DEF456/SKU> AEIOU1234AEIOU DEF456 Ein roter Fisch, eingelegt in einem leichten Olivenöl. 49.99/Amount> EUR

| Einkaufswagen und Button anpassen | 51

5 itemshipping-method-1 item-shippingmethod-2 item-shipping-method-3 AMAZON_EU http://img/8MP9Q.jpg item-shipping-method-1 Standard 5.00 EUR 6.00 EUR USAll item-shipping-method-2 Standard 5.00 EUR USAll FL item-shippingmethod-3 Standard 5.00 EUR USAll

Werbeaktionen überschreiben Mittels der Überschreibung von Werbeaktionen können Sie innerhalb Ihres individuellen Einkaufswagen-Codes feste Rabattwerte oder Prozentwerte festlegen und zur Verarbeitung an Amazon Payments senden. Diese Werbeaktionen können Sie auf Artikelebene oder Einkaufswagenebene festlegen. (Wenn Ihr Einkaufswagen-Code auf XML basiert, können Sie die Werbeaktionen entwedre auf Artikelebene oder auf Einkaufswagenebene festlegen, aber nicht beides gleichzeitig.) Das Hinzufügen von Werbeaktion-Überschreibungen besteht aus drei Teilen: 1. Wählen Sie die Art der Werbeaktionen: Artikelebene oder Einkaufswagenebene. 2. Für Werbeaktionen auf Artikelebene fügen Sie die Überschreibung zum Item-Tag hinzu, um die gewünschte Werbeaktion zu definieren. 3. Fügen Sie die passenden Tags und Definitionen hinzu, um die gewünschten Werberabatte oder Prozentwerte festzulegen. Diese Tabellen listen die XML-Tags auf, die Sie nutzen können, um Werbeaktionüberschreibungen im Einkaufswagen zu nutzen. Amount (DiscountRate) Erklärung

Der Rabattwert als Prozentsatz vom Preis.

Pflichtfeld

Ja, wenn DiscountRate angegeben wurde.

Typ

Positive Gleitkommazahl (Double)

Werte/Rang

0.0--1.0

XPath

/Order/Promotions/Promotion/DiscountRate/Amount

Amount (FixedAmount)

| Einkaufswagen und Button anpassen | 52

Erklärung

Die Höhe des Rabatts in Bezug zur Währungseinheit.

Pflichtfeld

Ja, wenn FixedAmount angegeben wurde.

Typ

Positive Gleitkommazahl (Double)

Werte/Rang

0.00--99999.99

XPath

/Order/Promotions/Promotion/FixedAmountDiscount/Amount

CartPromotionId Erklärung

Der Name der Werbeaktion für den Einkaufswagen.

Pflichtfeld

Ja, bei Werbeaktionen auf Einkaufswagenebene.

Typ

String, 3 Zeichen

Typ

String, 255 Zeichen

XPath

Order/Cart/CartPromotionId

CurrencyCode Erklärung

Währung für DiscountRate oder FixedAmount. Aktuell wird nur EUR unterstützt.

Pflichtfeld

Ja

Typ

String, 3 Zeichen

Werte/Rang

EUR

XPath

/Order/Promotions/Promotion/DiscountRate/CurrencyCode /Order/Promotions/Promotion/FixedAmountDiscount/CurrencyCode

DiscountRate Erklärung

Der Container für den Rabattwert.

Pflichtfeld

Ja, wenn PromotionBenefit angegeben wurde.

XPath

/Order/Promotions/Promotion/DiscountRate

FixedAmountDiscount Erklärung

Ein Container für den festen Rabattwert, der vom Preis abgezogen wird.

Pflichtfeld

Nein

XPath

/Order/Promotions/Promotion/FixedAmountDiscount

Promotion Erklärung

Der Container für die definierten Werbeaktionen.

Pflichtfeld

Ja

XPath

/Order/Promotions/Promotion/

| Einkaufswagen und Button anpassen | 53

PromotionBenefit Erklärung

Der Container für den Rabattwert.

Pflichtfeld

Ja, wenn Promotion angegeben wurde. PromotionBenefit muss eines - nur eines - der folgenden Felder enthalten: DiscountRate oder FixedAmountDiscount.

Werte/Rang

DiscountRate | FixedAmountDiscount.

XPath

/Order/Promotions/Promotion/PromotionBenefit

PromotionId Erklärung

Der Name der Werbeaktion für einen Artikel.

Pflichtfeld

Ja, bei Werbeaktionen auf Artikelebene.

Typ

String, 255 Zeichen

XPath

/Order/Cart/Items/Item/PromotionIds/PromotionId /Order/Promotions/Promotion/PromotionId

PromotionIds Erklärung

Der Container für Werbeaktionen, die auf einen individuellen Artikel zutreffen können. (Werbeaktionen auf Artikelebene)

Pflichtfeld

Nein

XPath

/Order/Cart/Items/Item/PromotionIds

Promotions Erklärung

Der Container für die Definition jeder verfügbaren Werbeaktion im Einkaufswagen. (Werbeaktionen auf Einkaufswagenebene)

Pflichtfeld

Nein

XPath

/Order/Promotions Hinweis: Sie können entweder eine Werbeaktion auf Einkaufswagenebene oder mehrere Werbeaktionen auf Artikelebene (eine pro Artikel) anbieten. Das bedeutet, dass sich Werbeaktionen auf Einkaufswagenebene und Werbeaktionen auf Artikelebene sich gegenseitig ausschließen. Diese Einschränkung steht nicht in der XSD-Datei. Sie können Werbeaktionen in Seller Central und im Rahmen Ihres Bestellprozesses festlegen. Sobald eine Bestellung aufgeben wird, werden alle Werbeaktionen geprüft und angewendet, falls zutreffend. Das bedeutet: Wenn Sie in Seller Central die Werbeaktionen "5 Euro Rabatt" und "Sparen Sie 25%" angelegt haben und außerdem eine Werbeaktion "10 Euro Rabatt" in Ihrem Einkaufsagen angelegt haben und sich die Bestellung für all diese Werbeaktionen qualifiziert, dann werden alle drei Aktionen angewendet. Der Käufer spart 15 Euro und erhält zusäztlich noch einen Rabatt von 25%. Falls Sie eine Werbeaktion "kostenloser Versand" in Seller Central angelegt, aber keine weitere Werbeaktionen in Ihrem Einkaufswagen festgelegt haben, dann wird die Werbeaktion "kostenloser Versand" auf Ihre Bestellung angewendet.

| Einkaufswagen und Button anpassen | 54

Eine Werbeaktion kann nicht bezwecken, dass der Käufer mehr spart, als die Artikel im Einkaufswagen wert sind. Das bedeutet: Wenn Sie in Seller Central die Werbeaktion "5 Euro Rabatt" angelegt haben und in Ihrem Code 15 Euro Rabatt gewähren, der Artikelpreis aber 10 Euro beträgt, dann spart Ihr Kunde 10 Euro und erhält den Artikel kostenlos. Das trifft auch auf prozentuale Rabatte zu: Wenn Sie in Seller Central einen Rabatt von 50% definieren und in Ihrem Einkaufswagencode einen Rabat von 60%, dann erhält Ihr Kunde einen Rabatt von maximal 100%. Auch bei kombinierten Rabatten trifft diese Regel zu: Wenn Sie einen Rabatt in Höhe von 15 Euro und einen Rabatt in Höhe von 25% anbieten und der Artikel 17,50 Euro kostet, dann kann Ihr Kunde maximal den Artikelpreis in Höhe von 17,50 Euro sparen. Wenn Sie in Ihrem Einkaufswagencode einen Rabattwert in Höhe von mehr als 100% definieren, dann kann der Rabatt nicht angewendet und die Bestellung nicht verarbeitet werden. Code-Beispiele für Überschreibungen von Werbeaktionen Hier sehen Sie ein Beispiel für einen Einkaufswagen, der Überschreibungen von Werbeaktionen enthält DEF456 AEIOU1234AEIOU Blauer Fisch Ein blauer Fisch in leichtem Olivenöl. 49.99 EUR 1 1 kg http://img/8MP9Q.jpg cart-promotion-1 cart-promotion-1 My promo 5 EUR Hier sehen Sie ein Code-Beispiel für einen Einkaufswagen, in dem Werbeaktionen auf Artikelebene überschrieben wurden: ABC123 AEIOU1234AEIOU Roter Fisch Ein roter Fisch in frischem Quellwasser. 19.99 EUR 101 1 kg item-promotion-1 DEF456DEF456 AEIOU1234AEIOU A blue fish packed in light olive oil. 49.99 EUR 1 1 kg item-promotion-2 MERCHANT http://img/8MP9Q.jpg item-promotion-1

| Einkaufswagen und Button anpassen | 55

10 EUR item-promotion-2 6 EUR

Flexible Versandoptionen Mittels flexibler Versandoptionen können Sie eigene Versandoptionen (Namen) festlegen, mit denen Sie die Versandeinstellungen überschreiben. Auf diese Weise können Sie Ihre eigenen Versandoptionsnamen festlegen (wie z.B. kostenloser Standard-Versand oder DHL Express-Versand) und diese mit den Standard-Namen von Bezahlen über Amazon verknüpfen, wie z.B. "Standard" oder "Express". Das bedeutet, dass Ihre Kunden den neuen Namen wie "kostenloser Standard-Versand" sehen und die Versandkosten anhand der damit verknüpften Versandart berechnet werden. Indem Sie flexible Versandoptionen nutzen,können Sie 20 verschiedene benutzerdefinierte Versandoptionennamen pro Lieferziel einrichten und diese mit den verschiedenen Versand-Ebenen und Versandkosten verknüpfen. • • •

Sie können den Versand-Ebenen Standard und Express bis zu sieben verschiedene Namen zuweisen. Sie können den Versand-Ebenen "Ein Tag" und "Zwei Tage" bis zu fünf verschiedene Namen zuweisen. Ihre benutzerdefinierten Versandoptionennamen können bis zu 100 Zeichen enthalten.

Sie können diese benutzerdefinierten Versandkostennamen für jede Versandregion definieren. Wenn Sie z.B. 20 verschiedene Versandoptionennamen innerhalb Deutschlands festlegen, können Sie auch noch weitere 20 Versandoptionennamen für Versandregionen außerhalb Deutschlands festlegen. Hinweis: Sie können die flexiblen Versandoptionen nicht nutzen, wenn Sie einen "Bezahlen über Amazon"-Button in Seller Central generieren. Für flexible Versandoptionen müssen Sie den Code anpassen können, das ist allerdings bei in Seller Central generierten Buttons nicht möglich. Für Informationen zur Konfiguration von Versandkostenüberschreibungen bei der Nutzung von Callbacks lesen Sie bitte das Handbuch Callback Guide und das Callback Guide Developer Cheat Sheet.

Darstellung bei Ihrem Kunden Ihre Kunden können die flexible Versandoptionen, die Sie in Ihrem Code definieren, sehen und auswählen. (Für weitere Informationen dazu, wie Sie diese Versandoptionen zu Ihrem Button-Code hinzufügen können, lesen Sie bitte Flexible Versandoptionen bei XML-basierten Einkaufswagen nutzen auf Seite 58.) Käufer sehen die flexiblen Versandoptionen an den folgenden Stellen: • • • • •

Express-Bestellvorgang Standard-Bestellvorgang Bestellübersichtseite "Mein Konto"-Seite bei Amazon Payments Bestellbenachrichtigungen über neue Bestellungen

Hier sehen Sie ein Beispiel dafür, wie flexible Versandoptionen auf der Bestellübersichtseite des Käufers aussehen: Abbildung 12: Darstellung beim Käufer mit vier benutzerdefinierten Versandoptionen

Bestellungen aus Händlersicht Die flexiblen Versandoptionen, die von Ihren Kunden ausgewählt werden können, werden in den folgenden Bereichen von Seller Central angezeigt:

| Einkaufswagen und Button anpassen | 56

• • •

Die Bestelldetailsseite Auf dem Packzettel In der herunterladbaren XML-Datei für die Bestellberichte

Die flexiblen Versandoptionen werden außerdem in den XML-basierten Benachrichtigungen angezeigt, die Sie erhalten, wenn Sie die Instant Order Processing Notification (IOPN) API nutzen. Hinweis: In der Zusammenfassung des Auftrags (aufgelistet auf der Seite "Bestellungen verwalten") zeigt die flexiblen Versandoptionen nicht an. Stattdessen werden die vordefinierten Versandoptionen angezeigt (wie z.B. Standard oder Express). Wenn Sie die Bestelldetails einsehen (auf der Seite Bestelldetails oder in den Bestellberichten), wird die korrigierte Versandoption angezeigt. Seller Central zeigt immer die zur Bestellung gehörende Service-Ebene und die benutzerdefinierte Versandoption, die mit dieser Service-Ebene verknüpft wurde, an. Seller Central Bestelldetails Auf der Bestelldetailsseite werden die Service-Ebene und die flexible Versandoption, die vom Käufer ausgewählt wurde, angezeigt. Abbildung 13: Der Händler sieht sowohl die Versandart, als auch den Verkaufkanal in den Details. Seller Central Bestellung und Packzettel Auf der Seite "Bestellung und Packzettel" wird die ausgewählte flexible Versandoption angezeigt. Abbildung 14: Der Händler sieht sieht die benutzerdefinierte Versandoption. Seller Central und Bestellberichte Die ausgewählte flexible Versandoption wird im Abschnitt CustomizationInfo der Bestellberichte wie folgt angezeigt: ... CartId miq://rose:1.0/cart/cba:1.0/cart:2.0/AZ4B0ZS3LGLX/A3JN8ZRLU5XWVP/ 2-1241714154767-D928C1251AE8F8E6 orderChannel Amazon Checkout (Live) CBAShipLabel Kostenloser Versand ... "Bestellung versandbereit"-E-Mail In der E-Mail-Benachrichtigung über eine versandbereite Bestellung wird die ausgewählte flexible Versandoption angezeigt. Abbildung 15: Der Händler sieht die E-Mail-Benachrichtigung über eine versandbereite Bestellung mit der benutzerdefinierten Versandoption. Instant Order Processing Notification (IOPN) API

| Einkaufswagen und Button anpassen | 57

Der Code, den Sie erhaltne, wenn Sie die Instant Order Processing Notification API nutzen, zeigt die flexible Versandoption an, die der Käufer ausgewählt hat. ... Standard-Versand ... ... Voraussetzungen •

XML-basierte Einkaufswagen müssen die order.xsd mit dem Datum 05/15/2009 verwenden, die das folgende neue Element innerhalb des ShippingMethod-Typs enthalten:

Service-Ebenen und benutzerdefinierte Versandoptionen Wenn Sie flexible Versandoptionen nutzen, müssen Sie Ihren benutzerdefinierten Versandoptionen trotzdem eine der beiden Service-Ebenen zuweisen (Standard oder Express). Der ursprüngliche Name der Service-Ebene wird Ihrem Kunden nicht angezeigt, ist aber für Sie in Seller Central und in den IOPN-Nachrichten sichtbar. Die Service-Ebene repräsentiert die Lieferbedingungen (Service Level Agreement, kurz SLA) einer Versandoption, die Sie mittels eines eigenen Namen angepasst haben. Hier sehen Sie die SLAs für jede der vordefinierten Service-Ebenen: Region

Standard

Express

UK Festland

3-5 Geschäftstage

1-2 Geschäftstage

(Vereinigtes Königreich, exklusive Feldpost, Kanalinseln, Nordirland und Äußere Hebriden) UK Postfach

3-4 Geschäftstage

(Postfächer im Vereinigten Königreich) Feldpost

3-5 Geschäftstage

(British Forces Post Office) UK außerhalb des Festlands

3-5 Geschäftstage

(Kanalinseln, Nordirland und Äußere Hebriden) Europa Zone 1

3-7 Geschäftstage

(Belgien, Dänemark, Frankreich (Festland), Deutschland, Irland, Luxemburg, Monaco und die Niederlande) Europa Zone 2

3-7 Geschäftstage

(Griechenland, Italien, Portugal und Spanien) Europa Zone 3

8-12 Geschäftstage

(alle anderen europäischen Länder) Nordamerika

6-10 Geschäftstage

Japan

6-10 Geschäftstage

| Einkaufswagen und Button anpassen | 58

Region

Standard

Australien und fernöstliches Asien

8-12 Geschäftstage

Rest der Welt

8-12 Geschäftstage

Express

Flexible Versandoptionen bei XML-basierten Einkaufswagen nutzen Um die Versand-Ebenen für XML-basierte Einkaufswagen anzupassen, fügen Sie den folgenden Code zum Bereich ShippingMethods hinzu: ... Standard-Versand ... ... Beispiel: Der folgende Code fügt eine Versandart namens "Standard-Versand" zu der vordefinierten Versand-Ebene "Standard" hinzu: CART20100731AEIOU 2010-08-31 STU434 AEIOU1234AEIOU Oliver Stops the Filibuster By Sandy Pfarrer 13.29 EUR 1 1.0 kg Books New item-Ship-1 item-Ship-2 item-Ship-3 itemShip-4 itemShip-1 Standard 1 EUR USFull50States Standard-Versand item-Ship-2 Expedited 2 EUR USFull50States Standard-Versand item-Ship-3 OneDay 3 EUR USContinental48States USPS Standard Shipping item-Ship-4 TwoDay 4 EUR USFull50States Standard-Versand VWXYZ98765VWXYZ www.IntegratorWorld.com http:// www.mysite.com/shopping http://www.mysite.com/home http://www.mysite.com/account

| Einkaufswagen und Button anpassen | 59

Flexible Versandoptionen und die Instant Order Processing Notification API Wenn Sie flexible Versandoptionen und die Instant Order Processing Notification API nutzen, erhalten Sie neue Informationen in der Nachricht, die an Sie senden. Wenn Sie diese Nachricht erhalten, müssen Sie die neuen Informationen parsen. Die Definition ist in der order.xsd wie folgt festgehalten: ... Wenn Sie die IOPN-Nachricht erhalten, wird der Eintrag für die flexible Versandoption wie folgt aussehen: ... DHL Standard-Versand ... Für weitere Informationen zu den IOPN-Nachrichten lesen Sie bitte das Instant Order Processing Notification API Handbuch (PDF).

Flexible Versandoptionen mit der Callback-API nutzen Falls Sie flexible Versandoptionen und die Callback-API nutzen, können Sie benutzerdefinierte Namen für die Versandoptionen im Parameter ShippingMethods festlegen, der in der Callback-Antwort-Datei zurückgegeben wird. USStandard USPS Standard Shipping Standard 3.49 EUR 98104 Für weitere Informationen zur Nutzung der Callback-API lesen Sie bitte den Callback API Guide (PDF, englisch).

Button-Stile anpassen Zeigen Sie auf Ihrer Website "Bezahlen über Amazon"-Buttons an, die Ihre Käufer anklicken können, um erfolgreich Bestellungen aufzugeben. Sie können zwischen verschiedenen Button-Größen, -Farben oder auch Hintergrundfarben für die Buttons wählen. Beispiel: Wir vermuten, dass Sie den folgenden Button verwenden möchten: Setzen Sie den buttonSettings-Parameter des Widgets auf die folgenden Werte, um diesen Button anzuzeigen: {size:'large', color:'orange', background:'white'}

Zusätzliche Funktionen von Bezahlen über Amazon Sie können Ihre Integration von Bezahlen über Amazon mit den folgenden Funktionen anpassen: • •

Verwenden Sie Callback-Überschreibungen - siehe The Callback API Guide (PDF, englisch). Verwenden Sie die Instant Order Processing Notifications - siehe das Handbuch zur Instant Order Processing Notification API (PDF).

| Einkaufswagen und Button anpassen | 60

Bitte laden Sie sich diese Dokumente herunter und lesen Sie diese, um weitere Informationen zu erhalten.

Anhang

A

Code-Beispiele Themen: •

• •

Bestellmanagement über den Amazon Marketplace Web Service (MWS) Callback-API Instant Order Processing Notification API

Verwenden Sie diese Code-Beispiele, um zu verstehen, wie die Einbindung von Bezahlen über Amazon funktioniert, und um Ihren eigenen Code zu erzeugen. Beachten Sie, dass diese Code-Beispiele alle eine Beispiel-Händlernummer (merchantId) namens "AEIOU1234AEIOU" verwenden. Wenn Sie diese Händlernummer im Code sehen, sollten Sie diese durch Ihre eigene Händlernummer ersetzen.

| Code-Beispiele | 62

Bestellmanagement über den Amazon Marketplace Web Service (MWS) Dateiname

Version

Aktualisiert

MWS-Berichte-API - erhalten Sie die Informationen zu Ihren Bestellungen automatisch.

2009-01-01

MWS-Feeds-API - laden Sie Bestellinformationen, Erstattungsaufträge und vieles mehr hoch.

2009-01-01

Callback-API Dateiname

Version

Aktualisiert

Beispielcode Java

1.0.2

2009-08-25 8:00

1.0.1

2009-03-10 16:00

Beispielcode PHP

1.0.0

15.01.2009 16:30

Beispielcode C#

1.0.0

20.01.2009 16:30

(mit Schema-Daten vom 2009-05-15) Beispielcode Java (mit Schema-Daten vom 30.11.2008)

Instant Order Processing Notification API Dateiname

Version

Aktualisiert

Beispielcode Java

1.0.1

2009-03-10 16:00

Beispielcode PHP

1.0.0

03.02.2009 14:30

Anhang

B

Button-Stile Themen: • • •

Weißer Hintergrund Heller Hintergrund Dunkler Hintergrund

Zeigen Sie auf Ihrer Website "Bezahlen über Amazon"-Buttons an, die Ihre Käufer anklicken können, um erfolgreich Bestellungen aufzugeben. Wählen Sie eine Button-Grafik, die Sie verwenden möchten, und kopieren Sie die Grafik-URL in den Code Ihrer Website. Hier sehen Sie die Button-Grafiken, die Sie auf Ihrer Website platzieren können.

| Button-Stile | 64

Weißer Hintergrund

Hintergrund: Weiß Farbe: Orange Größe: XL (173 x 38)

Hintergrund: Weiß Farbe: Orange Größe: L (151 x 38)

Hintergrund: Weiß Farbe: Orange Größe: M (126 x 35) Hintergrund: Weiß Farbe: Beige Größe: XL (173 x 38)

Hintergrund: Weiß Farbe: Beige Größe: L (151 x 38)

Hintergrund: Weiß Farbe: Beige Größe: M (126 x 35)

Heller Hintergrund Hintergrund: Hell Farbe: Orange Größe: XL (173 x 38)

| Button-Stile | 65

Hintergrund: Hell Farbe: Orange Größe: L (151 x 38)

Hintergrund: Hell Farbe: Orange Größe: M (126 x 35)

Hintergrund: Hell Farbe: Beige Größe: XL (173 x 38)

Hintergrund: Hell Farbe: Beige Größe: L (151 x 38)

Hintergrund: Hell Farbe: Beige Größe: M (126 x 35)

Dunkler Hintergrund Hintergrund: Dunkel Farbe: Orange Größe: XL (173 x 38)

Hintergrund: Dunkel Farbe: Orange Größe: L (151 x 38)

| Button-Stile | 66

Hintergrund: Dunkel Farbe: Orange Größe: M (126 x 35)

Hintergrund: Dunkel Farbe: Beige Größe: XL (173 x 38)

Hintergrund: Dunkel Farbe: Beige Größe: L (151 x 38)

Hintergrund: Dunkel Farbe: Beige Größe: M (126 x 35)

Anhang

C

XML-Schema und Definitionen Themen: •

Definitionstabelle

Hier finden Sie eine vollständige Liste der Cart-Elemente und ihren Definitionen für Bestellungen, die von Amazon Payments verarbeitet werden.

| XML-Schema und Definitionen | 68

Definitionstabelle A Amount (Preis) Erklärung

Die Kosten für einen Artikel

Pflichtfeld

Ja

Typ

Preis

Werte/Rang

0.01--99999.99

XPath

/Order/Cart/Items/Item/Price/Amount

Amount (Gewicht) Erklärung

Das Gewicht Ihres Artikels

Pflichtfeld

Ja, wenn ein Weight angegeben wurde.

Typ

Positive Gleitkommazahl (Double)

Werte/Rang

0.01--99999.99

XPath

/Order/Cart/Items/Item/Weight/Amount

Amount (Rabattwert in Prozent) Erklärung

Der Rabattwert als Prozentsatz vom Preis.

Pflichtfeld

Ja, wenn DiscountRate angegeben wurde.

Typ

Positive Gleitkommazahl (Double) Ein 10%-Wert ist 0.10, ein 0,10%-Wert ist 0.001

Werte/Rang

0.0--1.0

XPath

/Order/Promotions/Promotion/DiscountRate/Amount

Amount (Rabattwert in Euro) Erklärung

Die Höhe des Rabatts

Pflichtfeld

Ja, wenn FixedAmountDiscount angegeben wurde.

Typ

Positive Gleitkommazahl (Double)

Werte/Rang

0.00--99999.99

XPath

/Order/Promotions/Promotion/FixedAmountDiscount/Amount

Amount (Versandkosten) Erklärung

Die Kosten für den Versand.

Pflichtfeld

Ja, wenn ShipmentBased angegeben wurde.

| XML-Schema und Definitionen | 69

Typ

Preis

Werte/Rang

0.01--99999.99

XPath

/Order/ShippingMethods/ShippingMethod/Rate/ShipmentBased/Amount

Amount (Gewicht) Erklärung

Die berechneten Versandkosten. Das Gesamtewicht wird wie folgt berechnet: Stückzahl x Gewicht eines Artikels.

Pflichtfeld

Ja, wenn WeightBased angegeben wurde.

Typ

Boolean

Werte/Rang

Preis

XPath

/Order/ShippingMethods/ShippingMethod/Rate/WeightBased/Amount

C Cart Erklärung

Der wesentliche Container Ihrer Bestellung. Ein einfacher Einkaufswagen enthält ein Artikel-Element mit Ihrer Händlernummer (MerchantId) und einem Artikel (Item) mit einem Artikelpreis (Price/Amount), einem Währungscode (Price/CurrencyCode) und einer StückAngabe (Quantity).

Pflichtfeld

Ja

XPath

/Order/Cart

Category (Artikel) Erklärung

Die Gruppe, in die Ihr Artikel gehört.

Pflichtfeld

Nein

Typ

String/Enumerated List (Liste)

Werte/Rang

Antiquitäten | Kleidung, Schuhe & Accessories | Kfz-Zubehör| Schönheit | Bücher | Business | Kameras & Fotografie | Sammelstücke | Computer-Hardware & Zubehör | Elektronik | Lebensmittel & Getränke | Geschenke & Blumen | Gesundheit | Hobbys, Spielzeug & Spiele | Heim & Garten | Schmuck & Uhren | Medien & Unterhaltung | Haustiere | Software | Sport & Freizeit | Reisen

XPath

Order/Cart/Items/Item/Category

Condition Erklärung

Der Zustand, in dem sich der Artikel befindet.

Pflichtfeld

Ja, wenn Sie Versand durch Amazon für diesen Aritkel verwenden und wenn Sie den gleichen Artikel in mehreren Zuständen verkaufen. Nein, wenn Sie Versand durch Amazon nicht verwenden oder wenn ein über Versand durch Amazon verschickter Artikel nur in einem Zustand verfügbar ist.

Typ

String/Enumerated List (Liste)

| XML-Schema und Definitionen | 70

Werte/Rang

Beliebig | Club | Sammlerstück | Neu | Erneuert | Gebraucht

XPath

/Order/Cart/Items/Item/Condition

CountryCode Erklärung

Die ISO-Abkürzung für das Land (2 Buchstaben).

Pflichtfeld

Nein

Typ

String, maximal 2 Zeichen

Werte/Rang

ISO-Ländercodes

XPath

/Order/ShippingMethods/ShippingMethod/IncludedRegions/IncludedRegion/WorldRegion/ CountryCode /Order/ShippingMethods/ShippingMethod/ExcludedRegions/ExcludedRegion/WorldRegion/ CountryCode

CurrencyCode (Artikel) Erklärung

Währung des Artikelpreises. Aktuell wird nur EUR unterstützt.

Pflichtfeld

Ja

Typ

String/Enumerated List (Liste)

Werte/Rang

EUR

XPath

Währung des Artikelpreises. Aktuell wird nur EUR unterstützt.

CurrencyCode (Rabattwert in Prozent) Erklärung

Währung für DiscountRate. Aktuell wird nur EUR unterstützt.

Pflichtfeld

Ja

Typ

String/Enumerated List (Liste)

Werte/Rang

EUR

XPath

/Order/Promotions/Promotion/DiscountRate/CurrencyCode

CurrencyCode (Rabattwert in Euro) Erklärung

Währung für FixedAmountDiscount. Aktuell wird nur EUR unterstützt.

Pflichtfeld

Ja, wenn FixedAmountDiscount angegeben wurde.

Typ

String/Enumerated List (Liste)

Werte/Rang

EUR

XPath

/Order/Promotions/Promotion/FixedAmountDiscount/CurrencyCode

CurrencyCode (Versand) Erklärung

Währung der Versandkosten (ShipmentBased). Aktuell wird nur EUR unterstützt.

| XML-Schema und Definitionen | 71

Pflichtfeld

Ja, wenn ShipmentBased angegeben wurde.

Typ

String/Enumerated List (Liste)

Werte/Rang

EUR

XPath

/Order/ShippingMethods/ShippingMethod/Rate/ShipmentBased/Amount

CurrencyCode (Gewicht) Erklärung

Währung des gewichtbasierten Preises. Aktuell wird nur EUR unterstützt.

Pflichtfeld

Ja, wenn WeightBased angegeben wurde.

Typ

String/Enumerated List (Liste)

Werte/Rang

EUR

XPath

/Order/ShippingMethods/ShippingMethod/Rate/WeightBased/CurrencyCode

D Description (Artikel) Erklärung

Die Artikeldetails.

Pflichtfeld

Nein

Typ

String, maximal 255 Zeichen

XPath

/Order/Cart/Items/Item/Condition

Description (Versand) Erklärung

Die Beschreibung (oder Abkürzung) der Versandart.

Pflichtfeld

Nein

Typ

String, maximal 40 Zeichen

XPath

/Order/ShippingMethods/ShippingMethod/Description

Description (upsell) Erklärung

Die Beschreibung des Artikels, den Sie über die Upsell-Funktion verkaufen möchten.

Pflichtfeld

Nein

Typ

String, maximal 40 Zeichen

XPath

/Order/MerchantUp-sellItems/Description

DiscountRate Erklärung

Der Container für den Rabattwert.

Pflichtfeld

Ja, wenn PromotionBenefit angegeben wurde.

XPath

/Order/Promotions/Promotion/DiscountRate

| XML-Schema und Definitionen | 72

E ExcludedRegion Erklärung

Ein Container für die Liste der Regionen, in die Sie nicht versenden möchten.

Pflichtfeld

Nein

XPath

/Order/ShippingMethods/ShippingMethod/ExcludedRegions/ExcludedRegion

ExcludedRegions Erklärung

Ein Container für die Regionen, in die Sie nicht versenden möchten.

Pflichtfeld

Nein

XPath

/Order/ShippingMethods/ShippingMethod/ExcludedRegions

ExpirationDate Erklärung

Das Datum, zu dem die Session des Einkaufswagens abläuft. Nachdem das Ablaufdatum erreicht wurde, wird der Inhalt des Einkaufswagens nicht mehr verarbeitet.

Pflichtfeld

Nein

Typ

Datum nach ISO 8601

XPath

/Order/ExpirationDate

F FixedAmountDiscount Erklärung

Ein Container für den festen Rabattwert, der vom Preis abgezogen wird.

Pflichtfeld

Nein

XPath

/Order/Promotions/Promotion

FulfillmentNetwork Erklärung

Die Methode, die Sie für die Versandabwicklung verwenden.

Pflichtfeld

Nein, wenn Sie Versand durch Amazon nicht verwenden. Ja, wenn Sie Versand durch Amazon verwenden. Beachten Sie, dass Sie eine SKU angeben müssen, wenn Sie die Variable FullfilmentNetwork auf AMAZON_EU setzen.

Typ

String, maximal 10 Zeichen

Werte/Rang

MERCHANT | AMAZON_EU

XPath

/Order/Cart/Items/Item/FulfillmentMethod

Erklärung

Der Container für die URL, die auf Ihr Bild zeigt.

Pflichtfeld

Ja, wenn Images angegeben wurde.

I

| XML-Schema und Definitionen | 73

XPath

/Order/Cart/Items/Item/Images/Image /Order/MerchantUp-sellItems/Images/Image

Images Erklärung

Der Container für Ihre Bilderangabe (Image, URL).

Pflichtfeld

Nein

XPath

/Order/Cart/Items/Item/Images /Order/MerchantUp-sellItems/Images

IncludedRegion Erklärung

Ein Container für die Liste der Regionen, in die Sie versenden möchten.

Pflichtfeld

Ja, wenn ShippingMethods angegeben wurden. Sie müssen mindestens eine der folgenden Regionen angeben: PreDefinedRegion, USStateRegion, USZipRegion, WorldRegion.

XPath

/Order/ShippingMethods/ShippingMethod/IncludedRegions/ IncludedRegion

IncludedRegions Erklärung

Ein Container für die Regionen, in die Sie versenden möchten.

Pflichtfeld

Ja, wenn ShippingMethods angegeben wurden.

XPath

/Order/ShippingMethods/ShippingMethod/IncludedRegions

IntegratorId Erklärung

Ein eindeutiger Bezeichner für den Integrationsdienstleister, der Sie bei der Integration von Bezahlen über Amazon unterstützt.

Pflichtfeld

Nein

Typ

String, maximal 13 Zeichen

XPath

/Order/IntegratorId

IntegratorName Erklärung

Der Name des Integrationsdienstleisters, der Sie bei der Integration von Bezahlen über Amazon unterstützt.

Pflichtfeld

Nein

Typ

String, maximal 100 Zeichen

XPath

/Order/IntegratorName

Item Erklärung

Der Container für die Informationen zum Artikel, den Sie verkaufen.

Pflichtfeld

Ja

| XML-Schema und Definitionen | 74

XPath

/Order/Cart/Items/Item

Items Erklärung

Der Container für alle Artikel

Pflichtfeld

Ja

XPath

/Order/Cart/Items

m MerchantId Erklärung

Ihre eindeutige ID, die Amazon verwendet, um Ihre Bestellanfragen zu identifizieren. Sie müssen für jeden Artikel dieselbe Händlernummer eintragen.

Pflichtfeld

Ja

Typ

String, maximal 14 Zeichen

XPath

/Order/Cart/Items/Item/MerchantId /Order/MerchantUp-sellItems/MerchantId

MerchantUp-sellItem Erklärung

Container für den individuellen Artikel von Ihrer Website, den Sie mittels der Upsell-Funktion anzeigen möchten.

Pflichtfeld

Nein

XPath

/Order/MerchantUp-sellItems/MerchantUpsellItem

MerchantUp-sellItems Erklärung

Container für die Liste der individuellen Artikel von Ihrer Website, die Sie mittels der UpsellFunktion anzeigen möchten.

Pflichtfeld

Nein

XPath

/Order/MerchantUp-sellItems

O Order Erklärung

Der Hauptcontainer für Ihren Einkaufswagen. Alle anderen Elemente sind Unterelemente des Order-Elements. Der einfachste Order-Container beinhaltet ausschließlich einen Einkaufswagen mit einem Items-Element, das wiederum Ihre Händlernummer, einen Artikel mit Preis und Währung sowie eine Mengenangabe enthält. Das Order-Element muss die Version-Information enthalten, die mit der XSD-Datei übereinstimmt, um die XML-Datei zu generieren. Wenn Sie z.B. die XSD mit dem Datum 30. November 2008 verwenden, muss Ihr Namespace den folgenden String beinhalten: xmlns="http://payments.amazon.com/checkout/2008-11-30/"

Pflichtfeld

Ja

XPath

/Order

| XML-Schema und Definitionen | 75

P PostalRegion Erklärung

Die ISO-Abkürzung für das Land (2 Buchstaben).

Pflichtfeld

Nein

Typ

String, maximal 2 Zeichen

XPath

/Order/ShippingMethods/ShippingMethod/IncludedRegions/IncludedRegion/WorldRegion/ PostalRegion /Order/ShippingMethods/ShippingMethod/ExcludedRegions/ExcludedRegion/WorldRegion/ PostalRegion

PredefinedRegion Erklärung

Eine vordefinierte Versandregion. (Kein Staat, US-Postleitzahl oder spezielle Weltregion)

Pflichtfeld

Nein

Typ

String/Enumerated List (Liste)

Werte/Rang

USContinental48States | USFull50States | USAll | WorldAll (USAll enthält alle Staaten und alle Regionen im Besitz der USA, wie z.B. Puerto Rico, Guam und die Kanalzone. Außerdem enthalten sind Feldpostadressen des amerikanischen Militärs).

XPath

/Order/ShippingMethods/ShippingMethod/IncludedRegions/IncludedRegion/PreDefinedRegion /Order/ShippingMethods/ShippingMethod/ExcludedRegions/ExcludedRegion/ PreDefinedRegion

Price Erklärung

Container für die Artikelkosten. Menge x Preis = Artikelkosten. Der Preis enthält die Menge und den Währungscode.

Pflichtfeld

Ja

XPath

/Order/Cart/Items/Item/Price

Promotion Erklärung

Der Container für die definierten Werbeaktionen.

Pflichtfeld

Nein

XPath

/Order/Promotions/Promotion/

PromotionBenefit Erklärung

Der Container für den Rabattwert.

Pflichtfeld

Ja, wenn Promotion angegeben wurde. Der Werbeaktionsvorteil muss einen - nur einen - der folgenden Werte enthalten: DiscountRate oder FixedAmountDiscount.

XPath

/Order/Promotions/Promotion/PromotionBenefit

| XML-Schema und Definitionen | 76

PromotionId Erklärung

Der Name der Werbeaktion für einen Artikel.

Pflichtfeld

Ja, bei artikelbasierten Werbeaktionen. Nein, bei Einträgen auf Werbeaktionsebene.

Typ

String, maximal 255 Zeichen

XPath

/Order/Cart/Items/Item/PromotionIds/PromotionId /Order/Promotions/Promotion/PromotionId

PromotionIds Erklärung

def

Pflichtfeld

Nein

Typ

Boolean

Werte/Rang

Rang

XPath

ENTRY

Promotions Erklärung

Der Container für die Definition jeder verfügbaren Werbeaktion in der Bestellung.

Pflichtfeld

Nein

XPath

/Order/Promotions

Q Quantity Erklärung

Anzahl der Einzelartikel. Menge x Preis = Artikelkosten.

Pflichtfeld

Ja

Typ

Positive Ganzzahl

Werte/Rang

1-999

XPath

/Order/Cart/Items/Item/Quantity

R Rate (shipping) Erklärung

Der Container für de Definition der Versandkosten für eine bestimmte Versandart.

Pflichtfeld

Ja, wenn Sie eine Versandart definiert haben.

XPath

/Order/ShippingMethods/ShippingMethod/Rate

S ServiceLevel

| XML-Schema und Definitionen | 77

Erklärung

Der Name der Service-Ebene, die Sie in Ihrer Versandart definiert haben. Dieser Text erscheint im Bestellprozess des Käufers.

Pflichtfeld

Nein

Typ

String/Enumerated List (Liste)

Werte/Rang

Standard | Express | Ein Tag | Zwei Tage

XPath

/Order/ShippingMethods/ShippingMethod/ServiceLevel

ShipmentBased Erklärung

Ein Container für die Gebühren, die für einen individuellen Versand berechnet werden.

Pflichtfeld

Nein

XPath

/Order/ShippingMethods/ShippingMethod/Rate/ShipmentBased

ShippingMethod Erklärung

Ein Container für ein Set von Versandregeln.

Pflichtfeld

Nein

XPath

/Order/ShippingMethods/ShippingMethod

ShippingMethodId Erklärung

Der Name der Versandart, die Sie mit dem Artikel verknüpfen möchten.

Pflichtfeld

Nein

Typ

String, maximal 40 Zeichen

XPath

/Order/Cart/Items/Item/ShippingMethodIds/ShippingMethodId /Order/ShippingMethods/ShippingMethod/ShippingMethodId

ShippingMethodIds Erklärung

Container für die Versandarten, die Sie festlegen.

Werte/Rang

Rang

XPath

/Order/Cart/Items/Item/ShippingMethodIds

ShippingMethods Erklärung

Ein Container für alle Versandregeln.

Pflichtfeld

Nein

XPath

/Order/ShippingMethods/

SKU Erklärung

Der vom Händler definierte Identifikdationscode für den Artikel (SKU = Stock-keeping Unit).

| XML-Schema und Definitionen | 78

Pflichtfeld

Ja, wenn Sie Versand durch Amazon für diese Bestellung verwenden. Nein, wenn Sie den Artikel selbst versenden. (Siehe Titel). Beachten Sie, dass Sie eine SKU angeben müssen, wenn Sie die Variable FullfilmentNetwork auf AMAZON_EU setzen.

Typ

String, maximal 40 Zeichen

XPath

/Order/Cart/Items/Item/SKU

T Title (Artikel Erklärung

Eine kurze Beschreibung Ihres Artikels.

Pflichtfeld

Ja

Typ

String, maximal 80 Zeichen

XPath

/Order/Cart/Items/Item/Title

Title (upsell) Erklärung

Der Artikelname für Ihre Website, den Sie mittels der Upselling-Funktion einblenden möchten.

Pflichtfeld

Ja

Typ

String, maximal 80 Zeichen

XPath

/Order/MerchantUp-sellItems/Title

U Unit Erklärung

Der Gewichtstyp Ihres Artikels Nur "kg" wird akzeptiert.

Pflichtfeld

Ja, wenn Weight angegeben wurde.

Typ

String, maximal 2 Zeichen

Werte/Rang

kg

XPath

/Order/Cart/Items/Item/Weight/Unit

URL (Bild) Erklärung

die URL der Bilddatei, die Sie für den Artikel verwenden.

Pflichtfeld

Ja, wenn Images angegeben wurde.

Typ

String, maximal 255 Zeichen

XPath

/Order/Cart/Items/Item/Images/Image/URL

URL (Beschreibung) Erklärung

Die URL der Online-Beschreibung des Artikels.

| XML-Schema und Definitionen | 79

Pflichtfeld

Nein

Typ

String, 255 Zeichen

XPath

/Order/Cart/Items/Item/URL

URL (uspell) Erklärung

Die URL des Artikelbildes für die Upselling-Funktion. Wenn Sie eine URL angeben, müssen Sie das https://-Protokoll verwenden, ansonsten sehen Ihre Käufer eine Nachricht, die sie darauf hinweist, dass die Seite unsicher sein könnte

Pflichtfeld

Nein

Typ

String, maximal 255 Zeichen

XPath

/Order/MerchantUp-sellItems/Images/Image/URL

USStageRegion Erklärung

def

Pflichtfeld

Nein

Typ

String, maximal 2 Zeichen

XPath

/Order/ShippingMethods/ShippingMethod/IncludedRegions/IncludedRegion/USStateRegion /Order/ShippingMethods/ShippingMethod/ExcludedRegions/ExcludedRegion/USStateRegion

USZipRegion Erklärung

Eine Postleitzahlenregion in den USA.

Pflichtfeld

Nein

Typ

String, maximal 9 Zeichen

XPath

/Order/ShippingMethods/ShippingMethod/IncludedRegions/IncludedRegion/USZipRegion /Order/ShippingMethods/ShippingMethod/IncludedRegions/IncludedRegion/USZipRegion

W Weight Erklärung

Der Container für Gewichtseinheit und die gewichtsbasierten Versandkosten.

Pflichtfeld

Ja, wenn Sie den gewichtsbasierten Versand nutzen.

XPath

/Order/Cart/Items/Item/Weight

WeightBased

| XML-Schema und Definitionen | 80

Erklärung

Ein Container für die Gebühr, die für den individuellen Versand eines gewichtsbasierten Artikesl berechnet wird. Das Gesamtgewicht wird wie folgt berechnet: Stückzahl x Gewicht eines Artikels.

Pflichtfeld

Nein

XPath

/Order/ShippingMethods/ShippingMethod/Rate/WeightBased

WorldRegion Erklärung

Ein Container für eine Weltregion oder einen Staat. WorldRegion muss entweder PostalRegion oder CountryCode enthalten.

Pflichtfeld

Nein

Typ

Boolean

Werte/Rang

Rang

XPath

/Order/ShippingMethods/ShippingMethod/IncludedRegions/IncludedRegion/WorldRegion /Order/ShippingMethods/ShippingMethod/ExcludedRegions/ExcludedRegion/WorldRegion