Tpay — jak działa: integracje i zwroty

Tpay w WooCommerce łączy sklep z bramką płatniczą przez oficjalną wtyczkę, która obsługuje także WooCommerce Blocks.¹
Ten poradnik prowadzi od podłączenia płatności przez wtyczkę lub API po obsługę zamówień, zwrotów i typowych problemów. Wyjaśnia też, do czego służy Panel Akceptanta. Repozytorium oficjalnej wtyczki wymaga WooCommerce w wersji wyższej niż 6.x.x².

Czym jest integracja Tpay z WooCommerce i jak działa płatność?

Tpay z WooCommerce łączy płatność klienta z konkretnym zamówieniem. Klient wybiera metodę w kasie, a sprzedawca śledzi status zamówienia w WooCommerce.
Przed uruchomieniem płatności można skorzystać z Sandbox: środowiska testowego z osobnymi kluczami API. Po próbie sklep przełącza się na zweryfikowane konto produkcyjne.³ Open API w Sandbox wymaga dwóch danych z tego środowiska: identyfikatora klienta i sekretu API⁴.

Konto Tpay musi przejść weryfikację i aktywację, zanim sklep zacznie przyjmować wpłaty klientów. Aktywacja rachunku bankowego do wypłat wiąże się z opłatą aktywacyjną.³ Według LH.pl Tpay nie pobiera stałej opłaty miesięcznej.³
Od 1 stycznia 2026 r. aktywacja konta obejmuje weryfikację podstawowego rachunku bankowego. Kosztuje 99 zł w pakiecie Starter lub 1 zł w pozostałych pakietach⁵.

W standardowej ofercie płatności online Tpay prowizja od transakcji zaczyna się od 1,59%, a opłata stała wynosi 0,39 zł za transakcję.¹ Warunki dla klientów WP Desk wskazują prowizję standardową 1,59% i promocyjną 1%. Zniesiono w nich także opłatę stałą 0,39 zł za transakcję.⁶
Tabela zestawia prowizję i opłatę stałą w standardowej ofercie Tpay oraz promocji dla klientów WP Desk⁷.

Dane w tabeli: 1,6,7

Oferta Tpay przedstawiona przez WP Desk obejmuje 4 darmowe wypłaty miesięcznie.⁶ Rejestracja przez link LH.pl wiąże się z prowizją promocyjną 1,2%.³
Te warunki dotyczą określonych ofert. Nie są ustawieniami wtyczki WooCommerce, więc warto oddzielić koszt obsługi płatności od konfiguracji sklepu.

Jakie etapy obejmuje podłączenie Tpay do WooCommerce?

Podłączenie Tpay do WooCommerce zaczyna się od przygotowania konta i uruchomienia integracji w sklepie. Potem przychodzi czas na próbę płatności i przejście na konto produkcyjne. Konfigurację bramki trzeba powiązać z właściwym środowiskiem oraz jego dwoma danymi: identyfikatorem klienta i sekretem API.
Następny krok to sprawdzenie, czy metoda pojawia się podczas składania zamówienia. Test w środowisku próbnym nie zastępuje aktywacji konta, które ma przyjmować wpłaty klientów.

Co zrobić, gdy płatność Tpay w WooCommerce nie działa?

Płatność Tpay w WooCommerce najlepiej diagnozować od sprawdzenia środowiska i przypisanych do niego kluczy API. Później należy porównać status transakcji ze statusem zamówienia. Trzeba też zobaczyć, czy metoda płatności pojawia się w kasie.
W ustawieniach WooCommerce opisanych przez Tpay domyślny czas dotyczący niezrealizowanego zamówienia wynosi 60 minut. Po jego upływie status zamówienia ma znaczenie przy ustalaniu przyczyny problemu.^4,8

Jak sprawdzić, czy płatności Tpay działają w sklepie?

Tpay w WooCommerce warto sprawdzić z perspektywy klienta: od widoku kasy po zakończenie płatności. Wynik transakcji trzeba następnie zestawić ze statusem zamówienia. Kontrola obejmuje również zapis transakcji; w opisanych ustawieniach domyślny czas dotyczący niezrealizowanego zamówienia wynosi 60 minut.

• Metoda płatności Tpay powinna pojawić się podczas składania zamówienia. Sprawdź ją w tym widoku kasy, z którego korzysta sklep.
• Zamówienie testowe powinno przeprowadzić klienta przez proces płatności. Wykonaj próbę w środowisku testowym przed przyjmowaniem rzeczywistych wpłat.
• Status zamówienia powinien odpowiadać wynikowi próby. Porównaj go z informacją o transakcji dostępną sprzedawcy.

Integracja Tpay może obsługiwać klientów po aktywacji konta produkcyjnego i sprawdzeniu całej ścieżki płatności. Wcześniejsza próba pozwala wychwycić rozbieżność między wynikiem transakcji a statusem zamówienia. Tpay podaje, że przy kompletnych dokumentach i gotowym sklepie weryfikacja konta może zakończyć się nawet w 24 godziny⁹.

Wtyczka Tpay do WooCommerce: instalacja i konfiguracja krok po kroku

Wtyczkę Tpay dla WooCommerce instaluje się w WordPressie, łączy z kontem Tpay i konfiguruje do obsługi zamówień. Wariant Open API wymaga waluty PLN w sklepie oraz dostępu do Open API na koncie Tpay.⁴
Przed instalacją trzeba dopasować wymagania serwera do wybranego wariantu. Instrukcja Open API podaje PHP 7.0 jako minimalną wymaganą wersję⁴.

Poszczególne opisy wtyczki podają różne wymagania dotyczące PHP. Tabela porównuje minimalną wersję dla trzech wariantów lub opisów Tpay WooCommerce.

Dane w tabeli: 2,4,8

Tpay WooCommerce oferowana przez WP Desk to odrębna, płatna wtyczka. Jej cena podstawowa wynosi 149,00 zł, a cena z VAT 183,27 zł.⁶
WP Desk deklaruje 5 minut konfiguracji, aktualizacje i wsparcie dla 1 strony. Podaje też około 1 000 aktywnych instalacji oraz datę aktualizacji 20.08.2026.⁶

Jakie zadania pełni wtyczka Tpay w WooCommerce?

Wtyczka Tpay w WooCommerce służy nie tylko do przyjmowania płatności, lecz także do obsługi zamówienia po zakupie. Pozwala zarządzać zwrotami płatności w panelu WooCommerce i zmieniać kolejność logo banków.²
Wariant WP Desk „Tpay WooCommerce” również umożliwia zwroty bezpośrednio w WooCommerce. Obsługuje ponadto płatności osadzone BLIK w obrębie procesu zakupowego.⁶ Według Tpay klient najczęściej dostaje zwrot natychmiast, choć zależnie od banku może to potrwać do 7 dni roboczych¹⁰.

WooCommerce Blocks to blokowy widok kasy. Przy jego użyciu nie działa opcja doliczania dodatkowej kwoty za płatność Tpay.⁴ To ograniczenie dotyczy ustawienia wtyczki, a nie czasu zwrotu, który może wynieść do 7 dni roboczych.

Jak wtyczka łączy WooCommerce z bramką płatności Tpay?

Wtyczka Tpay Open API łączy sklep z bramką za pomocą danych przypisanych do konta. Potrzebne do konfiguracji identyfikator klienta i sekret API znajdują się w Panelu Akceptanta Tpay.⁴
Z Panelu Akceptanta pobiera się więc dwie dane do dostępu Open API: identyfikator klienta oraz sekret API⁴.

• Panel Akceptanta Tpay udostępnia dane do połączenia Open API. Odczytaj identyfikator klienta i sekret API właściwego konta.
• Ustawienia wtyczki Tpay przyjmują dane dostępowe. Wpisz w nich identyfikator klienta oraz sekret API.
• Połączenie WooCommerce z Tpay trzeba sprawdzić po zapisaniu ustawień. Porównaj wynik transakcji ze statusem zamówienia w sklepie.

Płatność kartą na stronie zamówienia można skonfigurować we wtyczce za pomocą klucza RSA. W tej konfiguracji służy on do obsługi danych karty.⁴

Jak skonfigurować wtyczkę Tpay po instalacji?

Wtyczka Tpay Open API pozwala ustalić, co stanie się z zamówieniem po płatności, oraz określić czas ważności transakcji. Status opłaconego zamówienia można ustawić osobno dla zakupów obejmujących wyłącznie produkty wirtualne.⁴

• Status opłaconego zamówienia określa, jak WooCommerce oznaczy zakup po płatności. Jeśli sklep sprzedaje wyłącznie wirtualne produkty w danym zamówieniu, może nadać mu osobny status.
• Automatyczne anulowanie transakcji w module Tpay Open API można ustawić na okres nie dłuższy niż 30 dni.⁴ Dobierz ten czas do sposobu obsługi nieopłaconych zamówień.
• Wynik płatności trzeba skontrolować po zapisaniu konfiguracji. Złóż próbne zamówienie i porównaj jego status z wynikiem transakcji.

Konfiguracja Tpay w WooCommerce wiąże dane konta z zasadami zmiany statusu zamówień. Wtyczka ma dwa ustawienia statusu po opłaceniu: ogólne i osobne dla zamówień obejmujących wyłącznie produkty wirtualne⁴.

Tpay i Autopay w WooCommerce: obsługa metod płatności w kasie

Tpay i Autopay są odrębnymi integracjami płatniczymi, więc każdą konfiguruje się w WooCommerce osobno. W modelu on-site klient płaci na stronie zamówienia sklepu. Wtyczka Tpay udostępnia tam kartę, BLIK, BLIK Płacę Później, Google Pay, Alior Raty oraz przelewy online z logo banków.¹
Tpay wymienia sześć kategorii metod on-site: kartę, BLIK, BLIK Płacę Później, Google Pay, Alior Raty i przelew online¹¹.

Metody płatności Tpay mogą zależeć od wartości koszyka lub zakupów oraz od opisanej integracji. Zakresy kwotowe dotyczą BLIK Płacę Później, Rat Pekao, Twisto i Rat Tpay. We wtyczce Tpay BLIK Płacę Później pojawia się przy koszyku od 30 zł do 4 000 zł.⁴ Tabela zestawia progi dla tych metod i wskazuje, której integracji dotyczy każdy z nich.

Dane w tabeli: 3,4,12

Płatności kartą w subskrypcjach wymagają dodatkowego rozszerzenia, na przykład WooCommerce Subscriptions.²
Gdy w kasie działają Tpay i Autopay, sprzedawca powinien przypisać wyświetlane metody do właściwych integracji. Klient zobaczy wtedy, którą bramkę wybiera.

Jak udostępnić Tpay klientom przy składaniu zamówienia?

Tpay w WooCommerce udostępnia się klientom przez włączenie metod płatności i ustawienie ich widoku w kasie. Można określić kolejność metod, powiązać je ze sposobem dostawy oraz wybrać miejsce wskazania banku.
Dla BLIK Płacę Później opisana widoczność dotyczy koszyka od 30 zł do 4 000 zł.

• Metody płatności Tpay można wyróżnić na stronie sklepu oraz ustawić ich kolejność i układ.¹ Uporządkuj kasę według metod dostępnych klientom.
• Dostępność metod Tpay można ograniczyć do wybranych sposobów dostawy.¹ Powiąż ograniczenie z dostawą, której ma dotyczyć.
• Wybór banku może pojawić się w koszyku; wybór metody płatności można też przenieść do Panelu Transakcyjnego Tpay.⁴ Ustal, gdzie klient ma wskazać metodę.

Kasa WooCommerce z Tpay pokazuje metody zgodnie z ustawioną kolejnością, sposobem dostawy i miejscem wyboru płatności. W przypadku BLIK Płacę Później znaczenie ma również wartość koszyka: od 30 zł do 4 000 zł.

Ceny i warunki sprawdzone u źródeł: październik 2026.