PDF Verification

Identity verification via a France Identite certificate PDF.

How it works

PDF verification uses an official document generated by the France Identite service. The full flow, from your user's perspective:

Your site displays the ZYKAY widget (QR code on desktop, button on mobile)
The user scans the QR code or presses the button
ZYKAY app opens on phone
The user selects their France Identite certificate PDF
The ZYKAY server validates the document
A grant_code is returned to the widget on your site
Your backend exchanges the grant_code via POST /v1/exchange

The PDF must come from the France Identite (opens in a new tab) attestation service. Other documents (scanned identity card, passport, etc.) are not accepted.

Scopes available

PDF verification supports all ZYKAY scopes:

Scope	Description	Returned attribute
`isAdult`	At 18 years or older	`age_over_18: true`
`isFrench`	French nationality	`is_french: true`
`isEU`	Citizen of the European Union	`is_eu: true`
`isMale`	Male gender	`is_male: true`
`isFemale`	Female gender	`is_female: true`
`isUnique`	Unique identifier per application	`nullifier: "0x..."`
`revealNationality`	ISO nationality code	`nationality: "FRA"`
`revealBirthYear`	Year of birth	`birth_year: 1990`

For the complete scope reference, see Available Scopes.

Frontend integration

No additional attributes are needed for PDF verification. This is the widget's default mode:

<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>

For all available attributes, see Frontend Integration.

Next steps

Frontend Integration (Script Tag) — widget configuration
Backend (Exchange API) — exchange of grant_code
Available scopes — complete scope reference

Quick Start