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 badania comScore na zlecenie Amazon Pay (USA, 40 sprzedawców) współczynnik konwersji z Amazon Pay był średnio o 35% wyższy niż we własnym checkoucie sprzedawców.

Dla operatorów sklepów TYPO3 integracja nie jest plug-and-play. Amazon Pay wymaga połączenia API (Amazon Pay API v2), domen sklepu zarejestrowanych w Seller Central i regularnych aktualizacji bezpieczeństwa. Przed uruchomieniem Amazon sprawdza domeny pod kątem swojej polityki dopuszczalnego użytkowania.

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 obywa się bez wypełniania formularza sklepu. 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 przekierowuje z powrotem do sklepu z identyfikatorem Checkout Session utworzonej po kliknięciu przycisku. Sklep uzupełnia Checkout Session przez Amazon Pay API o kwotę 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 dokumentacja nie wymienia providera Amazon Pay; połączenie powstaje jako własny Service-Provider. Dla tt_products lub sklepów niestandardowych potrzebna jest własna integracja. W obu przypadkach sklep TYPO3 musi używać HTTPS (obowiązkowe dla endpointu IPN w produkcji), 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

Niekompletna lista kontrolna przed uruchomieniem. Przed uruchomieniem sklep testuje w sandboxie przypadki udane i błędne oraz przechodzi listę kontrolną Amazona: 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 listy kontrolnej Amazona przed uruchomieniem sklepu.

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 przy checkoucie zaakceptować cykliczne Charge Permission, a sklep inicjuje każdą należną płatność przez Create Charge. Rozwiązanie: zarządzanie Charge Permissions 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 2020). Dla nowych integracji Amazon zaleca wersję 2. 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, w aimeos jako własny Service-Provider. 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 sklep działa na aimeos z jego interfejsem providerów, czy potrzebna jest integracja niestandardowa. Testy w sandboxie i lista kontrolna przed uruchomieniem wymagają dodatkowo 1 do 2 dni na przygotowanie i rundy korekt.