¶ PayU - płatności online i PayPo (REST API 2.1)

PayU w Hummerce to płatność online konfigurowana przez REST API 2.1 - z danymi pobieranymi bezpośrednio z panelu PayU sklepu. Integracja obsługuje też płatność odroczoną PayPo, dostępną wyłącznie w tej nowszej wersji API, i sama synchronizuje metody płatności oferowane przez PayU.

Stan na wersję Hummerce 2.35.65, aktualizacja 2026-10-07.

¶ Korzyści i zastosowania

Płatność online zgodna z aktualnym interfejsem PayU - REST API 2.1.
Obsługa płatności odroczonej PayPo - dostępna tylko przez REST API, nie przez starszy moduł Classic API.
Automatyczna synchronizacja metod płatności z PayU - nowe metody pojawiają się w panelu sklepu same, a metody wyłączone w PayU znikają z koszyka. Płatności bez wskazanej metody zostają nietknięte.
Wstępny wybór metody - klient wybierający w koszyku konkretną metodę PayU (np. BLIK) trafia od razu na jej stronę płatności, bez ponownego wyboru metody u PayU.
Bezpieczna weryfikacja powiadomień o płatności dzięki podpisowi z drugiego klucza (OpenPayu-Signature).
Osobne środowisko testowe (Sandbox) i produkcyjne - płatność można sprawdzić przed uruchomieniem produkcyjnym.
Punkt płatności PayU może mieć włączone dodatkowe metody - raty lub BLIK, zależnie od ustawień konta PayU sklepu.

¶ Jak to wygląda

Krok "Punkt płatności" kreatora dodawania sklepu w panelu PayU (środowisko Sandbox), używany przy konfiguracji płatności PayU w Hummerce

¶ Zasady działania

¶ Dwie wersje integracji

Do wersji 2.33 wykorzystywany był moduł PayU Classic API.
W nowszych sklepach korzystamy z PayU REST API 2.1.
Płatność PayPo jest obsługiwana wyłącznie przez REST API - Classic API jej bezpośrednio nie obsługuje.

¶ Synchronizacja metod płatności

Sklep cyklicznie (domyślnie co 24 godziny) pobiera z PayU listę metod płatności dostępnych dla punktu płatności sklepu.
Synchronizacja obejmuje płatności, które w panelu mają ustawiony Typ płatności online: PayU REST API. Konkretną metodę PayU (np. BLIK, Google Pay) wskazuje ostatnie pole tego ustawienia.
Nowa metoda w PayU - sklep tworzy ją jako płatność podrzędną płatności głównej PayU, nieaktywną i niewidoczną, z nazwą i logo z PayU. Włączenie jej w koszyku to zawsze decyzja administratora.
Metoda wyłączona w PayU albo nieoferowana już przez PayU - sklep wyłącza odpowiadającą jej płatność (nieaktywna i niewidoczna). Dotyczy to wyłącznie płatności przypisanych do konkretnej metody PayU.
Płatność bez wskazanej metody (płatność główna albo ogólna, w której klient wybiera bank na stronie PayU) oraz metody z listy ignorowanych - synchronizacja ich nie zmienia, zostają tak, jak ustawił administrator.
Synchronizacja nie włącza płatności i nie nadpisuje nazwy ani logo ustawionych ręcznie w panelu.
Gdy PayU jest chwilowo niedostępne albo zwraca pustą listę, sklep niczego nie zmienia.

¶ Płatność główna PayU

Płatność główna (grupująca metody PayU, np. przelew z wyborem banku na stronie PayU) musi mieć symbol payuRest.
Płatność z typem PayU REST API, która wskazuje konkretną metodę PayU, jest wyłączana przy synchronizacji, gdy PayU przestaje tę metodę oferować. Płatność z tym typem bez wskazanej metody (np. ogólna, z wyborem banku na stronie PayU) nie jest wyłączana.
Konkretna metoda PayU wskazana w płatności działa też jako wstępny wybór: klient po wybraniu takiej płatności w koszyku zostaje przekierowany bezpośrednio do tej metody w PayU (od wersji 2.35.23). Płatność bez wskazanej metody pokazuje klientowi wybór metody na stronie PayU.
Bez płatności głównej payuRest sklep nie tworzy nowych metod - aktualizuje i wyłącza tylko istniejące.

¶ Dane potrzebne do konfiguracji

Wszystkie dane klient pobiera z panelu PayU (środowisko testowe: Sandbox), w sekcji Mój sklep -> Punkty płatności -> Klucze konfiguracyjne: identyfikator punktu płatności (POS ID), dane protokołu OAuth (Client ID i Client Secret) oraz drugi klucz (MD5) do weryfikacji podpisu powiadomień.
Dodatkowo potrzebne: publiczny adres panelu administracyjnego sklepu produkcyjnego (sklep wysyła go do PayU jako adres powiadomień w każdej transakcji, więc w panelu PayU nie trzeba go ustawiać), waluty obsługiwane przez punkt płatności (domyślnie PLN) oraz informacja, czy punkt płatności ma włączone PayPo, raty lub BLIK.
Klucze środowiska testowego i produkcyjnego są różne - przy wdrożeniu wieloetapowym warto poprosić klienta o oba komplety od razu.

¶ Wersja

Do wersji 2.33 - integracja przez PayU Classic API.
W nowszych wdrożeniach - integracja przez PayU REST API 2.1, jedyną obsługującą płatność PayPo.
Od wersji 2.35.22 - automatyczna synchronizacja metod płatności z PayU.
Od wersji 2.35.23 - wstępny wybór metody płatności PayU na podstawie płatności wybranej w koszyku.
Od wersji 2.35.24 - płatność główna payuRest nie jest wyłączana przez synchronizację.
Od wersji 2.35.65 - synchronizacja wyłącza tylko płatności przypisane do konkretnej metody PayU, której PayU już nie oferuje; płatności bez metody i metody z listy ignorowanych zostają bez zmian.

¶ Zależności

Konto i punkt płatności (POS) założony w panelu PayU sklepu - zakłada i konfiguruje sklep we własnym zakresie.
Dane protokołu OAuth (Client ID, Client Secret) i drugi klucz (MD5) z panelu PayU.
Panel administracyjny sklepu produkcyjnego dostępny z internetu - na jego adres PayU wysyła powiadomienia o płatnościach.
Waluty obsługiwane przez punkt płatności w PayU (domyślnie PLN).
Do synchronizacji metod płatności - płatność główna o symbolu payuRest w panelu sklepu.

¶ Wdrożenie

Wymaga wdrożenia - płatność nie uruchamia się sama, wymaga wpisania danych z panelu PayU (POS ID, Client ID, Client Secret, drugi klucz) oraz wskazania środowiska (Sandbox lub Produkcja).
Minimalny szacowany czas: brak minimalnego czasu - do uzupełnienia.
Od czego zależy czas:
- liczba walut i dodatkowych metod (PayPo, raty, BLIK) do przetestowania w punkcie płatności,
- czy klient przekazuje od razu komplet danych testowych i produkcyjnych,
- przy przejściu ze starego modułu PayU - liczba istniejących płatności PayU do uporządkowania przed włączeniem synchronizacji (symbol płatności głównej, typ płatności i metoda PayU dla pozostałych, usunięcie nieużywanych),
- wersja sklepu - starsza niż wymagana do REST API 2.1 wymaga najpierw aktualizacji (wycena osobno).

¶ Ograniczenia

PayU Classic API (starsze sklepy, do wersji 2.33) nie obsługuje bezpośrednio płatności PayPo - wymaga ona REST API 2.1.
Synchronizacja tylko wyłącza płatności i tworzy nowe jako nieaktywne - włączenie metody w koszyku, kolejność i grupowanie ustawia administrator.
Synchronizacja wyłącza tylko płatności ze wskazaną metodą PayU, której PayU już nie oferuje. Metody, które mają pozostać włączone mimo zmian po stronie PayU, można dodać do listy ignorowanych.
Nie weryfikujemy konfiguracji pod kątem zgodności z prawem - regulamin i informacja o płatnościach leżą po stronie sklepu.

¶ Najczęstsze pytania

Czy PayU obsługuje płatność PayPo?
Częściowo. PayPo działa tylko w integracji przez REST API 2.1 - starszy moduł Classic API jej nie obsługuje.

Czy nowa metoda płatności z PayU pojawi się w sklepie sama?
Tak, w panelu sklepu - jako nieaktywna i niewidoczna. W koszyku pojawi się dopiero, gdy administrator ją włączy.

Dlaczego płatność PayU sama się wyłączyła?
Wyłącza ją synchronizacja, gdy PayU zgłasza metodę jako nieaktywną albo nie oferuje jej już dla punktu płatności sklepu. Wyłączone są tylko płatności przypisane do konkretnej metody PayU - płatność główna i płatność bez wskazanej metody (z wyborem banku na stronie PayU) nie są wyłączane, podobnie jak metody z listy ignorowanych. Sprawdź ustawienie Typ płatności online i wskazaną metodę, a potem włącz płatność ponownie.

Jak często sklep synchronizuje metody płatności z PayU?
Domyślnie co 24 godziny. Częstotliwość ustawia się w konfiguracji modułu, a wartość 0 wyłącza synchronizację.

Czy klient może od razu przejść do wybranej metody PayU, np. BLIK?
Tak, od wersji 2.35.23. Jeśli płatność w koszyku wskazuje konkretną metodę PayU, klient po jej wybraniu trafia od razu do tej metody, bez ponownego wyboru u PayU.

Skąd wziąć dane do konfiguracji PayU?
Z panelu PayU, w sekcji Mój sklep -> Punkty płatności -> Klucze konfiguracyjne.

Czy trzeba ustawiać adres powiadomień w panelu PayU?
Nie. Sklep przekazuje adres powiadomień do PayU w każdej transakcji - wystarczy, że panel administracyjny sklepu jest dostępny z internetu.

Czy dane środowiska testowego i produkcyjnego PayU są takie same?
Nie. Klucze Sandbox i produkcyjne są różne - do wdrożenia trzeba przekazać oba komplety.

Czy Hummerce nadal obsługuje starszą integrację PayU (Classic API)?
Tak, sklepy sprzed wersji 2.34 mogą z niej korzystać, ale nie obsługuje ona płatności PayPo ani synchronizacji metod płatności.

Ile trwa wdrożenie płatności PayU?
Czas wdrożenia ustalamy indywidualnie po analizie zakresu.

¶ Powiązane

Płatności - przegląd
PayPal, Przelewy24 i BLIK - inne płatności online w standardzie Hummerce.
Na hummerce.com: Integracja PayU, Platforma B2C.

Chcesz zobaczyć, jak płatność PayU może działać w Waszym sklepie? Umów bezpłatną prezentację.

¶ Szczegóły konfiguracji

¶ Parametry

Pole w panelu PayU	Parametr w sklepie	Opis
POS ID / ID punktu płatności	`merchantPosId`	Publiczny identyfikator POS
OAuth protocol - Client ID	`clientId`	Zazwyczaj równy POS ID
OAuth protocol - Client Secret	`clientSecret`	Sekret OAuth 2.0 (nie mylić z "kluczem MD5" ze starego API)
Drugi klucz (MD5)	`secondKey`	Do weryfikacji podpisu powiadomień `OpenPayu-Signature`
Środowisko	`mode`	`PROD` lub `SANDBOX`

¶ Synchronizacja metod płatności

Parametr w sklepie	Domyślnie	Opis
`syncIntervalHours`	24	Co ile godzin sklep pobiera metody płatności z PayU; 0 wyłącza synchronizację
`ignoreValues`	puste	Lista kodów metod PayU oddzielonych przecinkami (np. `blik,mtex`), których synchronizacja nie tworzy, nie aktualizuje i nie wyłącza
`syncBrandImages`	wyłączone	Gdy włączone - logo płatności jest aktualizowane do logo z PayU (nadpisuje logo wgrane ręcznie)