DocV

Start building

Overview

This solution uses DocV to verify user identities through government ID scans and biometric selfie capture in a single onboarding flow.

It enables you to:

• Capture and verify government-issued identity documents
• Match the document holder through biometric selfie verification
• Extract identity data directly from verified documents

Together, these capabilities help you verify user identities with high confidence while reducing manual review.

Key behaviors

Integration path

This solution uses the Direct API integration, where your application owns the onboarding experience end to end.

• Collect and submit user data via API
• Full control over user experience and data handling
• Launch the Document Verification Capture App from your frontend
• Final decision delivered via webhook after document capture completes

End-to-end flow

1. Set up your backend environment and configure API keys.
2. Collect user identity data (PII) on your custom frontend.
3. Create an evaluation (POST /api/evaluation) with PII and DocV settings.
4. RiskOS™ pauses the evaluation (eval_status: evaluation_paused) and returns a docvTransactionToken used to launch the Capture App via SDK or redirect.
5. Launch the DocV Web SDK or redirect to the Capture App URL.
6. The user completes government ID capture and selfie verification.
7. RiskOS™ resumes the evaluation and completes Document Verification.
8. RiskOS™ delivers the final decision via evaluation_completed webhook.
9. Route the user:
   • ACCEPT → Continue onboarding
   • REJECT → Stop or route to fallback flow
   • Retry behavior: DocV runs once per evaluation. If the session fails (for example, expired, declined, or resubmit), you must create a new evaluation to retry.

sequenceDiagram
    autonumber
    participant User as End User
    participant App as Your Platform
    participant Socure as Socure

    User->>App: Submit PII via signup form
    App->>Socure: POST /api/evaluation with PII and DocV settings
    Socure-->>App: evaluation_paused + docvTransactionToken

    Note over App: Extract docvTransactionToken from response
    App-->>User: Launch DocV SDK (Capture App)
    User->>Socure: Submit document images and selfie

    activate Socure
    Note over Socure: Process Document Verification
    Socure-->>App: Webhook: evaluation_completed (ACCEPT / REJECT)
    deactivate Socure

    App-->>User: Show final onboarding result

Evaluation processing

During the Direct API flow, RiskOS™ orchestrates multiple products and verification steps:

Next steps