Parcours Portefeuille EUDI

L'expérience utilisateur s'adapte automatiquement selon le contexte — aucune configuration requise de votre part.

Trois scénarios automatiques

L'application ZYKAY détecte l'état de l'utilisateur et optimise le parcours. Du plus complet au plus rapide :

Première visite (~15 secondes)

L'utilisateur n'a jamais été vérifié via le Portefeuille EUDI. Le parcours complet s'enclenche :

1. L'utilisateur ouvre l'app ZYKAY (via QR code ou bouton)
2. L'app demande la présentation du portefeuille EUDI (France Identité)
3. L'utilisateur approuve la présentation dans l'app France Identité
4. Vérification complète (~15 secondes)
5. Redirection vers votre site avec grant_code

Lors de la première visite, l'utilisateur doit avoir l'application France Identité installée et configurée avec son identité numérique (carte d'identité enregistrée).

Visite ultérieure avec données en cache (~15-30 secondes)

L'utilisateur a déjà présenté son portefeuille EUDI précédemment. Les données sont en cache sur le téléphone :

1. L'utilisateur ouvre l'app ZYKAY
2. Face ID valide l'identité
3. Vérification depuis les données en cache
4. Redirection vers votre site avec grant_code

Ce parcours est transparent pour l'utilisateur : pas de changement d'application, pas de présentation de document.

Connexion instantanée (~1,7 seconde)

L'utilisateur a déjà été vérifié pour votre site spécifiquement. La vérification est quasi-instantanée :

1. L'utilisateur ouvre l'app ZYKAY
2. Face ID valide l'identité
3. Vérification instantanée (aucune interaction supplémentaire requise)
4. Redirection vers votre site avec grant_code

La connexion instantanée s'active automatiquement pour les utilisateurs récurrents. C'est le scénario le plus courant après la première visite et offre la meilleure expérience utilisateur.

Sélection automatique du parcours

L'application choisit le parcours optimal sans intervention de votre part :

L'utilisateur a-t-il déjà été vérifié pour ce site ?
  OUI → Connexion instantanée (~1,7s)
  NON → Des données sont-elles en cache ?
    OUI → Depuis les données en cache (~15-30s)
    NON → Parcours complet avec France Identité (~15s)

Diagramme du flux

Utilisateur       Widget            App ZYKAY          Serveur ZYKAY
    |                |                   |                    |
    |-- Visite -->   |                   |                    |
    |                |-- verify-request ---------------------->
    |                |<- QR/deep link ---|                    |
    |-- Scan/Tap --> |                   |                    |
    |                |                   |-- Vérification --->|
    |                |                   |  (auto-optimisé)   |
    |                |                   |<-- grant_code -----|
    |                |<------ statut: terminé ----------------|
    |<- redirect --- |                   |                    |
    |                                                         |
    |-- POST /v1/exchange (backend) ----------------------->  |
    |<-- pass_token + attributs ----------------------------- |

Prérequis par scénario

Prérequis	Première visite	Visite ultérieure	Connexion instantanée
App ZYKAY	Oui	Oui	Oui
App France Identité	Oui	Non	Non
Face ID / biométrie	Oui	Oui	Oui
Connexion internet	Oui	Oui	Oui

Si l'app n'est pas installée

Si l'utilisateur n'a pas l'application ZYKAY, le widget affiche automatiquement une invite de téléchargement avec un lien vers l'App Store. L'utilisateur peut installer l'application et reprendre le processus de vérification.

Prochaines étapes

Portefeuille EUDI — intégration et migration
Scopes disponibles — référence complète
Dépannage — résolution des problèmes courants

Démarrage Rapide