Płatności online PayU - podłączenie operatora
Jak podłączyć operatora do PayU - punkt płatności, POS ID, klucze MD5 i OAuth, sandbox, adres powiadomień, włączenie płatności, adresy alarmów i lokalizacja fiskalizująca.
Zaktualizowano 2 listopada 2026
Na tej stronie
Płatności online przyjmuje się przez PayU - osobno dla każdego operatora, na jego własny punkt płatności. Po podłączeniu klient płaci BLIK-iem, kartą albo szybkim przelewem z linku wysłanego z panelu, w portalu i w aplikacji, a sprzedaż domyka się sama po wpłacie.
Zanim zaczniesz
Uprawnienia:
- Operator ma konto firmowe w PayU i punkt płatności (w PayU: Płatności elektroniczne › Moje sklepy › Punkty płatności).
- Panel jest dostępny z internetu po HTTPS - PayU wysyła na niego powiadomienia o wpłatach.
- Do pierwszych prób użyj konta testowego PayU (sandbox), a dopiero potem produkcyjnego.
Jak to działa
- Link albo koszyk Klient dostaje link z panelu albo płaci w portalu lub aplikacji.
- PayU Klient płaci na stronie PayU, na punkt płatności operatora.
- Powiadomienie PayU zawiadamia panel o wpłacie; system potwierdza stan, pytając PayU.
- Sprzedaż Wpłata trafia do sprzedaży, a paragon albo e-paragon drukuje kasa w lokalizacji.
Jeden operator = jeden punkt płatności. Marki operatora płacą na ten sam punkt.
Wpisz dane punktu płatności
- W PayU otwórz punkt płatności i skopiuj cztery pozycje: Id punktu płatności (POS ID), Drugi klucz (MD5), client_id i client_secret (protokół OAuth).
- W PayU, w ustawieniach punktu płatności, włącz automatyczny odbiór płatności.
- W panelu przejdź do Konfiguracja › Operatorzy, otwórz operatora i kliknij .
- W sekcji Integracja PayU wpisz Id punktu płatności (POS ID), Drugi klucz (MD5), OAuth - client_id i OAuth - client_secret.
- Zaznacz Środowisko sandbox, jeśli klucze są z konta testowego. Odznaczone oznacza produkcję.
- Zapisz zmiany operatora.
Klucze zapisane raz nie wracają na ekran. Pole pokazuje „Zapisano - wpisz nowy, aby zmienić” - zostaw je puste, jeśli nie zmieniasz klucza. Dane PayU zostają w chmurze i nie trafiają na kasy w lokalizacjach.
Włącz płatności online
- Na karcie operatora znajdź kartę Płatności online (PayU) i kliknij . Poczekaj na komunikat „PayU odpowiada poprawnie.”
- Skopiuj Adres powiadomień (notifyUrl) i wklej go w PayU, w konfiguracji punktu płatności.
- Kliknij .
- Włącz Przyjmuj płatności online.
- W Adresach alarmów kliknij i wpisz e-mail osoby, która rozwiązuje problemy z płatnościami (najwyżej 10 adresów).
- Wybierz Lokalizację fiskalizującą sprzedaży online.
- Opcjonalnie zmień Przelew zwrotny - alarm po (dni robocze). Kliknij .
Sam komplet kluczy nie uruchamia płatności. Dopóki Przyjmuj płatności online jest wyłączone, system nie wydaje linków do płatności, a stan na karcie to „Wyłączone”.
| Stan na karcie | Co znaczy |
|---|---|
| Nie skonfigurowana | brak danych PayU |
| Niekompletna | jest POS ID, brakuje kluczy |
| Wyłączone | dane są komplet, ale płatności nie są włączone |
| Przyjmuje płatności | operator przyjmuje płatności online |
Lokalizacja fiskalizująca
Ta lokalizacja drukuje e-paragony zamówień ze sklepu w portalu i aplikacji - cały koszyk, także z pozycjami z kilku lokalizacji. Wpłaty na zamówienia (także online) drukuje kasa lokalizacji zamówienia; lokalizacja fiskalizująca przejmuje je tylko wtedy, gdy lokalizacja zamówienia jest nieaktywna. Puste pole oznacza, że sklep fiskalizuje w lokalizacji pierwszej pozycji koszyka.
Alarmy
Problem z płatnością (np. wpłata po czasie albo brak dokumentu) trafia na listę Wymaga uwagi, a dodatkowo na adresy alarmów. Bez adresów karta pokazuje „Tylko lista „Wymaga uwagi””. Obsługę alarmów opisuje Płatności online PayU - lista, zwroty i alarmy.
Ważność linku do płatności ustawiasz w marce: Konfiguracja › Marki, zakładka Rezerwacje i wpłaty, pole Ważność linku do płatności (godziny).
Sprawdź, zanim przejdziesz na produkcję
- Na sandboxie wyślij link do płatności dla testowego zamówienia (Link do płatności online).
- Zapłać testowo i sprawdź w Płatności i kasa › Płatności online, że próba ma stan „Opłacono”.
- Wpisz klucze produkcyjne, odznacz Środowisko sandbox, kliknij i wklej adres powiadomień w produkcyjnym punkcie płatności.
Częste problemy
Powiązane
- Dodanie operatora Jak dodać operatora - firmę, która sprzedaje i wystawia dokumenty - uzupełnić jej dane, symbol w numeracji dokumentów i właściciela, a potem wyłączyć albo usunąć operatora.
- Płatności online PayU - lista, zwroty i alarmy Jak sprawdzić stan płatności online w PayU, zwrócić wpłatę przez PayU i obsłużyć alarmy z listy „Wymaga uwagi”.
- Link do płatności online Jak wysłać klientowi link do zapłaty w PayU (e-mail, SMS albo skopiowany link), jak śledzić jego stan i jak anulować płatność.