Wprowadzenie

PayU umożliwia łatwą akceptację płatności na Twojej stronie lub urzadzeniu mobilnym.

Oferujemy pełen zestaw API, które pozwalają tworzyć, rozliczać, anulować i pobierać zamówienia, wykonywać wypłaty i pobierać raporty.

W celu uproszczenia integracji, można użyć jednej z naszych wtyczek lub naszego PHP SDK.

Ponadto, wiele platform sklepowych oferuje wbudowaną integrację z PayU. Jeśli platforma jakiej używasz do nich należy, postępuj zgodnie z podanymi w niej instrukcjami aby szybko skonfigurować płatność przez PayU.

Na początek należy założyć konto PayU dla sprzedawców (obiorców płatności). Może to być konto produkcyjne (rejestruj lub skontaktuj się z partnerem PayU lub przedstawicielem handlowym) lub konto testowe na środowisku sandbox (rejestruj).

Po zalogowaniu się do panelu administracyjnego konta PayU, stwórz Sklep i Punkt Płatności w typie REST API.

Uwaga: jeżli zacząłeś od razu od konta produkcyjnego, nie będzie ono w pełni aktywne, dopóki nie zostanie przez nas zakończona wymagana prawem weryfikacja.

Przed rozpoczęciem integracji, warto wybrać jej właściwy model. Dostępne są różne opcje, a usługi i konfiguracja konta PayU mogą zależeć od odpowiedzi na poniższe pytania:

Czy każde zamówienie opłacone przez PayU będzie zrealizowane?

Jeśli nie, wyłącz auto-odbiór na swoim punkcie płatności i każdorazowo decyduj, czy zamówienie odebrać i rozliczyć lub anulować i zwrócić środki.

Czy sprzedawane są wysokokwotowe towary lub usługi?

Jeśli tak, zwiększ sprzedaż dzięki usłudze Raty | PayU.

Czy często będą wykonywane zwroty środków do płacących?

Jeśli tak, należy rozważyć wykonywanie zwrotów poprzez API zamiast wykonywać je poprzez Panel.

Czy chciałbyś umożliwić swoim klientom wybór metody płatności już na stronie Twojego serwisu?

Jeśli tak, zdecyduj się na "transparentną" integrację.

Czy dla swoich klientów będziesz tworzyć konta użytkowników?

Jeśli tak, użyj usługi Tokenizacji kart a dane kart płatniczych Twoich klientów zostaną bezpiecznie zapisane w PayU. Dzięki temu przy kolejnej płatności nie będzie trzeba podawać numeru karty, a płatności będzie można dokonać jednym kliknięciem.

Czy będziesz cyklicznie obciążał swoich klientów (np. co miesiąc)?

Jeśli tak, skorzystaj z usługi płatności cyklicznych.

Czy masowo wystawiasz faktury, które wymagają płatności na dedykowane subkonta bankowe?

Jeśli tak, wdróż usługę Mass Collect.

Czy musisz rozliczać odebrane płatności z innymi podmiotami?

Jeśli tak użyj API do wypłat aby usprawnić rozliczenia ze swoimi partnerami biznesowymi.

Sprawdź naszą ofertę handlową, aby dowiedzieć się więcej.

Jeśli potrzebujesz pomocy, skontaktuj się z nami przez wypełnienie formularzu tutaj.

W przypadku pytań o konkretne zamówienia i wywołania naszego API, podaj wartość nagłówka Correlation-Id w odpowiedzi zwróconej przez system PayU.

Strona płatności PayU

Kliknij przycisk - zostaniesz przekierowany na stronę podsumowania płatności serwowaną przez system PayU.

Powyższy przykład pokazuje integrację za pomocą formularza implementującego protokół REST API, zalecana jest jednak integracja za pomocą komunikatów JSON, ponieważ daje więcej możliwości rozszerzenia integracji.

Secure Form

Kliknij w przycisk - wywoła on Secure Form służący do bezpiecznego pobrania danych karty. Secure Form możesz również wlać w swoją stronę.

Aby zobaczyć wszystkie możliwości akceptacji płatności kartą zobacz sekcję poświęconą formatkom płatniczym.

Dane publicznego punktu płatności:

       
                
                Id punktu płatności (pos_id):       145227
                Drugi klucz (MD5):                  13a980d4f851f3d9a1cfc792fb1f5e50
                Protokół OAuth (client_id):         145227
                Protokół OAuth (client_secret):     12f071174cb7eb79d4aac5bc2f07563f
                
            

Poniżej znajduje się krótka list przypadków testowych. Sprawdź jak Twoja strona obsługuje następujące sytuacje:

1. Czy po wykonaniu żądania POST na endpoint /api/v2_1/orders następuje przekierowanie na adres przekazany przez PayU w odpowiedzi z kodem HTTP 302?
2. Czy Twój system odbiera i parsuje powiadomienia wysyłane przez PayU? Czy w odpowiedzi na powiadomienie wysyłany jest kod HTTP 200?
3. Czy prawidłowo ustalasz status zamówienia w PayU? Pamiętaj, status zamówienia jest przekazywany wyłącznie w notyfikacji, status zwrócony w odpowiedzi dotyczy danego żądania, a nie całego zamówienia(!).
4. Czy podajesz parametr continueUrl? Czy po zakończonej płatności użytkownik jest przekierowywany na ten adres?
5. Czy obsługujesz komunikat o nieudanej płatności doklejany jako query string do adresu strony podanej jako continueUrl?
6. W przypadku Tokenizacji Kart, czy Twój system obsługuje wszystkie scenariusze uwierzytelnienia płatności?

Opcje 1 i 2 mogą zostać wykonane poprzez Panel lub API.

Sandbox to niemal identyczna kopia produkcyjnego systemu PayU, której można używać do integracji i testów. Aby skorzystać ze środowiska testowego, należy się osobno zarejestrować (wymagany jest jedynie adres email). Transakcje testowe można odbierać od razu po rejestracji oraz utworzeniu sklepu i punktu płatności.

Przydatne adresy:

• utworzenie konta na środowisku sandbox
• logowanie do panelu

Zapoznaj się z instrukcją, jeżeli nie wiesz jak się zarejestrować lub założyć nowy sklep na koncie Sandbox.

W celu przetestowania płatności kartą, należy użyć poniższych danych.

Wszystkie karty testowe wspierają uwierzytelnienie za pomocą protokołu 3DS 2, a wynik uwierzytelnienia, o ile nie zaznaczono inaczej, to udane uwierzytelnienie typu frictionless.

W praktyce oznacza to, że dla każdego zamówienia (OrderCreateRequest) z podaniem numeru karty lub tokena kartowego należy spodziewać się odpowiedzi WARNING_CONTINUE_3DS, o ile nie jest to płatność wyłączona z obowiązku uwierzytelnienia (np. płatność cykliczna lub MOTO).

UWAGA - karty testowe, które zwracają domyślny wynik 3DS nie mogą zostać użyte do zapisania karty/tokenu z uwagi na wymogi SCA/PSD2.

Płatności OneClick powyższymi kartami testowymi wymagają CVV, chyba że w kolumnie "Zachowanie" sprecyzowano inaczej.

Lista funkcjonalności możliwa do sprawdzenia na środowisku sandbox:

• Płatności pay-by-link:
  • Polskie przelewy - mTransfer - mBank (m), Płać z iPKO (p), Pekao24Przelew - BankPekao (o);
  • Czeskie przelewy - Česká spořitelna (cs), Komerční banka (kb);
  • Słowackie przelewy - (besteron) Tatra banka, a. s. (tatra), Slovenská sporiteľňa, a. s. (sporo);
  • Dodatkowe (losowe) dane o kupującym (do pobrania przez TransactionRetrieveRequest) dostępne są wyłącznie dla metod:
    • Pekao24Przelew - Bank Pekao (o) (następnego dnia)
    • Komerční banka (kb) (natychmiastowo)
• Apple Pay,
• BLIK,
• Google Pay,
• Mass Collect,
• Płatności cykliczne,
• Raty i Płacę później,
• Płać w ratach z Mastercard,
• Visa Checkout,
• PayU|Mobile (Android oraz iOS),
• Wypłaty (Panel, API),
• Zestawienia,
• Zwroty (Panel, API).

Poniżej znajduje się lista metod płatności dostępnych poprzez PayU. Aby mieć pewność, że Twoi klienci będą płacić jedynie aktualnie dostępnymi metodami płatności, zalecamy korzystanie z możliwości ich automatycznego pobierania:

• Jeżeli korzystasz ze strony płatniczej PayU (parametr payMethod o wartości PAYMENT_WALL lub jego brak), zajmujemy się wszystkim, wliczając logotypy, które są aktualizowane automatycznie.
• Jeżeli wdrożyłeś metody płatności samodzielnie w swoim sklepie internetowym zalecamy abyś zapoznał się z tymi instrukcjami.
• Jeżeli nadal korzystasz z Classic API (NewPayment) i nie planujesz zmiany na Rest API to, zalecamy abyś zapoznał się z tymi instrukcjami.

Dzięki tej usłudze nasz całodobowy monitoring dba, aby w przypadku planowanej przerwy konserwacyjnej lub nieoczekiwanej awarii, dany kanał został wyłączony. W wypadku zaistnienia sytuacji tego typu, klient nadal może, np. zapłacić kartą kredytową, jeśli jego bank nie obsługuje przelewu w danym momencie.

Automatyczne anulowanie transakcji

Szczegóły metod płatności

Metoda płatności Raty | PayU jest dostępna tylko na rynku polskim (sprawdź szczegóły).

Metoda płatności Twisto | PayU Płacę Później jest dostępna tylko na rynku polskim (sprawdź szczegóły).

Metoda płatności PayPo | PayU Płacę Później jest dostępna tylko na rynku polskim (sprawdź szczegóły).

Metoda płatności Płacę Później z Twisto jest dostępna na rynku czeskim (sprawdź szczegóły).

Automatyczne anulowanie transakcji

Szczegóły metod płatności

Automatyczne anulowanie transakcji

W przypadku polskich przelewów czas automatycznego anulowania transakcji nieopłaconych wynosi 5 dni, a dla transakcji w statusie "Oczekuje na odbiór": 10 dni. Wyjątkiem jest metoda "Przelew bankowy", dla której w obu przypadkach czas automatycznego anulowania wynosi 10 dni.

Szczegóły metod płatności

(*) między 23:45 a 3:15 jest przetwarzane zakończenie i rozpoczęcie dnia księgowego, co może w tym czasie powodować przerwy w procesowaniu transakcji

Automatyczne anulowanie transakcji

Szczegóły metod płatności

Automatyczne anulowanie transakcji

W przypadku słowackich przelewów czas automatycznego anulowania transakcji nieopłaconych i transakcji w statusie "Oczekuje na odbiór" jest taki sam i wynosi 10 dni.

Szczegóły metod płatności

Automatyczne anulowanie transakcji

W przypadku przelewów międzynarodowych czas automatycznego anulowania transakcji nieopłaconych i transakcji w statusie "Oczekuje na odbiór" jest taki sam i wynosi 10 dni. Wyjątkiem jest metoda GiroPay (gp), dla której czas automatycznego anulowania transakcji nieopłaconych wynosi 5 dni, a czas automatycznego anulowania transakcji w statusie "Oczekuje na odbiór" wynosi 10 dni.

Szczegóły metod płatności

W PayU istnieje możliwość ustawienia dwóch rodzajów walut na poziomie pojedynczego sklepu: waluty transakcyjnej i waluty rozliczeniowej.

Waluta transakcyjna określa, w jakiej walucie płacący może dokonywać płatności. Ma ona też wpływ na dostępność metod płatności - karty są dostępne w każdej, a inne metody (np. szybkie przelewy) są dostępne tylko w CZK, EUR i PLN.

Waluta rozliczeniowa określa, w jakiej walucie środki ze sklepu zostaną wypłacone na konto merchanta. Domyślnie PayU rozlicza się z merchantem w tej samej walucie, w której była procesowana transakcja (1:1).

W zależności od wybranej waluty rozliczeniowej mogą wystąpić dodatkowe opłaty i ograniczenia w częstotliwości wypłat.

Poniższa tabela przedstawia spis walut transakcyjnych , w których PayU może rozliczać się z merchantem (1:1).

Dostępna jest także dodatkowa funkcjonalność (ICP) pozwalająca automatycznie przeliczyć walutę transakcyjną na wybraną przez merchanta walutę rozliczeniową – obecnie na EUR lub USD. W celu uzyskania dalszych informacji skontaktuj się z opiekunem handlowym bądź przez nasz formularz kontaktowy.

Poniższe parametry mogą być podane jako wartość pola language w obiekcie <Buyer>.

Tabela pokazuje wersje językowe dla strony wyboru metody płatności ("paywall"), formatki płatności kartą oraz wiadomości email z informacjami o płatności wysyłanej do płatnika.

Adres hosta

Produkcyjny:

https://secure.payu.com/

Sandbox:

https://secure.snd.payu.com/

Zaprzestanie wspierania starszych protokołów jest podyktowane względami bezpieczeństwa. Protokół TLS 1.2 to najlepszy sposób szyfrowania połączenia, zgodny z najwyższym standardem bezpieczeństwa PCI DSS 3.2.

Zmiana dotyczy wszelkiej komunikacji za pomocą HTTPS z systemem PayU i obejmuje wszystkie adresy REST API i Classic API.

Większość dostawców rozwiązań e-commerce oraz firm hostingowych dba o aktualizację oprogramowania, dlatego jeśli Twój serwis działa na gotowej platformie, najprawdopodobniej nie masz się czego obawiać. Możesz skontaktować się z dostawcami usług i zapytać, czy dokonali tej aktualizacji.

Jeśli Twój serwis korzysta z dedykowanego rozwiązania, upewnij się, że jest oparte o aktualną wersję protokołu. Poniższe informacje mogą być przydatne.

JAVA

Java 1.5 i wersje niższe nie wspierają TLS 1.2. Dla Javy 1.6, TLS 1.2 nie jest wspierany w publicznych aktualizacjach. Protokół ten jest wspierany w business editions od Oracle java version 6u115 b32.

W Java 1.7, TLS 1.2 jest wspierany, ale musi być jawnie włączony poprzez wybór protokołu w czasie tworzenia instancji SSLSocket & SSLEngine.

Więcej szczegółów: https://blogs.oracle.com/java-platform-group/jdk-8-will-use-tls-12-as-default

cURL

Curl wspiera TLS 1.2 od wersji 7.34.0. Poniższe polecenie testuje wersję szyfrowania połączenia.

Uwaga: test można wykonać dla dowolnego adresu - zob. zestawienie adresów REST API i Classic API.

curl --tlsv1.2 https://secure.payu.com/api/v2_1/orders

cURL+PHP

                    php -r '$ch = curl_init(); 
                    curl_setopt($ch, CURLOPT_URL, "https://secure.payu.com/api/v2_1/orders"); 
                    curl_setopt ($ch, CURLOPT_SSLVERSION, 6); 
                    var_dump(curl_exec($ch)); 
                    var_dump(curl_error($ch));'