Przejdź do głównej zawartości

Anulowanie sesji

Sesję weryfikacyjną możesz anulować w dowolnym momencie przed jej zakończeniem.

Endpoint​

DELETE /api/v1/verifications/{id}

Po wywołaniu status sesji zostanie ustawiony na expired. Endpoint zwraca 204 No Content przy sukcesie.

Przykład​

curl -X DELETE https://hub.dpay.pl/api/v1/verifications/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer deid_live_xxx"

Odpowiedź: HTTP/1.1 204 No Content (puste body)

Stany terminalne​

ostrzeżenie

Nie można anulować sesji w stanie terminalnym (completed, failed, expired). Próba zwróci błąd 409 Conflict z kodem SESSION_ALREADY_TERMINAL.

Przykład błędu​

{
  "error": {
    "code": "SESSION_ALREADY_TERMINAL",
    "message": "Cannot cancel a verification session that is already completed, failed, or expired."
  }
}

Kiedy anulować?​

Typowe scenariusze użycia DELETE /verifications/{id}:

  • Klient porzucił proces - zamknął okno przed dokończeniem weryfikacji
  • Anulowanie zamówienia - klient anulował zamówienie/wniosek po Twojej stronie
  • Wykrycie fraudu - chcesz przerwać weryfikację natychmiast
  • Cleanup - sprzątanie sesji testowych po zakończeniu testów E2E

Webhook po anulowaniu​

Anulowanie sesji generuje webhook verification.expired na skonfigurowane endpointy. Patrz Webhooks - Zdarzenia.

Alternatywa - czekanie na TTL​

Jeśli nie potrzebujesz natychmiastowego zamknięcia sesji, możesz po prostu poczekać na automatyczne wygaśnięcie po TTL (30 minut dla identity_verification, 60 minut dla account_data). Patrz Lifecycle - TTL sesji.

Ostatnia aktualizacja dnia