Business Cases

Business cases represent individual KYB verification sessions. These are standalone, session-based workflows that can operate independently or be linked to a business profile.

Event Callbacks

Endpoint Configuration: events_callback_url

Event callbacks provide real-time updates as the business verification progresses through different stages.

Available Events

Event Type	Trigger	Payload Content
`VERIFICATION_SESSION_STARTED`	Business begins the KYB session	`verification_session_id`, `client_reference_id`, `client_reference_data`
`VERIFICATION_REQUEST_SUBMITTED`	Business completes data entry	`verification_session_id`, `client_reference_id`, `client_reference_data`
`VERIFICATION_SESSION_COMPLETION`	KYB workflow finishes	Full `BusinessVerificationResultPayload`
`CASE_STATUS_UPDATE`	Reviewer updates the case decision	`verification_session_id`, `verification_result`, `author`, `reason`, optional officer/company references
`AML_MONITORING_UPDATE`	Ongoing AML monitoring detects a change	`verification_session_id`, `aml_monitoring_update` object
`SECTION_INFO_UPDATE`	Analyst edits business data	`verification_session_id`, `data` (section details, previous/current values)
`COMMENT`	Comment is added to the business case	`verification_session_id`, `comment`, `author`, `created_at`

Decision Callback

Endpoint Configuration: callback_url

📘
This callback is only sent for business verification sessions that are NOT linked to a business profile.

The decision callback delivers the final snapshot of the KYB workflow once it reaches a terminal state.

Learn more about Business case callbacks

Business Case - Event Callbacks

Learn about event callbacks that provides real-time updates as the verification progresses through different stages

Business Case - Decision Callbacks

Decision callbacks delivering the final snapshot of the verification workflow once it reaches a terminal state