Integracja Tpay WooCommerce łączy sklep z polską bramką płatności: klient płaci BLIK-iem, przelewem, kartą lub Google Pay, a status zamówienia aktualizuje się automatycznie po zaksięgowaniu wpłaty.
Jak działa integracja Tpay WooCommerce
Integracja Tpay WooCommerce pozwala przyjmować płatności bezpośrednio w sklepie i automatycznie aktualizować zamówienia. Służy do tego oficjalna wtyczka operatora Tpay, czyli poznańskiej spółki Krajowy Integrator Płatności.
Po uruchomieniu bramki możesz udostępnić klientom BLIK, szybkie przelewy, karty oraz Google Pay. W zależności od Twojej umowy z Tpay dostępne mogą być także raty i BLIK Płacę Później.
Dużą zaletą integracji jest sposób prezentowania płatności w checkoucie. Klient może wpisać kod BLIK bezpośrednio w sklepie. Przy szybkich przelewach widzi kafelki banków i od razu wybiera swój bank. Każdy dodatkowy krok wydłuża zakup, więc takie uproszczenie ma znaczenie szczególnie na telefonie.
Po zakończeniu płatności Tpay wysyła powiadomienie do WooCommerce. Sklep odbiera informację i zmienia status zamówienia, na przykład z „Oczekujące na płatność” na „W trakcie realizacji”. Nie trzeba ręcznie sprawdzać każdej wpłaty w panelu operatora.
Z poziomu panelu Tpay możesz również zlecać zwroty całkowite i częściowe. Przydaje się to wtedy, gdy klient oddaje jeden produkt z większego zamówienia albo otrzymuje zwrot części kosztów.
Zanim zaczniesz – konto Tpay i klucze Open API
Do uruchomienia bramki potrzebujesz zweryfikowanego konta Tpay oraz trzech danych: Client ID, Secret i kodu bezpieczeństwa. Sam sklep powinien mieć już działający koszyk, checkout i podstawowe dokumenty sprzedażowe.
Podczas weryfikacji Tpay może sprawdzić dane firmy, regulamin sklepu, politykę prywatności oraz informacje o sprzedawcy. Przejdź wcześniej pełną ścieżkę zakupową. Dodaj produkt do koszyka, wpisz dane klienta i sprawdź, czy da się dojść do wyboru płatności. Jeśli dopiero budujesz sklep, przejdź najpierw przez nasz przewodnik jak założyć sklep internetowy na WordPressie.
Client ID i Secret znajdziesz w Panelu Sprzedawcy. Wejdź do sekcji „Integracja”, otwórz zakładkę „API” i znajdź pozycję „Klucze do nowego Open API”. Kod bezpieczeństwa znajduje się w ustawieniach powiadomień. Pełny opis konfiguracji zawiera dokumentacja wdrożenia wtyczki Tpay.
Potrzebne dane to:
- Client ID używany podczas łączenia sklepu z API Tpay,
- Secret, który potwierdza uprawnienia sklepu,
- kod bezpieczeństwa służący do weryfikowania powiadomień o transakcjach.
Client Secret traktuj jak hasło. Przechowuj go poza publicznymi dokumentami, wiadomościami wysyłanymi przypadkowym osobom i zrzutami ekranu z zaplecza sklepu.
Merchant ID jest loginem do Panelu Sprzedawcy. Standardowa konfiguracja płatności opiera się na danych Open API, ale Merchant ID może być dodatkowo wymagany przy uruchamianiu rat.
W panelu Tpay włącz zgodę „Zezwól na nadpisanie adresu URL powiadomienia”. Wtyczka przekazuje wtedy właściwy adres, pod który operator wysyła informacje o płatnościach. Przy wyłączonej zgodzie klient może zapłacić poprawnie, a zamówienie nadal będzie czekało na płatność.
Wtyczka Tpay obsługuje sklepy rozliczane w złotówkach. Jeśli WooCommerce korzysta z innej waluty albo przelicznik zmieni walutę zamówienia, bramka nie obsłuży takiej transakcji.
Konfiguracja Tpay WooCommerce krok po kroku
Konfiguracja składa się z instalacji oficjalnej wtyczki, wpisania kluczy i włączenia wybranych płatności. Na końcu złóż zamówienie testowe i sprawdź całą ścieżkę, łącznie ze zmianą statusu.
Krok 1. Pobierz i zainstaluj oficjalną wtyczkę Tpay
Wtyczkę w wersji Open API pobierzesz ze strony modułów sklepowych Tpay. Najnowsze wydania są również publikowane w zasobach Tpay na GitHubie. Do instalacji potrzebujesz paczki ZIP.
W panelu WordPressa przejdź do „Wtyczki”, wybierz „Dodaj nową”, a następnie „Wyślij wtyczkę na serwer”. Wskaż pobrany plik ZIP, rozpocznij instalację i aktywuj moduł.
Nowsze wersje obsługują HPOS, czyli wydajniejszy sposób zapisywania zamówień w WooCommerce, oraz checkout zbudowany z bloków. Zgodność samej wtyczki nie wyklucza konfliktu z motywem, modułem dostaw albo dodatkiem zmieniającym pola zamówienia.
Przed instalacją wykonaj kopię zapasową. Sprawdź też wersje WordPressa, WooCommerce, PHP i używanego motywu. Aktualizacje najlepiej przeprowadzić wcześniej na kopii sklepu, zwłaszcza gdy sprzedaż już działa.
Krok 2. Wpisz Client ID, Secret i kod bezpieczeństwa
Dane dostępowe wpisujesz w globalnych ustawieniach Tpay w WooCommerce. W tym samym miejscu wybierasz środowisko produkcyjne lub testowe.
Produkcja korzysta z danych utworzonych w panel.tpay.com. Sandbox ma własny panel pod adresem panel.sandbox.tpay.com i osobny komplet kluczy. Client ID, Secret oraz kod bezpieczeństwa muszą pochodzić z jednego środowiska.
Połączenie produkcyjnego Client ID z testowym Secretem kończy się błędem uwierzytelnienia. Podobny efekt może dać spacja doklejona podczas kopiowania. Najbezpieczniej przekleić wszystkie wartości ponownie, bez ręcznego przepisywania.
Po zapisaniu ustawień sprawdź, czy wtyczka zgłasza poprawne połączenie. Jeśli widzisz błąd, zacznij od środowiska i kluczy. Dopiero później przechodź do analizy firewalla lub konfiguracji serwera.
Krok 3. Włącz metody płatności w checkoucie
Metody obsługiwane przez Tpay pojawiają się jako osobne pozycje w ustawieniach płatności WooCommerce. Na początek zwykle wystarczą BLIK, szybkie przelewy i karty. Google Pay oraz raty włączysz po ich aktywacji na koncie Tpay.
BLIK z kodem wpisywanym w sklepie zasługuje na wysoką pozycję na liście. Klient podaje sześć cyfr, zatwierdza płatność w aplikacji bankowej i często zamyka cały proces w kilkanaście sekund.
Po ustawieniu kolejności metod otwórz checkout na telefonie. Sprawdź, czy nazwy są czytelne, kafelki banków mieszczą się na ekranie, a pola płatności nie nachodzą na podsumowanie zamówienia.
Wtyczka pozwala też powiązać metody płatności z wybranymi sposobami dostawy. Możesz na przykład pokazywać konkretną opcję wyłącznie przy wysyłce kurierskiej. Takie reguły przetestuj dla każdej dostępnej dostawy.
Moduł Tpay może automatycznie anulować nieopłacone zamówienia po wskazanej liczbie dni, maksymalnie po 30. WooCommerce ma dodatkowo własne ustawienie czasu rezerwacji towaru. Domyślna wartość wynosi zwykle 60 minut, po których nieopłacone zamówienie może zostać anulowane. Ustaw oba mechanizmy świadomie, żeby produkty nie wracały do magazynu zbyt wcześnie.
Krok 4. Złóż zamówienie testowe i sprawdź zmianę statusu
Test powinien obejmować pełną ścieżkę klienta: dodanie produktu do koszyka, checkout, wybór Tpay, płatność i powrót do sklepu. Po prawidłowej transakcji status zamówienia powinien zmienić się z „Oczekujące na płatność” na „W trakcie realizacji”.
Sprawdź także:
- wiadomości e-mail wysyłane do klienta i obsługi sklepu,
- zmniejszenie stanu magazynowego,
- zapis transakcji w panelu Tpay,
- zgodność kwoty, waluty i numeru zamówienia,
- zachowanie sklepu po odświeżeniu strony z podziękowaniem.
Sam ekran z potwierdzeniem płatności daje za mało informacji. Najważniejsze jest powiadomienie wysłane przez Tpay do sklepu, ponieważ na jego podstawie WooCommerce aktualizuje zamówienie.
Sandbox Tpay i przejście na produkcję
Sandbox pozwala sprawdzić integrację bez wykonywania prawdziwych płatności. Ma własny panel, konto i klucze, dlatego przejście na produkcję wymaga podmiany całego zestawu danych.
W środowisku testowym przeprowadź kilka scenariuszy. Zacznij od udanej płatności, a potem anuluj transakcję przed zapłatą i wróć do sklepu bez jej kończenia. Sprawdź również zwrot pełnej kwoty oraz zwrot częściowy zlecony w panelu Tpay.
Obserwuj statusy zamówień po każdym teście. Zamówienie opłacone powinno przejść do realizacji, a przerwana płatność pozostać nieopłacona. Zwrot musi mieć właściwą kwotę i odnosić się do odpowiedniej transakcji.
Po zakończeniu testów wybierz środowisko produkcyjne i wprowadź Client ID, Secret oraz kod bezpieczeństwa z panelu produkcyjnego. Wyczyść pamięć podręczną strony, serwera i ewentualnej sieci CDN. Następnie otwórz checkout w prywatnym oknie przeglądarki, aby zobaczyć wersję bez zapisanych danych i starego cache.
Pierwsze produkcyjne zamówienie złóż na niewielką kwotę i opłać prawdziwą metodą. Sprawdź panel Tpay, WooCommerce, e-maile oraz stan magazynowy. Dzięki temu wyłapiesz problemy, zanim trafi na nie klient.
Typowe błędy przy integracji i jak je naprawić
Większość problemów z integracją Tpay WooCommerce wynika z pomieszanych kluczy, blokowanych powiadomień albo nieobsługiwanej waluty. Zacznij od tych trzech punktów, bo zwykle pozwalają szybko znaleźć przyczynę.
Błąd uwierzytelnienia najczęściej oznacza dane pochodzące z dwóch paneli. Skopiuj ponownie cały komplet z produkcji albo sandboxa. Usuń przypadkowe spacje przed i po każdej wartości.
Gdy klient zapłacił, a zamówienie nadal ma status „Oczekujące na płatność”, sprawdź zgodę na nadpisanie adresu URL powiadomienia. Następnie wyklucz adresy obsługujące powiadomienia Tpay z cache. Zajrzyj również do ustawień firewalla i zabezpieczeń hostingu, które mogą odrzucać połączenia przychodzące.
Problemy z walutą pojawiają się często po instalacji przelicznika. Produkt może być pokazany klientowi w euro, a Tpay obsługuje w tej integracji płatności w PLN. Sprawdź walutę zapisaną bezpośrednio przy zamówieniu.
Konflikty wtyczek diagnozuj na kopii sklepu. Wyłączaj dodatki pojedynczo i po każdej zmianie twórz nowe zamówienie. Stare zamówienie może zachować dane zapisane przez wcześniejszą konfigurację.
W logach WooCommerce szukaj błędów połączenia, odpowiedzi API i informacji o zmianach statusu. Historia powiadomień w panelu Tpay pokaże, czy operator wysłał wiadomość oraz jak odpowiedział sklep. Porównanie obu zapisów zwykle wskazuje moment, w którym proces został przerwany.
Prowizje Tpay w praktyce
Prowizje Tpay zależą od wybranego wariantu oraz rodzaju płatności. Dwa główne plany to Starter, rozliczany bez miesięcznego abonamentu, oraz Business z opłatą 99 zł miesięcznie.
W planie Starter aktywacja kosztuje 99 zł. Przelewy, karty i portfele cyfrowe mają stawkę 1,59% + 0,39 zł od transakcji, a BLIK 1,59% + 0,41 zł. Zwrot kosztuje 1 zł, z wyjątkiem zwrotów kartowych, a wypłata środków 2 zł.
Business ma aktywację za 1 zł i abonament 99 zł miesięcznie. Prowizja wynosi 0,99% bez standardowej opłaty stałej, przy czym dla BLIKA doliczane są 2 gr. Zwroty i wypłaty środków są bezpłatne.
Przy zamówieniu za 100 zł koszt płatności w Starterze wyniesie około 1,98 zł dla przelewu lub karty i około 2 zł dla BLIKA. Daje to mniej więcej 2% wartości koszyka.
Przy koszyku za 40 zł opłata stała ma większy udział. Prowizja za przelew lub kartę wyniesie około 1,03 zł, czyli około 2,6% zamówienia. Sklep z tańszymi produktami szybciej odczuje różnicę między cennikami.
Przy średnim koszyku w okolicy 100 zł oba warianty zbliżają się kosztowo przy miesięcznym obrocie około 10 tys. zł. Niższa wartość zamówień może przesunąć granicę na korzyść planu Business.
Tpay realizuje wypłaty w trybie D+1. Przy większych obrotach możesz otrzymać ofertę indywidualną. Przed podpisaniem umowy sprawdź aktualny cennik Tpay, zasady wypłat i stawki przypisane do konkretnych metod, ponieważ warunki handlowe mogą się zmieniać. Prowizje to tylko jedna pozycja w budżecie sklepu – pełne zestawienie znajdziesz w artykule ile kosztuje sklep internetowy.
Tpay, Przelewy24 czy PayU – co wybrać do WooCommerce
Tpay, Przelewy24 i PayU obsługują BLIK, szybkie przelewy oraz karty. Decyzję oprzyj na kosztach dla Twojego koszyka, wygodzie wdrożenia, terminach wypłat i raportach używanych przez księgowość.
Wtyczkę Przelewy24 pobiera się ze strony operatora. Moduł PayU jest dostępny w katalogu WordPressa, a wtyczka Tpay na stronie modułów operatora i w jego zasobach na GitHubie. Oba konkurencyjne wdrożenia opisaliśmy krok po kroku w przewodnikach po integracji Przelewy24 z WooCommerce i integracji PayU z WooCommerce.
Każda bramka wymaga innego kompletu danych. Przelewy24 korzysta z ID sprzedawcy, klucza CRC i klucza API. PayU wymaga czterech danych punktu płatności REST API. Przy integracji Tpay WooCommerce podajesz Client ID, Secret i kod bezpieczeństwa.
Tpay wyróżnia się kodem BLIK wpisywanym bezpośrednio w sklepie oraz kafelkami banków wyświetlanymi w checkoucie. Plan abonamentowy może dobrze pasować do sklepu z regularnym obrotem. Ograniczeniem pozostaje obsługa zamówień wyłącznie w złotówkach.
Porównując oferty, policz koszt dla własnej średniej wartości zamówienia i miesięcznej liczby transakcji. Dodaj opłaty stałe, abonament, zwroty oraz wypłaty. Dopiero taki rachunek pokaże, która bramka będzie rozsądna dla Twojego sklepu.
FAQ
-
W planie Starter przelewy, karty i portfele cyfrowe kosztują 1,59% + 0,39 zł od transakcji, a BLIK 1,59% + 0,41 zł, bez abonamentu. Plan Business za 99 zł miesięcznie obniża prowizję do 0,99% i znosi opłaty za zwroty oraz wypłaty. Stawki indywidualne znajdziesz w swojej umowie i panelu.
-
Trzy wartości z Panelu Sprzedawcy: Client ID i Secret z sekcji „Integracja”, zakładka „API” (pozycja „Klucze do nowego Open API”), oraz kod bezpieczeństwa z ustawień powiadomień. Przy ratach dochodzi Merchant ID, czyli login do panelu. Włącz też zgodę na nadpisanie adresu URL powiadomienia.
-
Tak. Klient wpisuje sześciocyfrowy kod BLIK bezpośrednio w checkoucie sklepu i zatwierdza płatność w aplikacji bankowej, bez opuszczania strony. Cały proces często zamyka się w kilkanaście sekund.
-
Najczęściej sklep nie odbiera powiadomień. Sprawdź, czy w panelu Tpay włączona jest zgoda na nadpisanie adresu URL powiadomienia, a potem cache i firewall – adresy powiadomień o płatności powinny być wyłączone z pamięci podręcznej. Porównaj też kwotę i walutę zamówienia z transakcją w panelu.
-
Nie. Integracja obsługuje płatności w złotówkach. Przy sprzedaży wielowalutowej zamówienia w PLN możesz rozliczać przez Tpay, ale dla pozostałych walut potrzebujesz innej bramki albo osobnego rozwiązania.