Przejdź do głównej zawartości

Wprowadzenie

Na tej stronie znajdziesz podstawowe informacje dotyczące płatności PayU. Obejmuje ona szereg tematów, w tym dostępne metody płatności, obsługiwane języki i waluty oraz wiele innych.

W PayU oferujemy REST API, które umożliwia tworzenie, rozliczanie, anulowanie i pobieranie zamówień, dokonywanie wypłat i nie tylko.

Aby uprościć integrację, możesz użyć jednej z naszych wtyczek. Możesz także wykorzystać nasze biblioteki PHP SDK lub Mobilne SDK. Ponadto wiele platform sklepowych oferuje wbudowaną integrację z PayU. Jeśli platforma, z której korzystasz, jest jedną z nich, postępuj zgodnie z instrukcjami na jej stronie, aby szybko skonfigurować płatność za pośrednictwem PayU.

Dla ułatwienia procesu płatności klientom, oferujemy obsługę wielu walut wraz z możliwością akceptowania płatności w walutach innych niż waluta sklepu. Ponadto, nasze formularze zostały przetłumaczone na różne języki.

Wybór rozwiązania

Przed rozpoczęciem ważne jest, aby wybrać odpowiednie rozwiązania dla swoich potrzeb. Dostępnych jest kilka opcji. Usługa, którą należy zintegrować i konfiguracja konta mogą zależeć od wielu czynników:

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ć lub anulować i zwrócić środki.

Czy sprzedajesz wysokokwotowe towary lub usługi?

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

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

Jeśli tak, rozważ 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?
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.

Dostępne środowiska

PayU zapewnia dwa środowiska robocze: produkcyjne i testowe (sandbox).

Twoja organizacja będzie głownie korzystać ze środowiska produkcyjnego. Na którym będą przetwarzane wszystkie płatności twoich klientów. Cała ta sekcja jest poświęcona rozpoczęciu pracy w tym środowisku.

Oprócz środowiska produkcyjnego oferujemy również środowisko testowe Sandbox. Sandbox jest oddzielną jednostką, która pozwala przetestować integrację i różne funkcjonalności oferowane przez payu, bez rzeczywistego przepływu gotówki. Więcej informacji na temat środowiska Sandbox i samego testowania można znaleźć w sekcji Testowanie integracji.

Notatka

Środowiska Produkcyjne i Sandbox są całkowicie oddzielnymi bytami i nie są w żaden sposób połączone. Jeżeli chcesz korzystać z obu środowisk, musisz założyć konto na każdym z nich.

Metody Płatności

Aby uzyskać pełną listę metod płatności PayU, odwiedź sekcję poświęconą metodom płatności.

Waluty

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

  • waluty transakcyjnej,
  • 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:

  • płatności kartami są dostępne w każdej walucie,
  • inne metody płatności (np. przelew bankowy) dostępne są 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 się z Tobą rozliczać (1:1).

Waluty
KodNazwa
CHF
frank szwajcarski
CZK
korona czeska
DKK
korona duńska
EUR
euro
GBP
funt szterling
HUF
forint węgierski
NOK
korona norweska
PLN
złoty polski
RON
lej rumuński
SEK
korona szwedzka
USD
dolar amerykański

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.

Dostępne języki

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.

Dostępne języki
KodJęzykStrona wyboru metodyFormatka kartowaEmailWidget
pl
polski
Tak
Tak
Tak
Tak
en
angielski
Tak
Tak
Tak
Tak
cs
czeski
Tak
Tak
Tak
Tak
bg
bułgarski
Nie
Tak
Tak
Tak
da
duński
Nie
Tak
Tak
Tak
de
niemiecki
Tak
Tak
Tak
Tak
el
grecki
Nie
Tak
Tak
Nie
es
hiszpański
Tak
Tak
Tak
Tak
et
estoński
Nie
Tak
Nie
Tak
fi
fiński
Nie
Tak
Nie
Nie
fr
francuski
Nie
Tak
Tak
Tak
hr
chorwacki
Nie
Tak
Tak
Nie
hu
węgierski
Nie
Tak
Tak
Tak
it
włoski
Tak
Tak
Tak
Tak
lt
litewski
Nie
Tak
Tak
Nie
lv
łotewski
Nie
Tak
Tak
Nie
nl
niderlandzki
Tak
Tak
Tak
Nie
pt
portugalski
Nie
Tak
Nie
Nie
ro
rumuński
Nie
Tak
Tak
Tak
ru
rosyjski
Nie
Tak
Nie
Nie
sk
słowacki
Tak
Tak
Tak
Tak
sl
słoweński
Nie
Tak
Nie
Nie
sr
serbski
Nie
Tak
Nie
Nie
sv
szwedzki
Nie
Tak
Tak
Nie
tr
turecki
Nie
Tak
Tak
Nie
uk
ukraiński
Nie
Tak
Tak
Nie

Szyfrowanie połączenia

Od 30 czerwca 2018 PayU wspier wyłącznie protokół TLS 1.2.

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.

SNI (Server Name Indication).

Od 09.12.2023 w celu poprawnego nawiązania połączenia TLS z serwerami PayU będzie wymagane rozszerzenie SNI (Server Name Indication).

Rozszerzenie SNI zostało zaproponowane w 2003 roku (rfc3546) i jest obecnie szeroko stosowanym standardem. SNI jest od wielu lat obsługiwane przez przeglądarki internetowe oraz wspierane przez biblioteki wiodących języków programowania.

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 znajdziesz na blogu Oracle.

cURL

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

CLassic API

Test można wykonać dla dowolnego adresu - zob. zestawienie adresów. Jeżeli potrzebujesz pomocy z integracją Classic API (niezalecane), skontaktuj się z naszym działem wsparcia.

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

Jeśli połączenie działa, pojawi się komunikat Unauthorized.

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));'

Jeśli połączenie działa, pojawi się komunikat "Unauthorized". TLS 1.1 i TLS 1.2 są wspierane od wersji OpenSSL 1.0.1. Wymuszanie TLS 1.1 i 1.2 jest wspierane dopiero od curl 7.34.0.