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). Au lieu d'uploader un PDF, l'utilisateur présente ses attributs d'identité directement depuis l'application. 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 ne change pas. L'API POST /v1/exchange avec signature HMAC fonctionne identiquement pour les deux méthodes.
Comparaison PDF vs Portefeuille EUDI
| Vérification PDF | Portefeuille EUDI | |
|---|---|---|
| Scopes | Tous (8 scopes) | isAdult, isFrench, isEU, isUnique |
| Vitesse (première fois) | ~30-60s | ~15s |
| Vitesse (retour) | Identique | ~1,7s |
| Prérequis | PDF France Identité | App France Identité |
| Attribut frontend | — | data-client-proof-mode="true" |
| Backend | POST /v1/exchange | Identique |
Les scopes isMale, isFemale, revealNationality et revealBirthYear ne sont pas disponibles avec le Portefeuille EUDI. Si vous les incluez dans data-scopes avec data-client-proof-mode="true", la vérification échouera.
Migrer depuis la Vérification PDF
Si votre intégration utilise déjà la vérification PDF, la migration vers le Portefeuille EUDI se fait en deux étapes :
1. Vérifiez vos scopes
Retirez les scopes non supportés si nécessaire :
- data-scopes="isAdult,isFrench,isMale"
+ data-scopes="isAdult,isFrench"2. Ajoutez l'attribut
<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"
+ data-client-proof-mode="true"></script>Votre backend (POST /v1/exchange) ne nécessite aucune modification.
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