AMAZON PAY best it Consulting GmbH & Co. KG Rekener Str. 60 46342 Velen Deutschland phone: +49-2863-383627-0 fax: +49-2863-383627-27 mail: support@bestit-online.de web: www.bestit-online.de Jetzt ein Projekt mit best.it starten: www.bestit-online.de/kontakt Dokumentation: BestitAmazonPayDomumentation.pdf v1.0 1/35
INHALT Einleitung... 3 Funktionsweise des Plugins...3 Voraussetzungen... 3 Vorteile von Amazon Pay...3 Amazon Registierung... 4 Ablauf Amazon Pay... 7 Installation... 8 Allgemeines... 8 Schritt 1: Zugangsdaten aus Amazon Sellercentral...8 Schritt 3: Installation des Plugins...10 Schritt 4: Rudimentäre Konfiguration...11 Schritt 5: Testen im Sandbox Modus...15 Aktualisierung des Plugins... 17 Ansicht im Shop... 17 Login & Pay... 21 Backend: Bestellung Abschliessen...22 Plugin-Konfiguration... 26 Live schalten... 33 Testszenarios... 33 Sofortbenachrichtigung - Instant Payment Notification (IPN)...34 Cronjob... 34 Kontaktdaten für Rückfragen... 35 SUPPORT... 35 *Gewährleistung* (kostenfreier Support)...35 *Kostenpflichtiger Support*... 35 Remote Zugang... 35 2/35
EINLEITUNG Mit Amazon Pay können Kunden mit den Zahlungs- und Adressinformationen aus einem Amazon-Kundenkonto in Ihrem Shop bezahlen. Ihre Kunden verbleiben während des gesamten Bezahlvorgangs in Ihrem Shop und werden nicht zu Amazon umgeleitet. Sie als Händler erhalten nach der Transaktion sowohl die E-Mail-Adresse als auch die Anschrift Ihrer Kunden für die Bestellabwicklung und die weitere Kundenansprache. Das Preismodell für Amazon Pay ist transaktionsbasiert, d.h. es fallen keine Grundgebühren, Vorauszahlungen oder Ähnliches an. FUNKTIONSWEISE DES PLUGINS VORAUSSETZUNGEN Shopware ab Version 5.x bis 5.2.x PHP Erweiterungen CURL und SimpleXML. Zugangsdaten Amazon Sellercentral und Amazon Marketplace Webservices IonCube Loader ab 5.4 Gültiges SSL Zertifikat VORTEILE VON AMAZON PAY 3/35 Unterstützung für physische & digitale Güter Order-Management über Ihre eigenen Systeme (Reine Zahlungsabwicklung, keine Übermittlung von Artikeldaten notwendig) Zahlungsabwicklung gemäß Ihren Vorgaben, Unterstützung für Vorbestellungen, Teilbestellungen usw. Optimiert auch für Einsatz auf mobilen Endgeräten Multilingual: DE / EN / FR / ES / IT Multicurrency: Unterstützt EUR & GBP
AMAZON REGISTIERUNG Sie starten die Registrierung durch Klick auf den oberen Button Neue Anwendung registrieren. Nachdem Sie die Registrierung durchgeführt haben, erhalten Sie alle relevanten Daten, die Sie in das Plugin übernehmen müssen, durch einen Klick auf Zugangsdaten kopieren : 4/35
5/35
Geben Sie diese Daten an das Plugin zurück, durch Klick auf Konfigurationsdaten aus Seller Central einfügen weiter. Die Daten können nun gespeichert werden. 6/35
ABLAUF AMAZON PAY Nachdem eine Bestellung eines Kunden durchgeführt worden ist, müssen die Bestellung zuerst autorisiert werden. Amazon prüft also, ob die Bestellung des Kunden mit Amazon durchgeführt werden kann andernfalls wird eine Fehlermeldung mit Status Klärung notwendig gesetzt. Das Plugin prüft regelmäßig per Cronjob den Bestellstatus aller Bestellungen. Wird z.b. der Bestellstatus von Offen zu Zur Lieferung bereit geändert, wird die Bestellung im Hintergrund autorisiert und der Zahlungsstatus angepasst. Anhand des neuen Zahlungsstatus wissen Sie, dass die Autorisierung erfolgreich durchgeführt wurde. Die Authorisierung einer Bestellung bedeutet, dass die Auszahlung für 7 Tage garantiert ist. Innerhalb dieser 7 Tage sollten Sie die Lieferung versenden und dann den dafür vorgesehenen Bestellstatus setzen. Der tatsächliche Transfer des Betrags vom Konto des Käufers zu Amazon, das sogenannte Capture, wird dann vom Plugin erneut automatisch im Hintergrund durchgeführt. Vom 8. Bis zum 30. Tag kann der Transfer (das Capture) fehlschlagen. Die Auszahlung ist nicht mehr garantiert. 7/35
INSTALLATION ALLGEMEINES Für die Einrichtung der Zahlungsart Amazon Pay sind folgende Schritte notwendig: 1. 2. 3. 4. 5. Zugangsdaten aus Amazon Sellercentral Installation des Plugins Rudimentäre Konfiguration des Plugins Testen der Konfiguration im Sandbox Modus Live schalten SCHRITT 1: ZUGANGSDATEN AUS AMAZON SELLERCENTRAL Melden Sie sich mit Ihren Amazon Zugangsdaten unter an. Wählen Sie im oberen Bereich der Webseite die Sandbox-Ansicht von Amazon Payments Unter Einstellungen -> Integrationseinstellungen: Setzen Sie die Händler-URL in der Form ein um die automatische Benachrichtigung von Amazon zu Ihrem Shop via IPN zu ermöglichen. 8/35
Die übrigen Einstellungen sind zumindest für die Funktionsweise des Plugins ohne Bedeutung. Sie sollten allerdings unbedingt die Banner-Bilddatei mit Ihrem Shop-Logo hochladen. Diese wird dem Käufer im Login-Popup-Fenster angezeigt, und fördert so die Wiedererkennung und das Vertrauen des Kunden in das Login-Fenster. Gehen Sie wieder zur Startseite, z.b. über einen Klick auf das Logo von Amazon oben links. Sie sehen die ersten Schritte. Führen Sie Schritt 1 aus, um die API-Zugangsdaten (Access Key ID und Secret Access Key) zu erhalten Nun haben Sie alle Informationen, die Sie zur Installation und Konfiguration des Plugins benötigen. 9/35
SCHRITT 3: INSTALLATION DES PLUGINS Nach Anmeldung im Backend Ihres Shops kann das Plugin nun mit dem Plugin Manager installiert werden. Dieser wird durch je einen Klick auf Einstellungen und anschließend auf Plugin Manager aufgerufen: Laden Sie das ZIP-Archiv mit dem Plugin über Plugin manuell hinzufügen hoch, es steht anschließend im Plugin-Manager zur Installation bereit: Nach einem Klick auf das grüne Symbol mit dem Kreuz öffnet sich ein Fenster mit der Plugin Konfiguration. 10/35
SCHRITT 4: RUDIMENTÄRE KONFIGURATION Für den Test der Integration sind erst einmal nur die drei Parameter aus den ersten beiden Schritten notwendig: Standardmäßig ist der Sandbox-Modus aktiviert. Dies muss für den Test der Integration auch so bleiben. Wir empfehlen, die übrigen Parameter auf den vorgegebenen Einstellungen für den Test zu belassen. Im Folgenden wird in dieser Dokumentation insbesondere bei den Status-Angaben von den Standard-Werten gesprochen, um Verwechslungen zu vermeiden. Im Backend unter Einstellungen -> Versandkosten müssen Sie nun die Zahlungsart Bezahlen über Amazon Ihren Versandarten zuordnen. 11/35
Dazu wählen Sie eine Versandart aus Anschließend klicken Sie auf Versandart editieren (Stift Symbol). Es öffnet sich ein neues Fenster. Im unteren Bereich muss unter der Zahlart Auswahl die verfügbare Bezahlen über Amazon ausgewählt und mit dem oberen Pfeil zu den ausgewählten verschoben werden: Erst nach dem Speichern wird die Versandart mit Amazon verknüpft. 12/35
Als letzter Konfigurationsschritt muss unter Einstellungen -> Zahlungsarten die Zahlungsart Amazon Pay aktiviert werden. Wählen Sie dazu links Amazon Pay aus und machen ein Häkchen in der Zeile Aktiv : 13/35
Optional können Sie an dieser Stelle Aufschläge / Abschläge, Position der Zahlungsart oder die Beschreibung ändern. 14/35
SCHRITT 5: TESTEN IM SANDBOX MODUS Im Amazon Sellercentral und im Plugin ist nun der Sandbox Modus aktiv. Erstellen Sie nun ein Käufertestkonto im Sellercentral, den Link erhalten Sie aus der Übersicht im Sellercentral: 15/35
Geben Sie Ihren Namen, Ihre E-Mail-Adresse und Passwörter an und erstellen Sie das Testkonto. Beachten Sie, dass in den Beispiel-Adressen die Hausnummer vor der Straße steht. 16/35
AKTUALISIERUNG DES PLUGINS Sie können das Plugin einfach über den Plugin-Manager aktualisieren. Aus Sicherheitsgründen wird die Zahlungsart deaktiviert. Testen Sie Amazon Pay, bevor Sie die Zahlungsart Ihren Kunden wieder zur Verfügung stellen. ANSICHT IM SHOP Nach der Installation wird der Amazon Pay Button in folgenden Bereichen angezeigt: MODAL-BOX WARENKOEB 17/35
WARENKORB Zusätzlich wird der Button auch auf der Bestellabschlussseite angezeigt, wenn die Zahlungsmethode Amazon Pay vom Kunden ausgewählt wurde. MODAL-DIALOG MEIN KONTO 18/35
Nach dem Klick auf Amazon Pay öffnet sich das für Amazon-Kunden gewohnte Anmeldefenster. Melden Sie sich mit Ihrem Testkonto aus Schritt 5 an: Nach der Anmeldung werden Sie und später Ihre Kunden - zurück zu Ihrem Shop geführt. Nach Auswahl und Klick auf Weiter, können Sie aus Ihren Lieferadressen wählen: 19/35
Nach der Auswahl der Lieferadresse und der Zahlungsart wird man zur Bestellbestätigungsseite geführt. Lieferadresse und Versandadresse werden von Amazon eingebunden. Erst nach Einverständniserklärung der AGB und einem Klick auf Zahlungspflichtig bestellen ist der Bestellvorgang abgeschlossen. Sie erhalten die Bestellnummer aus Ihrem Shop und die Transaktionsnummer von Amazon: 20/35
Im Anschluss erhalten Sie eine Bestellbestätigung Ihres Shops per E-Mail und eine E-Mail über die autorisierte Zahlung von Amazon. LOGIN & PAY Mit Login & Pay bieten Sie Ihren Kunden die Möglichkeit, sich mit Ihrem Amazon-Konto bei Ihnen anzumelden. Bei der Anmeldung wird dies angezeigt: Ist Ihr Kunde über Amazon Login angemeldet gibt es fünf Möglichkeiten: 1. Ihr Kunde war bereits mit seinem Shopware-Konto angemeldet: Der Shopware-Account wird automatisch dem Amazon-Konto zugeordnet. 2. Ihr Kunde meldet sich an seinem Konto an, nachdem er sich über Amazon angemeldet hat: Der Shopware-Account wird automatisch dem Amazon-Konto zugeordnet. 3. Ihr Kunde meldet sich nicht an, es existiert aber ein Konto mit gleicher E-MailAdresse: Ihr Kunde wird aufgefordert, sich anzumelden, damit das Konto zugeordnet werden kann. 4. Ein neuer Kunde: es existiert kein Konto mit gleicher E-Mail-Adresse: Es wird ein neues reguläres Konto angelegt. Der Verknüpfungsparameter ist die email Adresse auf dem Amazon Konto. 21/35
Mit einer einfachen Anmeldung kann Ihr Kunde direkt den Bezahlvorgang starten. Da Adressdaten in diesem Schritt nicht übermittelt werden, findet bei einem neuen Kunden kein richtiger Login statt. Beim Klick auf das Kundenkonto erfährt Ihr Kunde dies: BACKEND: BESTELLUNG ABSCHLIESSEN BEISPIEL: NORMALE BESTELLUNG Basierend auf den Standardeinstellungen, hat die neue Bestellung Bestellstatus: Offen Zahlungsstatus: Offen Die Ware ist vorhanden, Sie können das Paket vorbereiten und den Status anpassen: Bestellstatus: Zur Lieferung bereit Zahlungsstatus: Offen Per Cron wird im Hintergrund die Autorisierung der Zahlung angewiesen. Nach erfolgreicher Autorisierung wird der Zahlungsstatus geändert: Bestellstatus: Zur Lieferung bereit Zahlungsstatus: Reserviert Erst jetzt sind die Rechnungsdaten vollständig hinterlegt. Sie können die Rechnung generieren, die Waren versenden und den Bestellstatus aktualisieren: Bestellstatus: Komplett ausgeliefert Zahlungsstatus: Reserviert Per Cron wird nun das sogenannte Capture durchgeführt. Sie erhalten den Betrag ausgezahlt, der Zahlungsstatus wird angepasst: Bestellstatus: Komplett ausgeliefert Zahlungsstatus: Komplett bezahlt Der Kunde erhält von Amazon eine Abbuchungsbenachrichtigung per E-Mail. Dieser Ablauf wird durch das folgende Schema verdeutlicht. 22/35
Abbildung 1: Ablaufschema einer normalen Bestellung Info: Erst wenn die Trigger Komplett ausgeliefert und Reserviert gesetzt sind, wird Amazon den Capture-Vorgang durchführen. 23/35
BEISPIEL: NORMALE BESTELLUNG MIT AUTOMATISCHER AUTORISIERUNG Sie können in der Plugin-Konfiguration angeben, dass Bestellungen, deren Positionen im Warenkorb komplett einen Lagerbestand größer Null haben, sofort autorisiert werden. Der erste Schritt wird also automatisch durchgeführt und die Bestellung hat so schnell wie möglich den Status Bestellstatus: Zur Lieferung bereit Zahlungsstatus: Offen Sie erhalten die vollständigen Rechnungsdaten und können die Bestellung deutlich schneller abschließen. BEISPIEL: RÜCKERSTATTUNG EINER ABGESCHLOSSEN BESTELLUNG Ein Kunde hat eine Bestellung ganz oder teilweise zu Ihnen zurückgesendet. Korrigieren Sie die Positionen aus der Bestellung und passen Sie gegebenenfalls die Versandkosten an. Danach stellen Sie Bestellstatus: Storniert Zahlungsstatus: Wiedergutschrift. Per Cronjob wird im Hintergrund die Rückerstattung angewiesen. Der Kunde erhält eine Erstattungsbenachrichtigung von Amazon. Wenn Sie sicher sind, dass die Zahlung soweit Abgeschlossen ist, setzen Sie den Status auch auf Komplett abgeschlossen um den Prozess aus dem Cronjob zu nehmen. BEISPIEL: STORNIERUNG EINER BESTELLUNG VOR AUSLIEFERUNG. Sie haben eine Zahlung bereits autorisiert. Bestellstatus: Zur Lieferung bereit Zahlungsstatus: Offen Jetzt reicht es, den Status der Bestellung auf Storniert und den Zahlungsstatus auf Wiedergutschrift zu setzen. BEISPIEL: TEILSTORNIERUNG EINER BESTELLUNG VOR AUSLIEFERUNG Sie haben eine Bestellung bereits autorisiert, ein Kunde möchte eine Position nicht mehr haben oder Sie können eine Position nicht mehr liefern. Löschen Sie einfach die Position oder korrigieren Sie Beträge nach unten. Der neue Rechnungsbetrag wird dann zu Amazon übermittelt. Status-Anpassungen sind nicht notwendig. 24/35
BEISPIEL: AMAZON PAY ZUSAMMEN MIT WARENWIRTSCHAFTEN Viele Plugins, die Shopware mit Warenwirtschaftssystemen verbinden, übermitteln nur neue Bestellungen. Später werden von der Warenwirtschaft häufig nur Statusänderungen übertragen. Wenn Ihre Warenwirtschaft Amazon Pay unterstützt, können Sie einfach in der Plugin-Konfiguration die Option Bestellstatus übermitteln deaktivieren. Falls Ihr Shop die Kommunikation mit Amazon übernehmen soll, kann folgende Konfiguration für Sie sinnvoll sein: Option Automatische Autorisierung : Alle Artikel haben positiven Lagerbestand Bestellstatus für nicht autorisierte Bestellungen: In Bearbeitung (Wartet) Zahlstatus für nicht autorisierte Bestellungen: Offen Bestellstatus für autorisierte Bestellungen: Zahlstatus für autorisierte Bestellungen: Offen Reserviert Bestellstatus für ausgelieferte Bestellungen: Zahlstatus für garantierte Zahlungen: In Bearbeitung (Wartet) Reserviert Bestellstatus für ausgelieferte Bestellungen: Zahlstatus nach erfolgreicher Auszahlung: Komplett abgeschlossen Komplett bezahlt Der Ablauf sehe im Normalfall folgendermaßen aus: 1. Ihr Kunde hat die Bestellung abgeschlossen und alle Artikel sind vorrätig und damit sofort zur Auslieferung bereit. Die Bestellung wird sofort autorisiert. Durch den Bestellstatus In Bearbeitung wird die Bestellung aber noch nicht zu Ihrer Warenwirtschaft übermittelt. 2. Die Bestellung wurde erfolgreich autorisiert und der Zahlstatus damit auf Reserviert gesetzt. Durch den Bestellstatus Offen wird die Bestellung erst jetzt zu Ihrer Warenwirtschaft übermittelt. Der Bestellstatus wird nun üblicherweise wieder zu In Bearbeitung geändert. 3. Sie versenden die Bestellung und lassen durch Ihre Warenwirtschaft den Status auf komplett abgeschlossen setzen. Beim nächsten Aufruf des Cronjobs wird das Capture ausgeführt und damit die Auszahlung veranlasst. Sollte eine Bestellung nicht autorisiert werden können oder sollte das Capture fehlschlagen, können Sie sich per E-Mail informieren lassen. Sie werden dann auch informiert, wenn die Auszahlung erfolgreich angewiesen werden konnte. 25/35
PLUGIN-KONFIGURATION Von oben nach unten werden im Folgenden die Einstellungsmöglichkeiten beschrieben. AKTIV Das Plugin funktioniert natürlich nur, wenn es aktiviert wird. HÄNDLERNUMMER Die Händlernummer erfahren Sie im Amazon Sellercentral unter dem Menüpunkt Einstellungen -> Einstellungen zum Bestellprozess. ACCESS KEY ID Die Amazon Access Key ID wird Ihnen im Sellercentral mitgeteilt. SECRET ACCESS KEY Die Amazon Secret Access Key wird Ihnen im Sellercentral mitgeteilt CLIENT ID Die Client ID erhalten Sie von Amazon. Mit dieser ID ist Amazon Login & Pay aktiv. Ohne stehen nur die Funktionen von Amazon Pay zur Verfügung, SANDBOX AKTIVIERT Im Sandbox-Modus werden keine gültigen Bestellungen ausgeführt. Dieser Modus dient ausschließlich dazu, die Implementierung vorzunehmen und zu testen. Bestellungen können nur mit Testkonten durchgeführt werden. REGION Auswahl der Region: Deutschland für ein EUR geführtes Konto Großbritannien für ein GBP geführtes Konto. BESTELLSTATUS ÜBERMITTELN Der Status der Bestellung soll automatisch per Cron zu Amazon übermittelt werden. SOFORTIGE ZAHLUNGSBENACHRICHTIGUNG (IPN) Die drei Werte dieser Option haben folgende Auswirkung: 26/35 Aktiviert Das Plugin fragt das Resultat einer Authorize-, Capture- oder Refund-Anfrage nicht mehr via Cronjob, sondern wartet auf die Benachrichtigung von Amazon. Diese
Option sollte insbesondere bei vielen Bestellungen gewählt werden, da vom Plugin sonst zu viele Abfragen gestellt werden. Deaktiviert Das Resultat einer Authorize, Capture oder Refund-Anfrage wird nur via Cronjob abgefragt. Diese Einstellung sollte normalerweise nur verwendet werden, wenn Ihre Warenwirtschaft den kompletten Bestellabschluss abfertigt. Optional Mit dieser Standardeinstellung ist beides aktiv. Normalerweise wird so die automatische Benachrichtigung als schnellere Methode verwendet, um das Resultat einer Authorize, Capture oder Refund-Anfrage auszuwerten. Sollte es zu technischen Problemen kommen (z.b. ausgelaufenes SSL-Zertifikat, Blockade des Amazon-Servers) dient der Cronjob noch als Ausweichmöglichkeit. VERSANDSTATUS ÜBERMITTELN AB (BESTELLNUMMER) Erst ab dieser Bestellnummer werden Statusübermittlungen berücksichtigt. Dies kann sinnvoll sein, wenn Shopware ältere Bestellungen nicht übermitteln soll. KUNDE BEI ABGELEHNTER ZAHLUNGSART INFORMIEREN Eine Auszahlung kann vorerst abgelehnt werden, wenn z.b. die Kreditkarte des Kunden zur Zeit des Captures ungültig geworden sein sollte. Ist dies der Fall, können Sie Ihren Kunden dies automatisch per E-Mail mitteilen. Wenn Sie diese Option auswählen, passen Sie unbedingt die E-Mail-Vorlage AmazonInvalidPayMethod unter System E-Mails an. STATUS-E-MAILS SENDEN Sie als Shopbetreiber erhalten eine E-Mail, wenn Authorize oder Capture fehlschlagen sollte und bei erfolgreicher Auszahlung. Die E-Mail-Vorlage AmazonShopOwnerNotification können Sie unter den System-E-Mails anpassen. WBESTELLSTATUS FÜR NICHT AUTORISIERTE BESTELLUNGEN Eine unbestätigte Bestellung wird mit diesem Status angelegt. Der Status muss sich vom Bestellstatus für autorisierte Bestellungen unterscheiden! Standard: Offen ZAHLSTATUS FÜR NICHT AUTORISIERTE BESTELLUNGEN Der Zahlstatus einer unbestätigten Bestellung. Standard: Offen BESTELLSTATUS AUTORISIERBARE BESTELLUNGEN Wenn eine Bestellung zur Lieferung bereit ist, wird dieser Status gesetzt. Der Status muss sich vom Bestellstatus für nicht autorisierte Bestellungen unterscheiden! 27/35
ZAHLSTATUS AUTORISIERBARE BESTELLUNGEN Dieser Status wird nach Autorisierung gesetzt. Standard: Offen BESTELLSTATUS AUTORISIERTE BESTELLUNGEN Wenn eine Bestellung zur Lieferung bereit ist, wird dieser Status gesetzt. Standard: zur Lieferung bereit ZAHLSTATUS FÜR AUTORISIERTE BESTELLUNGEN Zahlstatus nach erfolgreicher Autorisierung. Die Auszahlung ist nun 7 Tage garantiert, die Bestellung sollte innerhalb dieser 7 Tage auf den Status für komplett ausgelieferte Bestellungen gesetzt werden. Standard: Reserviert BESTELLSTATUS FÜR AUSGELIEFERTE BESTELLUNGEN Wird eine Bestellung auf diesen Status gesetzt, wird die Zahlung angewiesen. Standard: Komplett ausgeliefert ZAHLSTATUS FÜR GARANTIERTE ZAHLUNGEN Die Auszahlung wird angewiesen. Standard: Reserviert BESTELLSTATUS NACH ERFOLGREICHER AUSZAHLUNG Die Zahlung wird angewiesen, der Bestellstatus bleibt normalerweise unverändert. Standard: Komplett ausgeliefert ZAHLSTATUS FÜR GARANTIERTE ZAHLUNGEN Die Auszahlung wird angewiesen. Standard Status: Reserviert BESTELLSTATUS NACH ERFOLGREICHER AUSZAHLUNG Die Bestellung kann nun komplett abgeschlossen werden. ZAHLSTATUS NACH ERFOLGREICHER AUSZAHLUNG Nach erfolgreicher Anweisung der Auszahlung wird dieser Status gesetzt. Standard: komplett bezahlt BESTELLSTATUS BEI ZAHLUNGSAUSFALL 28/35
Kann eine Zahlung nicht angewiesen werden, wird dieser Status gesetzt - so eine Bestellung sollte nicht ausgeliefert werden. Standard: Klärung notwendig ZAHLSTATUS BEI ZAHLUNGSAUSFALL Kann eine Zahlung nicht angewiesen werden, wird dieser Status gesetzt. Standard: Überprüfung notwendig BESTELLSTATUS FÜR STORNO NACH AUSZAHLUNG Status für Bestellungen, die durch den Kunden oder Shopbetreiber ganz oder teilweise nach Auszahlung storniert werden. Standard: Bestellung storniert ZAHLSTATUS FÜR STORNO NACH AUSZAHLUNG Status für Bestellungen, die durch den Kunden oder Shopbetreiber ganz oder teilweise nach Auszahlung storniert werden. Standard: Wiedergutschrift BESTELLSTATUS KOMPLETTE STORNIERUNG VOR AUSZAHLUNG Stornierung einer kompletten Bestellung vor Auszahlung. Standard: Bestellung storniert ZAHLSTATUS KOMPLETTE STORNIERUNG VOR AUSZAHLUNG Stornierung einer kompletten Bestellung vor Auszahlung. Standard: Wiedergutschrift 29/35
AUTOMATISCHE AUTORISIERUNG Die möglichen Werte dieser Option haben folgende Auswirkung: Nie Die Bestellung aktiv durch Änderung des Bestellstatus autorisiert werden Alle Artikel haben positiven Lagerbestand Wenn Alle Artikel einen positiven Lagerbestand haben, bedeutet dies, dass die Bestellung zur Lieferung bereit ist. Deswegen wird die Autorisierung sofort nach Abschluss der Bestellung durchgeführt. Immer Unabhängig vom Lagerbestand wird die Autorisierung immer sofort nach Bestellabschluss durchgeführt. CAPTURE NOW Mit der Autorisierung bietet Amazon Pay die Möglichkeit, dass Capture sofort durchführen zu lassen. Dies darf nach den Richtlinien normalerweise erst durchgeführt werden, wenn die Ware versendet worden ist. Wenn Sie z.b. ESD-Artikel (Download-Artikel) anbieten, können Sie diese Option aktivieren. 30/35
LAGERBESTAND NOTWENDIG Amazon Pay nur zur Verfügung stellen, wenn alle Artikel im Warenkorb einen positiven Lagerbestand haben. HÄNDLERBESTELLUNGEN VERBIETEN Amazon Pay für reine Netto-Besteller (z.b. gesteuert über Kundengruppeneinstellungen) verbieten. AUSGESCHLOSSENE KATEGORIEN (IDS) Sind Artikel im Warenkorb, die in den angegebenen Kategorien gelistet sind, wird Amazon Pay dem Kunden nicht zur Verfügung gestellt. Die Auflistung der IDs muss durch Komma getrennt werden, z.b. 33, 43, 77 Alle Artikel, die sich in Unterkategorien befinden, werden ebenfalls berücksichtigt. PLATZHALTER FÜR LEERFELDER Ist ein Plicht-Feld leer (z.b. Hausnummer), wird dieser Wert eingesetzt. Standard: Leerzeichen STATUSAUSGABE CRONJOB Bei manuellem Cronjob-Aufruf werden Statusinformationen ausgebeben. TEMPLATE ÜBERSCHREIBEN Ist diese Option aktiv, können Sie in Ihrem eigenem Template das Plugin-Template überschreiben. BUTTON IN DER WARENKORB-MODALBOX ANZEIGEN Auswahl oder Deaktivieren des Buttons in der Warenkorb-Modalbox. Standardmäßig wird der Button Bezahlen über Amazon in der sogenannten Modal-Box angezeigt. Diese erscheint direkt nach Hinzufügen eines Artikels in den Warenkorb. Die Deaktivierung dieser Option kann sinnvoll sein, wenn andere Plugins das Layout zerstören. BUTTON IN DER ANMELDE-MODALBOX ANZEIGEN Auswahl oder Deaktivieren des Buttons in der Login-Modalbox. Bei der Anmeldung wird eine andere Modalbox angezeigt. Der Button wird angezeigt, wenn Artikel im Warenkorb des Kunden sind. BUTTON AUF DER ANMELDE-SEITE ANZEIGEN 31/35
Auswahl oder Deaktivieren des Buttons auf der Seite. Sind Artikel im Warenkorb vorhanden, wird der Bezahlen-Button angezeigt, sonst der Login-Button. BUTTON AUF DER REGISTRIERUNGS-SEITE ANZEIGEN Auswahl oder Deaktivieren des Buttons auf der Seite. Sind Artikel im Warenkorb vorhanden, wird der Bezahlen-Button angezeigt, sonst der Login-Button. BUTTON AUF DER FEHLERSEITE ANZEIGEN Kommt es während der Anmeldung zu einem Fehler, z.b. durch ein technisches Problem, wird der Kunde zu einer Fehlerseite weitergeleitet mit einem Hinweis, dass ein Fehler vorliegt. Der Button wird hier angezeigt, damit Ihr Kunde einen weiteren Versuch starten kann, WIDGETS FÜR SMARTPHONES AKTIVIEREN Die Art der Anzeige der Adressen und Zahlungsarten wird automatisch von Amazon angepasst. Diese Option sollte nur für spezialisierte Mobil-Templates gesetzt werden. 32/35
LIVE SCHALTEN Sind Ihre Testbestellungen erfolgreich verlaufen, folgen Sie den Empfehlungen im Sellercentral: Danach deaktivieren Sie in den Plugin-Einstellungen den Sandbox-Modus. TESTSZENARIOS Im Sandbox-Modus können Sie auf der Bestellabschlussseite verschiedene Bestellverläufe simulieren, um Ihren Bestellablauf richtig anzupassen. Unterhalb der Widgets für Adressbuch und Zahlungsweise gibt es nur im Sandbox-Modus die Möglichkeit für die Simulierung für: 33/35 Normale Bestellung Ungültige Autorisierung Ungültige Zahlungsart für eine bestimmte Zeit Ungültiges Capture
SOFORTBENACHRICHTIGUNG - INSTANT PAYMENT NOTIFICATION (IPN) Nach einer der ausgeführten Aktion Authorize, Capture oder Refund können Sie automatisch von Amazon über das Resultat benachrichtigt werden. Dies beschleunigt die Abarbeitung einer Bestellung normalerweise erheblich, da Sie nicht auf den Aufruf des nächsten Cronjobs warten müssen. Hierzu müssen Sie im Amazon Sellercentral unter Einstellungen -> Integrationseinstellungen Ihre Händler-URL in der Form hinterlegen. Außerdem müssen Sie in der Plugin-Konfiguration die Option Sofortige Zahlungsbenachrichtigung auf Aktiviert oder Optional setzen. Deaktivieren Sie die Option, wird das Plugin alle Sofortbenachrichtigungen ignorieren. CRONJOB Autorisierung und Capture werden üblicherweise mit dem Shopware-Cronjob ausgeführt. Dieser kann fehlschlagen; dies kann dazu führen, dass der Cronjob des Plugins deaktiviert wird. Um sicher zu gehen, können Sie den Cronjob für Amazon Pay losgelöst von Shopware aufrufen. Hierzu müssen Sie auf Ihrem Server einen eigenen Cronjob mit folgender URL für die Beispiel-Domain einrichten: https://www.example.com/amazonpay/cron/apikey/ihrshopwareapikey Für IhrShopwareAPIKey kann jeder API-Schlüssel eines Backend-Benutzers genommen werden. 34/35
KONTAKTDATEN FÜR RÜCKFRAGEN best it Consulting GmbH & Co. KG Rekener Str. 60 46342 Velen Deutschland phone: +49-2863-383627-0 fax: +49-2863-383627-27 mail: web: SUPPORT Das Plugin wird kostenlos angeboten und enthält keine Support Leistung. Die häufigsten Fragen, können Sie in unserem F.A.Q. klären: Beachten Sie bitte nachfolgend unsere Supportbedingungen: *GEWÄHRLEISTUNG* (KOSTENFREIER SUPPORT) Als Entwickler eines Plugins tragen wir sorge dafür, das unser Plugin einen korrekten, vorgegebenen Leistungsumfang hat. Sollten wir im Rahmen Ihrer Anfrage einen Fehler auf ein von uns entwickeltes Plugin zurückführen, werden wir die damit verbundene Serviceleistung nicht in Rechnung stellen. *KOSTENPFLICHTIGER SUPPORT* Grundsätzlich möchten wir jedem Kunden unseren Service anbieten. Deshalb kontingentieren wir unsere Kapazitäten und bieten unseren Projekt- und Großkunden einen entsprechenden Support Level mit Reaktionszeiten an. Die Reservierung dieser Kontingente nimmt einen Großteil unserer Kapazitäten und Priorisierung in Anspruch. Wie Sie unseren kostenpflichtigen Support buchen können erfahren Sie im Rahmen Ihres Einzelfalls. REMOTE ZUGANG Der Remote Zugang ermöglicht uns in der ersten Analyse einen Blick auf die Konfiguration des Plugins ohne Zugang zum Backend zu erhalten. Im Supportfall aktivieren Sie den Zugang und teilen uns bitte den Key mit. Wir rufen damit diese URL auf: www.ihrshop.de/amazonpay/check?key=*ihrkey* 35/35