Przejdź do treści
Jak uruchomić integrację z PayByLink w sklepie WooCommerce

Jak uruchomić integrację z PayByLink w sklepie WooCommerce

Opublikowano: 19 października 2026| Zaktualizowano: 19 października 2026

Klient może wrócić do sklepu z ekranu banku, chociaż zamówienie nadal czeka na potwierdzenie płatności. Przyczyną bywa brak powiadomienia serwerowego, błędne dane modułu albo wybór niewłaściwej metody płatności.

Krótka odpowiedź

Aby uruchomić PayByLink w WooCommerce, wybierz operatora obsługującego przelewy online, aktywuj konto sprzedawcy, zainstaluj zgodny moduł i wpisz dane wymagane przez operatora. Następnie wykonaj test udany, odrzucony i przerwany, sprawdzając transakcję u operatora, powiadomienie serwerowe, status zamówienia i e-mail.

PayByLink jest przelewem online z wyborem banku, a PayPo jest usługą płatności odroczonej.

Usługi KC Mobile

Potrzebujesz pomocy w tym temacie?

Czytasz poradnik „Jak uruchomić integrację z PayByLink w sklepie WooCommerce”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny.

Czytasz poradnik „Jak uruchomić integrację z PayByLink w sklepie WooCommerce”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny. Omów temat tego poradnika

Co przygotować przed uruchomieniem integracji?

Przed konfiguracją przygotuj aktywne konto sprzedawcy, dostęp administratora do WordPressa i dane sklepu wydane przez operatora. Zależnie od dostawcy będą to identyfikatory punktu płatności, klucz API, sekret podpisu lub osobne dane do środowiska testowego.

Przygotuj sklep dostępny pod adresem HTTPS, adres powrotu klienta oraz adres powiadomień serwerowych, jeśli moduł wymaga ich ręcznego ustawienia. Adres powrotu wyświetla klientowi stronę po opuszczeniu bankowości, a powiadomienie serwerowe informuje sklep o zmianie stanu transakcji. Dokumentacja Tpay dla WooCommerce, sprawdzona w październiku 2026, wskazuje wymóg zezwolenia na nadpisanie adresu URL powiadomienia w panelu akceptanta: Ustawienia > Powiadomienia.

Nie publikuj kluczy API, sekretów podpisu ani zrzutów panelu zawierających dane uwierzytelniające. Do zgłoszenia technicznego wystarczą nazwa operatora, wersje WordPressa, WooCommerce i modułu, identyfikator zamówienia oraz zanonimizowany fragment logu.

Jak sprawdzić, czy dostawca obsługuje sklep i wybraną wtyczkę?

Dostawca obsługuje integrację wtedy, gdy dokumentacja modułu potwierdza zgodność z używaną wersją WooCommerce, typem checkoutu i wybranym operatorem. Zapytaj o obsługę klasycznego i blokowego checkoutu, dostępność środowiska testowego, zwroty oraz sposób dostarczania powiadomień.

Tabela porządkuje pytania, które warto rozstrzygnąć przed instalacją. Operator może obsługiwać PayByLink, chociaż jego wtyczka nie udostępnia wszystkich funkcji operatora.

kryteria wyboru modułu płatności do WooCommerce
KryteriumCo potwierdzićOdpowiedzialny za odpowiedź
PlatformaZgodność z wersją WooCommerce i typem checkoutuDostawca modułu
OperatorDostępność PayByLink i wymaganej metody płatnościOperator płatności
TestyDostęp do środowiska testowego i scenariuszy próbnychOperator płatności
ZwrotyCzy sklep może zlecić zwrot przez modułOperator i dostawca modułu
UtrzymanieObsługiwane wersje i kanał pomocy technicznejDostawca modułu

Porównuj odpowiedzi dla konkretnej nazwy i wersji modułu, a nie tylko dla platformy WooCommerce.

Potrzebujesz pomocy w tym temacie?

Wolisz od razu porozmawiać? Zadzwoń: 604 939 140

Wysyłając formularz, zgadzasz się na przetwarzanie danych w celu kontaktu (polityka prywatności). Odpowiadamy w 24h.

Jak wykonać test płatności przed publikacją?

Test PayByLink jest zaliczony, gdy operator, powiadomienie serwerowe, status zamówienia i e-mail pokazują ten sam wynik. Ekran potwierdzenia po powrocie klienta nie dowodzi, że WooCommerce otrzymał potwierdzenie od operatora.

Wykonaj scenariusze w środowisku testowym, jeśli operator je udostępnia. Zapisz identyfikator zamówienia i porównaj go z transakcją w panelu operatora. Sprawdź, czy ponowienie płatności lub odświeżenie strony powrotu nie tworzy drugiego zamówienia ani nie oznacza nieopłaconego zamówienia jako opłaconego.

Tabela przedstawia minimalny zestaw scenariuszy odbiorczych. Status pośredni może różnić się w zależności od modułu, więc sprawdź go w jego dokumentacji.

scenariusze testowe PayByLink i oczekiwany wynik
ScenariuszWynik u operatoraOczekiwany status zamówieniaCo sprawdzić
Płatność udanaTransakcja potwierdzonaProcessing dla zamówienia z produktem fizycznymPowiadomienie, notatka i e-mail
Płatność odrzuconaTransakcja odrzuconaFailedKomunikat dla klienta i brak realizacji
Płatność przerwanaBrak potwierdzenia płatnościPending paymentMożliwość ponowienia bez duplikatu
Powrót po płatnościWynik zgodny z transakcjąStatus odpowiadający potwierdzeniuPowrót nie zastępuje powiadomienia

Zgodność potwierdza dopiero spójny wynik transakcji, powiadomienia i statusu zamówienia.

Dlaczego płatność nie zmienia statusu zamówienia?

Status zamówienia nie zmienia się, gdy powiadomienie operatora nie dociera do modułu albo moduł nie dopasowuje go do transakcji. WooCommerce zaleca sprawdzenie notatek zamówienia i logów bramki; panel logów znajduje się w WooCommerce > Status > Logs, zgodnie z dokumentacją sprawdzoną w październiku 2026.

Diagnozuj problem w tej kolejności:

1. Odszukaj zamówienie w WooCommerce i sprawdź notatki, metodę płatności, kwotę oraz identyfikator transakcji.
2. Znajdź transakcję w panelu operatora i porównaj kwotę, walutę oraz identyfikator zamówienia.
3. Włącz logowanie w ustawieniach modułu i sprawdź nowe wpisy w WooCommerce > Status > Logs. Po diagnozie wyłącz szczegółowe logowanie, jeśli nie jest potrzebne.
4. Potwierdź u operatora, czy powiadomienie wysłano i jaki kod odpowiedzi otrzymał endpoint.
5. Sprawdź, czy zapora, wtyczka bezpieczeństwa, cache lub przekierowanie nie blokują żądania.

Odpowiedź 4xx lub 5xx w logu dostarczenia oznacza problem z odpowiedzią endpointu, ale przyczynę ustalisz na podstawie logu modułu i dokumentacji operatora. Nie zmieniaj ręcznie statusu zamówienia, dopóki nie potwierdzisz płatności u operatora. Przy eskalacji przekaż identyfikator zamówienia, czas próby, wersje modułów i zanonimizowany wpis logu, bez sekretów API.

Jak obsłużyć zwrot i uzgodnić płatność z zamówieniem?

Zwrot uzgadniaj po identyfikatorze transakcji, kwocie i numerze zamówienia, a nie tylko po nazwisku kupującego. Możliwość zlecenia zwrotu z WooCommerce zależy od operatora i funkcji modułu.

Przed uruchomieniem sprawdź, czy zwrot z panelu WooCommerce przekazuje dyspozycję operatorowi, czy tylko zapisuje informację w sklepie. W drugim przypadku zleć zwrot w panelu operatora i odnotuj go w zamówieniu. Po operacji sprawdź kwotę zwrotu, status transakcji i notatkę zamówienia.

Uzgadniaj raport operatora z zamówieniami według identyfikatora transakcji. Różnice rozpatruj z uwzględnieniem zwrotów częściowych, opłat operatora i czasu zaksięgowania wskazanego w raporcie.

Kiedy potrzebna jest pomoc przy wdrożeniu?

Pomoc wykonawcy jest potrzebna, gdy operator nie udostępnia zgodnego modułu, sklep ma niestandardowy checkout albo powiadomienia docierają, lecz nie zmieniają zamówienia. Diagnoza powinna rozdzielić błąd konfiguracji operatora od błędu modułu lub modyfikacji sklepu.

Przekaż wykonawcy nazwę operatora i modułu, wersje WordPressa oraz WooCommerce, opis checkoutu, numer przykładowego zamówienia, czas testu i zanonimizowane logi. Dodaj informację, czy problem dotyczy wszystkich metod płatności, czy tylko PayByLink. Nie przesyłaj haseł administratora ani kluczy API zwykłym e-mailem.

Perspektywa KC Mobile: w odbiorze integracji sprawdzamy niezależnie powrót przeglądarki i powiadomienie serwerowe, ponieważ poprawny ekran klienta nie potwierdza poprawnego statusu zamówienia. Jeśli sklep wymaga konfiguracji modułu, testów i uzgodnienia statusów, integracja płatności z WooCommerce obejmuje prace po stronie sklepu i odbiór scenariuszy testowych.

Przy problemach dotyczących innej bramki sprawdź testy integracji Worldpay z WooCommerce.

Jak uruchomić integrację PayPo w WooCommerce?

Integrację PayPo uruchomisz przez operatora lub moduł, który obsługuje tę usługę i ma ją aktywną dla Twojego sklepu. Dokumentacja Tpay dla WooCommerce wymienia płatności odroczone, a dokumentacja PayPo opisuje usługę płatności odroczonej; informacje sprawdziliśmy w październiku 2026. Nie oznacza to, że każda wtyczka PayByLink automatycznie udostępnia PayPo. Potwierdź kompatybilność konkretnego modułu, metodę aktywacji i warunki konta u operatora.

Więcej poradników w tym temacie

Wspomniane narzędzia

WooCommerceWordPressTpayPayByLinkPayPo

Najczęściej zadawane pytania

Czy do integracji potrzebuję wtyczki operatora?
Najczęściej potrzebujesz modułu WooCommerce dostarczonego lub wskazanego przez operatora, ponieważ łączy checkout z procesem płatności i obsługą powiadomień. Własne API ma sens przy niestandardowym procesie, ale wymaga implementacji i utrzymania.
Czy mogę testować płatność na działającym sklepie?
Bezpieczniej wykonać test na stagingu i w środowisku testowym operatora. Test produkcyjny może utworzyć prawdziwą transakcję, wiadomość do klienta i wpis w raportach.
Czy powrót klienta na stronę sklepu potwierdza płatność?
Nie. Powrót przeglądarki wyświetla stronę po płatności, a powiadomienie serwerowe przekazuje zmianę stanu do sklepu. Status potwierdź również w panelu operatora.
Gdzie znajdę logi modułu płatności?
WooCommerce udostępnia logi w panelu pod adresem WooCommerce > Status > Logs. Wybierz źródło odpowiadające nazwie bramki i ogranicz analizę do daty testu.
Czy PayByLink i BLIK to ta sama metoda?
Nie. PayByLink przekierowuje klienta do bankowości internetowej wybranego banku, a BLIK wykorzystuje odrębny proces autoryzacji. Dostępność obu metod zależy od umowy i konfiguracji bramki.
#WooCommerce#PayByLink#PayPo#płatności online#integracja płatności#test płatności#powiadomienia serwerowe#status zamówienia
Zdjęcie autora: Krzysztof Czapnik
O autorze

Krzysztof Czapnik

Founder & Technical Lead, KC Mobile

Projektuję i rozwijam strony WordPress, sklepy WooCommerce oraz aplikacje internetowe. Łączę projektowanie z programowaniem, integracjami i technicznym SEO. Projekty KC Mobile prowadzę osobiście.

Potrzebujesz pomocy z tym tematem? Napisz - odpowiem osobiście w 24h.

Potrzebujesz pomocy w tym temacie?

Czytasz poradnik „Jak uruchomić integrację z PayByLink w sklepie WooCommerce”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny.