Amazon Pay für TYPO3

Amazon Pay reduziert Kaufabbrüche, weil Kunden kein neues Konto anlegen müssen

Ein großer Teil der deutschen Online-Käufer hat ein Amazon-Konto. Wenn diese Nutzer in einem TYPO3-Shop auf “Kaufen” klicken und ein Registrierungsformular mit 12 Pflichtfeldern sehen, brechen viele ab. Amazon Pay löst dieses Problem: Der Kunde authentifiziert sich mit seinem Amazon-Konto, Lieferadresse und Zahlungsmittel werden automatisch übernommen. Kein Formular, keine Kreditkartennummer, kein neues Passwort. Laut einer comScore-Studie im Auftrag von Amazon Pay (USA, 40 Händler) lag die Conversion Rate mit Amazon Pay im Schnitt 35 % über dem eigenen Checkout der Händler.

Für TYPO3-Shop-Betreiber ist die Integration kein Plug-and-Play. Amazon Pay setzt eine API-Anbindung voraus (Amazon Pay API v2), in Seller Central eingetragene Shop-Domains und regelmäßige Sicherheitsupdates. Amazon prüft die Domains vor dem Go-Live gegen seine Nutzungsrichtlinie.

Typische Einsatzszenarien

Mittelständische B2C-Shops mit aimeos. Online-Shops für Mode, Elektronik, Haushaltswaren, die neben PayPal und Kreditkarte eine dritte Zahlungsart anbieten wollen. Amazon Pay funktioniert besonders gut bei impulsgetriebenen Käufen unter 200 Euro, wo jede Hürde im Checkout direkt Umsatz kostet. Die Integration in aimeos erfolgt über einen eigenen Service-Provider, der in die Payment-Pipeline eingehängt wird.

Spendenplattformen und Mitgliedsbeiträge. Vereine und NGOs, die über ihre TYPO3-Website Spenden oder Mitgliedsbeiträge einziehen, profitieren von der niedrigen Einstiegshürde. Der Spender klickt “Mit Amazon bezahlen”, bestätigt den Betrag und ist fertig. Kein IBAN-Eintippen, keine Lastschrift-Einrichtung. Für wiederkehrende Zahlungen unterstützt Amazon Pay Recurring Payments.

Digitale Produkte und Downloads. Software-Lizenzen, E-Books, Online-Kurse - Produkte ohne physischen Versand profitieren besonders, weil der gesamte Kaufprozess ohne Eingaben in ein Shop-Formular auskommt. Keine Versandadresse nötig, nur Authentifizierung und Zahlung.

Technische Architektur

Amazon Pay v2 basiert auf einer REST-API mit JSON-Payloads. Der Ablauf in einem TYPO3-Shop: Der Kunde klickt den Amazon-Pay-Button, wird zu Amazon weitergeleitet (oder ein Popup öffnet sich), loggt sich ein und bestätigt Adresse und Zahlungsmittel. Amazon leitet mit der ID der Checkout-Session zurück an den Shop, die beim Klick auf den Button angelegt wurde. Der Shop ergänzt die Checkout-Session über die Amazon Pay API um Betrag und Bestelldetails. Nach Bestätigung durch den Kunden wird die Zahlung ausgelöst.

Die Integration in TYPO3 erfordert drei Komponenten: einen API-Client (HTTP-Requests an die Amazon Pay API mit Signatur per RSA-Schlüssel), eine Frontend-Komponente (Amazon Pay Button als JavaScript-Widget) und einen Webhook-Handler für asynchrone Benachrichtigungen (Zahlungsbestätigung, Rückerstattung, Chargeback).

Für aimeos listet die Dokumentation keinen Amazon-Pay-Provider; die Anbindung entsteht als eigener Service-Provider. Für tt_products oder Custom-Shops ist eine eigene Integration nötig. In beiden Fällen muss der TYPO3-Shop HTTPS verwenden (für den IPN-Endpunkt im Live-Betrieb Pflicht), und die Webhook-URL muss von außen erreichbar sein.

Amazon stellt eine Sandbox-Umgebung bereit, in der alle Zahlungsflüsse ohne echtes Geld getestet werden können. Die Sandbox nutzt eigene API-Endpunkte und Test-Konten.

Häufige Probleme und Lösungen

Go-Live-Checkliste unvollständig. Vor dem Go-Live testet der Shop in der Sandbox Erfolgs- und Fehlerfälle und arbeitet Amazons Checkliste ab: Button-Platzierung, Error-Handling bei abgelehnten Zahlungen, Darstellung auf Mobilgeräten, korrekte Stornierung. Häufige Fehler: Der Amazon-Pay-Button erscheint nicht auf der Produktseite (nur im Warenkorb), Fehlermeldungen bei Zahlungsablehnung fehlen oder sind auf Englisch. Lösung: Amazons Pre-Launch-Checkliste vollständig abarbeiten, bevor der Shop live geht.

IPN-Benachrichtigungen (Instant Payment Notifications) gehen verloren. Amazon sendet Zahlungsbestätigungen asynchron per POST an eine hinterlegte URL. Wenn TYPO3 diese Requests durch Caching, Redirect-Regeln oder fehlende CSRF-Ausnahmen blockiert, bleibt die Bestellung im Status “ausstehend”. Lösung: Eine dedizierte eID-Route oder Middleware-Route für den Webhook einrichten, die außerhalb der normalen TYPO3-Request-Verarbeitung läuft.

Recurring Payments und Abo-Modelle. Amazon Pay unterstützt wiederkehrende Zahlungen, aber die Einrichtung ist komplexer als bei Stripe Subscriptions. Der Kunde muss beim Checkout einer wiederkehrenden Charge Permission zustimmen, und der Shop löst jede fällige Zahlung per Create Charge aus. Lösung: Charge Permissions als eigene Datenbank-Entität verwalten und einen Cronjob einrichten, der fällige Zahlungen auslöst.

Migration und Versions-Kompatibilität

Amazon Pay v2 ist die aktuelle API-Version (seit 2020). Für neue Integrationen empfiehlt Amazon Version 2. Bestehende v1-Implementierungen funktionieren noch, erhalten aber keine Updates und keine neuen Features. Die Migration von v1 auf v2 betrifft den kompletten API-Client: Andere Endpunkte, anderer Signatur-Mechanismus (RSA statt HMAC), andere Session-Verwaltung.

Für TYPO3 gibt es keine offizielle Amazon Pay Extension im TER mit aktivem v12/v13-Support. Die Integration erfolgt als Custom-Code, in aimeos als eigener Service-Provider. Gosign implementiert Amazon Pay als eigenständiges Composer-Paket, das in beliebige TYPO3-Shop-Setups eingebunden werden kann. Dieses Paket kapselt den API-Client, den Button und den Webhook-Handler, sodass ein TYPO3-Major-Upgrade nur die TYPO3-spezifische Adapter-Schicht betrifft.

Für Shop-Betreiber, die neben Amazon Pay auch PayPal, Kreditkarte und Klarna anbieten, empfiehlt Gosign eine einheitliche Payment-Abstraktion. Statt jeden Provider einzeln zu integrieren, wird eine gemeinsame Schnittstelle implementiert, über die alle Payment-Provider angesteuert werden. aimeos bringt diese Abstraktion nativ mit (Service-Provider-Architektur). Für Custom-Shops baut Gosign eine vergleichbare Schicht, die den Checkout-Code von den Provider-spezifischen APIs entkoppelt. Das reduziert den Aufwand für neue Payment-Provider auf die Implementierung eines einzelnen Adapters statt einer Komplett-Integration.

Die Gesamtkosten einer Amazon Pay Integration in einem bestehenden TYPO3-Shop liegen bei 3 bis 8 Entwicklungstagen, je nachdem ob der Shop auf aimeos mit seiner Provider-Schnittstelle läuft oder eine Custom-Integration nötig ist. Sandbox-Tests und Go-Live-Checkliste erfordern zusätzlich 1 bis 2 Tage für Vorbereitung und Korrekturrunden.