> For the complete documentation index, see [llms.txt](https://docs.vida.id/identity-stack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vida.id/identity-stack/verify/kyc-mobile-sdk/integration-overview/android-sdk.md).

# Android SDK

VIDA's Android SDK combines **OCR, document verification, and KYC** in a single verification flow. Users get the same experience and the same response payload as on **iOS and Web**.

{% hint style="success" %}
**One integration, one result.** Users complete the whole flow inside the SDK, and your app receives a single structured response.
{% endhint %}

### Capabilities

<table><thead><tr><th width="234.5234375">Capability</th><th>What it does</th></tr></thead><tbody><tr><td><strong>OCR</strong></td><td>Extracts document fields as structured, machine-readable data</td></tr><tr><td><strong>Document Verification</strong></td><td>Checks image quality, detects tampering, and classifies the document</td></tr><tr><td><strong>KYC</strong></td><td>Completes identity verification as part of the same flow</td></tr><tr><td><strong>Liveness</strong></td><td>Confirms that a real, live person is present</td></tr><tr><td><strong>Face Match</strong></td><td>Compares the selfie with the photo on the document</td></tr></tbody></table>

### How it works

{% stepper %}
{% step %}

#### Guided capture

When the camera opens, the SDK gives users real-time, friendly guidance on screen. Capture happens automatically once the image meets the quality requirements.

| Prompt shown to user | Purpose                                  |
| -------------------- | ---------------------------------------- |
| *Move closer*        | Document is too small in the frame       |
| *Avoid glare*        | Reflection is obscuring document details |

{% hint style="info" %}
No capture button is needed. The SDK captures the image as soon as the quality gates are met.
{% endhint %}
{% endstep %}

{% step %}

#### Automated document checks

After capture, the SDK checks the image for:

* Blur and glare
* Tampering
* Document type (classification)
* Front-and-back side match *(where required)*
  {% endstep %}

{% step %}

#### OCR and user review

OCR extracts the document fields, and the SDK shows a **configurable review screen** where users confirm the information before submitting.
{% endstep %}

{% step %}

#### Unified result

Your app receives **a single structured response**. Verification records can be viewed in the Dashboard.
{% endstep %}
{% endstepper %}

### Why use the Android SDK

{% columns %}
{% column %}

#### 🎯 Higher quality input

Real-time guidance catches bad images before submission, reducing retakes and rejections.
{% endcolumn %}

{% column %}

#### 🔁 Consistent across platforms

Flows and payloads match iOS and Web, so your team can share logic, testing, and support processes.
{% endcolumn %}

{% column %}

#### ⚖️ Flexible risk control

Configurable thresholds and retry rules let you balance conversion against risk.
{% endcolumn %}
{% endcolumns %}

### Requirements

<table><thead><tr><th width="298.69140625">Requirement</th><th>Details</th></tr></thead><tbody><tr><td>Minimum Android version</td><td><code>[API level]</code></td></tr><tr><td>Permissions</td><td>Camera</td></tr><tr><td>Language</td><td><code>[Kotlin / Java]</code></td></tr><tr><td>Credentials</td><td><code>[Client ID / API key]</code> from your VIDA account</td></tr></tbody></table>

### Integration at a glance

{% stepper %}
{% step %}

#### Add the SDK

Add the VIDA SDK dependency to your project. See Installation.
{% endstep %}

{% step %}

#### Initialize and launch

Initialize the SDK with your credentials and launch the verification flow. See Quickstart.
{% endstep %}

{% step %}

#### Handle the result

Receive the structured response in your callback and continue your app flow. See Response payload.
{% endstep %}
{% endstepper %}

### Configuration

{% hint style="warning" %}
Thresholds and retry rules directly affect your conversion rate and fraud exposure. Test your settings in the sandbox before moving to production.
{% endhint %}

<details>

<summary>What can be configured?</summary>

* Quality thresholds (blur, glare)
* Retry rules
* Review screen behavior

</details>