Sesja checkout

Checkout to płatność wbudowana w Twoją stronę: klient trafia na stronę Zevio z formularzem płatności. Sesję checkout tworzysz przez API - w dokumentacji w panelu (Developers → REST API) znajdziesz szczegóły i przykłady. Odpowiedź zawiera sessionId, embedUrl (link do wstawienia na stronę lub w aplikację) oraz expiresAt. Czas życia sesji: domyślnie 30 minut; opcjonalnie możesz ustawić czas do 24 godzin. Po wygaśnięciu klient zobaczy Ta sesja checkout wygasła i nie będzie mógł zapłacić - potrzebna jest nowa sesja i nowy embedUrl.

Co widzi klient

Formularz płatności jest taki sam jak przy linku do płatności (kwota, BLIK lub karta, zgoda regulaminu, e-mail). Szczegóły pól i przycisków: Jak wygląda płatność dla klienta.

Strona „Przetwarzanie płatności”

Po kliknięciu Zapłać klient widzi ekran Przetwarzanie Płatności z tekstem Proszę czekaj, potwierdzamy Twoją płatność… i spinnerem. Strona sama sprawdza status co kilka sekund. Po potwierdzeniu - automatyczne przekierowanie na stronę sukcesu lub błędu (albo na successUrl / cancelUrl z sesji). Nie zamykaj okna podczas oczekiwania.

Komunikaty przy problemach z sesją

  • Nie znaleziono sesji checkout - nieprawidłowy lub nieistniejący identyfikator; przycisk powrotu.
  • Ta sesja checkout została już zakończona - płatność już wykonana; nie można zapłacić ponownie tą samą sesją.
  • Sesja wygasła - po upływie czasu (domyślnie 30 min); klient musi dostać nowy link.
  • Sesja została anulowana - np. po nieudanej płatności; trzeba utworzyć nową sesję.

Po zatwierdzeniu klient trafia na bramkę lub stronę „Proszę czekaj…”; po rozliczeniu - na stronę sukcesu lub błędu. Jeśli przy tworzeniu sesji podałeś successUrl i cancelUrl, klient może zostać przekierowany na te adresy.

Obiekt sesji i wygaśnięcie

Odpowiedź API zawiera sessionId, embedUrl (URL do osadzenia lub przekierowania), expiresAt (data wygaśnięcia). Po utworzeniu płatności w sesji pojawia się paymentId. Status sesji: PENDING, COMPLETED, EXPIRED, CANCELLED. Po pomyślnej płatności status zmienia się na COMPLETED; ta sama sesja nie może być użyta ponownie. Domyślny czas życia to 30 minut; w żądaniu możesz podać expiresInMinutes (opcjonalnie, maks. 1440). Pełna lista pól jest w dokumentacji REST API w panelu.

Sesja checkout | Zevio