PayU w WooCommerce – konfiguracja krok po kroku

PayU obsluguje ponad 300 000 sklepow internetowych w Polsce i przetwarza wiecej transakcji niz jakikolwiek inny operator. Obsluguje BLIK, szybkie przelewy, karty platnicze, raty, Apple Pay i Google Pay – praktycznie wszystko, czego polscy klienci oczekuja przy finalizacji zamowienia.

Dla wlasciciela sklepu WooCommerce to oznacza, ze jedna integracja daje dostep do kilkunastu metod platnosci. Nie musisz instalowac osobnych wtyczek do BLIK-a, kart i przelewow.

Zakladanie konta – wymagane dokumenty

Wejdz na payu.pl i zaloz konto firmowe. Przygotuj: NIP, numer rachunku bankowego firmowego, dane rejestrowe (CEIDG lub KRS). Weryfikacja trwa zazwyczaj 1–2 dni robocze, choc w okresach wzmozonego ruchu (np. Przed Black Friday) moze sie wydluzyc do 3–5 dni.

Gdzie znalezc klucze API

Po aktywacji konta przejdz do panelu PayU: Moje sklepy > Punkty platnosci. Dla kazdego punktu PayU generuje cztery klucze:

• POS ID – identyfikator punktu platnosci
• Klucz MD5 (Second Key) – do podpisywania zadan
• Client ID – do autoryzacji OAuth 2.0
• Client Secret – druga czesc autoryzacji OAuth

Zapisz te dane w bezpiecznym miejscu. PayU pozwala utworzyc osobne punkty platnosci dla srodowiska testowego (sandbox.payu.com) i produkcyjnego (secure.payu.com). Klucze nie sa zamienne miedzy srodowiskami – to najczestsze zrodlo bledu 401 Unauthorized.

Oficjalna wtyczka PayU (darmowa) vs WP Desk (platna)

PayU SA udostepnia darmowa wtyczke WooCommerce PayU w repozytorium WordPress. Obsluguje BLIK, przelewy, karty i raty. Instalacja jest prosta, ale interfejs ustawien jest minimalistyczny.

Alternatywa to platna wtyczka od WP Desk (Octolize) – kosztuje okolo 300 PLN/rok, ale oferuje nizsza prowizje (1,2% bez stalej oplaty vs standardowe 2,45% + 0,35 PLN), rozbudowane ustawienia i lepsza obsluge techniczna.

Dla wiekszosci sklepow oficjalna wtyczka wystarczy. Platna wersja WP Desk oplaca sie przy wiecej niz 100 transakcjach miesiecznie – wtedy nizsza prowizja szybko zwraca koszt licencji.

Instalacja krok po kroku

1. W panelu WordPressa przejdz do Wtyczki > Dodaj nowa
2. Wyszukaj WooCommerce PayU (autor: PayU SA)
3. Kliknij Zainstaluj, potem Wlacz
4. Przejdz do WooCommerce > Ustawienia > Platnosci

Po aktywacji zobaczysz kilka nowych metod: PayU – standardowa platnosc, PayU – BLIK, PayU – raty, PayU – karty. Kazda wlaczasz lub wylaczasz niezaleznie.

Przejdz do WooCommerce > Ustawienia > Platnosci > PayU i uzupelnij formularz kluczami z panelu PayU:

• POS ID – identyfikator punktu platnosci
• Drugi klucz (MD5) – do weryfikacji podpisu transakcji
• Client ID – do autoryzacji OAuth
• Client Secret – druga czesc OAuth

Zaznacz opcje Tryb testowy (sandbox). W trybie sandbox symulujesz platnosci bez realnych pieniedzy – PayU udostepnia testowe numery kart i kody BLIK w dokumentacji developerskiej.

Czesty blad: wklejenie kluczy produkcyjnych do trybu sandbox (lub odwrotnie). Klucze sa przypisane do srodowiska. Drugi typowy problem – niewidoczna spacja na koncu klucza po skopiowaniu z panelu. Jesli widzisz 401 Unauthorized, zacznij od tego.

Po podlaczeniu PayU masz dostep do pelnej gamy metod platnosci. Kazda aktywujesz osobno w panelu PayU (nie w WooCommerce).

BLIK – najpopularniejsza metoda (65% transakcji online w Polsce). Wiecej o konfiguracji w artykule o BLIK w WooCommerce.

Karty platnicze – Visa, Mastercard, obsluga 3D Secure. Prowizja standardowa: 2,45% + 0,35 PLN (lub 1,2% przez WP Desk).

Szybkie przelewy – przekierowanie do banku klienta. Prowizja BLIK-owa (1,19% + 0,09 PLN).

PayU Raty – klient rozklada platnosc na raty (3, 6, 12 lub 24 miesiace). Wymagania: zamowienie powyzej 300 PLN, aktywacja w panelu PayU. Prowizja wliczona w koszt rat – sprzedawca dostaje pelna kwote.

Apple Pay i Google Pay – dostepne automatycznie po aktywacji kart platniczych. Nie wymagaja osobnej konfiguracji.

Standardowe stawki (oficjalna wtyczka):

• Szybkie przelewy / BLIK: 2,45% + 0,35 PLN
• Karty platnicze: 2,45% + 0,35 PLN

Stawki przez WP Desk (platna wtyczka):

• Szybkie przelewy / BLIK: 1,2% (bez stalej oplaty)
• Karty: 1,2% (bez stalej oplaty)

Kalkulacja dla 500 transakcji miesiecznie przy srednim zamowieniu 120 PLN:

• Oficjalna wtyczka: 500 x (120 x 2,45% + 0,35) = 1 645 PLN/mc
• WP Desk: 500 x (120 x 1,2%) = 720 PLN/mc
• Roznica: 925 PLN miesiecznie, 11 100 PLN rocznie

Przy 100 transakcjach roznica wynosi 185 PLN/mc – licencja WP Desk (300 PLN/rok) zwraca sie juz w drugim miesiacu.

Czas wyplaty srodkow: T+1 (nastepny dzien roboczy) dla weryfikowanych sprzedawcow, T+3 dla nowych kont. Wyplaty sa darmowe od pewnego progu obrotow – szczegoly ustalasz z opiekunem PayU.

Potrzebujesz pomocy z doborem bramki platnosci? Sprawdz nasza oferte budowy sklepow internetowych.

Przed wylaczeniem sandbox przejdz przez te scenariusze:

1. Udana platnosc – zamowienie zmienia status na "Przetwarzane" automatycznie
2. Odrzucona platnosc – zamowienie wraca do "Oczekujace na platnosc"
3. Zwrot – zmien status na "Zwrocone" i sprawdz, czy PayU potwierdza zwrot w panelu
4. Timeout – nie potwierdzaj platnosci BLIK w ciagu 2 minut, sprawdz czy zamowienie sie anuluje

Checklist przed przejsciem na produkcje:
- Klucze produkcyjne (nie sandbox!) wklejone poprawnie
- Callback URL ustawiony na pelny adres HTTPS
- Email z potwierdzeniem zamowienia wysyla sie poprawnie
- Strona "Dziekujemy za zamowienie" dziala

Blad 401 Unauthorized

Niezgodnosc kluczy ze srodowiskiem. Klucze sandbox nie dzialaja w trybie produkcyjnym i odwrotnie. Skopiuj klucze ponownie – czasem dodaje sie niewidoczna spacja.

Notyfikacje PayU nie dochodza do WooCommerce

Sprawdz, czy serwer nie blokuje polaczen przychodzacych od PayU. Adresy IP PayU musza byc na whiteliscie firewalla. Sprawdz tez, czy callback URL w ustawieniach wtyczki jest poprawny i dostepny z zewnatrz.

Podwojne zamowienia

Klient klika "Zaplac" dwa razy, bo strona laduje sie wolno. Rozwiazanie: wlacz blokade przycisku po kliknieciu (wiekszosc nowoczesnych motywow WooCommerce robi to domyslnie) i sprawdz mechanizm idempotentnosci w ustawieniach wtyczki.

Problem z SSL / mixed content

PayU wymaga HTTPS. Jesli sklep ma mieszana tresc (HTTP + HTTPS), bramka platnosci moze sie nie zaladowac. Sprawdz certyfikat SSL i wymus przekierowanie calej witryny na HTTPS.

Masz problem z integracjami platnosci WooCommerce? Skontaktuj sie z nami – pomagamy sklepom uruchomic platnosci online szybko i bezboledsnie.