Vérification PDF
Vérification d'identité via un PDF d'attestation France Identité.
Comment ça marche
La vérification PDF utilise un document officiel généré par le service France Identité. Le flux complet, du point de vue de votre utilisateur :
- Votre site affiche le widget ZYKAY (QR code sur desktop, bouton sur mobile)
- L'utilisateur scanne le QR code ou appuie sur le bouton
- L'application ZYKAY s'ouvre sur le téléphone
- L'utilisateur sélectionne son PDF d'attestation France Identité
- Le serveur ZYKAY valide le document
- Un
grant_codeest retourné au widget sur votre site - Votre backend échange le
grant_codeviaPOST /v1/exchange
Le PDF doit provenir du service d'attestation de France Identité (opens in a new tab). Les autres documents (carte d'identité scannée, passeport, etc.) ne sont pas acceptés.
Scopes disponibles
La vérification PDF supporte tous les scopes ZYKAY :
| Scope | Description | Attribut retourné |
|---|---|---|
isAdult | A 18 ans ou plus | age_over_18: true |
isFrench | Nationalité française | is_french: true |
isEU | Citoyen de l'Union européenne | is_eu: true |
isMale | Sexe masculin | is_male: true |
isFemale | Sexe féminin | is_female: true |
isUnique | Identifiant unique par application | nullifier: "0x..." |
revealNationality | Code nationalité ISO | nationality: "FRA" |
revealBirthYear | Année de naissance | birth_year: 1990 |
Pour la référence complète des scopes, consultez Scopes disponibles.
Intégration frontend
Aucun attribut supplémentaire n'est nécessaire pour la vérification PDF. C'est le mode par défaut du widget :
<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"></script>Pour tous les attributs disponibles, consultez Intégration Frontend.
Prochaines étapes
- Intégration Frontend (Script Tag) — configuration du widget
- Backend (Exchange API) — échange du
grant_code - Scopes disponibles — référence complète des scopes