Pobierz zwroty płatności
Zwraca wszystkie zwroty danej płatności - w tym nieudane próby, ponieważ każdy zwrot zapisujemy przed skierowaniem go do rozliczenia. Płatność bez zwrotów zwraca pustą tablicę.
To właściwy endpoint do odpytywania o stan zwrotu: wywołuj go co kilka sekund, aż status
będzie końcowy (COMPLETED, CANCELED albo ERROR). Klucz API musi mieć uprawnienie
do odczytu, a zwroty przez API muszą być włączone dla konta.
Autoryzacje
Klucz API generowany w Panelu Paymove.
Format: 51 znaków z prefiksem środowiska - sk_test_ w sandboxie,
sk_live_ na produkcji.
Przykład: sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Klucz przekazuj wyłącznie z serwera. Żądanie wysłane ze strony sklepu zostanie odrzucone - a klucz i tak nigdy nie może trafić do kodu frontendowego.
Parametry ścieżki
Wewnętrzny identyfikator zamówienia nadany przez Paymove
"PAY1784798914400"
Odpowiedź
Lista zwrotów płatności
Identyfikator zwrotu w Paymove
"9f2c1b44-6d2f-4f0e-9a71-2b8c5d3e1a90"
Zawsze REFUND
REFUND Identyfikator SAMEGO ZWROTU w postaci {orderId płatności}-rN. Identyfikator płatności znajdziesz w parentOrderId.
"PAY1784798914400-r1"
orderId zwracanej płatności - ten sam, który podałeś w ścieżce
"PAY1784798914400"
Zwrócona kwota w groszach. Przy tworzeniu płatności to samo pole nazywa się price
15000
Status zwrotu. Jedyny status oznaczający sukces to COMPLETED; CANCELED pisane przez jedno l. Zwrot osiąga stan końcowy zwykle w ciągu kilkudziesięciu sekund.
INITIALIZED, PENDING, WAITING_FOR_EXTERNAL_ACTION, COMPLETED, CANCELED, ERROR "PENDING"
Metoda płatności, którą zapłacono zwracaną płatność
"BLIK"
Identyfikator partnera, do którego należy płatność
"3a7d1f52-8b64-4c19-9e03-7d2a5f8c1b44"
UUID produktu, w ramach którego powstała płatność
"891412c8-8717-4449-9543-e34112bec470"
Locale płatności
"pl"
Tekst przekazany w polu reason żądania
"Klient zrezygnował z zamówienia"
Czas utworzenia zwrotu (ISO 8601, UTC)
"2026-10-06T11:42:03Z"
Czas ostatniej zmiany statusu zwrotu (ISO 8601, UTC)
"2026-10-06T11:42:04Z"