Zwroty i podgląd transakcji w InPost Pay

W tym rozdziale dowiesz się, jak obsługiwać zwroty i jak śledzić transakcje realizowane za pośrednictwem InPost Pay. Znajdziesz tutaj także informacje o integracji z API, które pozwala na pełną automatyzację tych procesów w Twoim systemie.

Podgląd transakcji

Masz możliwość podglądu wszystkich transakcji wykonanych przez klientów w Twoim sklepie:

• Panel Merchanta Banku – rozbudowany panel, w którym możesz filtrować, przeglądać oraz eksportować transakcje w wybranym okresie.

• Panel Merchanta InPost (wersja uproszczona) – prosty podgląd transakcji i możliwość ręcznego wykonywania pojedynczych zwrotów.

Obsługa zwrotów

Zwroty mogą być wykonywane:

• Ręcznie – przez Administratora usługi InPost Pay wskazanego na umowie lub osoby przez niego uprawnione poprzez panel Merchanta Banku lub panel Merchanta InPost (pojedyncze zwroty).

• Automatycznie – dzięki integracji z API (opcja rekomendowana przy większej liczbie operacji).

Integracja z API

Jeśli korzystasz z systemu ERP lub innego oprogramowania, możesz w pełni zintegrować obsługę transakcji i zwrotów za pomocą API.

• Obsługiwane są metody opisane w rozdziale „Zwroty i transakcje – API”.

• Dzięki integracji możesz:

  • pobierać listy transakcji w zadanym zakresie dat,

  • inicjować zwroty bezpośrednio ze swojego systemu,

Ta opcja pozwala na automatyzację procesów i eliminuje potrzebę logowania do panelu w celu wykonania pojedynczej operacji.

Kiedy używać którego rozwiązania?

• Panel Merchanta Banku – jeśli chcesz mieć pełny dostęp do transakcji, raportów i zaawansowanych funkcji.

• Panel Merchanta InPost – jeśli potrzebujesz szybkiego wglądu w podstawowe informacje i prostą obsługę zwrotów.

• API – jeśli chcesz zintegrować procesy bezpośrednio ze swoim systemem (np. ERP), aby oszczędzić czas i ograniczyć pracę manualną.

✅ Dzięki powyższym narzędziom masz pełną kontrolę nad obsługą transakcji i zwrotów – zarówno ręcznie, jak i automatycznie.

Na tej stronie

Zwroty i transakcje - API

Aplikacja Merchant API która jest częścią systemu InPost Pay dostarcza następujące usługi:

• GET /v1/izi/transaction Pozwalająca na pobranie listy transakcji dla zautoryzowanego Merchanta. Pełen opis pól dotyczących
  transakcji oraz filtrów przy pomocy których można ograniczyć zwracany rezultat, znajduje się poniżej.

• POST /v1/izi/transaction/{transaction_id}/refund Pozwalająca na zlecenie pełnego lub częściowego zwrotu dla wybranej transakcji,
  przeprowadzonej w jednym ze sklepów zautoryzowanego Merchanta. W przypadku tej usługi, przeprowadzana jest dodatkowa
  weryfikacja zlecenia poprzez weryfikację sygnatury wiadomości.

Lista metod:

• GET /v1/izi/transaction - Lista transakcji

• POST /v1/izi/transaction/{transaction_id}/refund - Zlecenie zwrotu
  
  

Autoryzacja

Autentykacja jest wymagana i jest ona przeprowadzana tak samo jak w przypadku integracji z InPost Pay (Basket App). Należy pobrać access_token przy
pomocy posiadanego client_id oraz client_secret, a następnie przekazać go jako Bearer Token w nagłówku Authorization.

Dostępne środowiska:

• Sandbox: https://sandbox-api.inpost.pl

• Produkcja: https://api.inpost.pl

Specyfikacja REST API

Panel Merchanta

Portal Merchanta, to portal umożliwiający:

• Oglądanie szczegółów poszczególnych transakcji

• Realizację zwrotów

• Wyszukiwanie rozliczeń

• Podgląd podpisanych dokumentów

• Sprawdzenie informacji o pobranych prowizjach.

 Poniżej znajdziesz instrukcje korzystania z panelu Merchanta.

Link do panelu Merchanta (zwroty i transakcje): https://merchant.unicredit.pl/

Link do panelu administratora (nadawanie uprawnień): https://merchant.unicredit.pl/administration

Instrukcja obsługi panelu Merchanta

• Instrukcja użytkownika

Open

Przykładowy raport rozliczeniowy

Open

Legenda do raportu:

• PaymentId – unikalny identyfikator płatności w systemie, pozwalający odróżnić ją od innych transakcji 
  Przykład: Dla tego samego numeru zamówienia każda próba płatności otrzymuje inne ID.

  • pierwsza próba zakończona odrzuceniem ma jedno unikalne ID,

  • druga próba, również odrzucona, ma inne unikalne ID,

  • kolejna próba płatności za to samo zamówienie, zakończona sukcesem, także otrzymuje kolejne unikalne ID.

• FundingAmount – kwota zamówienia, jaką klient zapłacił.

• FundingAmountCurrency – waluta, w której została wyrażona kwota zamówienia.

• Date – data wykonania płatności przez klienta.

• Status – aktualny stan płatności (np. rozpoczęta, w toku, zakończona, odrzucona).

• IsSettled – informacja, czy dana płatność została już rozliczona i przekazana na konto odbiorcy.

• Commission – wysokość prowizji pobranej od tej płatności.

• CommissionCurrency – waluta, w której wyrażona jest prowizja.

• PaymentMethod – sposób realizacji płatności (np. karta, BLIK, przelew online).

• Description – pole zawierające numer zamówienia oraz numer płatności, rozdzielone znakiem | (np. 12345|2b1da033-da73-4e66-86e6-2ced020e4099).

• SettlementId – unikalny identyfikator rozliczenia, w ramach którego dana płatność została ujęta.

• SettlementImpactAmount – kwota wpływu tej płatności na rozliczenie (np. kwota netto po odjęciu prowizji).

• SettlementImpactCurrency – waluta, w której wyrażona jest kwota wpływu na rozliczenie.

• DbaName – nazwa merchanta (sprzedawcy), pod jaką funkcjonuje w systemie.

• TransferReference – numer przelewu (rozliczenia), służący do identyfikacji konkretnego transferu środków.

• BookingIds – numer księgowania w systemie banku, przypisany do danej transakcji lub rozliczenia.

Panel Transakcyjny InPost Pay

W panelu InPost Pay https://merchant.inpost.pl możesz zlecać zwroty transakcji oraz podglądać listę transakcji swojego sklepu internetowego.

Aby uzyskać dostęp do listy transakcji, uzupełnij dane swojego sklepu w zakładce Dane Sklepu, a następnie przejdź do zakładki Klucze API i kliknij przycisk Utwórz Secret, który pojawi się w prawym górnym rogu ekranu.

Szczegółową instrukcję uzupełniania Danych Sklepu znajdziesz w rozdziale 3. Uzupełnij dane sklepu.

Szczegółową instrukcję generowania Secret do zwrotów znajdziesz w rozdziale 6. Klucze API – Merchant Secret (opcjonalnie dla integracji ERP/API).

1. Lista Transakcji

Na tym ekranie zobaczysz listę wszystkich transakcji w Twoim sklepie internetowym wykonanych za pośrednictwem InPost Pay. Zakładka ta prezentuje listę transakcji, gdzie możliwe jest wyszukanie transakcji oraz wykonanie zwrotu. Ekran umożliwia wyszukanie transakcji za pomocą filtrów.

Open

W tabeli znajdziesz:

• ID transakcji: Unikalny numer identyfikujący każdą transakcję. Jest to kluczowy numer, który pozwoli Ci łatwo odnaleźć szczegółowe informacje na temat konkretnej transakcji.

• Data utworzenia: Data i godzina, kiedy transakcja została przeprowadzona.

• Status: Aktualny stan Twojej transakcji (np. zakończona, anulowana, oczekująca na płatność). Dokładny status będzie zależał od fazy procesu płatności.

• Kwota: Wartość transakcji w PLN. To kwota, która została faktycznie zapłacona lub powinna zostać zapłacona.

• Metoda płatności: Sposób, w jaki klient dokonał płatności (np. karta, przelew bankowy, płatność BLIK).

• Opis: Krótki opis transakcji, który może zawierać dodatkowe informacje o płatności.

• ID zamówienia: Numer zamówienia ze sklepu, do którego odnosi się dana transakcja. To pozwala na powiązanie płatności z konkretnym zamówieniem złożonym przez klienta. Numer zamówienia stanowi numer znajdujący się przed symbolem ‘|’.

U góry strony znajdziesz filtry, po których możesz filtrować listę transakcji.

2. Szczegóły transakcji

Aby zobaczyć szczegóły konkretnej transakcji należy kliknąć na symbol trzech kropek po prawej stronie danej transakcji.

Open

Na stronie szczegółów transakcji znajdziesz poniższe informacje:

• Data Utworzenia: Pokazuje datę i godzinę, kiedy transakcja została utworzona.

• Data Autoryzacji: Pokazuje datę i godzinę autoryzacji płatności.

• Kwota: Wyświetla kwotę transakcji w złotych polskich (PLN).

• Status: Wskazuje aktualny status transakcji.

• Metoda Płatności: Prezentuje metodę płatności użytą przez klienta.

• Numer Zamówienia: Identyfikator zamówienia powiązanego z tą transakcją.

• Nazwa Merchanta: Nazwa Twojego sklepu.

• payment_gateway_id & POS_ID: Identyfikatory wewnętrzne systemu płatności.

• Rozliczone: Wskazuje, czy transakcja została już rozliczona.

• Opis: Dodatkowe informacje o transakcji.

• Kwota zwrotu: Wyświetla kwotę, którą można zwrócić klientowi w ramach tej transakcji.

• Rodzaj zwrotu: Pozwala wybrać rodzaj zwrotu (np. częściowy lub całkowity).

• Kwota (pole tekstowe): Pole do wprowadzenia kwoty zwrotu, jeśli zwrot jest częściowy. Jeśli zwrot jest całkowity pole nie jest edytowalne.

• Zwróć (przycisk): Pozwala na wysłanie żądania zwrotu środków klientowi.

Open

3. Wykonanie zwrotu

Aby wykonać zwrot przejdź do szczegółów transakcji, którą chcesz zwrócić.

W sekcji "Zwrot" wybierz rodzaj zwrotu: "Całościowy" (pełny zwrot) lub "Częściowy" (zwrot części kwoty).

Jeśli wybierzesz "Częściowy", wprowadź żądaną kwotę zwrotu w odpowiednim polu.

Open

Po wybraniu rodzaju i kwoty zwrotu, kliknij przycisk "Zwróć". System wyświetli okno podsumowania zwrotu z najważniejszymi informacjami (ID transakcji, kwota zwrotu). Sprawdź poprawność danych i kliknij "Potwierdź zwrot".

Open

Po udanym wysłaniu żądania zwrotu, system wyświetli komunikat potwierdzający. Informacje o statusie zwrotu będą dostępne w historii transakcji.

Open

4. Lista zwróconych transakcji

W zakładce zwroty zobaczysz tylko listę transakcji, które zwróciłeś całkowicie.

Open

Ważne uwagi:

• Zawsze dokładnie sprawdzaj wprowadzone dane przed potwierdzeniem zwrotu.

• W przypadku jakichkolwiek problemów lub wątpliwości, skontaktuj się z obsługą klienta bok.pay@inpost.pl.

5. Nadawanie uprawnień do systemu innym użytkownikom

Aby nadać innym użytkownikom dostęp do określonych funkcji systemu, skorzystaj z zakładki Uprawnienia w menu.

Open

Uwaga! Przed dodaniem nowego użytkownika upewnij się, że ma on założone konto na swój adres mailowy na portalu https://merchant.inpost.pl

Naciśnij przycisk „Dodaj użytkownika” w prawym górnym rogu ekranu

Open

Uzupełnij wszystkie wymagane dane dotyczące nowego użytkownika systemu oraz określ jego role w systemie, do których chcesz nadać mu dostęp. Następnie kliknij przycisk „Zapisz”.

Open

Dodany użytkownik otrzyma wiadomość e-mail z informacją o aktywacji konta. Po zalogowaniu zobaczy konto sklepu wraz z elementami, do których został mu nadany dostęp.

Open

W zakładce „Zaproszeni” znajdziesz listę użytkowników, którzy otrzymali zaproszenie, ale jeszcze go nie zaakceptowali. W zakładce „Aktywni” wyświetlana jest lista użytkowników, którzy już zaakceptowali zaproszenie.

Open

Aby edytować uprawnienia dowolnego użytkownika, kliknij ikonę trzech kropek znajdującą się po prawej stronie jego nazwy i wybierz odpowiednie uprawnienia.

Open