Szybki start

1 Szybki start z płatnościami

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

Przed rozpoczęciem procesu integracji należy się upewnić, że punkt płatności na którym będą realizowane zamówienia jest typu Checkout - Express Payment (do sprawdzenia na ekranie sklepów w Panelu Managera).

Skopiuj poniższy kod i umieść go w kodzie strony, na której chciałbyś mieć usługę płatności on-line. Zapisz zmiany w źródle strony.

<form method="post" action="https://secure.payu.com/api/v2_1/orders">
    <input type="hidden" name="continueUrl" value="http://shop.url/continue">
    <input type="hidden" name="currencyCode" value="PLN">
    <input type="hidden" name="customerIp" value="123.123.123.123">
    <input type="hidden" name="description" value="Order description">
    <input type="hidden" name="merchantPosId" value="145227">
    <input type="hidden" name="notifyUrl" value="http://shop.url/notify">
    <input type="hidden" name="products[0].name" value="Product 1">
    <input type="hidden" name="products[0].quantity" value="1">
    <input type="hidden" name="products[0].unitPrice" value="1000">
    <input type="hidden" name="totalAmount" value="1000">
    <input type="hidden" name="OpenPayu-Signature" value="sender=145227;algorithm=SHA-256;signature=bc94a8026d6032b5e216be112a5fb7544e66e23e68d44b4283ff495bdb3983a8">
    <button type="submit" formtarget="_blank" >Pay with PayU</button>
</form >
            

Odśwież stronę, aby zobaczyć przycisk.

Szczegółowe instrukcje na temat tworzenia płatności PayU poprzez formularz znajdziesz w sekcji Integracja formularza zamówienia dokumentacji REST API.

1.1 Style CSS

Dodaj definicję styli CSS.

Możesz ją umieścić w sekcji <head> swojej strony lub w oddzielnym pliku ze stylami, który jest dołączony do Twojej strony. Ostylowanie pozwoli na to, aby usługa płatności on-line była dobrze widoczna i rozpoznawalna dla Twoich klientów.

<style>
#payu-payment-form button[type=submit] {
    border: 0px;
    height: 35px;
    width: 140px;
    background: url('http://static.payu.com/pl/standard/partners/buttons/payu_account_button_long_03.png');
    background-repeat: no-repeat;
    cursor: pointer;
}
</style>
            

Odśwież stronę, aby zobaczyć przycisk.

1.2 Przykład

Powinieneś zobaczyć dokładnie taki sam przycisk jak poniżej.

Kliknij w niego - po przekierowaniu zobaczysz stronę, na której Twoi klienci mogą dokonać płatności.

Gratulacje! Właśnie zintegrowałeś usługę płatności on-line ze swoim sklepem.

Zauważ, że wdrożona usługa wykorzystuje wartości testowe. Aby skonfigurować ją do działania z Twoim sklepem, musisz wprowadzić wartości przypisane do Twojego konta sprzedawcy w PayU.

Odśwież stronę, aby zobaczyć przycisk.

2 Terminologia

PayU Licencjonowany dostawca usług płatniczych (tzw. PSP) oraz acquirer (członek organizacji Visa i MasterCard). Dla celów tej dokumentacji PayU oznacza także aplikację do rozliczania płatności.
Merchant Merchant (lub akceptant płatności) to podmiot, który zawarł umowę z PayU i został zarejestrowany w PayU. Na poziomie aplikacji PayU, "merchant" to zestaw encji: Firma/Sklep/POS (zob. wpisy poniżej).
Panel Panel Menadżera lub Panel Administracyjny to interfejs użytkownika aplikacji PayU udostępniany merchantom. Odnośnik do panelu jest wysyłany do użytkowników w trakcie rejestracji merchanta w PayU. Opis panelu można pobrać tutaj.
Firma Podmiot korzystający z mechanizmów PayU w celu odbioru środków pieniężnych od klienta. Cechami Firmy są nazwa, adres, numer identyfikacji podatkowej itp.
Sklep Sklep internetowy odbierający płatności; jedna firma może posiadać kilka sklepów.
POS Punkt usługowy realizujący odbieranie płatności. Dla danego punktu usługowego definiowane są wszystkie parametry usługi. Jeden Sklep może posiadać kilka punktów usługowych.
Klient / Płacący / Kupujący Osoba dokonująca płatności, klient sklepu internetowego.
UrlSecure.payu.com Adres URL, pod którym jest zainstalowana aplikacja PayU (https://secure.payu.com/paygw)
Adres powrotu - poprawnie Adres URL aplikacji Sklepu, pod który Klient jest przekierowany po prawidłowym rozpoczęciu transakcji
Adres powrotu - błąd Adres URL aplikacji Sklepu, pod który Klient jest przekierowany po błędnym rozpoczęciu transakcji
Adres raportów Adres URL aplikacji Sklepu, pod który są wysyłane za pomocą metody POST informacje o zmianie stanu płatności – raporty

3 Typy płatności

Karty płatnicze
Nazwa Wartość transakcji Czas auto anulowania (dni) Opis Księgowanie
c 0,50 - 7000,00 5 Karta płatnicza - transakcja w PLN 24h/7
c 3,00 - 7000,00 5 Karta płatnicza, transakcja w CZK 24h/7
c 0,50 - 7000,00 5 Karta płatnicza - transakcja w EUR 24h/7
c 0,50 - 7000,002 5 Karta płatnicza - transakcja w RUB 24h/7
c 10 - 700000,002 5 Karta płatnicza - transakcja w HUF 24h/7
ma tak jak powyżej dla kart płatniczych 5 Masterpass to źródło danych karty - 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 "payment flow", dostępny poprzez payment/get lub Transaction Data Retrieve. 24h/7
Polskie
Nazwa Wartość transakcji (PLN) Czas auto anulowania (dni) Opis Księgowanie
blik 1,00 - 999999,99 10 BLIK 24h/7
m 0,37 - 999999,99 10 mTransfer - mBank 24h/7
mtex 1,00 - 999999,99 10 mTransfer mobilny - mBank(*) 24h/7
w 0,37 - 7000,00 10 BZWBK - Przelew24 24h/7
o 0,37 - 999999,99 10 Pekao24Przelew - Bank Pekao 24h/7
i 0,37 - 999999,99 10 Płacę z Inteligo 24h/7
p 0,37 - 999999,99 10 Płać z iPKO 24h/7
pkex 1,00 - 999999,99 10 PayU Express Bank Pekao(*) 24h/7
g 0,37 - 999999,99 10 Płać z ING 24h/7
gbx 1,00 - 999999,99 10 Płacę z Getin Bank 24h/7
gbex 1,00 - 999999,99 10 GetIn Bank PayU Express(*) 24h/7
nlx 1,00 - 999999,99 10 Płacę z Noble Bank 24h/7
nlex 1,00 - 999999,99 10 Noble Bank PayU Express(*) 24h/7
ib 0,50 - 999999,99 10 Paylink Idea - IdeaBank 03:00-22:00
l 0,50 - 999999,99 10 Credit Agricole 03:00-24:00
as 0,37 - 999999,99 10 Płacę z T-mobile Usługi Bankowe dostarczane przez Alior Bank 24h/7
exas 1,00 - 500 (po przekroczeniu max. wartości lub w przypadku negatywnej oceny ryzyka transakcji przez PayU transakcja jest realizowana typem płatności  Płacę z T-mobile Usługi Bankowe dostarczane przez Alior Bank [as]) 10 PayU Express T-mobile Usługi Bankowe(*) 24h/7
u 0,37 - 999999,99 10 Eurobank 05:00-22:00
ab 0,37 - 999999,99 10 Płacę z Alior Bankiem 24h/7
exab 0,37-500 (po przekroczeniu max. wartości lub w przypadku negatywnej oceny ryzyka transakcji przez PayU transakcja jest realizowana typem płatności  Płacę z AliorBankiem [ab]) 10 PayU Express z Alior Bankiem(*) 24h/7
ps 0,37 - 999999,99 10 Płacę z PBS 1:30-23:30
wm 0,37 - 999999,99 10 Przelew z Millennium 24h/7
h 0,37 - 999999,99 10 Przelew z BPH 5:00-21:00
wd 0,50 - 999999,99 10 Przelew z Deutsche Banku 24h/7
wr 1,00 - 999999,99 10 Raiffeisen POLBANK(**) 05:00-22:00
wc 0,37 - 999999,99 10 Przelew z Citi Handlowego 24h/7
bo 0,37 - 999999,99 10 Płać z BOŚ 24h/7
bnx 0,37 - 999999,99 10 Płacę z BNP Paribas 24h/7
bnex 0,37 - 999999,99 10 BNP Paribas PayU Express(*) 24h/7
orx 1,00 - 999999,99 10 Płacę z Orange 24h/7
orex 1,00 - 999999,99 10 PayU Express Orange(*) 24h/7
b 0,50 - 999999,99 10 Przelew bankowy
pu W zależności od wyboru kanału płatności parametr przyjmuje wartość odpowiednią dla danego kanału płatności. Konto PayU. Więcej informacji o koncie PayU znajduje się w sekcji "Konto PayU"
ai 300,00 - 20000,00 5 Raty PayU
t 0,50 - 1000,00 1 płatność testowa - zostanie wyświetlony formularz, w którym można bezpośrednio zmienić status transakcji

(*) typ platności dostepny jest dla: Konta PayU oraz PayU | Express

(**) proces półautomatyczny

Czeskie
Nazwa Wartość transakcji (CZK) Czas auto anulowania (dni) Opis
cs 3,00 - 999999,99 10 PLATBA 24 - Česká spořitelna
mp 3,00 - 999999,99 10 mTransfer - mBank
kb 3,00 - 999999,99 10 MojePlatba – Komerční banka
rf 3,00 - 999999,99 10 ePlatby pro eKonto - Raiffeisenbank
pg 3,00 - 999999,99 10 Moneta Money Bank
pv 3,00 - 999999,99 10 Sberbank
pf 3,00 - 999999,99 10 Fio banka
era 3,00 - 999999,99 10 Era - Poštovní spořitelna
cb 3,00 - 999999,99 10 ČSOB
uc 3,00 - 999999,99 10 UniCredit
bt 3,00 - 999999,99 14 Bankovní převod
pt 3,00 - 999999,99 14 Převod přes poštu (poštovní poukázkou)

3.1 Konto PayU

Włączenie usługi konta PayU polega na ustawieniu wartości ‘pu’ w polu pay_type. Można to zrobić na trzy sposoby:

  1. ręcznie, w przypadku gdy integracja polega na zbudowaniu predefiniowanego formularza;
  2. dynamicznie, korzystając z pluginu javascript (patrz: "narzędzia WWW");
  3. automatycznie, korzystając z usługi udostepniającej dane o kanałach płatności w pliku xml (patrz: "narzędzia WWW").

Konto PayU pozwala kupującemu predefiniować i skonfigurować preferowane przez niego kanały płatności. Dodatkowo, jeśli kupujący korzysta z karty płatniczej może zapisać jej dane w koncie PayU. Przy kolejnych transakcjach wykonywanych kartą nie będzie już potrzeby wprowadzania tych danych ponownie (płatność zatwierdzana jest jednym kliknięciem), co usprawnia proces zakupowy.

Należy jednak zwrócić uwagę na fakt iż zintegrowane w ten sposób Konto PayU nie udostępnia wszystkich możliwości konta PayU. Przede wszystkim nie jest możliwa wymiana informacji o adresie przesyłki i/lub faktury, zapisanych przez kupującego w koncie PayU.

Aby uzyskać pełne wdrożenie konta PayU można posłużyć się dokumentacją.

3.2 Test-t

Typ test służy do generowania płatności testowych, środki pozyskane z takich transakcji nie są przekazywane do Sklepu, typ ten nie wymaga żadnych dodatkowych parametrów dla nowej płatności.

Transakcje testowe są domyślnie wyłączone, są również automatycznie blokowane po 3 dniach od ostatniego ich użycia. W celu przeprowadzania testów należy aktywować ten rodzaj płatności za pomocą opcji Moje sklepy > Nazwa sklepu > Lista punktów płatności > Nazwa punktu, następnie zmieniamy status dla „Płatności testowej” poprzez kliknięcie w kolumnie Stan.

4 Zestawienie endpointów

Przed rozpoczęciem analizy pełnej dokumentacji REST API, warto zapoznać się w skrócie z wszystkim żądaniami oferowanymi w tym protokole integracji.
Adres Metoda HTTP Komentarz Pełne omówienie
/pl/standard/user/oauth/authorize POST Dostarcza token autoryzacyjny (OAuth). Uwierzytelnienie komunikatów
api/v2_1/paymethods POST Dostarcza aktualnie dostępne metody płatności. Pobranie metod płatności
/api/v2_1/orders POST Tworzy zamówienie i umożliwia przeprowadzenie płatności. Tworzenie nowego zamówienia przez API
/api/v2_1/orders/{orderId} GET Pozwala pobrać dane i status zamówienia. Pobrania danych zamówienia
/api/v2_1/orders/{orderId} DELETE Pozwala anulować zamówienie. Anulowanie zamówienia
/api/v2_1/orders/{orderId}/transactions GET Pozwala pobrać szczegóły płatności (dane konta bankowego lub karty płatniczej). Pobranie danych transakcji
/api/v2_1/orders/{orderId}/status PUT Pozwala odebrać (rozliczyć) opłacone zamówienie. Odebranie zamówienia
/api/v2_1/orders/{orderId}/refunds POST Pozwala na pełne lub częściowe zwroty (uznania) do płatności. Zwroty
/api/v2_1/payouts POST Pozwala zlecić wypłatę bezpośrednio z aplikacji sklepu (wypłaty automatyczne i ad hoc są też dostępne poprzez Panel). Wypłaty
/api/v2_1/reports/{reportId} GET Pozwala pobrać wygenerowane zestawienie transakcji (zestawienia automatyczne i ad hoc są też dostępne poprzez Panel). Zestawienia