Skip to main content
Event Name: kyc_session_expired
This event is emitted when a KYC verification session expires before completion. The session state is EXPIRED.

Event Payload

The webhook payload contains the following structure:

Field Description

string
required
Unique event identifier (UUID)
string
required
Event type - always kyc_session_expired for this webhook
string
required
Event timestamp in ISO 8601 format
object
required
Contains the event data
string
required
Unique KYC session ID (UUID)
string
Unique user ID (UUID)
Unique related party ID (UUID)
string
required
Entity type associated with the KYC session. Possible values: user, related-party

Expected Responses

Success Response

HTTP 200 OKThe webhook was processed successfully.

Client Error

HTTP 4xx StatusClient-side error. Will not be retried.

Server Error

HTTP 5xx StatusServer-side error. Will be retried with exponential backoff.

Implementation Example