Amazon Pay dla TYPO3

Amazon Pay redukuje porzucenia zakupów, bo klienci nie muszą zakładać nowego konta

Znaczna część kupujących online posiada konto Amazon. Gdy ci użytkownicy w sklepie TYPO3 klikają “Kup” i widzą formularz rejestracyjny z 12 obowiązkowymi polami, wielu rezygnuje. Amazon Pay rozwiązuje ten problem: klient uwierzytelnia się kontem Amazon, adres dostawy i metoda płatności są przejmowane automatycznie. Żadnego formularza, żadnego numeru karty kredytowej, żadnego nowego hasła. Według case studies samego Amazona współczynnik konwersji rośnie o 15 do 30%, w zależności od branży i obecnej jakości checkout.

Dla operatorów sklepów TYPO3 integracja nie jest plug-and-play. Amazon Pay wymaga połączenia API (Login with Amazon, Amazon Pay API v2), certyfikowanej implementacji i regularnych aktualizacji bezpieczeństwa. Amazon weryfikuje każdą integrację przed uruchomieniem.

Typowe scenariusze zastosowań

Średnie sklepy B2C z aimeos. Sklepy internetowe z modą, elektroniką, artykułami gospodarstwa domowego, które obok PayPal i karty kredytowej chcą zaoferować trzecią metodę płatności. Amazon Pay sprawdza się szczególnie dobrze przy impulsywnych zakupach poniżej 200 EUR, gdzie każda przeszkoda w checkout bezpośrednio kosztuje obrót. Integracja z aimeos odbywa się przez własny Service-Provider, który jest wpinany w pipeline płatności.

Platformy darowizn i składki członkowskie. Stowarzyszenia i organizacje pozarządowe, które za pośrednictwem swojej witryny TYPO3 zbierają darowizny lub składki członkowskie, korzystają z niskiego progu wejścia. Darczyńca klika “Zapłać przez Amazon”, potwierdza kwotę i gotowe. Żadnego wpisywania IBAN, żadnego ustawiania polecenia zapłaty. Dla płatności cyklicznych Amazon Pay wspiera Recurring Payments.

Produkty cyfrowe i pliki do pobrania. Licencje oprogramowania, e-booki, kursy online - produkty bez fizycznej wysyłki korzystają szczególnie, ponieważ cały proces zakupowy zamyka się w mniej niż 30 sekund. Nie potrzeba adresu wysyłki, tylko uwierzytelnienie i płatność.

Architektura techniczna

Amazon Pay v2 opiera się na REST-API z payload JSON. Przebieg w sklepie TYPO3: klient klika przycisk Amazon Pay, jest przekierowywany do Amazon (lub otwiera się popup), loguje się i potwierdza adres oraz metodę płatności. Amazon zwraca Access Token do sklepu. Sklep tworzy Checkout Session przez Amazon Pay API, w której są zdeponowane dane koszyka i szczegóły zamówienia. Po potwierdzeniu przez klienta płatność jest inicjowana.

Integracja w TYPO3 wymaga trzech komponentów: klienta API (żądania HTTP do Amazon Pay API z podpisem RSA), komponentu frontendowego (przycisk Amazon Pay jako widget JavaScript) oraz handlera webhook dla asynchronicznych powiadomień (potwierdzenie płatności, zwrot, obciążenie zwrotne).

Dla aimeos istnieje plugin społecznościowy pokrywający podstawowe funkcje. Dla tt_products lub sklepów niestandardowych potrzebna jest własna integracja. W obu przypadkach sklep TYPO3 musi używać HTTPS (obowiązek od Amazon Pay v2), a URL webhook musi być dostępny z zewnątrz.

Amazon udostępnia środowisko sandbox, w którym wszystkie przepływy płatności można testować bez prawdziwych pieniędzy. Sandbox korzysta z własnych endpointów API i kont testowych.

Częste problemy i rozwiązania

Certyfikacja nie udaje się za pierwszym podejściem. Amazon sprawdza przed uruchomieniem, czy integracja funkcjonuje poprawnie: umiejscowienie przycisku, obsługa błędów przy odrzuconych płatnościach, wyświetlanie na urządzeniach mobilnych, prawidłowe anulowanie. Częste błędy: przycisk Amazon Pay nie pojawia się na stronie produktu (tylko w koszyku), komunikaty o błędach przy odrzuceniu płatności brakują. Rozwiązanie: kompletne przejście Integration Checklist Amazona przed złożeniem wniosku o weryfikację.

Powiadomienia IPN (Instant Payment Notifications) giną. Amazon wysyła potwierdzenia płatności asynchronicznie przez POST na zdeponowany URL. Jeśli TYPO3 blokuje te żądania przez cachowanie, reguły przekierowań lub brak wyjątków CSRF, zamówienie pozostaje w statusie “oczekujące”. Rozwiązanie: skonfigurowanie dedykowanej trasy eID lub middleware dla webhook, która działa poza normalnym przetwarzaniem żądań TYPO3.

Recurring Payments i modele abonamentowe. Amazon Pay wspiera płatności cykliczne, ale konfiguracja jest bardziej złożona niż przy Stripe Subscriptions. Klient musi jawnie zaakceptować Billing Agreement, a sklep musi regularnie wysyłać żądania Authorize. Rozwiązanie: zarządzanie Billing Agreements jako oddzielna encja bazodanowa i skonfigurowanie cronjoba, który inicjuje należne płatności.

Migracja i kompatybilność wersji

Amazon Pay v2 to aktualna wersja API (od 2021). Wersja 1 nie jest już akceptowana dla nowych integracji od końca 2023. Istniejące implementacje v1 nadal działają, ale nie otrzymują aktualizacji ani nowych funkcji. Migracja z v1 na v2 dotyczy kompletnego klienta API: inne endpointy, inny mechanizm podpisu (RSA zamiast HMAC), inne zarządzanie sesjami.

Dla TYPO3 nie ma oficjalnego rozszerzenia Amazon Pay w TER z aktywnym wsparciem v12/v13. Integracja odbywa się jako kod niestandardowy lub przez pluginy społecznościowe dla aimeos. Gosign implementuje Amazon Pay jako samodzielny pakiet Composer, który można wpiąć w dowolną konfigurację sklepu TYPO3. Ten pakiet enkapsuluje klienta API, przycisk i handler webhook, dzięki czemu aktualizacja główna TYPO3 dotyczy jedynie warstwy adapterów specyficznych dla TYPO3.

Całkowity koszt integracji Amazon Pay w istniejącym sklepie TYPO3 wynosi od 3 do 8 dni deweloperskich, w zależności od tego, czy można wykorzystać plugin aimeos, czy potrzebna jest integracja niestandardowa. Certyfikacja Amazon wymaga dodatkowo 1 do 2 dni na przygotowanie i rundy korekt.