KYB Events
These webhook events notify merchants about changes related to Know Your Business (KYB) verification for business users.Understanding KYB
- KYB: Represents the overall business verification record associated with a business user.
- KYB Session: Represents a specific verification attempt or verification flow linked to that KYB record.
KYB Levels
The overall verification level assigned in the system:| Level | Code | Description |
|---|---|---|
| REGULAR | 1 | Full KYB verification completed |
| LIGHT | 2 | Basic/light KYB verification |
Available Events
| Event | Description | Triggered By |
|---|---|---|
| kyb_state_updated | Sent when the overall KYB state changes | KYB state change |
Notes
kyb_state_updatedrefers to the KYB record itself and is emitted when the business user’s verification level changes.- KYB events are always associated with a business user (
userId).