Integracja Tpay z Magento 2 opiera się na instalacji modułu przez Composer, uruchomieniu go komendami Magento oraz uzupełnieniu konfiguracji w panelu administracyjnym sklepu w sekcji Stores, Configuration, Sales i Payment Methods. Do poprawnego wdrożenia potrzebujesz aktywnego konta Tpay, sklepu Magento 2, obsługi waluty PLN oraz włączonego dostępu do Open API w Panelu Akceptanta.
Spis treści
Co przygotować przed wdrożeniem
Dokumentacja Tpay wskazuje, że moduł działa na Magento 2.x, wymaga zainstalowanego Composera oraz aktywnego konta w Tpay. Dodatkowo sklep musi obsługiwać polskiego złotego, a w panelu Tpay trzeba mieć dostęp do sekcji kluczy Open API, ponieważ bez niej nie skonfigurujesz nowego sposobu integracji.
Przed startem warto też sprawdzić ustawienia powiadomień w Panelu Akceptanta. Tpay zaleca włączenie opcji pozwalającej na nadpisywanie adresu URL powiadomień, ponieważ jest to potrzebne do poprawnego odbioru statusów transakcji przez moduł Magento.
Instalacja modułu
Instalacja odbywa się po stronie serwera i wymaga użycia Composera. Najpierw doinstalowujesz biblioteki Tpay PHP oraz Tpay Open API PHP, potem sam moduł Magento 2 Basic, a następnie uruchamiasz moduł komendami Magento odpowiedzialnymi za aktywację, aktualizację, kompilację i wdrożenie statycznych plików.
Po zakończeniu instalacji logujesz się do panelu Magento i przechodzisz do ustawień płatności. Właśnie tam aktywujesz moduł i wybierasz sposób działania płatności zgodny z potrzebami sklepu, na przykład szybkie przelewy online, płatności kartą przez panel Tpay albo wariant on-site.
Konfiguracja płatności
W ustawieniach głównych modułu wpisujesz ID sprzedawcy oraz kod bezpieczeństwa z Panelu Akceptanta Tpay. ID sprzedawcy to identyfikator nadany przy rejestracji, a kod bezpieczeństwa znajdziesz w sekcji Ustawienia, Powiadomienia i Bezpieczeństwo.
Jeżeli korzystasz z płatności standardowych przez Open API, musisz dodatkowo uzupełnić Client ID i Secret z sekcji Integracja, API i Klucze do nowego Open API. W przypadku konfiguracji Origin API albo płatności kartowych on-site potrzebne będą z kolei klucz API i hasło API ze starego API.
Dodatkowe możliwości
Tpay udostępnia w Magento 2 także obsługę wielu walut, ale dla walut innych niż PLN jest ona realizowana przez płatności kartowe z użyciem Origin API i wymaga osobnego konta Tpay obsługującego daną walutę oraz aktywnej funkcji Multistore w Magento.
Moduł wspiera również realizację zwrotów z poziomu Magento przez sekcję Sales, Invoices i opcję Credit memo, ale działa to tylko przy poprawnie skonfigurowanym module. Dlatego najpierw warto doprowadzić do pełnej poprawności podstawowej integracji, a dopiero później uruchamiać funkcje dodatkowe.