Integracja Tpay z PrestaShop polega na pobraniu modułu płatności, zainstalowaniu go w panelu sklepu, a następnie uzupełnieniu danych konfiguracyjnych takich jak ID sprzedawcy i kod bezpieczeństwa z Panelu Akceptanta Tpay. Tpay udostępnia instrukcje zarówno dla starszych wdrożeń PrestaShop 1.6 i 1.7, jak i dla nowszej wersji modułu opartej o Open API.
Spis treści
Co przygotować przed wdrożeniem
Przed rozpoczęciem integracji warto sprawdzić wersję sklepu i środowiska serwera. Według dokumentacji Tpay klasyczny moduł wymaga PrestaShop 1.6 lub 1.7 oraz PHP minimum 5.6, natomiast wersja Open API obsługuje PrestaShop od 1.7.7.5 do 9.x oraz PHP 7.1 do 8.1.
W dokumentacji pojawia się także wymóg ustawienia waluty PLN dla płatności przelewami, a przy wersji Open API dodatkowo zalecenie włączenia przyjaznych adresów URL w panelu PrestaShop. Brak aktywnych przyjaznych linków może powodować niepoprawne działanie modułu.
Instalacja modułu
W starszych wersjach PrestaShop instalację zaczynasz od pobrania modułu, zalogowania się do panelu administracyjnego i przejścia do sekcji modułów, gdzie dodajesz nowy moduł i przesyłasz plik do instalacji. W PrestaShop 1.7 oraz nowszych wdrożeniach Open API proces wygląda podobnie, ale zwykle odbywa się przez sekcję Marketplace albo Menedżer Modułów i opcję Załaduj moduł.
Po poprawnej instalacji przechodzisz od razu do konfiguracji modułu Tpay. To właśnie tam wpisujesz dane dostępowe i włączasz potrzebne funkcje płatności.
Konfiguracja płatności
W konfiguracji modułu należy wpisać ID sprzedawcy oraz kod bezpieczeństwa pobrany z panelu Tpay. Dokumentacja wskazuje, że kod bezpieczeństwa znajduje się w ustawieniach powiadomień i bezpieczeństwa w Panelu Akceptanta, a pozostałe ustawienia zależą już od potrzeb konkretnego sklepu.
Jeżeli planujesz korzystać z BLIK-a lub zwrotów, potrzebne będą też klucz API i hasło API wygenerowane w panelu Tpay z uprawnieniami do transakcji i zwrotów. W przypadku płatności kartami dodatkowa konfiguracja nie jest wymagana, jeśli klient jest przekierowywany do panelu transakcyjnego Tpay, natomiast ustawienia API kart są potrzebne dopiero wtedy, gdy dane karty mają być wpisywane bezpośrednio na stronie sklepu.
Testy i najczęstsze problemy
Po zapisaniu ustawień Tpay warto wyczyścić pamięć podręczną sklepu, wygenerować nowe zamówienie i wykonać testową płatność, aby sprawdzić poprawność działania integracji. To prosty sposób, żeby szybko wychwycić błędy konfiguracji jeszcze przed uruchomieniem płatności dla klientów.
Jednym z najczęstszych problemów jest podanie błędnego kodu bezpieczeństwa, na przykład wpisanie hasła do panelu zamiast właściwego kodu. Przy problemach z przekierowaniem do panelu transakcyjnego warto też zaktualizować moduł do najnowszej wersji.