Event Name:
kyc_expiration_warningThis event is emitted when an active KYC verification is approaching its document expiration date. It is intended to give merchants enough time to trigger a new KYC verification session before the current verification expires.
Event Payload
The webhook payload contains the following structure:Field Description
string
required
Unique event identifier (UUID)
string
required
Event type - always
kyc_expiration_warning for this webhookstring
required
Event timestamp in ISO 8601 format
object
required
Contains the event data
integer
required
Unique KYC record identifier
string
required
Entity type associated with the KYC record. Possible values:
user, related-partystring
Unique user ID (UUID)
Unique related party ID (UUID)
string
required
Document expiration date in
YYYY-MM-DD formatinteger
required
Number of days remaining before the KYC document expires
string
required
Recommended action for the merchant to prevent the KYC from expiring
When This Event Is Sent
This webhook is sent when a KYC record is close to expiration and has not been previously notified. Typical conditions include:- The KYC is still in a valid operational state
- The document expiration date is within the warning threshold
- A warning has not already been sent for that KYC
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.