EUDI Wallet Journey

The user experience automatically adapts based on context — no configuration required on your part.

Three automatic scenarios

The ZYKAY app detects the user's state and optimizes the route. From the most complete to the fastest:

First visit (~15 seconds)

The user has never been verified via EUDI Wallet. The complete process begins:

1. The user opens the ZYKAY app (via QR code or button)
2. The app requests EUDI wallet presentation (France Identite)
3. The user approves the presentation in the France Identite app
4. Verification complete (~15 seconds)
5. Redirect to your site with grant_code

During the first visit, the user must have the France Identite application installed and configured with their digital identity (registered identity card).

Subsequent visit with cached data (~15-30 seconds)

The user has already presented their EUDI wallet previously. The data is cached on the phone:

1. The user opens the ZYKAY app
2. Face ID validates identity
3. Verification from cached data
4. Redirect to your site with grant_code

This journey is transparent for the user: no application change, no document presentation.

Instant connection (~1.7 seconds)

The user has already been verified for your site specifically. Verification is almost instantaneous:

1. The user opens the ZYKAY app
2. Face ID validates identity
3. Instant verification (no additional interaction required)
4. Redirect to your site with grant_code

Instant login turns on automatically for returning users. This is the most common scenario after the first visit and provides the best user experience.

Automatic route selection

The application chooses the optimal route without intervention on your part:

Has the user already been verified for this site?
  YES -> Instant login (~1.7s)
  NO -> Is data cached on device?
    YES -> From cached data (~15-30s)
    NO -> Full France Identite flow (~15s)

Flow diagram

User             Widget            ZYKAY App          ZYKAY Server
    |                |                   |                    |
    |-- Visit -->    |                   |                    |
    |                |-- verify-request ---------------------->
    |                |<- QR/deep link ---|                    |
    |-- Scan/Tap --> |                   |                    |
    |                |                   |-- Verification --->|
    |                |                   |   (auto-optimized) |
    |                |                   |<-- grant_code -----|
    |                |<------ status: completed --------------|
    |<- redirect --- |                   |                    |
    |                                                         |
    |-- POST /v1/exchange (backend) ----------------------->  |
    |<-- pass_token + attributes ---------------------------- |

Prerequisites by scenario

Prerequisites	First visit	Later visit	Instant connection
ZYKAY App	Yes	Yes	Yes
France Identite App	Yes	No	No
Face ID / biometrics	Yes	Yes	Yes
Internet connection	Yes	Yes	Yes

If the app is not installed

If the user does not have the ZYKAY app, the widget automatically displays a download prompt with a link to the App Store. The user can install the application and resume the verification process.

Next steps

EUDI Wallet — integration and migration
Available scopes — full reference
Troubleshooting — resolving common issues

Quick Start