User Cases (Sessions)

User cases represent individual verification sessions initiated through your application. These are standalone, session-based workflows that can operate independently or be linked to a user profile.

Learn more about Event Callbacks and Callbacks

User Case - Event Callbacks

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

User Case - Callbacks

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

User Profile - Event Callbacks

User profiles provides a comprehensive set of events covering the entire lifecycle from creation to ongoing monitoring

Example : Session-based KYC Flow

Scenario: Standalone verification session (not linked to profile)

1. User initiates KYC
   → Your app creates verification session
   
2. Event: VERIFICATION_SESSION_STARTED
   {
     "event_type": "VERIFICATION_SESSION_STARTED",
     "verification_session_id": "vs_123",
     "client_reference_id": "user_456"
   }
   → Update UI: "Verification in progress"
   
3. User completes submission
   
4. Event: VERIFICATION_REQUEST_SUBMITTED
   {
     "event_type": "VERIFICATION_REQUEST_SUBMITTED",
     "verification_session_id": "vs_123"
   }
   → Update UI: "Processing your documents"
   
5. Verification completes
   
6. Event: VERIFICATION_SESSION_COMPLETION
   {
     "event_type": "VERIFICATION_SESSION_COMPLETION",
     "aiprise_summary": { "decision": "APPROVED" },
     "id_info": { /* ... */ },
     "face_match_info": { /* ... */ }
   }
   → Update UI: "Verification successful"
   
7. Callback: callback_url
   {
     "verification_session_id": "vs_123",
     "aiprise_summary": { "decision": "APPROVED" }
     // Full payload
   }
   → Grant user access
   → Enable premium features