Zestawienia

Cechy zestawienia

Zestawienia to obszerne raporty dostarczające szczegółowego podsumowania zrealizowanych transakcji zakupu, zwrotów i wypłat.

Notatka

Generowanie zestawień, które będą wysyłane na adres URL w celu pobrania przez API, wymaga konfiguracji na poziomie firmy. W związku z tym, aby umożliwić taką konfigurację, skontaktuj się z działem wsparcia PayU.

Zestawienia są dostępne w formacie plików: .csv, .pdf i .abo* (*jedynie dla rynku czeskiego)

Zestawienia mogą być:

wysłane jako załącznik na adres e-mail (w formacie .zip),
pobrane z panelu merchanta,
pobrane przez API.

Opis pól w formacie .csv

Poniższa tabela przedstawia opis wszystkich dostępnych pól danych w najpopularniejszym i najbardziej elastycznym formacie (.csv) wraz z odniesieniem do powiązanych pól w REST API i Classic API.

Kolejność i zakres pól w zestawieniu jest dowolna. Przy tworzeniu zestawienia istnieje możliwość ustawienia kolumn według własnych preferencji.

Opisy pól pliku w formacie .csv

Nazwa kolumny	Classic API	REST API	Typ danych	Opis
Data	trans_recv	localReceiptDateTime	yyyy-mm-dd	Data zakończenia transakcji.
ID transakcji	trans_id	properties.payment_id	NUM {0,10}	ID transakcji przypisane przez PayU.
Kwota	amount	amount	NUM {2,14}	Kwota rozliczenia (1,00).
Waluta	n/a	currencyCode	STR {3}	Waluta rozliczeniowa.
Typ operacji	n/a	n/a	STR {1,4}	Most common values: t - transakcja zakupu, r - prowizja naliczona przez PayU, c - zwrot (credit), w - wypłata na konto bankowe merchanta, wc - anulowanie wypłaty na konto bankowe merchanta, cr - prowizja naliczona przez PayU dotycząca płatności ratalnych, rc – zwrot prowizji naliczonej przez PayU, bc – korekta rozliczenia (prowizji), nt – operacja bez zmiany salda rachunku akceptanta, or – zwrot nadpłaty, orc – anulowanie zwrotu nadpłaty. .
Saldo	n/a	n/a	NUM {2,14}	Saldo konta merchanta po transakcji.
Zmiana salda	n/a	n/a	BOOL	TRUE/FALSE.
Order ID	order_id	extOrderId	STR {1,1024}	Identyfikator zamówienia/zakupu podany przez merchanta.
Opis	desc	description	STR {1,50}	Opis zamówienia podany przez merchanta (lub przez PayU, jeżeli typ transakcji jest powiązany z opłatami/prowizją).
Opis2/nr konta	desc2	additionalDescription	STR {0,50}	Rozszerzony opis zamówienia podany przez merchanta lub numer rachunku bankowego - jeżeli typem operacji jest wypłata (w, wc).
Typ płatności	trans_pay_type	payMethod value	STR {1,4}	Metoda płatności wybrana przez płatnika (dostępne wartości można znaleźć tutaj).
Id sesji	session_id	extOrderId	STR {1,1024}	Identyfikator płatności podany przez merchanta.
Miasto	city	buyer.delivery.city	STR {0,50}	Adres dostawy - miejscowość.
Kod	post_code	buyer.delivery.postalCode	STR {0,25}	Adres dostawy - kod pocztowy.
Telefon	phone	buyer.phone	STR {0,100}	Numer telefonu płatnika.
E-mail	email	buyer.email	STR {0,100}	Adres e-mail płatnika.
Ulica	street	buyer.delivery.street	STR {0,150}	Adres dostawy - ulica.
Imię i nazwisko	first_name, last_name	buyer.firstName, buyer.lastName	STR {0,200}	Imię i nazwisko płatnika.
Kwota operacji	n/a	n/a	NUM {2,14}	Operacyjna kwota transakcji, zwrotu, korekt lub wypłat (1,00). Pole specyficzne ICP.
Waluta operacji	n/a	n/a	STR {3}	Waluta operacyjna. Pole specyficzne ICP.
Prowizja	n/a	n/a	NUM {2,14}	Prowizja PayU: wartość ujemna - potrącona od kwoty transakcji; wartość dodatnia - bez potrąceń, płatne po wystawieniu faktury (post-paid).
Waluta prowizji	n/a	n/a	STR {3}	Waluta prowizji.
Kurs wymiany	n/a	n/a	NUM {20,10}	Kurs wymiany dla sklepu z różną walutą: transakcyjną i rozliczeniową. Pole specyficzne ICP.
Godzina	n/a	n/a	{hh-mm-ss} 24 hour format	Czas, w którym płatność została rozliczona.
ID punktu sprzedaży	pos_id	merchantPosId	STR {1,7}	Identyfikator punktu płatności, na którym dokonano transakcji.
Nazwa punktu sprzedaży	n/a	n/a	STR	Nazwa punktu płatności ustalona przez merchanta w Panelu Menadżerskim PayU.
Płatność podzielona	n/a	n/a	BOOL	Pokazuje czy płatność była typu split payment.
Publiczny identyfikator wypłaty	n/a	payout.payoutId	STR	Identyfikaor nadany przez PayU - może być pobrany przez API.
Zewnętrzny identyfikator wypłaty	n/a	payout.extPayoutId	STR	Unikalny identyfikator wypłaty nadany przez merchanta (wymagana jest niepowtarzalność w zakresie sklepu).
Nazwa sklepu	n/a	n/a	STR	Zdefiniowany w Panelu Menadżerskim PayU.

Pobieranie zestawień poprzez API

Notatka

Włączenie tej funkcjonalności wymaga specjalnej konfiguracji po stronie PayU. Aby z niej korzystać skontaktuj się z nami poprzez formularz kontaktowy.

Otrzymywanie powiadomień o zestawieniach i pobieranie samych zestawień porzez API wymaga ustawienia opcji "Tryb notyfikacji" (na ekranie "Tworzenie zestawienia" w panelu menedżerskim) na Notify url.

Powiadomienia o zestawieniach

Notyfikacja w formie XML zostanie wysłana gdy zestawienie będzie gotowe do pobrania.

Przykład powiadomienia do zestawienia
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <reportNotifyRequest xmlns="http://www.openpayu.com/public/21/openpayu">
    <report>
     <reportId>4a3534fb-85b5-4f29-9da8-a6d73b34d528</reportId>
     <reportPlanId>635601897450895020</reportPlanId>
     <reportUrl>https://secure.payu.com/api/v2_1/reports/4a3534fb-85b5-4f29-9da8-a6d73b34d528</reportUrl>
     <status>READY</status>
    </report>
   </reportNotifyRequest>

Gdzie:

<reportId> - identyfikator raportu;
<reportPlanId> - identyfikator reportu przypisany do merchanta;
<reportUrl> - url the report is availabe adres url, na którym jest dostępny raport;
<status> - status raportu.

Pobieranie zestawienia

Ciało żądania metody GET

Wysyłając żądania z metodą GET upewnij się, że w ciele żądania nie przesyłasz żadnych danych. Zgodnie ze standardem RFC 9110 żądania, które nie spełniają tego wymogu, zostaną odrzucone przez PayU i zwrócony zostanie kod HTTP 403.

Po otrzymaniu notyfikacji, wywołaj adres zawarty w reportUrl uzywając metody HTTP GET. W nagłówku żądania powinien się znaleźć:

Authorization: Basic {string}

Gdzie {string} jest ciągiem znaków, zakodowanym w base64, składającym się z dwóch członów połączonych dwukropkiem **posId:Drugi klucz (MD5) - pamiętaj o dwukropku pomiedzy wartościami posId i drugiego klucza!

Do zautoryzowania żądania musisz użyć POS'a wybranego w panelu menedżerskim PayU podczas generowania zestawienia. Jeżeli w sklepie znajduje się tylko jeden POS, może on zostać użyty jako domyślny POS do zestawień dla tego sklepu. Próba autoryzacji z innym POS'em zakończy się błędem. Pojawienie się błędu HTTP 404 będzie wskazywało na próbę pobrania zestawienie dla innego POS'a (zestawienie nie może zostać odnalezione dla użytego POS).

Transakcje ICP w zestawieniach

ICP jest rozwiązaniem dedykowanym dla sprzedawców działających na rynkach międzynarodowych, którzy chcą otrzymywać wypłaty w walucie innej niż waluta transakcji.

Ważne pola dla transakcji ICP

W poniższej tabeli zawarto główne kolumny zawierające dane dotyczące przewalutowania w transakcjach ICP:

Ważne pola przy transakcjach ICP

Nazwa kolumny	Classic API	REST API	Typ danych	Opis
Kwota operacji	n/a	n/a	NUM {2,14}	Oryginalna kwota transakcji, zwrotu, korekt lub wypłat (1,00).
Waluta operacji	n/a	n/a	STR {3}	Oryginalna waluta transakcji.
Kurs wymiany	n/a	n/a	NUM {20,10}	Kurs wymiany dla sklepu z różnymiącymi walutami: transakcyjną i rozliczeniową.

Przykład zestawienia z transakcjami ICP

Możesz pobrać przykładowe ICP_transactions_statement.csv (3.54KB). W przykładzie zaprezentowano tylko wybrane pola.

Cechy zestawienia​

Opis pól w formacie .csv​

Pobieranie zestawień poprzez API​

Powiadomienia o zestawieniach​

Pobieranie zestawienia​

Transakcje ICP w zestawieniach​

Ważne pola dla transakcji ICP​

Przykład zestawienia z transakcjami ICP​

Na tej stronie