Portefeuille EUDI

Vérification d'identité via portefeuille EUDI (France Identité).

Comment ça marche ?

Le Portefeuille EUDI utilise l'application France Identité comme portefeuille d'identité numérique (EUDI Wallet). L'utilisateur présente ses attributs d'identité directement depuis son portefeuille EUDI. La vérification s'effectue directement sur l'appareil de l'utilisateur — ZYKAY ne voit jamais les données personnelles.

Les utilisateurs déjà vérifiés bénéficient d'une connexion instantanée (~1,7 seconde) via Face ID, sans aucune interaction supplémentaire.

L'utilisateur doit avoir l'application France Identité (opens in a new tab) installée et configurée avec son identité numérique.

Intégration rapide

Ajoutez `data-client-proof-mode`

Un seul attribut supplémentaire active le Portefeuille EUDI :

<script src="https://widget-app.zykay.com/v4/loader.min.js"
        data-partner-id="pk_live_xxx"
        data-success-path="/verified"
        data-scopes="isAdult,isFrench,isUnique"
        data-client-proof-mode="true"></script>

Le widget gère le reste

Le widget affiche un QR code (desktop) ou un bouton (mobile). L'application ZYKAY sur le téléphone route automatiquement l'utilisateur vers le parcours optimal.

Échangez le `grant_code`

const hash = new URLSearchParams(window.location.hash.slice(1));
const grantCode = hash.get('grant_code');
if (grantCode) {
  await fetch('/api/zykay/exchange', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ grant_code: grantCode })
  });
}

Le backend est indépendant de la méthode côté utilisateur. L'API POST /v1/exchange avec signature HMAC reste identique.

Caracteristiques

Caractéristique	Portefeuille EUDI
Scopes disponibles	`isAdult`, `isFrench`, `isEU`, `isUnique`
Vitesse (première fois)	~15s
Vitesse (retour)	~1,7s
Prérequis utilisateur	App France Identité (portefeuille EUDI)
Attribut frontend	`data-client-proof-mode="true"`
Backend	`POST /v1/exchange`

Parcours utilisateur

L'application ZYKAY optimise automatiquement le parcours selon le contexte de l'utilisateur. Trois scénarios sont possibles, du plus lent au plus rapide :

Scénario	Durée	Quand
Première visite	~15s	L'utilisateur n'a jamais été vérifié
Visite ultérieure	~15-30s	Données en cache, pas de re-présentation EUDI
Connexion instantanée	~1,7s	Utilisateur déjà vérifié pour votre site

La connexion instantanée s'active automatiquement pour les utilisateurs ayant déjà été vérifiés pour votre site. Aucune configuration n'est requise de votre part.

Pour le détail de chaque parcours, consultez Parcours Portefeuille.

Prochaines étapes

Parcours Portefeuille — détail des trois scénarios
Scopes disponibles — référence complète
Intégration Frontend — tous les attributs du widget
Backend (Exchange API) — échange du grant_code
Dépannage — résolution des problèmes courants

Démarrage Rapide