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
Poniżej znajduje się lista metod płatności dostępnych w PayU. Aby upewnić się, że klient płaci tylko aktualnie dostępnymi metodami płatności, zalecamy skorzystanie z możliwości automatycznego pobierania metod płatności:
- Jeżeli korzystasz ze strony płatności PayU (używasz parametru
PAYMENT_WALLw sekcji payMethod lub nie używasz sekcjipayMethodw ogóle), zajmiemy się wszystkim, wraz z logotypami, które są aktualizowane automatycznie. - Jeżeli nie chcesz przekierowywać klienta na formatkę płatniczą, a zamiast tego chciałbyś aby cały proces płatniczy przebiegał na stronie twojego sklepu, PayU oferuje możliwość pobierania metod płatności.
- Jeżeli nadal korzystasz z Classic API (NewPayment) i nie planujesz wkrótce aktualizacji do REST API, skontaktuj się z nami.
Dzięki usłudze pobierania metod płatności nasz całodobowy monitoring dba o dezaktywację kanałów w przypadku planowanej konserwacji lub nieoczekiwanej awarii. Jeśli coś takiego by się wydarzyło, konsument może zapłacić kartą kredytową, jeśli jego bank nie jest w stanie przetworzyć przelewu w danym momencie.
Informacje na temat limitu czasu po jakim transakcje są automatycznie anulowane można znaleźć w sekcji Automatyczne anulowanie transakcji.
Metody płatności oparte na kartach płatniczych
| Wartość | Limity kwotowe | Opis | Księgowanie |
|---|---|---|---|
| c | 0,01 - 999999,99 | Karta płatnicza - płatność w CHF, EUR, GBP, USD. | 24h/7 |
| c | 0,05 - 999999,99 | Karta płatnicza - płatność w PLN, RON. | 24h/7 |
| c | 0,30 - 999999,99 | Karta płatnicza - płatność w CZK. | 24h/7 |
| c | 0,02 - 999999,99 | Karta płatnicza - płatność w BGN. | 24h/7 |
| c | 1,00 - 999999,99 | Karta płatnicza - płatność w RUB. | 24h/7 |
| c | 5 - 9999999 | Karta płatnicza - płatność w HUF. | 24h/7 |
| c | 0,50 - 9999999,99 | Karta płatnicza - płatność w innych walutach. | 24h/7 |
| jp | tak jak powyżej dla kart płatniczych | Źródłem danych kartowych jest portfel Apple Pay. Autoryzacja i rozliczenie odbywa się tak jak dla standardowej transakcji kartą płatniczą. W Panelu oraz na zestawieniach, transakcje te oznaczone są tak samo jak inne płatności kartą, tj. używając wartości 'jp' można wywołać płatność metodą Apple Pay, jednak utworzona płatność będzie już oznaczona metodą 'c'. O fakcie użycia Apple Pay mówi parametr paymentFlow, dostępny poprzez Pobieranie danych transakcji. | 24h/7 |
| ap | tak jak powyżej dla kart płatniczych | Źródłem danych kartowych jest portfel Google Pay (d. Android Pay). Autoryzacja i rozliczenie odbywa się tak jak dla standardowej transakcji kartą płatniczą. W Panelu oraz na zestawieniach, transakcje te oznaczone są tak samo jak inne płatności kartą, tj. używając wartości 'ap' można wywołać płatność metodą Google Pay, jednak utworzona płatność będzie już oznaczona metodą 'c'. O fakcie użycia Google Pay mówi parametr paymentFlow, dostępny poprzez Pobieranie danych transakcji. | 24h/7 |
| ma | tak jak powyżej dla kart płatniczych | Źródłem danych kartowych jest portfel Masterpass. Autoryzacja i rozliczenie odbywa się tak jak dla standardowej transakcji kartą płatniczą. W Panelu oraz na zestawieniach, transakcje te oznaczone są tak samo jak inne płatności kartą, tj. używając wartości 'ma' można wywołać płatność metodą Masterpass, jednak utworzona płatność będzie już oznaczona metodą 'c'. O fakcie użycia Masterpass mówi parametr paymentFlow, dostępny poprzez Pobieranie danych transakcji. | 24h/7 |
| vc | tak jak powyżej dla kart płatniczych | Źródłem danych kartowych jest portfel Visa Checkout. Autoryzacja i rozliczenie odbywa się tak jak dla standardowej transakcji kartą płatniczą. W Panelu oraz na zestawieniach, transakcje te oznaczone są tak samo jak inne płatności kartą, tj. używając wartości 'vc' można wywołać płatność metodą Visa Checkout, jednak utworzona płatność będzie już oznaczona metodą 'c'. O fakcie użycia Visa Checkout mówi parametr paymentFlow, dostępny poprzez Pobieranie danych transakcji. | 24h/7 |
Raty i Płacę Poźniej
Metoda płatności Raty | PayU jest dostępna tylko na rynku polskim.
Metoda płatności Twisto | PayU Płacę Później jest dostępna tylko na rynku polskim.
Metoda płatności PayPo | PayU Płacę Później jest dostępna tylko na rynku polskim.
Metoda płatności Płacę Później z Twisto jest dostępna na rynku czeskim.
| Wartość | Limity kwotowe (PLN) | Opis | Waluta |
|---|---|---|---|
| ai | 100,00 - 50000,00 * | PayU | Raty | PLN |
| dpt | 1,00 - 1500,00 | Twisto | PayU Płacę później (Polska) | PLN |
| dpp | 10,00 - 2000,00 | PayPo | PayU Płacę później (Polska) | PLN |
| dpcz | 3,00 - 999999,99 | Płacę Później z Twisto (Czechy) | CZK |
| dpts | 1500,00 - 100000,00 | Twisto Podziel na 3 (Czechy) | CZK |
- * - w zależności od wariantu.
Polskie szybkie przelewy pay-by-link (PLN)
| Wartość | Limity kwotowe (PLN) | Opis | Księgowanie |
|---|---|---|---|
| blik | 0,01 - 49999,99 | BLIK | 24h/7 |
| m | 0,37 - 999999,99 | mTransfer - mBank | 24h/7 |
| w | 0,37 - 999999,99 | Przelew24 - Santander (form. BZ WBK) | 24h/7 |
| o | 0,37 - 999999,99 | Pekao24Przelew - Bank Pekao | 24h/7 |
| i | 0,37 - 999999,99 | Płacę z Inteligo | 24h/7 |
| p | 0,37 - 999999,99 | Płać z iPKO | 24h/7 |
| g | 0,37 - 999999,99 | Płać z ING | 24h/7 |
| gbx | 1,00 - 999999,99 | Płacę z VeloBank | 24h/7 |
| l | 0,37 - 999999,99 | Credit Agricole | 24h/7(*) |
| ab | 0,37 - 999999,99 | Płacę z Alior Bankiem | 24h/7 |
| ps | 0,37 - 999999,99 | Płacę z Bankiem Nowym S.A. (d. PBS) | 01:00 – 23:30, 24h w weekendy |
| wm | 0,37 - 999999,99 | Przelew z Millennium | 24h/7 |
| wc | 0,37 - 999999,99 | Przelew z Citi Handlowego | 24h/7 |
| bo | 0,37 - 999999,99 | Płać z BOŚ | 24h/7 |
| bnx | 0,37 - 999999,99 | BNP Paribas | 24h/7 |
| bs | 0,50 - 999999,99 | Banki Spółdzielcze | 24h/7 |
| nstb | 0,50 - 999999,99 | Nest bank | 24h/7 |
| plsb | 0,50 - 999999,99 | Plus Bank | 24h/7 |
| b | 0,50 - 999999,99 | Przelew bankowy |
Czeskie szybkie przelewy pay-by-link (CZK)
| Wartość | Limity kwotowe (CZK) | Opis |
|---|---|---|
| cs | 3,00 - 999999,99 | Česká spořitelna |
| mp | 3,00 - 999999,99 | mBank |
| kb | 3,00 - 999999,99 | Komerční banka |
| rf | 3,00 - 999999,99 | Raiffeisenbank |
| pg | 3,00 - 999999,99 | Moneta Money Bank |
| pf | 3,00 - 999999,99 | Fio banka |
| cb | 3,00 - 999999,99 | ČSOB |
| uc | 3,00 - 999999,99 | UniCredit |
| bt | 3,00 - 999999,99 | Bank transfer |
| pt | 3,00 - 999999,99 | Postal transfer |
Słowackie szybkie przelewy pay-by-link (EUR)
| Wartość | Limity kwotowe (EUR) | Opis | Księgowanie |
|---|---|---|---|
| posta | 0,5 - 999999,99 | Poštová banka, a. s. | 24h/7 |
| sporo | 0,5 - 999999,99 | Slovenská sporiteľňa, a. s. | 24h/7 |
| tatra | 0,5 - 999999,99 | Tatra banka, a. s. | 24h/7 |
| viamo | 0,5 - 999999,99 | Viamo | 24h/7 |
| vub | 0,5 - 999999,99 | Všeobecná úverová banka, a. s. | 24h/7 |
Międzynarodowe metody płatności
Skontaktuj się z opiekunem handlowym w celu ich udostępnienia.
| Wartość | Limity kwotowe (rownowartość w EUR) | Opis | Typ | Dostępność | Waluta |
|---|---|---|---|---|---|
| gp | 1,00 - 999999,99 | GiroPay | pbl | DE | EUR |
| pbc | 1,00 - 999999,99 | Bancontact | karta płatnicza | BE | EUR |
| pid | 1,00 - 999999,99 | iDEAL | pbl | NL | EUR |
| pmb | 1,00 - 999999,99 | MyBank | przelew tradycyjny / pbl | IT | EUR |
| pscd | 1,00 - 1000,00 | PaySafeCard | voucher prepaid | AT, BE, CY, DE, ES, FI, FR, IT, LI, LT, LU, MT, NL, PT, SI, SK | EUR |
| sb | 1,00 - 999999,99 | Sofort Banking | przelew tradycyjny/ pbl | AT, BE, CH, DE, ES, GB, IT, NL | EUR, GBP*, CHF* |
| sdd | 1,00 - 1000,00 | SEPA Direct Debit | polecenie zapłaty | AT, BE, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HR, HU, IE, IS, IT, LI, LT, LU, LV, MC, MT, NL, NO, PT, RO, SE, SI, SK, SM | EUR |
| pmbc | 1,00 - 99999,99 | Multibanco | pbl | PT | EUR |
| ptrl | 1,00 - 1000,00 | Trustly | pbl | DE, DK, EE, ES, FI, GB, LT, LV, NL, NO, PT, SE, SK | EUR, DKK*, GBP*, NOK*, SEK* |
- CHF* - tylko w połączeniu z kodem kraju CH,
- DKK* - tylko w połączeniu z kodem kraju DK,
- GBP* - tylko w połączeniu z kodem kraju GB,
- NOK* - tylko w połączeniu z kodem kraju NO,
- SEK* - tylko w połączeniu z kodem kraju SE.
Automatyczne anulowanie transakcji
| Metody płatności | Transakcje nieopłacone | Czekające na odbiór |
|---|---|---|
| Płatności kartami | 1 godzina | 5 dni |
| Raty i płacę później | 5 dni - dla Rat (ai) 10 dni - dla innych metod | 5 dni - dla Rat (ai) 10 dni - dla innych metod |
| Polskie przelewy pay-by-link (PLN) | 5 dni (10 dni dla metody "Przelew bankowy" (b)) | 10 dni |
| Czeskie przelewy pay-by-link (CZK) | 14 dni - dla przelewu bankowego (bt) i przekazu pocztowego (pt) 10 dni - dla innych metod | 14 dni - dla przelewu bankowego (bt) i przekazu pocztowego (pt) 10 dni - dla innych metod |
| Slowackie przelewy pay-by-link (EUR) | 10 dni | 10 dni |
| Międzynarodowe metody płatności | 5 dni - dla GiroPay (gp) 10 dni - dla innych metod | 10 dni |
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 |
| HRK | kuna chorwacka |
| 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 | Widget | |
|---|---|---|---|---|---|
| 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.
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.