Płatność PayU przenosi klienta na bezpieczną stronę PayU: BLIK, przelew z jego banku, karta, Apple Pay lub Google Pay. Sklep sam poznaje wynik i nadaje zamówieniu status.
Kiedy to się przyda:
- Sprzedajesz w Polsce — klienci płacą BLIKIEM i przelewem ze swojego banku, jak są przyzwyczajeni.
- Klient nie chce opuszczać strony — kod BLIK wpisuje się bezpośrednio przy składaniu zamówienia.
- Towar trzeba najpierw sprawdzić — pieniądze czekają na Twoje potwierdzenie i dopiero potem są pobierane.
- Trzeba zwrócić część pieniędzy — PayU zwraca część, status pozostaje opłacony.
Od czego zacząć: „Ustawienia sklepu” → „Zamówienie i płatność” → PayU → cztery klucze i przełącznik „Włączony”.
Co potrafi płatność PayU
- Przyjmuje płatność na stronie PayU — BLIK, przelew bankowy, karta, Apple Pay, Google Pay.
- Przyjmuje kod BLIK przy składaniu zamówienia — bez przechodzenia na stronę PayU.
- Pozwala sprawdzić w trybie testowym — pieniądze nie są pobierane, kluczy można nie wpisywać.
- Sama nadaje status zamówieniu — opłacone, czeka na potwierdzenie, zwrócone, anulowane.
- Pobiera pieniądze po Twoim potwierdzeniu i zwraca całą kwotę lub część — przyciskami w karcie zamówienia.
Jak podłączyć PayU
Potrzebujesz umowy Twojej firmy z PayU i punktu płatności typu REST API w panelu PayU. Elbuz nie ma wspólnych kluczy: moduł działa tylko z Twoimi.
- Weź cztery klucze z panelu PayU (gdzie dokładnie).
- Otwórz ekran modułu. „Ustawienia sklepu” → sekcja „Zamówienie i płatność” → karta PayU.
- W bloku „Połączenie” wyłącz „Tryb testowy (sandbox)” i wpisz klucze.
- W bloku „Płatność” wybierz „Waluta POS” — tę, w której działa punkt w PayU (dlaczego to ważne).
- Włącz przełącznik „Włączony” u góry ekranu.
- Kliknij „Zapisz”. Ustawienia od razu trafiają do sklepu: na dole pojawi się „Zapisano i zastosowano w sklepie”.
1
Karta PayU2
Przełącznik „Włączony”- Karta PayU: kliknij, aby otworzyć ekran konfiguracji.
- Czy klienci widzą tę metodę płatności; karta pokazuje też, czy ostatnie zmiany dotarły do sklepu.
1
Przełącznik „Włączony”2
Tryb testowy (sandbox)3
POS ID4
Drugi klucz (MD5)5
Co jeszcze do skonfigurowania- Po zapisaniu pokazuje PayU klientom.
- Płatności testowe bez pobierania pieniędzy; wyłącz przed sprzedażą.
- Numer punktu płatności z panelu PayU.
- Klucz tajny: po zapisaniu nie jest pokazywany, widać tylko, że jest ustawiony.
- Czego jeszcze brakuje, żeby płatność działała.
Bez trybu testowego włączony moduł nie zapisze się bez wszystkich czterech kluczy: pod pustym polem pojawi się „Wymagane — bez tego moduł nie zadziała”. „Drugi klucz (MD5)” i „Sekret klienta OAuth (client_secret)” po zapisaniu nie są pokazywane — widać tylko „ustawiono”. Aby je zmienić, kliknij „Zastąp”.
W panelu PayU nie trzeba wpisywać adresu powiadomień o płatności: moduł przekazuje go z każdą płatnością. Na ekranie jest pokazany dla informacji — „Adres powiadomień”. Jeśli strona jest chroniona przez Cloudflare lub hasłem, ten adres musi pozostać otwarty.
Jak działa okno w ogóle — w artykule „Ustawienia sklepu”.
Skąd wziąć klucze w panelu PayU
Panel PayU (panel.payu.pl) jest po polsku. Ścieżka: „Płatności elektroniczne” → „Moje sklepy” → Twój sklep → „Punkty płatności” → punkt „REST API (Checkout)” → „Klucze konfiguracji”. Nie ma takiego punktu — utwórz go: „Dodaj punkt płatności”.
| Pole w Elbuz | Co skopiować w panelu PayU |
|---|---|
| ID punktu płatności (POS ID) | Id punktu płatności (pos_id) |
| Drugi klucz (MD5) | Drugi klucz (MD5) — nim sklep sprawdza podpis każdego powiadomienia PayU |
| Identyfikator klienta OAuth (client_id) | Protokół OAuth — client_id, zwykle ta sama liczba co POS ID |
| Sekret klienta OAuth (client_secret) | Protokół OAuth — client_secret |
Kopiuj przyciskiem w panelu, bez spacji na początku i na końcu.
Waluta punktu płatności: kto widzi PayU
Punkt płatności PayU działa w jednej walucie, najczęściej PLN. Moduł nie przelicza kwot. Dlatego PayU pojawia się przy składaniu zamówienia tylko wtedy, gdy klient widzi ceny w walucie punktu.
- „Waluta POS” — PLN, EUR, USD, GBP, CZK, HUF, RON, BGN, CHF, DKK, NOK lub SEK. Domyślnie PLN.
- Klient musi widzieć ceny w tej walucie. W oknie „Waluty i kursy” w Elbuz w wierszu PLN potrzebna jest „Aktywność”. Jeśli PLN nie jest główną walutą Elbuz, potrzebne są jeszcze „Pokazuj na stronie” i kurs: Kursy walut.
- Nie ma waluty w sklepie — po prawej pojawi się „W sklepie nie ma waluty PLN — klienci nie zobaczą tej metody płatności”.
Punkt jest w PLN, a klient przełączył stronę na EUR — PayU nie zobaczy. Dla dwóch walut potrzebne są dwa punkty w PayU, a moduł działa z jednym.
1
Waluta POS2
Kod BLIK w kasie3
Brak PLN w sklepie- Waluta punktu płatności PayU: metoda jest pokazywana tylko klientom z cenami w tej walucie.
- Pozwala klientowi wpisać kod BLIK od razu przy składaniu zamówienia, tylko PLN.
- Sklep nie ma waluty PLN, więc klienci nie zobaczą PayU.
Dla jakich adresów i na którym miejscu
Blok „Gdzie pokazywać”:
- „Strefa geograficzna” — płatność tylko dla klientów z adresem w tej strefie; „Wszystkie strefy” — dla wszystkich.
- „Kolejność sortowania” — miejsce na liście płatności, mniejsza liczba jest wyżej.
Moduł nie ma limitu kwoty zamówienia: PayU jest widoczne przy każdej kwocie.
Kod BLIK bezpośrednio w sklepie
Klient wpisuje 6-cyfrowy kod BLIK przy składaniu zamówienia i potwierdza płatność w aplikacji banku. Nie przechodzi na stronę PayU.
- Poproś opiekuna PayU o włączenie dla Twojego punktu „Transparent payment with a BLIK authorization code”. Bez tego PayU odrzuci kod.
- W bloku „Płatność” włącz „Kod BLIK w kasie”. Przełącznik jest widoczny tylko przy walucie PLN.
- Kliknij „Zapisz”.
Klient widzi pole „Kod BLIK”, przycisk „Zapłać BLIKIEM” i link „Inna metoda płatności (strona PayU)”. Po wpisaniu kodu — „Potwierdź płatność w aplikacji banku. Czekamy na odpowiedź…”.
Sklep czeka na potwierdzenie banku około dwóch minut. Jeśli się nie doczeka, klient widzi „Bank jeszcze nie potwierdził płatności…” i może wpisać nowy kod. Jeśli już potwierdził płatność w banku, zamówienie samo stanie się opłacone.
Kod błędny, wygasły lub już użyty — klient widzi, co się stało, i bierze nowy kod w aplikacji. Sam kod sklep przekazuje tylko do PayU i nigdzie go nie zapisuje.
Jak sprawdzić w trybie testowym
Płatności testowe idą do środowiska testowego PayU (sandbox), pieniądze nie są pobierane. „Tryb testowy (sandbox)” jest domyślnie włączony.
- Zostaw włączony „Tryb testowy (sandbox)” i wszystkie cztery klucze puste — moduł użyje publicznego punktu testowego PayU w walucie PLN. Albo wpisz klucze swojego testowego konta PayU.
- „Waluta POS” — PLN. Sprawdź, czy PLN jest w sklepie (powyżej).
- Włącz moduł i zapisz.
- Otwórz stronę w PLN, złóż zamówienie na siebie i wybierz „Płatność przez PayU”. Przed przejściem pojawi się „Tryb testowy (sandbox PayU): pieniądze nie są pobierane.”
- Zapłać kartą testową lub kodem BLIK z dokumentacji PayU. Kod
777123— udana płatność. - Sprawdź, czy zamówienie trafiło do Elbuz ze statusem z pola „Opłacone”.
W trybie testowym można wpisać albo wszystkie cztery klucze, albo żadnego. Wpisano część — pod pustymi polami pojawi się „Potrzebne są wszystkie cztery klucze — albo zostaw wszystkie puste (punkt testowy PayU)”.
Przed sprzedażą wyłącz „Tryb testowy (sandbox)” i wpisz klucze produkcyjne: publiczne klucze testowe zna każdy. Dopóki tryb jest włączony, po prawej widać „Włączony tryb testowy — pieniądze nie są pobierane. Wyłącz go przed sprzedażą”.
Co widzi klient
Przy składaniu zamówienia metoda nazywa się „Płatność przez PayU” z podpowiedzią „BLIK, szybki przelew z Twojego banku, karta, Apple Pay, Google Pay…”. Po potwierdzeniu — „Przechodzimy do strony płatności PayU…” i strona PayU.
| Co się stało | Dokąd wraca klient |
|---|---|
| Zapłacił | Strona udanego zamówienia |
| BLIK lub przelew jest jeszcze w drodze | Też strona udanego zamówienia. Zamówienie stanie się opłacone, gdy tylko PayU powiadomi sklep — zwykle w ciągu minuty-dwóch |
| Nie zapłacił i wrócił do sklepu | Składanie zamówienia z komunikatem „Płatność nie została zakończona. Spróbuj ponownie lub wybierz inną metodę płatności.” Koszyk zostaje zachowany |
Jakie metody są widoczne na stronie PayU, zależy od Twojej umowy z PayU. Strona otwiera się w głównym języku sklepu, a nie w języku wybranym przez klienta.
Każda próba płatności to osobna płatność w PayU, a zamówienie w sklepie jest to samo. Nowa próba anuluje w PayU poprzednią nieopłaconą. Jeśli starą próbę jednak opłacono na inną kwotę, status się nie zmieni (poniżej).
Statusy zamówienia
Status nadaje sam sklep, gdy PayU powiadamia o płatności. Jakie dokładnie — wybierasz w bloku „Statusy zamówienia”.
1
Opłacone2
Oczekuje na potwierdzenie3
Zwrócono4
Anulowane- „Opłacone” — status, który zamówienie dostaje, gdy PayU potwierdzi płatność.
- „Oczekuje na potwierdzenie” — pieniądze są zablokowane na karcie kupującego i pobierane po potwierdzeniu w karcie zamówienia.
- „Zwrócono” — status po pełnym zwrocie.
- „Anulowane” — status, gdy płatność czekająca na potwierdzenie zostaje anulowana: na Twoje żądanie albo przez samo PayU po kilku dniach.
| Pole | Kiedy jest nadawany | Domyślnie |
|---|---|---|
| Opłacone | PayU potwierdziło płatność. Klient dostaje zwykły e-mail o zamówieniu | „W realizacji” |
| Oczekuje na potwierdzenie | W punkcie PayU wyłączono automatyczny odbiór płatności: pieniądze są zablokowane i pobierane po potwierdzeniu. Klient nie dostaje e-maila | „Oczekujące” |
| Zwrócono | Klientowi zwrócono całą kwotę | „Zwrócono środki” |
| Anulowane | Płatność czekającą na potwierdzenie anulowano: pieniądze wracają do klienta | „Anulowane” |
Dopóki klient nie zapłaci, zamówienie pozostaje niepotwierdzone i nie jest uznawane za nowe. Ponowna próba płatności nie tworzy dodatkowego zamówienia.
Kiedy status się nie zmienia
- Inna kwota. Klient zmienił koszyk po przejściu do płatności i zapłacił starą kwotę. W panelu PayU płatność jest, a zamówienie w Elbuz zostaje z dotychczasowym statusem. Porównaj kwotę i w razie potrzeby zwróć płatność (jak).
- Fałszywe powiadomienie. Sklep sprawdza podpis drugim kluczem, a potem sam dopytuje PayU: punkt, numer próby, kwotę i walutę. Obce powiadomienie nie zmieni zamówienia.
- PayU nie odpowiedziało na sprawdzenie. Sklep niczego nie zmienia, a PayU powtarza powiadomienie później.
Potwierdzenie, anulowanie i zwrot w karcie zamówienia
Zamówienie ze strony trafia do dokumentów „Zamówienie klienta” w Elbuz ze sposobem płatności „Karta płatnicza”. W jego karcie jest blok „Płatność w PayU”: stan płatności, kwota, pobrano, zwrócono i ile jeszcze można zwrócić. Poniżej — wszystkie próby płatności.
Widać tylko przyciski dostępne teraz dla zamówienia:
| Przycisk | Kiedy jest | Co robi |
|---|---|---|
| Zwróć środki | Płatność jest zakończona i jest jeszcze co zwracać | Zwraca całą kwotę lub część, kilka razy. Pole kwoty jest już wypełnione pozostałą kwotą: aby zwrócić wszystko, zostaw proponowaną kwotę |
| Pobierz blokadę | Płatność czeka na potwierdzenie | Pobiera pieniądze, status z pola „Opłacone”. Tylko całą kwotę: części PayU nie pobiera |
| Zdejmij blokadę | Płatność czeka na potwierdzenie | Anuluje płatność, pieniądze wracają do klienta. Status z pola „Anulowane” |
| Odśwież status | Zawsze | Pobiera stan płatności z PayU, jeśli powiadomienie nie dotarło |
Przed każdą operacją na pieniądzach program prosi o potwierdzenie; przy zwrocie i zdjęciu blokady — z ostrzeżeniem „Tej operacji nie można cofnąć.”. Status zamówienia zmienia się tak samo jak po powiadomieniu PayU.
PayU realizuje zwrot przez kilka minut: „Zwrócono” w bloku zmieni się, gdy się zakończy. Po pełnym zwrocie — status z pola „Zwrócono”, po częściowym status bez zmian. Klient nie dostaje e-maila o zwrocie.
Gdy sklep nie odpowie, pojawi się „Nie wiadomo, czy operacja przeszła. Kliknij „Powtórz” — pieniądze nie zostaną przesunięte drugi raz”. „Powtórz” powtarza tę samą operację, a ponowne kliknięcie przycisku to już nowa operacja.
Zwracać pieniądze i zarządzać blokadą może tylko użytkownik z uprawnieniem „Operacje płatności: zwrot, blokada, kredyt” — domyślnie właściciel. „Odśwież status” jest dostępne dla każdego, kto widzi zamówienie.
Nie pobierzesz blokady — PayU samo anuluje płatność po kilku dniach (termin zależy od metody płatności), a pieniądze wrócą do klienta. Pilnuj zamówień ze statusem z pola „Oczekuje na potwierdzenie”.
Zwrot można też zrobić w panelu PayU — akcja „Refund” na liście transakcji.
Gdy przez PayU były już zamówienia, nagłówek ekranu modułu pokazuje je za 30 dni: liczbę, kwotę, średnią wartość zamówienia i udział anulowanych lub zwróconych.
Scenariusze
AGD: lodówka droższa niż limit karty
Poproś PayU o włączenie w Twoim punkcie BLIK i szybkich przelewów. Klient kupujący lodówkę za 6 000 zł płaci przelewem ze swojego banku, limit karty nie przeszkadza. Zamówienie samo staje się opłacone.
Elektronika: pobieranie dopiero po sprawdzeniu dostępności
W panelu PayU wyłącz dla punktu automatyczny odbiór płatności („autoodbiór”). W „Oczekuje na potwierdzenie” wybierz status, przy którym magazyn sprawdza dostępność.
Towar jest — kliknij „Pobierz blokadę” w karcie zamówienia; nie ma — „Zdejmij blokadę”, a pieniądze wrócą do klienta. Nie zwlekaj: po kilku dniach PayU samo anuluje niepotwierdzoną płatność.
Odzież: zamówiono trzy rozmiary, zostawiono jeden
Klient zwraca dwie kurtki z trzech. W karcie zamówienia kliknij „Zwróć środki” i wpisz kwotę za dwie kurtki, na przykład 598.00. PayU zwróci część, status pozostanie opłacony, a zwróconą kwotę widać w bloku „Płatność w PayU”.
Kawa: sprzedaż do strefy euro
Poproś PayU o punkt w EUR i wpisz jego klucze. „Waluta POS” — EUR, w oknie „Waluty i kursy” włącz EUR dla strony. Klienci z cenami w euro płacą bez przeliczania, a kwota w PayU jest dokładnie równa kwocie zamówienia.
Kosmetyki z telefonu: płatność bez przechodzenia na inną stronę
Punkt jest w PLN, PayU włączyło BLIK kodem. Włącz „Kod BLIK w kasie”. Klient wpisuje kod z aplikacji bankowej, potwierdza płatność — i od razu widzi udane zamówienie.
Co zrobić, gdy płatność nie działa
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Klient nie widzi PayU przy składaniu zamówienia | Moduł jest wyłączony, brak kluczy (a tryb testowy jest wyłączony), klient widzi ceny w innej walucie albo adres jest poza strefą geograficzną | Sprawdź „Włączony”, klucze, „Waluta POS” i „Strefa geograficzna”, potem „Zapisz” |
| Klient widzi „Nie udało się otworzyć strony płatności” | Błąd w kluczach albo punkt PayU działa w innej walucie | Wklej klucze z panelu jeszcze raz, sprawdź walutę punktu. Nie pomogło — wsparcie Elbuz włączy dziennik żądań i sprawdzi odpowiedź PayU |
| Kod BLIK za każdym razem jest odrzucany | PayU nie włączyło dla punktu płatności kodem BLIK | Poproś opiekuna PayU o włączenie „Transparent payment with a BLIK authorization code” |
| Płatność przeszła, a status się nie zmienił | Powiadomienia PayU nie docierają: strona jest bez HTTPS albo adres powiadomień jest zablokowany ochroną lub hasłem | Kliknij „Odśwież status” w karcie zamówienia. Potem odblokuj „Adres powiadomień” z bloku „Połączenie” |
| Pełny zwrot przyjęto, a status zamówienia się nie zmienił | PayU jeszcze realizuje zwrot | Poczekaj kilka minut: status zmieni się, gdy tylko PayU zakończy zwrot |
| „Sklep nie przyjął ustawień” lub „Sklep nie przyjął części wartości — zobacz zaznaczone pola” | Sklep nie odpowiedział albo odrzucił niektóre pola | Popraw zaznaczone pola i zapisz. Jeśli pola nie są zaznaczone, zmiany pójdą z następnym eksportem |
Najczęstsze pytania
Czy PayU można podłączyć w sklepie z Ukrainy?
Moduł działa z każdym punktem płatności PayU. Czy PayU zawrze umowę z Twoją firmą i jakie metody udostępni, decyduje PayU.
Co się stanie, jeśli wyłączę moduł?
PayU zniknie z formularza zamówienia. Klucze i ustawienia zostają zachowane: po ponownym włączeniu wszystko jest na miejscu.
Czy można wysłać klientowi link do płatności PayU z Elbuz?
Nie. Link do płatności z karty zamówienia działa z innymi usługami: Płatność przez link.
Jak potwierdzić płatność, która czeka na potwierdzenie?
W karcie zamówienia w Elbuz kliknij „Pobierz blokadę” w bloku „Płatność w PayU”. Pobierana jest tylko cała kwota: części PayU nie pobiera.
Na liście „Strefa geograficzna” nie ma potrzebnej strefy — co zrobić?
Strefę, na przykład „Polska”, tworzy wsparcie Elbuz. Potem wybierz ją w bloku „Gdzie pokazywać”.
Jak zmienić nazwę „Płatność przez PayU” w formularzu zamówienia?
Na ekranie modułu nie ma nazwy. Zmienia ją wsparcie Elbuz.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Ustawienia sklepu → „Zamówienie i płatność” → PayU
- Uprawnienia
- okno „Ustawienia sklepu” w „Uprawnieniach grup”
- Przygotuj
- umowę z PayU, punkt REST API, cztery klucze, walutę punktu w „Walutach i kursach”
Powiązane tematy
- Jeśli trzeba zrozumieć, jak działa okno ustawień sklepu — Ustawienia sklepu.
- Jeśli waluty punktu nie ma w sklepie — Kursy walut.
- Jeśli sprzedajesz także do krajów bałtyckich — Jak przyjmować płatności Paysera w sklepie.
- Jeśli trzeba obsłużyć opłacone zamówienie w Elbuz — Zamówienie klienta.
