Skip to main content

​
KYC Events

These webhook events notify merchants about changes related to Know Your Customer (KYC) verification, including updates to an entity’s overall KYC status and the outcome of individual verification sessions.

​
Understanding KYC vs KYC Session

  • KYC: Represents the overall verification record associated with an entity.
  • KYC Session: Represents a specific verification attempt or verification flow linked to that KYC record.

​
Entity Types

KYC events can be associated with different entity types:

​
KYC Levels

The overall verification level assigned in the system:

​
KYC Session States

Possible states for an individual verification session:

​
KYC Session Check States

Possible states for individual checks within a session:

​
Available Events

​
Notes

  • kyc_state_updated and kyc_expiration_warning refer to the KYC record itself.
  • kyc_session_* events refer to the lifecycle of a specific verification session.
  • Depending on the flow, events may be associated with user or related-party.
  • related_party.kyc_session_created only applies to related parties of business users and carries the full related-party profile in addition to the session info.