# eKYB V1 vs V2 Comparison

In V1, eKYB Verification presents a functional but generic credentials form experience. The screen focuses on collecting user information user information with standard input fields and minimal contextual structure. Processing and success state are simple and isolated, with little continuity between steps. The experience feels transactional, with basic feedback once the form is submitted.

In V2, eKYB Verification introduces a more structured, branded and guided experience. The interface is organized into clear sections, improving readability and reducing cognitive load. Processing and success states feel more cohesive with smoother visual transitions and clearer confirmation messaging making the flow feel complete and intentional.

<br />

<Image align="center" caption="V1 is a basic eKYB experience with limited guidance." src="https://files.readme.io/c1beb9ffc4230ae3d0f60dfc577a868565f5bb05f68c26f3d5a929fa53ee9235-v1.png" />

<br />

<Image align="center" caption="V2 delivers a more structured, guided, and branded eKYB experience." src="https://files.readme.io/02192621834b7b8b8c19d35d9af67b4993dce88b077758eb0dfdde6cc0a41fcc-v2.png" />

<br />

***

<br />

## Feature Comparison

Functional capabilities of the module (objective features only; no UX or performance differences).

<br />

| Capabilities               | V1 | V2 | Notes                                                                                                                            |
| -------------------------- | -- | -- | -------------------------------------------------------------------------------------------------------------------------------- |
| eKYB data collection       | ✅  | ✅  | Core eKYB data capture supported in both versions.                                                                               |
| Inline validation          | ✅  | ✅  | Field-level validation during input available in both versions.                                                                  |
| Error States               | ✅  | ✅  | Both versions cover general error cases that users can encounter.                                                                |
| Customization options      | ❌  | ✅  | V1 provides limited customization options, while V2 allows full control over text, colors, buttons, illustrations, and behavior. |
| Documentation completeness | ❌  | ✅  | V2 provides complete, standardized documentation coverage.                                                                       |

<br />

***

<br />

## Behavior Differences

How the module behaves during runtime.

| Behavior              | V1                            | V2                                                                | Notes                                                                          |
| --------------------- | ----------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| Feedback presentation | Brief contextual instructions | Clear, actionable feedback for a successful capture               | V2 has updated feedback instructions for users to correct their action faster. |
| State transitions     | Default transitions           | Specifically designed screen-by-screen transitions for smoothness | V2 includes transition guidelines as part of the module documentation package. |
| Processing behavior   | Static processing screen      | Branded processing state with consistent loading behavior         | V2 aligns loading behavior with the overall system patterns                    |

<br />

***

<br />

## **Customization Overview**

Customization in V2 is significantly simpler and more consistent across modules.

<Image align="center" caption="Customizing the experience to match your brand is simpler in V2" src="https://files.readme.io/628504ced4925849858a96b4b9ff316c4af7f62e35f9e4e765cef3b1710a0575-eKYBGIFcustomization.gif" />

<br />

Instead of having isolated configuration options per screen or component, V2 uses a unified token-based system that allows developers to control visuals, behaviors, and experience patterns with fewer parameters and predictable outcomes.

This means:

* Less engineering work to override UI elements
* Consistent branding across modules
* Predictable behavior when changing settings
* Reduced risk of breaking flows
* Clear separation between visual tokens and experience configuration

V2 also centralizes all customization options under a single structure, so developers always know where to look and what they can modify.

<br />

<br />