Subskrypcje i płatności - przegląd
Sekcja Subskrypcje i płatności służy do przeglądania subskrypcji, pojedynczych płatności i zwrotów oraz wspólnej listy aktywności. Dostęp mają tylko administratorzy i właściciele organizacji; członek zespołu nie widzi tej sekcji (szczegóły w Role i uprawnienia). Kwoty wyświetlane są w walucie każdej transakcji (zgodnie z walutą oferty: PLN, EUR lub USD). Poniżej: co oznaczają statusy i co znajdziesz w każdej zakładce; szczegóły w podstronach.
Statusy transakcji
- Płatności: Udane (SUCCESS), Nieudane (FAILED), W toku (PENDING), Zwrócona (REFUNDED).
- Subskrypcje: Aktywna (ACTIVE), Okres próbny (TRIAL) przy promocyjnej cenie próbnej oferty, Opóźniona płatność (PAST_DUE), Wstrzymana (PAUSED), Oczekująca anulowania (PENDING_CANCELLATION), Anulowana (CANCELLED), Wygasła (EXPIRED), Zawieszona (SUSPENDED), Zakończona (COMPLETED).
- Zwroty: Oczekujący (PENDING), Udany (SUCCESS), Nieudany (FAILED).
Zakładka: Subskrypcje
Karty statystyk, wyszukiwanie, filtry (status, daty, metoda). Tabela z akcją Zobacz → szczegóły subskrypcji. Szczegóły: Subskrypcje.
Zakładka: Płatności
Karty, wyszukiwanie, filtry, Eksportuj CSV. Tabela; Zobacz → szczegóły; przy udanej płatności także Zwroty. Szczegóły: Płatności.
Zakładka: Zwroty
Przycisk Utwórz zwrot, karty, wyszukiwanie, filtry, tabela. Zwrot tylko dla płatności udanej; kwota nie może przekraczać kwoty płatności. Szczegóły: Zwroty.
Zakładka: Wszystkie aktywności
Wspólna lista aktywności (płatności, zwroty, subskrypcje itd.) z wyszukiwaniem i filtrami. Kolumna Akcje - Zobacz prowadzi do szczegółów wybranego elementu (płatność, zwrot lub subskrypcja).
Przepływ statusów
Płatność: PENDING (utworzona, oczekuje na bramkę) → SUCCESS (rozliczona) lub FAILED (odrzucona/błąd). Po pełnym zwrocie: REFUNDED. Subskrypcja: ACTIVE (kolejne płatności po ewentualnym okresie próbnym), TRIAL (promocyjna cena próbna z ustawień oferty), PAST_DUE (opóźniona płatność), PAUSED (wstrzymana), PENDING_CANCELLATION (anulowana, ważna do końca okresu), CANCELLED (już po okresie), EXPIRED (wygaśnięcie naturalne), SUSPENDED (zablokowana), COMPLETED (zakończona z limitem). Zwrot: PENDING (w trakcie) → sukces lub nieudany (FAILED) w zależności od odpowiedzi bramki. System okresowo przetwarza cykliczne płatności subskrypcji i ponawia nieudane próby według limitu (np. 3 próby).
Eksport CSV
W zakładce Płatności przycisk Eksportuj CSV otwiera modal: wybór zakresu dat (od-do) i kolumn (ID, data, kwota, klient, status, metoda itd.). Po Generuj CSV system generuje plik CSV do pobrania. Eksport dotyczy płatności w kontekście wybranej organizacji. Analogicznie Klienci mają opcję eksportu z filtrami.
Widok organizacji vs osobisty
Sekcja działa w kontekście organizacji (merchant) oraz w widoku osobistym użytkownika (własne subskrypcje jako klient). W widoku org widzisz kolumnę Klient/Organizacja i karty KPI z przychodem; w widoku osobistym - uproszczone listy bez statystyk merchant.
Persistencja filtrów
Wyszukiwanie, filtry statusu, metody i zakres dat są zapamiętywane per organizacja/użytkownik - po powrocie z szczegółów płatności lista ma te same ustawienia co przed wyjściem.
Eksport danych
- Eksportuj CSV - na zakładkach Płatności i Subskrypcje (kontekst org); wybór kolumn w modalu.
- Eksport KSeF XML - tylko gdy organizacja ma NIP i płatność kwalifikuje się do raportowania; widoczny przy udanych płatnościach.
- Platform ADMIN widzi dodatkowo kolumnę i akcje KSeF (submit numeru).
Ścieżki szczegółów
- Płatność:
/dashboard/transactions/payments/{payId} - Subskrypcja:
/dashboard/subscriptions/{subId}(osobna ścieżka, nie pod/transactions/) - Zwrot:
/dashboard/transactions/refunds/{refId}
Webhooki i powiadomienia
Każda udana/nieudana płatność może wygenerować webhook (Premium+) i powiadomienie dzwonka w panelu. Statusy w UI odpowiadają statusom w API (SUCCESS, FAILED, PENDING, REFUNDED).