Jak dodać PayU do sklepu i nie popsuć obsługi zamówień

Dodanie PayU do sklepu internetowego nie powinno kończyć się na wklejeniu kluczy API i przycisku „zapłać”. Najwięcej problemów pojawia się później: zamówienie ma zły status, klient wraca na pustą stronę, sklep nie dostaje potwierdzenia płatności albo obsługa ręcznie sprawdza przelewy.

Dobrze wdrożona bramka płatnicza skraca zakup i porządkuje zaplecze. Źle wdrożona robi chaos dokładnie tam, gdzie klient jest najbliżej zapłaty.

Co przygotować przed integracją PayU?

• konto sprzedawcy PayU i dane punktu płatności,
• środowisko testowe albo sandbox,
• adres powrotu klienta po płatności,
• adres do powiadomień serwer-serwer, czyli webhook/notify URL,
• mapę statusów zamówienia w sklepie,
• jasny plan zwrotów, anulowania i płatności nieudanych.

Jeśli używasz WooCommerce, PrestaShop, Magento albo innej gotowej platformy, część pracy wykona wtyczka. Nadal trzeba ją poprawnie skonfigurować i przetestować. Wtyczka nie zgadnie, jak Twoja firma obsługuje zamówienia.

Najważniejszy element: status zamówienia

Klient widzi tylko ekran płatności. Firma widzi cały proces: nowe zamówienie, oczekiwanie na płatność, płatność przyjęta, kompletowanie, wysyłka, zwrot, anulowanie. Integracja PayU musi dobrze przepinać statusy, bo od tego zależą e-maile, faktury, stany magazynowe i praca obsługi.

Nie zakładaj, że samo przekierowanie klienta z powrotem do sklepu oznacza płatność. Potwierdzenie powinno przyjść po stronie serwera, niezależnie od tego, czy klient zamknął kartę, stracił internet albo wrócił później.

Typowy przepływ płatności

1. Klient wybiera PayU w checkoutcie.
2. Sklep tworzy zamówienie i wysyła dane płatności do PayU.
3. PayU pokazuje klientowi ekran płatności albo przekierowuje do banku/metody płatności.
4. Klient opłaca zamówienie.
5. PayU odsyła klienta do sklepu na stronę podziękowania.
6. PayU wysyła powiadomienie serwerowe o statusie transakcji.
7. Sklep aktualizuje status zamówienia i uruchamia dalszą obsługę.

To ostatnie powiadomienie jest krytyczne. Strona „dziękujemy za zamówienie” jest ważna dla UX, ale nie powinna być jedynym źródłem prawdy.

Checkout: co klient musi zrozumieć?

Przy płatnościach online warto unikać technicznego języka. Klient powinien wiedzieć, ile płaci, za co płaci, kiedy wróci do sklepu i co stanie się, jeśli płatność się nie uda. Dobre komunikaty ograniczają liczbę porzuconych koszyków i pytań do obsługi.

• Pokaż pełną kwotę przed przejściem do PayU.
• Nie ukrywaj kosztów dostawy do ostatniego kroku.
• Po powrocie pokaż jasny status: opłacone, oczekuje, nieudane.
• Wyślij e-mail potwierdzający, ale dopiero po właściwym statusie płatności.
• Przetestuj zachowanie na telefonie, bo większość płatności dzieje się mobilnie.

Testy przed publikacją

Przed uruchomieniem na produkcji przejdź przez kilka scenariuszy: płatność udana, płatność przerwana, zamknięta karta, powrót po czasie, ponowna próba zapłaty, zwrot, anulowanie zamówienia i brak odpowiedzi z zewnętrznej usługi. Dopiero wtedy wiadomo, czy integracja działa także przy błędach, przerwach i ponownych próbach płatności.

Warto też sprawdzić, czy dane płatności nie trafiają do narzędzi analitycznych, logów frontendu albo maili technicznych. Płatności to nie miejsce na przypadkowe debugowanie na produkcji.

Kiedy wdrażać PayU przez wtyczkę, a kiedy indywidualnie?

Wtyczka ma sens, gdy sklep działa standardowo i potrzebujesz szybkiego, bezpiecznego wdrożenia. Indywidualna integracja jest lepsza przy niestandardowym checkoutcie, marketplace, płatnościach rozbitych na kilka etapów, własnym panelu zamówień albo automatyzacjach po stronie CRM i magazynu.

Najważniejsze: bramka płatnicza ma pasować do procesu sprzedaży. Nie odwrotnie.

Źródło pomocnicze: PayU Europe Developer Guide: Payment Flows.