📸 Selfie Capture – Overview in Ditto ID Identity Verification (IDV)

🧭 Purpose

The selfie capture step in Ditto ID’s IDV flow ensures that the person submitting the document is the actual document holder. It enables biometric face matching and liveness detection, fulfilling compliance and security needs for:

• KYC (Know Your Customer)
• AML (Anti-Money Laundering)
• Account activation or re-verification

🧠 Key Features

• Liveness Detection: Confirms user is physically present
• Face Match Scoring: Matches selfie with document photo
• Front/Back Camera Toggle: Configurable through API
• Anti-Spoofing: Detects masks, photos, or replays
• Secure Flow: Fully handled inside SDK for tamper-resistance

👨‍💻 Developer Responsibilities

• Listen to getIDVSelfieProcessStartConfirmation
• Show a UI with:
  • Instructional text: “Ensure good lighting and a clear face view”
  • A “Start” button
• Call setIDVSelfieProcessStartConfirmation upon user action
• Handle post-capture events or errors

🔄 Workflow (Step-by-Step)

1. ✅ User completes document verification
2. 🔔 SDK triggers getIDVSelfieProcessStartConfirmation
3. 🖼️ App shows a screen with instructions to prepare for selfie capture
4. 👤 User taps "Start"
5. 📤 App calls setIDVSelfieProcessStartConfirmation(true, useBackCamera, workflow)
6. 📷 SDK launches selfie camera and captures the selfie
7. 🧾 SDK triggers getIDVSelfieConfirmation
8. 🖼️ App displays the captured selfie to the user
9. 👆 User taps:
   • ✅ "Confirm" ➝ App calls setIDVSelfieConfirmation(true, workflow, challengeMode)
   • 🔁 "Retake" ➝ App calls setIDVSelfieConfirmation(false, workflow, challengeMode)
10. 🔄 If confirmed: SDK proceeds to the next step in the IDV workflow
11. 🔁 If rejected: SDK re-launches selfie capture and returns to step 6

flowchart TD
    
   Start([Start]) -->|✅ User completes document verification| B[🔔 SDK triggers getIDVSelfieProcessStartConfirmation]
    B --> C[🖼️ App shows selfie prep screen]
    C -->|👤 User taps Start| E[📤 App calls setIDVSelfieProcessStartConfirmation]
    E --> F[📷 SDK launches selfie camera and captures selfie]
    F --> G[🧾 SDK triggers getIDVSelfieConfirmation]
    G --> H[🖼️ App displays captured selfie to user with match result]
    H -->|👆 User choice| J[📤 App calls setIDVSelfieConfirmation]
    J -->|Continue| L[🔄 SDK proceeds to next step in IDV workflow]
    J -->|Rescan Document| M[SDK calls getIDVDocumentScanProcessStartConfirmation]
    J -->|Rescan Selfie| E
    
    style B fill:#d4fdd4,stroke:#228b22,stroke-width:2px
    style G fill:#d4fdd4,stroke:#228b22,stroke-width:2px
    style M fill:#d4fdd4,stroke:#228b22,stroke-width:2px
    style E fill:#ffe4b3,stroke:#ff8c00,stroke-width:2px
    style J fill:#ffe4b3,stroke:#ff8c00,stroke-width:2px

🟩 Green - Callbacks issued by Ditto ID SDK
🟧 Orange - APIs invoked by the Client App