↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak przyjmować płatności PayU w sklepie

    6 min czytaniaZaktualizowano

    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

    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.

    1. Weź cztery klucze z panelu PayU (gdzie dokładnie).
    2. Otwórz ekran modułu. „Ustawienia sklepu” → sekcja „Zamówienie i płatność” → karta PayU.
    3. W bloku „Połączenie” wyłącz „Tryb testowy (sandbox)” i wpisz klucze.
    4. W bloku „Płatność” wybierz „Waluta POS” — tę, w której działa punkt w PayU (dlaczego to ważne).
    5. Włącz przełącznik „Włączony” u góry ekranu.
    6. Kliknij „Zapisz”. Ustawienia od razu trafiają do sklepu: na dole pojawi się „Zapisano i zastosowano w sklepie”.
    Sekcja „Zamówienie i płatność” ustawień sklepu z kartą modułu PayU
    1Karta PayU
    2Przełącznik „Włączony”
    1. Karta PayU: kliknij, aby otworzyć ekran konfiguracji.
    2. Czy klienci widzą tę metodę płatności; karta pokazuje też, czy ostatnie zmiany dotarły do sklepu.
    Ekran konfiguracji PayU, zmaksymalizowany, z blokiem „Połączenie” i listą kontrolną
    1Przełącznik „Włączony”
    2Tryb testowy (sandbox)
    3POS ID
    4Drugi klucz (MD5)
    5Co jeszcze do skonfigurowania
    1. Po zapisaniu pokazuje PayU klientom.
    2. Płatności testowe bez pobierania pieniędzy; wyłącz przed sprzedażą.
    3. Numer punktu płatności z panelu PayU.
    4. Klucz tajny: po zapisaniu nie jest pokazywany, widać tylko, że jest ustawiony.
    5. 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 ElbuzCo 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.

    Blok „Płatność” z walutą punktu i przełącznikiem kodu BLIK obok listy kontrolnej
    1Waluta POS
    2Kod BLIK w kasie
    3Brak PLN w sklepie
    1. Waluta punktu płatności PayU: metoda jest pokazywana tylko klientom z cenami w tej walucie.
    2. Pozwala klientowi wpisać kod BLIK od razu przy składaniu zamówienia, tylko PLN.
    3. 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.

    1. Poproś opiekuna PayU o włączenie dla Twojego punktu „Transparent payment with a BLIK authorization code”. Bez tego PayU odrzuci kod.
    2. W bloku „Płatność” włącz „Kod BLIK w kasie”. Przełącznik jest widoczny tylko przy walucie PLN.
    3. 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.

    1. 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.
    2. „Waluta POS” — PLN. Sprawdź, czy PLN jest w sklepie (powyżej).
    3. Włącz moduł i zapisz.
    4. 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.”
    5. Zapłać kartą testową lub kodem BLIK z dokumentacji PayU. Kod 777123 — udana płatność.
    6. 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łoDokąd wraca klient
    ZapłaciłStrona udanego zamówienia
    BLIK lub przelew jest jeszcze w drodzeTeż 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 sklepuSkł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”.

    Blok „Statusy zamówienia” PayU z czterema polami statusów
    1Opłacone
    2Oczekuje na potwierdzenie
    3Zwrócono
    4Anulowane
    1. „Opłacone” — status, który zamówienie dostaje, gdy PayU potwierdzi płatność.
    2. „Oczekuje na potwierdzenie” — pieniądze są zablokowane na karcie kupującego i pobierane po potwierdzeniu w karcie zamówienia.
    3. „Zwrócono” — status po pełnym zwrocie.
    4. „Anulowane” — status, gdy płatność czekająca na potwierdzenie zostaje anulowana: na Twoje żądanie albo przez samo PayU po kilku dniach.
    PoleKiedy jest nadawanyDomyślnie
    OpłaconePayU potwierdziło płatność. Klient dostaje zwykły e-mail o zamówieniu„W realizacji”
    Oczekuje na potwierdzenieW 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óconoKlientowi zwrócono całą kwotę„Zwrócono środki”
    AnulowanePł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:

    PrzyciskKiedy jestCo robi
    Zwróć środkiPł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 potwierdzeniePobiera pieniądze, status z pola „Opłacone”. Tylko całą kwotę: części PayU nie pobiera
    Zdejmij blokadęPłatność czeka na potwierdzenieAnuluje płatność, pieniądze wracają do klienta. Status z pola „Anulowane”
    Odśwież statusZawszePobiera 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 widziszDlaczego tak jestCo 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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo