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?
Jeśli tak, zbuduj swoją własną stronę płatniczą.
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.
Ś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).
| Kod | Nazwa |
|---|---|
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.
| Kod | Język | Strona wyboru metody | Formatka kartowa | Secure Form | |
|---|---|---|---|---|---|
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 | Tak |
es | hiszpański | Tak | Tak | Tak | Tak |
et | estoński | Nie | Tak | Nie | Tak |
fi | fiński | Nie | Tak | Nie | Tak |
fr | francuski | Nie | Tak | Tak | Tak |
hr | chorwacki | Nie | Tak | Tak | Tak |
hu | węgierski | Nie | Tak | Tak | Tak |
it | włoski | Tak | Tak | Tak | Tak |
lt | litewski | Nie | Tak | Tak | Tak |
lv | łotewski | Nie | Tak | Tak | Tak |
nl | niderlandzki | Tak | Tak | Tak | Tak |
pt | portugalski | Nie | Tak | Nie | Tak |
ro | rumuński | Nie | Tak | Tak | Tak |
ru | rosyjski | Nie | Tak | Nie | Tak |
sk | słowacki | Tak | Tak | Tak | Tak |
sl | słoweński | Nie | Tak | Nie | Tak |
sr | serbski | Nie | Tak | Nie | Tak |
sv | szwedzki | Nie | Tak | Tak | Tak |
tr | turecki | Nie | Tak | Tak | Tak |
uk | ukraiński | Nie | Tak | Tak | Tak |
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.
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.
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.