Tpay w sklepie internetowym - integracja BLIK i szybkich przelewow

Przy budowie sklepu WooCommerce jedno z pierwszych pytan brzmi: ktora bramka platnosci? Tpay od lat jest solidna, polska alternatywa dla PayU i Przelewy24, a od 2026 roku zmienil strukture prowizji tak, ze przy wiekszych obrotach moze byc wyraznie tanszy. Jesli rozważasz integracja Tpay sklep internetowy od zera albo chcesz migrowac ze starej konfiguracji na nowe Open API - ten artykul przeprowadzi Cie przez caly proces: od rejestracji, przez konfiguracje webhooków, az po BLIK on-site i automatyczne zwroty.

Przed przystąpieniem do pracy warto miec swiadomosc jednej rzeczy: stara wtyczka Tpay (transferuj.pl) bazowała na przestarzalym API. Nowa, oficjalna wtyczka na WordPress.org uzywaja Open API z kluczami Client ID i Secret. Jezeli Twoj sklep dziala jeszcze na starym module - przeczytaj ten poradnik do konca, bo zmiana keyset i aktualizacja konfiguracji webhooków to absolutna koniecznosc.

Czym jest Tpay i jakie metody platnosci oferuje

Tpay to polska instytucja platnicza (nadzorowana przez KNF) z siedziba we Wroclawiu, istniejaca od 2011 roku pod marka Transferuj.pl, przemianowana w 2017 roku. Obsluguje ponad 50 000 sklepow i obsługuje kilka roznych sposobow przyjmowania platnosci:

• BLIK - 6-cyfrowy kod generowany przez aplikacje bankowa; mozliwy do osadzenia bezposrednio na stronie kasy (on-site) lub na stronie Tpay (redirect)
• Pay by Link (PBL) - szybki przelew przez bankowosc internetowa; klient loguje sie do banku, przelew jest wstepnie wypelniony
• Karta platnicza (Visa, Mastercard) - obsluga 3D Secure v2
• Raty i platnosci odroczone - przez zewnetrznych partnerow (m.in. Twisto)
• Portfele cyfrowe - Google Pay, Apple Pay (wymaga osobnej konfiguracji kart)

W moich projektach zdecydowana wiekszosc transakcji idzie przez BLIK (ok. 55-60%) i Pay by Link (ok. 25-30%). Karta to juz relatywnie mniejszy udzial przy sklepach kierujacych sie wylacznie do klientow krajowych.

Rejestracja konta akceptanta - co przygotowac

Wejdz na register.tpay.com i zaloguj sie przez Google lub e-mail. Rejestracja konta trwa kilka minut, ale weryfikacja i aktywacja pelnej mozliwosci przyjmowania platnosci wymaga kilku dokumentow:

1. Pelna nazwa firmy, adres, NIP, numer KRS lub CEIDG
2. Dokument tozsamosci wlasciciela/reprezentanta (skan lub zdjecie)
3. Regulamin sklepu internetowego w formacie PDF lub link URL - Tpay sprawdza czy zawiera informacje o metodach platnosci, procedurze reklamacji i polityce zwrotow
4. Konto bankowe zarejestrowane na firme (pierwsze wyplaty ida tylko na konto zweryfikowane)

W mojej praktyce weryfikacja przy zakladaniu konta dla nowego klienta trwa 1-3 dni robocze. Przy jednym projekcie e-commerce (sklep dzieciecy) weryfikacja zajela ponizej 24 godzin - Tpay mial komplet dokumentow. Przy innym kliencie z bardziej zlozons struktura spolki (sp. z o.o., kilku wspolnikow) czekalismy 4 dni robocze na dodatkowe potwierdzenie KRS.

Nowy cennik Tpay 2026 - pakiety Starter i Business

Od 1 stycznia 2026 Tpay porzucil model jednej prowizji i wprowadzil dwa pakiety. To istotna zmiana, ktora wplywa na rentownosc sklepu:

Progi oplacalnosci: jesli Twoj sklep generuje ponizej ok. 15 000-20 000 zl miesiecznego obrotu, Starter jest tanim wejsciem bez stalych kosztow. Powyzej 30 000 zl/mc Business zwraca sie z nawiazka, bo oszczednosc na prowizji (0,6 punktu procentowego) szybko pokrywa 99 zl abonametu.

Przykladowo: 100 transakcji po 300 zl to 30 000 zl obrotu. W Starterze: 100 x (1,59% x 300 + 0,39) = 100 x (4,77 + 0,39) = 516 zl miesiecznie. W Business: 100 x (0,99% x 300) + 99 = 297 + 99 = 396 zl. Roznica 120 zl miesiecznie.

Szersze porownanie z PayU i Przelewy24 omawiam w osobnym artykule: PayU, Przelewy24 i Tpay - porownanie bramek platniczych.

Instalacja wtyczki Tpay do WooCommerce

Officjalna wtyczka Tpay dostepna jest na WordPress.org pod nazwa "WooCommerce Payment Gateway - tpay.com". Instalacja zajmuje dosłownie 2 minuty:

1. Panel WordPress > Wtyczki > Dodaj nowa > szukaj "tpay"
2. Zainstaluj "WooCommerce Payment Gateway - tpay.com" i aktywuj
3. Przejdz do WooCommerce > Ustawienia > Platnosci
4. Znajdz wiersze Tpay i wlacz poszczegolne metody (Tpay - wszystkie metody, BLIK, Karta)

Jeden szkopul: stara wtyczka "Transferuj.pl" rowniez moze pojawic sie w wynikach wyszukiwania. Upewnij sie, ze instalujesz ta z oficjalnym logo Tpay i wersja >=2.x (wymagana do Open API).

Konfiguracja kluczy Open API

To jest krok, na ktorym wiele osob blokuje sie przy pierwszej integracji. Stare klucze (Merchant ID + hash) nie dzialaja w nowej wtyczce. Nowe klucze to Client ID i Secret z sekcji Open API.

Skad brac klucze:
Zaloguj sie do panel.tpay.com > Integracja > API > sekcja "Klucze do nowego Open Api". Zobaczysz dwa pola: Client ID (ciag cyfr, np. 01234567-abcd-...) i Secret (dlugi string alfanumeryczny). Skopiuj oba.

Gdzie wkleic:
WooCommerce > Ustawienia > Platnosci > Tpay (kliknij Zarzadzaj) > pola Client ID i Sekret API. Dodatkowe pole "Kod bezpieczenstwa" to osobna wartosc z zakladki Ustawienia > Powiadomienia > sekcja Bezpieczenstwo.

Na potrzeby testow panel Tpay udostepnia srodowisko sandbox z odrebnymi kluczami. Przelacz wtyczke w tryb testowy zaznaczajac opcje "Tryb testowy" w ustawieniach - wtedy wszystkie transakcje sa symulowane, a platnosci nie pobieraja realnych srodkow.

Konfiguracja BLIK on-site - platnosci bez przekierowania

BLIK to juz ok. 60% polskich transakcji e-commerce. Standardowa implementacja (redirect) przenosi klienta na strone Tpay, gdzie wpisuje kod. Lepsza opcja to BLIK on-site (osadzony) - kod jest wpisywany bezposrednio w formularzu checkoutu, bez opuszczania sklepu.

W wtyczce Tpay dla WooCommerce BLIK on-site aktywujesz oddzielnie: WooCommerce > Ustawienia > Platnosci > znajdz wiersz "BLIK" (odrebny od glownego Tpay) > wlacz. Ta metoda pojawia sie jako samodzielna opcja platnosci przy kasie.

BLIK One Click idzie krok dalej: przy pierwszym zakupie klient zaznacza zgode na zapamietanie urzadzenia (alias) w swojej aplikacji bankowej. Przy kolejnym zakupie na tym samym urzadzeniu wystarczy kliknac "Zaplac BLIK" i potwierdzic w aplikacji - bez wpisywania kodu. Wdrozenie One Click wymaga po stronie sklepu przechowywania aliasu przypisanego do konta uzytkownika, co oficjalna wtyczka obsługuje automatycznie dla zalogowanych klientow.

U jednego z moich klientow (sklep z akcesoriami do domu, Poznań) wdrozenie BLIK on-site zamiast redirect zmniejszylo wspołczynnik porzucenia koszyka przy platnosci o ok. 11 punktow procentowych w pierwszym miesiacu. Klienci po prostu nie lubili byc przenoszeni poza sklep na ostatnim kroku.

Pay by Link (szybkie przelewy) - konfiguracja i dzialanie

Pay by Link to mechanizm, ktory generuje gotowy przelew w systemie bankowosci internetowej klienta. Klient wybiera bank z listy, loguje sie, a dane odbiorcy i kwota sa juz wypelnione. Wystarczy kliknac "Zatwierdz".

Tpay obsluguje kilkadziesiat bankow w modelu Pay by Link, w tym PKO BP, mBank, Pekao, ING, Alior, Santander i inne. Lista dostepnych bankow jest aktualizowana na stronie Tpay i pojawia sie dynamicznie w checkoucie.

Konfiguracja: Pay by Link jest juz wbudowany w glowna metode Tpay (nie wymaga osobnej aktywacji). Po wlaczeniu "Tpay - wszystkie metody platnosci" klienci widza liste bankow lub ikone ogolnego szybkiego przelewu.

Czas ksiegowania: platnosci Pay by Link sa ksiegowane zwykle w ciagu kilku minut w godzinach roboczych bankow. Nocne i weekendowe transakcje moga byc oprozniczone do nastepnej sesji rozliczeniowej miedzybanowej, co w praktyce oznacza od kilku minut do kilku godzin. Webhook wysylany przez Tpay dociera do sklepu w momencie potwierdzenia platnosci po stronie banku - nie czekasz recznie na zmiane statusu zamowienia.

Budowa kompletnego sklepu WooCommerce od podstaw, lacznie z doborem bramki platnosci, opisuję szczegolowo w artykule: Sklep WooCommerce 2026 - kompletny przewodnik.

Webhook zwrotny - jak go ustawic i co sprawdzic

Webhook (adres do notyfikacji) to URL, pod ktory Tpay wysyla powiadomienie POST za kazdym razem, gdy status transakcji sie zmieni: platnosc potwierdzona, odrzucona, zwrot zainicjowany. Bez poprawnego webhooka Twoj sklep nie dowie sie, ze ktos zaplaci - zamowienia bedziez wisly w statusie "Oczekuje na platnosc" na wieki.

Adres webhooka generowany przez wtyczke Tpay wyglada tak:
https://twojsklep.pl/?wc-api=wc_tpay

Gdzie wkleic webhook:
Panel Tpay > Ustawienia > Powiadomienia > pole "Adres do notyfikacji". Wklej pelny adres HTTPS. Zapisz.

Co musi sie stac po stronie sklepu:
Serwer musi odpowiedziec kodem HTTP 200 OK. Jezeli Tpay dostanie odpowiedz 301/302 (redirect), 404, 500 lub timeout - uzna powiadomienie za nieudane i ponowi probe (kilka razy, co kilka minut). Przy dluzszym problemie z webhookiem zamowienia pozostana w nieprawidlowym statusie.

Powiadomienia Tpay sa podpisane cyfrowo sygnatura JWS w naglowku X-JWS-Signature. Wtyczka WooCommerce weryfikuje ta sygnature automatycznie - nie musisz implementowac tego recznie, ale warto wiedziec ze mechanizm dziala i chroni przed falsywymi powiadomieniami.

Automatyczne zwroty przez WooCommerce

Zwroty to temat, o ktorym czesto zapomniano przy konfiguracji sklepu - a reklamacje i zwroty to codziennosc. Tpay obsluguje automatyczne zwroty bezposrednio z panelu zamowien WooCommerce:

1. Wejdz do zamowienia w WooCommerce > Zamowienia
2. Kliknij przycisk "Zwrot" pod lista produktow
3. Wpisz kwote zwrotu (czaciowy lub pelny)
4. Kliknij "Zwrot przez Tpay"

Tpay inicjuje przelew zwrotny na konto klienta. Standardowy czas pojawienia sie srodkow u klienta to 1-10 dni roboczych, w zaleznosci od banku. Przy przelewach zwrotnych BLIK pieniadze wracaja do aplikacji bankowej zwykle w ciagu 1-2 dni roboczych.

Koszt zwrotu w pakiecie Starter: 0,90 zl za kazde polecenie zwrotu. W Business stawka jest negocjowana (czesto brak oplaty). Prowizja od oryginalnej transakcji nie jest zwracana przez Tpay - to standard w calej branzy bramek platniczych.

Jesli szukasz wiekszej automatyzacji procesu zwrotow po stronie klienta, warto rozwazyc wtyczke Elastic Returns/Flexible Refund - laczy sie z Tpay i pozwala klientom skladac wnioski o zwrot bezposrednio z konta w sklepie, bez kontaktu z obsluga.

Platnosci ratalne i odroczone - czy Tpay to obsługuje

Tpay nie oferuje wlasnych rat - wspolpracuje z zewnetrznymi partnerami. W checkoucie mozna aktywowac platnosci odroczone lub ratalne przez dedykowane widgety (np. Twisto, PayPo) - ale to odrebna konfiguracja, nie objeta podstawowa wtyczka. Jesli prowadzisz sklep z wyzsza srednia wartoscia koszyka (300+ zl), warto rozwazyc integracje platnosci odroczonych rownolagle do Tpay. Szerzej pisalem o tym w artykule o ratach i platnosciach odroczonych w WooCommerce.

Testowanie przed uruchomieniem - srodowisko sandbox

Nigdy nie konfiguruj bramki platnosci od razu na produkcji bez testow. Tpay udostepnia srodowisko sandbox z osobnymi kluczami Client ID i Secret - dostepnymi po zalogowaniu do panelu deweloperskiego Tpay.

Przy testach sprawdz:

• Platnosc BLIK: wpisz testowy kod (sandbox zwraca sukces dla kazdego poprawnie sformatowanego kodu)
• Platnosc karta: uzyj danych testowych Visa/MC z dokumentacji Tpay
• Webhook: zweryfikuj ze zamowienie zmienia status na "Przetwarzanie" lub "Zakonczone" po potwierdzeniu platnosci
• Zwrot: wykonaj testowy zwrot i sprawdz czy pojawia sie w panelu akceptanta sandbox

Po testach przywroc klucze produkcyjne i wylacz tryb testowy w ustawieniach wtyczki.

Integracja Tpay ze Shoperem i innymi platformami

Jesli prowadzisz sklep na Shoperze zamiast WooCommerce, integracja Tpay wyglada inaczej - Shoper ma wlasny panel partnerow platnosci i modul Tpay jest tam dostepny jako gotowa integracja. Konfiguracja sprowadza sie do wpisania kluczy API w panelu Shopera bez instalowania dodatkowych wtyczek.

Podobnie dziala integracja z PrestaShop (osobna wtyczka Open API dostepna na support.tpay.com), Magento 2 i Sylius. Kazda platforma ma odrebna instrukcje, ale logika jest taka sama: klucze Open API + adres webhooka + wybor metod platnosci.

Budowa sklepow e-commerce, w tym dobor platformy i bramek platnosci, to jedna z moich glownych specjalizacji - jesli masz pytania dotyczace konkretnego przypadku, zajrzyj na strone oferty sklepow internetowych lub napisz do mnie.

Najczestsze bledy przy integracji Tpay

Podsumowuje bledy, ktore widze najczesciej przy audytach i migracjach sklepow:

• Uzywanie starych kluczy (Merchant ID + hash) z nowa wtyczka - integracja nie dziala, brak czytelnego komunikatu bledu
• Niepodany lub zly adres webhooka - zamowienia nie zmieniaja statusu automatycznie
• Brak SSL lub wygasly certyfikat - Tpay odmawia wyslania webhooka, platnosci moga byc odrzucane
• Tryb testowy (sandbox) zostawiony wlaczony na produkcji - klienci nie moga plalic, sklep nie pokazuje bledu
• Waluta inna niz PLN w konfiguracji WooCommerce - Tpay w podstawowej konfiguracji dziala tylko w PLN
• Brak kodu bezpieczenstwa w polu "Security Code" - czesc wtyczek wymaga tego odrebnego pola obok Client ID i Secret

Jesli po konfiguracji platnosci nie pojawiaja sie w checkoucie, pierwszym krokiem jest sprawdzenie logu bledu WooCommerce (WooCommerce > Status > Logi) i statusu konta w Panelu Akceptanta Tpay (czy konto jest aktywne i zweryfikowane).

Dla wiekszej perspektywy: w moich projektach sklepowych Tpay sprawdza sie najlepiej dla sklepow skierowanych do polskich klientow, przy obrotach od 15 000 do 200 000 zl miesieczny. Ponizej tego progu Przelewy24 bywa prostszym wejsciem. Powyzej warto negocjowac indywidualne stawki - Tpay jest na to otwarty przy wyzszych wolumenach. Pelna oferte sklepy internetowe - od zera do wdrozenia bramki platnosci - realizuje dla klientow z calej Polski i Niemiec.

Najczęstsze pytania

Ile kosztuje integracja Tpay z WooCommerce?

Sama wtyczka jest bezplatna - dostepna na WordPress.org lub w panelu Tpay. Koszty to prowizje od transakcji: w pakiecie Starter 1,59% + 0,39 zl od kazdej platnosci, w Business 0,99% (Pay by Link i BLIK) plus 99 zl abonamentu miesiecznie. Nie ma jednorazowej oplaty aktywacyjnej dla nowych akceptantow od 2026 roku.

Jak dziala BLIK on-site w Tpay?

Klient wybiera BLIK jako metode platnosci na stronie kasy sklepu i wpisuje 6-cyfrowy kod bezposrednio w formularzu - bez przekierowania do zewnetrznej strony. Transakcja zatwierdzana jest aplikacja bankowa. Przy kolejnych zakupach mozna wlaczyc BLIK One Click - klient zatwierdza platnosc tylko w aplikacji, bez wpisywania kodu.

Czym rozni sie Pay by Link od standardowego przelewu?

Pay by Link (szybki przelew) to platnosc inicjowana z poziomu bankowosci internetowej klienta - klient loguje sie do swojego banku i zatwierdza gotowy przelew w kilka sekund. Standardowy przelew bankowy wymaga recznie wpisanych danych. Pay by Link jest ksiegowany natychmiast (w godzinach roboczych bankow), a sklep dostaje potwierdzenie przez webhook w ciagu minut.

Gdzie znalezc klucze Client ID i Secret do konfiguracji wtyczki?

Zaloguj sie do Panelu Akceptanta na panel.tpay.com, przejdz do Integracja > API > sekcja Klucze do nowego Open API. Tam znajdziesz Client ID i Secret. Osobne klucze testowe dostepne sa w trybie sandbox - nie uzywaj kluczy produkcyjnych do testow.

Co to jest webhook Tpay i jak go skonfigurowac?

Webhook to adres URL Twojego sklepu, na ktory Tpay wysyla powiadomienie POST o statusie platnosci (oplacono, odrzucono, zwrot). W WooCommerce adres ten jest generowany automatycznie przez wtyczke w formacie https://twojsklep.pl/?wc-api=wc_tpay. Nalezy go wkleic w Panelu Akceptanta: Ustawienia > Powiadomienia > Adres do notyfikacji. Serwer musi odpowiedziec kodem HTTP 200, w przeciwnym razie Tpay ponawia probe kilkakrotnie.

Czy Tpay dziala w trybie testowym (sandbox)?

Tak. W Panelu Akceptanta mozna przelaczac wtyczke w tryb testowy - wtedy transakcje nie pobieraja realnych srodkow. Do testow sluza odrebne klucze sandbox generowane w panelu deweloperskim Tpay. Warto przetestowac caly cykl: platnosc, webhook, zmiane statusu zamowienia i zwrot przed uruchomieniem na produkcji.

Jak szybko Tpay wyplaca srodki na konto firmowe?

Standardowo wyplata nastepuje raz na dobe, po przekroczeniu minimalnego progu saldo ustawionego przez akceptanta w Panelu Akceptanta (np. 100 zl). Mozna tez skonfigurowac wyplate reczna lub zmieniac progi. Pierwsze wyplaty po weryfikacji konta moga byc opoznione o 1-2 dni robocze.

Czy Tpay nadaje sie do malego sklepu z kilkudziesiecioma zamowieniami miesiecznie?

Tak, pakiet Starter nie ma miesiecznej oplaty stalej - placisz wylacznie prowizje od transakcji. Przy malych obrotach (np. 5 000 zl/mc) koszty sa proporcjonalne i niske. Warto jednak porownac Tpay z Przelewy24 i PayU dla swojego profilu zamowien, bo stawki prowizji roznymi sie w zaleznosci od metody platnosci i negocjacji.