Nowość w Endora Commerce: wbudowany CRM z szansami sprzedażowymi Zobacz →
Endora Commerce

Integracja z PayU

Moduł PayU łączy kasę Endora Commerce z PayU GPO: kupujący płaci BLIK-iem, kartą, portfelem albo szybkim przelewem, a zamówienie zmienia status dopiero po zweryfikowanym powiadomieniu od operatora.

Dla kogo jest PayU

PayU GPO to bramka, którą wielu polskich sprzedawców ma już podpisaną dla sklepu detalicznego. W hurcie jej rola jest zwykle węższa: obsługuje nowych klientów bez przyznanego limitu, zamówienia przedpłacone, drobne dokupienia i kanał B2C, jeśli prowadzisz go na tej samej platformie. Duże zamówienia stałych odbiorców i tak idą najczęściej na przelew z terminem albo w ciężar limitu kupieckiego. Te sposoby płatności platforma ma w standardzie, niezależnie od bramki.

Moduł PayU jest modułem płatnym, podobnie jak pozostałe bramki płatności online. Otwarty rdzeń zawiera warstwę płatności oraz przelew, płatność przy odbiorze i limit kupiecki.

Metody płatności i dwa warianty kasy

Integracja obsługuje:

  • BLIK, także jako BLIK One Click dla powracających kupujących,
  • karty przez formularz PayU Secure Form, z możliwością zapisania karty,
  • Apple Pay i Google Pay,
  • pay-by-link, czyli szybki przelew z banku kupującego.

Kasę ustawiasz na jeden z dwóch sposobów. W wariancie przekierowania kupujący po złożeniu zamówienia przechodzi na stronę PayU i tam wybiera metodę. W wariancie wbudowanym formularz płatności jest częścią Twojej kasy. Pole karty to wtedy PayU Secure Form: formularz hostowany przez PayU i osadzony w ramce, więc dane karty trafiają bezpośrednio do operatora, a do platformy wraca tylko token.

Od złożenia zamówienia do statusu „opłacone”

  1. Kupujący składa zamówienie i wybiera PayU. Platforma zakłada zamówienie po stronie operatora.
  2. Kupujący autoryzuje płatność: na stronie PayU albo w formularzu w Twojej kasie.
  3. PayU wysyła powiadomienie o wyniku. Moduł sprawdza podpis z nagłówka OpenPayu-Signature i dopiero po jego potwierdzeniu zmienia status zamówienia.
  4. Platforma emituje zdarzenie rozliczenia albo odmowy płatności, które możesz przekazać dalej, na przykład webhookiem do ERP.

Podpis ma tu praktyczne znaczenie: adres powiadomień jest publiczny, więc bez weryfikacji każdy mógłby oznaczyć zamówienie jako opłacone. PayU oczekuje odpowiedzi HTTP 200 i ponawia powiadomienie, gdy jej nie dostanie, więc to samo powiadomienie może przyjść więcej niż raz. Szczegóły opisuje dokumentacja cyklu życia płatności PayU.

Zapisane karty i BLIK One Click

Powracający kupujący nie wpisuje danych płatności od nowa. Przy kartach działa to na tokenach PayU: po pierwszej udanej płatności operator wydaje token wielokrotnego użytku, a platforma przechowuje token, nie numer karty.

BLIK One Click pozwala zapłacić bez przepisywania kodu BLIK z aplikacji banku przy każdym zamówieniu. Ta usługa nie jest w PayU dostępna domyślnie: wymaga spełnienia warunków operatora i przejścia procesu wdrożenia z opiekunem konta. Uwzględnij to w harmonogramie, bo ten krok nie zależy od platformy.

Zwroty powiązane z reklamacją

Zwrot środków nie jest osobną operacją w panelu bramki. Wychodzi z modułu reklamacji: gdy rozliczasz zgłoszenie zwrotem pieniędzy, platforma zleca zwrot w PayU dla płatności, którą zamówienie zostało opłacone. Zwrot pieniędzy i zwrot towaru mają dzięki temu wspólny rekord.

  • Kwota dla pozycji domyślnie odpowiada kwocie zapłaconej za zwracaną ilość i nie może jej przekroczyć.
  • PayU dopuszcza kilka zwrotów częściowych do jednego zamówienia, o ile ich suma nie przekracza wartości zamówienia. Pasuje to do reklamacji rozliczanych pozycja po pozycji.
  • Jeśli moduł PayU jest wyłączony, rozliczenie reklamacji zwrotem zostaje odrzucone do czasu jego ponownego włączenia. Zgłoszenie nie zmienia wtedy statusu.

Co przygotować po stronie PayU

ElementPo co
Konto firmowe i sklep w PayUSklep w panelu PayU ma własną walutę i saldo, co warto uwzględnić przy sprzedaży w kilku walutach
Punkt płatności typu REST APIDla niego PayU generuje klucze, którymi platforma autoryzuje żądania
Drugi klucz punktu płatnościSłuży do weryfikacji podpisu powiadomień
Konto w środowisku sandboxPubliczny punkt testowy PayU wystarcza do samego przekierowania, a do testów zwrotów operator zaleca własne konto w sandboxie
Konfiguracja usług BLIK po stronie PayUWarianty BLIK inne niż przekierowanie na stronę płatności wymagają specjalnej konfiguracji punktu płatności przez operatora

Klucze wpisujesz w panelu administracyjnym. Pola tajne są szyfrowane w spoczynku i nie da się ich odczytać z powrotem przez API. Listę środowisk i danych testowych znajdziesz w dokumentacji testowania PayU.

PayU a pozostałe bramki

Płacisz stawkę PayU i nic ponad to. Endora nie dokłada własnej marży pośrednika, tak samo jak przy Stripe i tpay.

Wybór między PayU a tpay sprowadza się zwykle do tego, z kim masz już umowę i jakie warunki wynegocjowałeś, bo obie bramki pokrywają metody, których polski kupujący oczekuje. Stripe ma więcej sensu, gdy większość płatności to karty klientów zagranicznych. Jeśli sprzedajesz wyłącznie na fakturę z terminem płatności, bramka online może w ogóle nie być potrzebna: wystarczą przelew, limit kupiecki i faktury w KSeF. Pełną listę znajdziesz w katalogu integracji.

Sprawdźmy, co da się podłączyć u Ciebie

Umów bezpłatną konsultację. Przejdziemy przez Twój ERP, magazyn i procesy sprzedaży, i pokażemy, jak wygląda ścieżka integracji krok po kroku.

Michał Zabielski, założyciel i CEO Endory

Michał Zabielski

Założyciel i CEO Endory

Odpowiadamy w ciągu jednego dnia roboczego.