Integracja PayU przez REST API
Zamówienia, powiadomienia, zwroty, zapisane karty i BLIK na Twojej stronie, zbudowane na REST API 2.1. Dla sklepów i aplikacji, w których gotowa wtyczka nie obsłuży procesu sprzedaży.
Jak budujemy integrację z PayU
Sześć najczęstszych sytuacji i to, jak w każdej budujemy integrację z PayU.
Jeśli zaczynasz nową integrację z PayU,
to budujemy ją na aktualnym API PayU. Starszy protokół Classic nie jest już dostępny dla nowych wdrożeń, więc nic nie trzeba będzie przepisywać.
Jeśli klient płaci bez konta w Twoim sklepie,
to integracja łączy się z PayU kluczem Twojego punktu płatności i sama odnawia dostęp, zanim wygaśnie, więc płatności nie stają w środku dnia.
Jeśli klient jest zalogowany i płaci zapisaną kartą,
to kartę łączymy z jego kontem w Twoim sklepie. Zapisywanie kart musi włączyć PayU, więc sprawdzamy to przed wyceną.
Jeśli płatność ma być częścią panelu, aplikacji albo rezerwacji,
to piszemy integrację, która obsłuży Twój sposób sprzedaży, z BLIK-iem i kartą na Twojej stronie, bez przekierowania. Gotowa wtyczka tego nie zrobi. Porównanie bramek
Jeśli klient zwraca część zamówienia,
to zlecasz zwrot częściowy w swoim panelu. Panel pokazuje, ile jeszcze da się zwrócić, bo suma zwrotów nie może przekroczyć kwoty zamówienia.
Jeśli chcesz najpierw testować,
to zaczynamy w środowisku testowym PayU, a na pierwsze próby wystarcza publiczny testowy punkt płatności. Testy pod dużym ruchem robimy u siebie, bo środowisko testowe PayU nie jest do tego przeznaczone.
Od koszyka do opłaconego zamówienia
Najprostszy przebieg z przekierowaniem na stronę płatności PayU.
Twój serwer
łączy się kluczem punktu płatności
Na startzamówienie 10517Zamówienie w PayU
kwota, produkty, adres powiadomień i strona powrotu
Z kroku 1tworzy zamówienieStrona płatności
klient wybiera metodę i płaci
Z kroku 2link do płatnościPowiadomienie
podpisane, na adres podany w zamówieniu
Z kroku 3zmiana statusuStatus w Twoim systemie
po sprawdzeniu podpisu i kwoty
Z kroku 4potwierdzenie odbioru
Gdy się uda
COMPLETED: płatność przyjęta, uruchamiamy realizację zamówienia.
Zatrzymane do sprawdzenia
Z kroku 4: podpis albo kwota się nie zgadzaZamówienie nie zmienia statusu, a powiadomienie bez zgodnego podpisu zostaje odrzucone.
Gdy się nie uda
CANCELED: płatność anulowana, kupujący nie został obciążony. Zamówienie wraca do płatności albo wygasa.
Potwierdzenie albo ponowienie
PayU czeka, aż Twój serwer potwierdzi odbiór powiadomienia. Bez potwierdzenia wysyła je jeszcze raz według harmonogramu, więc żadna płatność nie przepada.
Opłacone zostaje opłacone
Gdy płatność jest przyjęta (COMPLETED), kolejne powiadomienia o tym samym zamówieniu nie zmieniają już jego stanu.
Odbiór ręczny
Płatność może czekać, aż Twój system ją odbierze albo anuluje, na przykład po sprawdzeniu magazynu. Bez decyzji PayU anuluje ją po czasie właściwym dla metody płatności.
Sprawdzony podpis
Każde powiadomienie sprawdzamy drugim kluczem Twojego punktu płatności, zanim cokolwiek z nim zrobimy, więc podrobione powiadomienie nie zmieni statusu zamówienia.
Jak długo PayU ponawia powiadomienia
Gdy Twój serwer nie potwierdzi odbioru powiadomienia, PayU wysyła je jeszcze raz. Harmonogram rozciąga się na trzy doby.
Co robi nasz moduł: Krótka awaria serwera nie gubi płatności, kolejka przyjmuje powiadomienie przy następnej próbie.
Co robi nasz moduł: Monitoring zgłasza, że adres powiadomień nie odpowiada, zanim zauważy to klient.
Co robi nasz moduł: Zamówienia bez potwierdzenia trafiają na listę i sprawdzamy je, pobierając dane transakcji wprost z PayU.
Cztery sposoby płatności przez PayU
Od przekierowania po kartę zapisaną na koncie klienta. Wdrażamy każdy z nich i dobieramy je do tego, ile ma się dziać na Twojej stronie.
| Strona płatności PayUprzekierowanie | BLIK na Twojej stroniekod wpisany w sklepie | Karta przez Secure Formpola karty od PayU | Karta zapisanana koncie klienta | |
|---|---|---|---|---|
| Klient zostaje na Twojej stronie | Strona płatności PayUniena stronie PayU | BLIK na Twojej stronietakw Twoim formularzu i w aplikacji banku | Karta przez Secure Formtakw polach PayU osadzonych na Twojej stronie | Karta zapisanatakjednym kliknięciem przy kolejnym zakupie |
| Dane karty omijają Twój serwer | Strona płatności PayUtak | BLIK na Twojej stronietak | Karta przez Secure Formtak | Karta zapisanatak |
| Działa bez dodatkowej konfiguracji w PayU | Strona płatności PayUtak | BLIK na Twojej stronieczęściowo | Karta przez Secure Formtak | Karta zapisananieZapisywanie kart musi włączyć PayU, a starsze punkty płatności mogą go nie mieć. |
| Działa bez konta klienta | Strona płatności PayUtak | BLIK na Twojej stronietak | Karta przez Secure Formtak | Karta zapisananieZapisana karta jest powiązana z kontem klienta. |
| Dobre do | Strona płatności PayUSzybkiego startu i wielu metod naraz | BLIK na Twojej stronieZakupów z telefonu bez opuszczania sklepu | Karta przez Secure FormPłatności kartą bez przekierowania | Karta zapisanaSklepów z powracającymi klientami |
Zamówienie w Twoim systemie, zamówienie w PayU
Tak łączymy dane, żeby każde powiadomienie trafiło do właściwego zamówienia.
- Twój systemnumer zamówienia 10517→unikalny, łączy powiadomienia z zamówieniemPayUidentyfikator zamówienia w PayU
- Twój systemsuma zamówienia 210,00 zł→PayU liczy w groszachPayUkwota 21000 groszy
- Twój systempozycje koszyka→ceny jednostkowe w groszachPayUprodukty z ceną i liczbą sztuk
- Twój systemadres e-mail klienta→PayU wysyła na niego potwierdzeniePayUe-mail kupującego
- Twój systemadres IP klienta→wymagany przy tworzeniu zamówieniaPayUadres IP kupującego
- Twój systemadres obsługi powiadomień→może być inny dla każdej płatnościPayUadres powiadomień
- Twój systemstrona po płatności→tylko dla klienta, nie potwierdza wpłatyPayUstrona powrotu
| Co | Kierunek | Kiedy |
|---|---|---|
| Zamówienie | Twój system → PayU | Gdy klient klika "Zapłać". W odpowiedzi wraca link do strony płatności. |
| Powiadomienie o statusie | PayU → Twój system | Po każdej zmianie statusu, podpisane. Podpis sprawdzamy, zanim zamówienie się zmieni. |
| Powrót klienta | PayU → Twój system | Po płatności. To strona dla klienta i niczego nie potwierdza. |
Najczęstsze pytania o PayU
Odpowiedzi o kartach, zapisanych kartach, powiadomieniach, odbiorze płatności, zwrotach i wycenie.
Czytaj dalej
Inne bramki i strony, które łączą się z płatnościami.
Jak dziś płacą Twoi klienci?
Napisz, gdzie mają działać płatności PayU i co ma się dziać po wpłacie. Odpowiemy w godzinę z pytaniami i wyceną.