> 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/one-click-onboarding/user-journey.md).

# User Journey

#### 1. **Client Landing Screen**

This is the initial interface users see on the client-managed platform before starting the onboarding process.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2FyT8Hg3YbHLo3sKIRaZfV%2F126.png?alt=media&amp;token=9c463fab-e80d-4f4b-8a1e-5eb2cd44f2b8" alt="" width="183"><figcaption></figcaption></figure>

***

#### 2. **Phone Number Input**

Users are prompted to enter their phone number. The "Next" button remains inactive until the full number is input correctly.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2FrPFX3BHHSWS9Wj7ySQum%2FLiveness%20Introduction%20(5).png?alt=media&amp;token=151d4037-2051-4ac3-9d37-60ccc6eea874" alt=""><figcaption></figcaption></figure>

***

#### 3. **Phone Number Not Found**

If the number is not recognized, users see this screen with options to re-enter the number or return to the homepage.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2FJBhWZo5JnsXmKEoSHBn6%2FLiveness%20Introduction%20(4).png?alt=media&amp;token=e4881762-049f-44b4-bcf4-c4277559bc53" alt=""><figcaption></figcaption></figure>

***

#### 4. **NIK Input (National Identity Number)**

Users must enter their NIK. Similar to the phone number field, the button activates only after the complete number is entered.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2FwuaYGDa6JZ9KYv6AkYXQ%2FLiveness%20Introduction%20(6).png?alt=media&amp;token=c8271c97-e819-4bca-95aa-ac6a2e020d32" alt=""><figcaption></figcaption></figure>

***

#### 5. **Consent Screen**

Before continuing, users are presented with a consent notice informing them that their identity will be verified.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2F9c15znt5MvLG8bXXQpuy%2FConsent%20page%20(2).png?alt=media&amp;token=e1f7c5ea-1689-48e7-b37c-dec34a10c544" alt=""><figcaption></figcaption></figure>

***

#### 6. **Liveness Tutorial Screen**

Instructions are shown to guide users through the liveness check process, explaining best practices and things to avoid.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2FjAkIECDEx0oIFzVWUMZ3%2FLiveness%20Introduction%20(7).png?alt=media&amp;token=3988d037-0f6c-4e05-81e3-bd858500a6ca" alt=""><figcaption></figcaption></figure>

***

#### 7. **Camera Access Request**

Users are prompted to grant camera access to begin the liveness verification.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2FCFrqow0KbA4jqUn5qs1A%2FLoading%20(2).png?alt=media&amp;token=2f7df607-6f1b-4509-bf41-dec068019a47" alt=""><figcaption></figcaption></figure>

***

#### 8. **Selfie Capture Screen**

This screen provides clear steps for users to capture their selfie correctly for identity verification.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2Fvjcbsl9gVbbkaVsYfJ6J%2FConsent%20page%20(3).png?alt=media&amp;token=13784967-6072-4360-8991-7b46fdec6411" alt=""><figcaption></figcaption></figure>

***

#### 9. **Need Help Screen**

Guidance is offered for users who are unsure or facing difficulties during the selfie/liveness step.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2FH9aFjF9S0sAb2MpgO8RG%2FLiveness%20Introduction%20(3).png?alt=media&amp;token=2b324891-440b-4a6c-850c-4ae8130db52d" alt=""><figcaption></figcaption></figure>

***

#### 10. **Maximum Attempts Reached**

Appears if the user has failed the liveness check too many times. They are informed that they cannot proceed further at this time.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2Ff4CD32clZ5y0geu0bzYf%2FMaximum%20attempts.png?alt=media&amp;token=312bb3f6-4992-49eb-872e-063919368a00" alt=""><figcaption></figcaption></figure>

***

#### 11. **Review Screen (On Error)**

Displayed if there’s an error with the captured selfie. The user is shown the issue and prompted to retake or adjust as needed.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2FfmEhmoYFZnRUFGAD8xCg%2FScreenshot%202025-08-01%20at%2012.40.23%20AM.png?alt=media&amp;token=94410194-b851-4a6b-a6d2-5ea060c7d79f" alt="" width="188"><figcaption></figcaption></figure>

***

#### 12. **Personal Information Review**

After successful liveness and OCR, users can review their personal details extracted from their ID.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2FovHwRLADP248cqkMJE0a%2FLoading%20(1).png?alt=media&amp;token=d4ce30f7-807d-4092-b941-a7b13e03c507" alt=""><figcaption></figcaption></figure>

***

#### 13. **Incorrect Data Handling**

If the data is incorrect, users are given the option to identify which part is wrong and correct it.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2F6U2Dx8aRoECq5G48hKJH%2FScreenshot%202025-08-01%20at%2012.41.25%20AM.png?alt=media&amp;token=afe94e29-264b-477f-9381-1e73c0a4d513" alt="" width="188"><figcaption></figcaption></figure>

***

#### 14. **Success Confirmation**

This final screen confirms that the onboarding and KYC process has been successfully completed.

<figure><img src="https://2033469942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC2s0IISjZwzGfw8dm215%2Fuploads%2FEEPsj7gcGmPsFcKH3LCc%2FLoading%20(3).png?alt=media&amp;token=39bd8b3f-5998-4f98-87c2-a7a580f997ef" alt=""><figcaption></figcaption></figure>
