Zwroty i transakcje

W tym rozdziale dowiesz się jak obsłużyć zwroty transakcji oraz jak korzystać z Portalu Merchanta.

Zwroty transakcji mogą być zlecane przez Merchanta poprzez API, w tym celu należy przygotować obsługę metod opisanych w Zwroty i transakcje - API. Drugim sposobem wykonania zwrotu jest ręcznie zlecenie poprzez Portal Merchanta.

Na tej stronie

Zwroty i transakcje - API

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

• status: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.

• status: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:

• status:GET /v1/izi/transaction - Lista transakcji

• status: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.

 Poniżej znajdziesz instrukcje korzystania z panelu Merchanta.

Link do panelu Merchanta (zwroty i transakcje): https://merchant.aion.eu/

Link do panelu administratora (nadawanie uprawnień): https://merchant.aion.eu/administration

Instrukcja obsługi panelu Merchanta

• Instrukcja użytkownika

Open

• Przykładowy raport rozliczeniowy

Open

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.