Statusy płatności w systemie: co oznaczają i kiedy działać
Statusy płatności w systemie: co oznaczają i kiedy działać
Tylko status „opłacona” (PAID/CONFIRMED) potwierdza, że środki faktycznie dotarły, i dopiero wtedy realizujemy zamówienie. Statusy typu NEW, CREATED czy PENDING oznaczają, że proces płatności wciąż trwa, więc nie są podstawą do wydania towaru czy usługi. Jako sprzedawca opieramy decyzję na webhooku lub potwierdzeniu z panelu API, nigdy na samym przekierowaniu klienta po płatności.
Krótko mówiąc:
- Statusy FAILED, EXPIRED i CANCELED oznaczają odrzucenie, upływ czasu albo przerwanie płatności; poinformuj klienta, że może ponowić próbę po sprawdzeniu przyczyny.
- Przy autoryzacji wstępnej blokada środków nie oznacza ich pobrania; dopiero CAPTURED kończy rozliczenie finansowe, więc zamówienie czeka na ten etap.
- Przy fladze podejrzenia oszustwa wstrzymaj realizację i zleć ręczną weryfikację, nawet jeśli status formalnie potwierdza powodzenie płatności, przed wydaniem towaru lub usługi.
- Przy płatności BLIK autoryzacja w aplikacji zwykle jest nieodwołalna, ale awaria banku może opóźnić zaksięgowanie środków na rachunku odbiorcy mimo potwierdzenia w aplikacji.
- Przy rozbieżności poproś płacącego o potwierdzenie przelewu w pliku PDF, a przed reklamacją porównaj numer transakcji, kwotę i czas operacji po obu stronach.
Spis treści
- Słownik najczęstszych statusów i ich znaczenie
- Cykl życia transakcji: typowe przejścia statusów i wyjątki
- Jak sprawdzać status: praktyczna instrukcja dla sprzedawcy i płacącego
- BLIK i płatności natychmiastowe: co trzeba wiedzieć o statusach
- Kiedy realizować zamówienie: reguły operacyjne dla sprzedawcy
- Najczęstsze problemy i checklist krok po kroku
- Przykład praktyczny: jak Settleo obsługuje statusy płatności w rozliczeniach grupowych
- Perspektywa autora: kierunek rozwoju obsługi statusów płatności
- Krótka oferta Settleo: jak pomagamy śledzić statusy i automatyzować rozliczenia
- Najczęściej zadawane pytania
- Źródła
Słownik najczęstszych statusów i ich znaczenie
Każdy system płatności używa własnej nazewniczej konwencji, ale logika jest wspólna dla większości polskich i europejskich dostawców, zgodnie z dokumentacją statusów Paynow.
- CREATED/NEW: transakcja została zarejestrowana, ale płatnik jeszcze jej nie dokończył. Nie podejmuj żadnych działań, po prostu czekaj.
- PENDING/PROCESSING: płatność jest w trakcie przetwarzania przez bank lub operatora. To stan przejściowy, nie końcowy.
- PAID/CONFIRMED: środki zostały zaksięgowane. To jedyny moment, w którym bezpiecznie realizujesz zamówienie.
- CAPTURED: dotyczy modeli z autoryzacją wstępną (pre-auth), oznacza ostateczne pobranie wcześniej zablokowanych środków.
- FAILED/REJECTED: płatność się nie powiodła, zwykle z powodu braku środków lub odrzucenia przez bank.
- EXPIRED/CANCELED: czas na dokończenie płatności minął albo płatnik ją przerwał.
- REFUNDED: środki wróciły do płatnika po wcześniejszym zaksięgowaniu.
Gdy system oznacza transakcję flagą podejrzenia oszustwa, wstrzymaj realizację do czasu ręcznej weryfikacji, nawet jeśli status formalnie wygląda na pozytywny.
Cykl życia transakcji: typowe przejścia statusów i wyjątki
Większość transakcji przechodzi ścieżką CREATED, potem PROCESSING, a na końcu PAID, czasem z dodatkowym etapem CAPTURED przy modelach z autoryzacją wstępną. Alternatywna ścieżka kończy się na EXPIRED lub FAILED, gdy płatność nie dojdzie do skutku.
Systemy informują o zmianie statusu dwoma kanałami: webhookiem (IPN), który wysyła powiadomienie serwerowe w momencie zmiany, oraz odpowiedzią z API przy odpytaniu ręcznym. Dokumentacja Paymentic wskazuje webhook jako główne źródło prawdy, a polling API traktuje jako metodę zapasową, używaną głównie przy awarii powiadomień.
Przy modelu pre-auth blokada środków nie jest jeszcze pobraniem pieniędzy. Dopiero capture kończy transakcję finansowo, a zwrot (refund) jest zawsze operacją następczą, wykonywaną po wcześniejszym zaksięgowaniu wpłaty.
Jak sprawdzać status: praktyczna instrukcja dla sprzedawcy i płacącego
Sprzedawca i płacący weryfikują status z dwóch różnych pozycji, ale oboje potrzebują tych samych danych: numeru transakcji, kwoty i znacznika czasu.
- Skonfiguruj webhook/IPN jako podstawowe źródło informacji o statusie, zamiast polegać na przekierowaniu po płatności.
- Jeśli webhook się nie odezwie w rozsądnym czasie, sprawdź status ręcznie przez zapytanie do API.
- Jako płacący otwórz bankowość elektroniczną i rozróżnij „przelewy oczekujące” od „historii operacji”, bo to dwa różne widoki.
- Pobierz potwierdzenie przelewu w formacie PDF, jeśli sprzedawca kwestionuje otrzymanie wpłaty, zgodnie ze wskazówkami Portfel.
- Porównaj numer transakcji, kwotę i czas operacji po obu stronach, zanim zgłosisz reklamację.
Porada profesjonalisty: Zapisuj numer transakcji od razu po płatności, nie dopiero gdy pojawi się problem, bo bez niego bank rozpatruje sprawę znacznie dłużej.
BLIK i płatności natychmiastowe: co trzeba wiedzieć o statusach
BLIK ma swoją specyfikę, która wpływa na to, jak czytamy jego statusy. Kod jest sześciocyfrowy i ważny przez krótki czas, a aplikacja bankowa pokazuje kwotę i odbiorcę jeszcze przed ostatecznym potwierdzeniem.
- Po autoryzacji transakcja BLIK jest zwykle nieodwołalna, więc traktujemy potwierdzenie w aplikacji jako wiążące.
- Przelewy natychmiastowe (w tym Express Elixir) skracają cykl statusów, ale techniczne zawieszenia wciąż się zdarzają.
- Potwierdzenie w aplikacji bankowej nie zawsze oznacza to samo co zaksięgowanie na rachunku odbiorcy, zwłaszcza przy przejściowym obciążeniu systemu banku.
Zasady działania samego schematu BLIK, w tym jego dostępność 24/7, opisuje regulamin systemu BLIK.
Kiedy realizować zamówienie: reguły operacyjne dla sprzedawcy
Podstawowa reguła brzmi prosto: realizujemy zamówienie dopiero po otrzymaniu statusu PAID lub CONFIRMED, potwierdzonego webhookiem albo zaksięgowaniem na koncie. Sam fakt, że klient wrócił na stronę z podziękowaniem, niczego nie dowodzi.
W modelu pre-auth capture jest momentem granicznym: dopiero wtedy pieniądze faktycznie znikają z konta płatnika. Przy statusach FAILED, EXPIRED lub CANCELED po prostu nie realizujemy zamówienia i informujemy klienta, że może spróbować ponownie.
Najczęstsze problemy i checklist krok po kroku
Długie utrzymywanie się statusu PENDING, odrzucenia i podwójne wpłaty to trzy najczęstsze sytuacje wymagające interwencji.
- Sprawdź logi webhooków i API, zanim założysz, że płatność zaginęła.
- Poproś płacącego o potwierdzenie przelewu w PDF, jeśli status w systemie się nie zgadza z tym, co widzi klient.
- Zweryfikuj numer transakcji i znacznik czasu po obu stronach, bo to najszybszy sposób na znalezienie rozbieżności.
- Jeśli podejrzewasz podwójną wpłatę, przygotuj od razu procedurę zwrotu, zamiast czekać na reklamację klienta.
- Eskaluj sprawę do dostawcy płatności lub banku z kompletem danych: kwotą, datą, numerem transakcji i statusem z obu systemów.
Porada profesjonalisty: Im więcej konkretnych danych przekażesz do PSP przy pierwszym zgłoszeniu, tym krótszy będzie czas wyjaśnienia sprawy.
Więcej o postępowaniu przy nadpłatach znajdziesz w artykule o podwójnych wpłatach.
Przykład praktyczny: jak Settleo obsługuje statusy płatności w rozliczeniach grupowych
W naszym systemie monitorujemy statusy płatności i automatycznie powiadamiamy uczestników oraz administratorów o każdej zmianie, co ogranicza liczbę pytań typu „czy moja wpłata doszła”. Typowy scenariusz wygląda tak: rodzic płaci składkę, system odbiera status PAID, a saldo w panelu aktualizuje się w ciągu kilku sekund.
Dzięki temu skarbnik nie musi ręcznie sprawdzać każdej wpłaty, pula uczestników zamyka się szybciej, a przy statusie PENDING system sam wysyła przypomnienie, zanim ktokolwiek zapomni dopłacić. Więcej o mechanice tych powiadomień opisujemy w artykule o powiadomieniach o wpłatach.
Perspektywa autora: kierunek rozwoju obsługi statusów płatności
Powiadomienia serwerowe i standardy interoperacyjne będą zyskiwać na znaczeniu szybciej, niż większość sprzedawców się spodziewa. Rosnąca popularność płatności natychmiastowych oznacza, że ręczne sprawdzanie statusu przestaje się opłacać, bo klient oczekuje potwierdzenia w kilka sekund, nie godzin. Kto zainwestuje w automatyzację i jasne procedury teraz, uniknie chaosu, gdy wolumen transakcji wzrośnie.
— Mateusz
Krótka oferta Settleo: jak pomagamy śledzić statusy i automatyzować rozliczenia
Zamiast ręcznie sprawdzać, czy każda wpłata doszła, w Settleo widzisz status każdej transakcji w jednym panelu, a system sam wysyła przypomnienia przy statusie oczekującym. Szczegóły dotyczące dostępnych planów i cen znajdziesz na stronie Settleo.
Rozwiązanie sprawdza się dla skarbników klasowych, trenerów, organizatorów wydarzeń i administratorów szkół, którzy rozliczają składki cykliczne lub jednorazowe opłaty. Zamiast arkuszy kalkulacyjnych i wiadomości e-mail, masz jeden panel z raportami w czasie rzeczywistym. Sprawdź stronę główną Settleo i wypróbuj darmowy pakiet do 30 użytkowników.
Najczęściej zadawane pytania
Czy da się sprawdzić status przelewu bez logowania do banku?
Zwykle nie, bo szczegóły przelewu są dostępne tylko w bankowości elektronicznej nadawcy lub odbiorcy. Wyjątkiem jest sytuacja, gdy sprzedawca udostępnia panel z podglądem statusu transakcji, jak ma to miejsce w systemach SaaS do rozliczeń grupowych.
Jak sprawdzić, czy transakcja przeszła?
Najpewniejszym sposobem jest sprawdzenie statusu w panelu sprzedawcy, który powinien opierać się na webhooku lub odpowiedzi z API, a nie tylko na przekierowaniu po płatności. Jako płacący możesz dodatkowo zweryfikować operację w historii swojego konta bankowego.
Jak sprawdzić status transakcji w PayU?
W PayU status transakcji widać zarówno w panelu sprzedawcy, jak i w potwierdzeniu wysyłanym do płatnika po zakończeniu płatności. Status „zakończona” lub „opłacona” oznacza zaksięgowanie środków, a statusy pośrednie wskazują, że proces wciąż trwa.
Jak sprawdzić status transakcji BLIK?
Status transakcji BLIK widoczny jest w aplikacji bankowej płatnika zaraz po autoryzacji kodu, który jest ważny przez krótki czas, zgodnie z regulaminem systemu BLIK. Po autoryzacji transakcja jest zwykle nieodwołalna, więc to potwierdzenie w aplikacji traktujemy jako wiążące.
Co zrobić, gdy status płatności jest długo „w trakcie”?
Najpierw sprawdź logi webhooków i odpowiedź z API, zanim założysz awarię płatności. Jeśli status nie zmienia się po dłuższym czasie, poproś płacącego o potwierdzenie przelewu w PDF i porównaj numer transakcji oraz kwotę po obu stronach.