Event Name:
kyb_state_updatedThis event is emitted when the overall KYB verification level changes for a business user, typically after a verification process is completed, downgraded, or expires.
Event Payload
The webhook payload contains the following structure:Example Payload
Field Description
string
required
Unique event identifier (UUID)
string
required
Event type - always
kyb_state_updated for this webhookstring
required
Event timestamp in ISO 8601 format
object
required
Contains the event data
integer
required
Unique KYB record ID
string
required
Unique business user ID (UUID)
string
required
Current KYB level. Common values include
REGULAR and LIGHTWhen This Event Is Sent
This webhook is sent when the KYB record changes its overall verification level for a business user. Typical scenarios include:- A verification flow upgrades the business user to
REGULAR - A review or business rule downgrades the business user to
LIGHT
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.