Zwróć płatność
Zwraca płatność w całości. Kod 200 oznacza, że Paymove przyjął zwrot do realizacji -
nie że pieniądze już wróciły do klienta; typową odpowiedzią jest status: PENDING. Stan
końcowy sprawdzaj przez GET pod tym samym adresem.
Wymagania i ograniczenia:
- Zwroty przez API nie są dostępne dla każdego partnera - to funkcja włączana
indywidualnie, po uprzednim zgłoszeniu do Paymove (integration@paymove.io). Dopóki nie
jest aktywna, odpowiedzią jest
403. Klucz API musi mieć uprawnienie do zapisu. - Zwroty częściowe nie są obsługiwane.
amountMinormożna pominąć; jeśli je podasz, musi być równe pełnej kwocie płatności. - Jeden zwrot na płatność. Istniejący zwrot w stanie
PENDINGlubCOMPLETEDblokuje kolejne próby. - Zwrócić można wyłącznie płatność ze statusem
COMPLETED. Udany zwrot ustawia status płatności naREFUNDED. - Nie ma klucza idempotencji - przed ponowieniem żądania sprawdź listę zwrotów.
- Żądanie nie zawiera
productId- produkt i dane rozliczeniowe Paymove odczytuje z samej płatności.
Pełny opis: Zwroty.
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 - pole orderId payloadu webhooka albo odpowiedzi zapytania o status. Nie jest to externalId ani skrót płatności z redirectUrl
"PAY1784798914400"
Treść
Wszystkie pola są opcjonalne - puste body {} zwraca pełną kwotę płatności. Żądanie nie zawiera productId; produkt i dane rozliczeniowe Paymove odczytuje z płatności.
Opcjonalnie - kwota zwrotu w groszach jako liczba całkowita. Musi być równa pełnej kwocie płatności: zwroty częściowe nie są obsługiwane, a inna wartość kończy się kodem 400. Pominięcie pola zwraca całą kwotę.
x >= 115000
Opcjonalnie - adres e-mail płatnika, używany przy autoryzacji poprzedzającej zwrot. Bez niego wstawiana jest wartość zastępcza; płatności przyjęte bez adresu e-mail zwracają się poprawnie i bez tego pola.
"klient@example.com"
Opcjonalnie - dowolny tekst zapisywany przy zwrocie i zwracany w polu comment
"Klient zrezygnował z zamówienia"
Odpowiedź
Zwrot przyjęty do realizacji
Obiekt zwrotu. POST zwraca jeden taki obiekt, GET tablicę obiektów tego samego typu.
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"