BLIK w WooCommerce - konfiguracja krok po kroku

Sprawdź pełną nazwę wtyczki w WordPressie. Produkt innego dostawcy może obsługiwać tę samą bramkę, ale mieć inne formularze, opcje i wymagania. Nie stosuj instrukcji WP Desk do oficjalnego modułu PayU ani odwrotnie.

Źródła: wydanie PayU, strona modułu P24, wydanie Tpay i wydanie paynow. To stan dokumentacji podczas przygotowania poradnika, nie gwarancja zgodności każdej kombinacji dodatków.

Jeśli dopiero wybierasz sposób obsługi kupującego, zacznij od poradnika płatności BLIK w WooCommerce. Dalsze kroki służą skonfigurowaniu wybranego rozwiązania.

Potwierdź, że konto operatora należy do właściwego sprzedawcy i ma uruchomiony potrzebny wariant BLIK. Nazwa metody widoczna w module nie zastępuje jej aktywacji na koncie. Przygotuj osobne dane produkcyjne i testowe, zgodnie z instrukcją dostawcy.

Przed zmianą wykonaj kopię plików, bazy i konfiguracji. Testy prowadź na środowisku, które nie obciąży klienta ani nie wyśle prawdziwego zamówienia do realizacji. Sprawdź produkcyjne klucze, automatyczne odnowienia, magazyn i wiadomości, które mogły zostać skopiowane ze sklepem.

Zapisz, czy używasz klasycznej kasy, Blocks albo dodatkowego kreatora checkoutu. Wybierz przykładowy koszyk odpowiadający rzeczywistej sprzedaży i zanotuj oczekiwany wynik. Ułatwi to odróżnienie braku metody wynikającego z konfiguracji od problemu jej działania.

Nie potrzebujesz kodu BLIK prawdziwego klienta do ustawienia modułu. Dane testowe i scenariusze bierz z dokumentacji operatora. Jeżeli nie możesz potwierdzić środowiska lub bezpiecznego powrotu do wcześniejszej konfiguracji, zatrzymaj pracę przed próbą płatności. Nie testuj nieznanych ustawień na zamówieniach obsługiwanych w produkcji.

Oficjalny moduł PayU korzysta z danych punktu płatności REST. Globalną konfigurację znajdziesz w WooCommerce > Ustawienia PayU. Dane środowiska produkcyjnego i sandbox są rozdzielone, a tryb testowy sprawdza się również dla konkretnej metody. Jeśli metoda korzysta z ustawień globalnych, musi używać właściwego zestawu danych.

Opis oficjalnej wtyczki przedstawia BLIK jako osobną metodę z przekierowaniem. Nie zakładaj, że samo włączenie tej opcji doda pole kodu w checkout. Możliwości API i instrukcja innego producenta nie zmieniają funkcji zainstalowanego modułu. Źródła: oficjalne repozytorium PayU i polska instrukcja modułu.

Sprawdź aktywność BLIK na odpowiednim punkcie płatności oraz dostępność metody dla używanego koszyka. Następnie odbierz rozpoczęcie płatności, powrót i aktualizację zamówienia. Nie wystarczy stwierdzić, że kafelek jest widoczny.

Pełną konfigurację danych oraz środowiska opisuje instrukcja PayU w WooCommerce. Jeśli korzystasz z innej wtyczki PayU, wróć do jej dokumentacji i sprawdź, czy rzeczywiście odpowiada nazwie oraz wersji produktu w sklepie.

Nowy oficjalny moduł ma konfigurację w WooCommerce > Ustawienia > Przelewy24. Sekcja BLIK pozwala uruchomić wpisanie kodu bezpośrednio w sklepie. Opcja One Click dotyczy zapisanego aliasu: zalogowany klient może zdecydować o jego zachowaniu przy pierwszej płatności, aby później płacić bez ponownego wpisywania kodu. Źródło: instrukcja nowej gałęzi modułu P24.

Nie utożsamiaj braku kodu z gwarantowanym brakiem potwierdzenia w banku. Sprawdź zachowanie dla gościa i zalogowanego klienta, zgodnie z obsługiwanym scenariuszem. Nie zapisuj aliasu w dokumentacji wdrożenia ani nie używaj danych klienta do prób konfiguracji.

Podstawowa integracja P24 wymaga właściwych danych konta oraz IP serwera łączącego się z API. Adres ten nie jest adresem komputera administratora ani regułą odblokowania przychodzącego webhooka. Dane i poszczególne etapy opisuje instrukcja Przelewy24.

Po włączeniu metody sprawdź jej widoczność w rzeczywistym szablonie kasy. Osobny kafelek, przekierowanie do operatora oraz formularz wewnątrz sklepu mogą być różnymi wariantami. Odbierz dokładnie ten, który zamierzasz udostępnić kupującemu.

W Tpay dane globalne ustawia się w WooCommerce > Ustawienia Tpay. Obejmują identyfikator klienta, sekret API, kod bezpieczeństwa i środowisko. Metody włącza się następnie w ustawieniach płatności WooCommerce. Dokumentacja wymaga również zgody na nadpisanie adresu powiadomień w panelu Tpay.

Opcja BLIK LVL 0 oznacza wpisanie kodu w sklepie. Bez niej klient jest przekierowywany do eBLIK. Sprawdź, czy metoda korzysta z właściwych ustawień globalnych oraz czy jej warunki pasują do dostawy i koszyka. Źródło: oficjalna instrukcja Tpay dla WooCommerce.

W oficjalnym paynow przejdź do WooCommerce > Ustawienia > Płatności > Paynow > Zarządzaj. Podaj klucz API i klucz podpisu dla właściwego środowiska. Adres powrotu powstaje automatycznie, a adres powiadomień konfiguruje się w panelu sprzedawcy według instrukcji modułu. Źródło: dokumentacja paynow.

Nie kopiuj adresu powiadomień między Tpay, paynow i P24. Najpierw ustal produkt oraz domenę, do której ma trafić zdarzenie. Po zapisaniu konfiguracji porównaj transakcję operatora ze stanem zamówienia, również przy kontrolowanym braku powrotu do sklepu.

Zgodność trzeba oceniać dla konkretnej metody. PayU dodało BLIK dla Blocks w wersji modułu 2.4.0, a inne metody otrzymywały wsparcie w kolejnych wydaniach. Tpay opisuje dodanie Blocks w 1.5.0. Źródła: historia modułu PayU i historia Tpay. Nie wynika z tego, że wszystkie moduły działają od dowolnej instalacji WooCommerce 8.0.

W paynow plik wydania 2.5.11 deklaruje Cart & Checkout Blocks oraz testy do WooCommerce 10.2.0. README podaje inne, starsze minimum WooCommerce, dlatego nie traktuj go jako zapewnienia zgodności z każdą nowszą wersją. Sprawdź informacje wydania paynow i wykonaj odbiór własnego zestawu.

Testuj gościa i klienta zalogowanego, telefon i komputer oraz używane warianty dostawy. Przy odrzuceniu kodu nie ponawiaj płatności bez sprawdzenia stanu wcześniejszej próby.

Zwykły kod BLIK ma 6 cyfr i ważność 2 minuty, zgodnie z FAQ BLIK. Nie oznacza to, że po takim czasie WooCommerce musi anulować zamówienie. Liczy się potwierdzony stan transakcji, a nie sam upływ czasu widoczny przy kodzie.

WooCommerce wyjaśnia: "Directly changing an order's status to Cancelled or Refunded will not automatically refund your customer." Źródło: dokumentacja zwrotów. Użyj obsługiwanej akcji refundacji przez bramkę i sprawdź wynik także u operatora. Nie ponawiaj zwrotu tylko dlatego, że ekran nie odświeżył się natychmiast.

Pay Later jest osobną usługą z warunkami aktywacji i użycia. W Tpay historia modułu wskazuje jej dodanie w 1.12.0. Nie oznacza to automatycznego uruchomienia na każdym koncie. Podobnie obsługa OneClick w API operatora nie dowodzi dostępności przełącznika w każdej wtyczce.

Przy podwójnym wpisie powiadomienia sprawdź identyfikatory transakcji. Powtórzony webhook nie jest sam w sobie dowodem drugiego obciążenia. Nie szukaj nieudokumentowanego przełącznika idempotencji.

Standardowa integracja od 1499 zł netto dotyczy jednego PayU, P24 albo Tpay w istniejącym WooCommerce. Inne moduły, awarie i szerszy zakres ustalamy osobno. Jeśli potrzebujesz pomocy przy WordPressie, napisz do nas: podaj adres lub platformę i cel albo objaw. Nie wysyłaj kluczy ani kodów płatniczych.

• BLIK i integracja API: jak uruchomić płatność w sklepie