Integracja Tpay z WordPress i WooCommerce polega na zainstalowaniu wtyczki płatności, aktywowaniu jej w ustawieniach WooCommerce oraz uzupełnieniu danych z Panelu Akceptanta Tpay, takich jak ID sprzedawcy, kod bezpieczeństwa i w niektórych przypadkach klucze API. To najprostsza droga do uruchomienia płatności online w sklepie opartym o WooCommerce, ponieważ nie wymaga samodzielnego programowania integracji.
Spis treści
Co przygotować przed startem
Zanim zaczniesz, sklep powinien działać na WordPressie z aktywną wtyczką WooCommerce, a Ty musisz mieć aktywne konto w Tpay. W materiałach Tpay pojawia się też wymaganie odpowiedniej wersji PHP, przy czym instrukcja WooCommerce wskazuje minimum PHP 5.3, a wersja Open API minimum PHP 7.0, dlatego w praktyce najlepiej upewnić się, że serwer korzysta z nowszej wersji zgodnej z aktualnym WordPressem i WooCommerce.
W przypadku wdrożenia opartego o Open API sklep powinien mieć ustawioną walutę PLN, a na koncie Tpay trzeba mieć uruchomiony dostęp do Open API w sekcji Integracja i API w Panelu Akceptanta. To ważne, bo bez aktywnego dostępu do właściwych kluczy część metod płatności albo funkcji dodatkowych po prostu nie zadziała.
Instalacja wtyczki
Instalację zaczynasz w panelu WordPressa, przechodząc do sekcji Wtyczki i Dodaj nową. Następnie możesz wgrać pobraną wtyczkę Tpay przez opcję wyślij wtyczkę na serwer, zainstalować ją i aktywować, a analogicznie wcześniej lub równolegle zadbać o aktywną wtyczkę WooCommerce.
W materiałach Tpay opisano też prosty scenariusz, w którym po aktywacji WooCommerce i bramki Tpay przechodzisz od razu do konfiguracji płatności w sklepie. Dzięki temu cały proces jest zrozumiały nawet dla osoby nietechnicznej, bo większość ustawień uzupełnia się z poziomu panelu administracyjnego WordPressa.
Konfiguracja w WooCommerce
Po instalacji przejdź do WooCommerce, potem Ustawienia i Płatności, włącz metodę płatności Tpay, a następnie kliknij Zarządzaj lub dokończ konfigurację, zależnie od wersji modułu. W tym miejscu wpisujesz podstawowe dane integracyjne, przede wszystkim ID sprzedawcy oraz kod bezpieczeństwa pobrany z konta Tpay.
Jeżeli chcesz uruchomić płatności BLIK na stronie sklepu lub korzystać ze zwrotów, potrzebne będą także klucz API i hasło API. Tpay wskazuje, że klucz należy utworzyć w Panelu Akceptanta w sekcji Integracja lub API, z odpowiednimi uprawnieniami do transakcji i zwrotów oraz z aktywnym statusem klucza.
Na co uważać
Jednym z najczęstszych błędów jest wpisanie nieprawidłowego kodu bezpieczeństwa albo pomylenie go z innymi danymi z panelu, co może powodować błędy integracji i komunikaty o niepoprawnych parametrach. Dlatego po zapisaniu ustawień warto od razu wykonać testową płatność i sprawdzić, czy zamówienie otrzymuje poprawny status.
Dobrą praktyką jest również sprawdzenie, czy wybrane metody płatności są faktycznie włączone i czy sklep zapisuje poprawnie statusy zamówień po opłaceniu. Gotowe moduły sklepowe Tpay weryfikują powiadomienia o płatności przed zmianą statusu zamówienia, co pomaga ograniczyć błędy po stronie sklepu.
