France Identité

Verifies a user’s identity using the France Identité mobile app

Provides a secure verification option where users prove their identity through France’s national digital identity app. Ideal for fast, trusted onboarding or identity verification processes.

info

For new integrations, use the eIDs (v2) step instead. It supports France Identité alongside other eID providers through a unified configuration, and is the recommended approach going forward. The FRANCE_IDENTITE:v1 step remains available for existing integrations.

---

Key features

• OIDC-based authentication: Secure authentication using France Identité via OpenID Connect.
• Seamless redirection: Redirects users to France Identité for login and returns them post-authentication.
• Ready-to-use: No additional configuration needed for integration.

---

Configuration

Option	Type	Required	Description
enableRetry	boolean	No	When true, adds a retry output route that can be used to handle user cancellations. Defaults to false.

---

Input data blocks

This step does not require any input data blocks.

---

Routes

Route	Description
verified	The user's identity has been successfully authenticated by the France Identité wallet. The user has consented to sharing their data, and the OIDC flow has completed with the reception of an ID Token containing the verified attributes.
not_verified	The authentication attempt failed. The identity could not be verified because the user failed to authenticate with their wallet (e.g., by entering an incorrect PIN).
retry	Available when enableRetry: true. Taken when the user clicks the Go back button. Returns a rollback transition to the retry step.

:::note User cancellation vs. retry The close button (X) in the header always aborts the session — it is not affected by enableRetry and never routes to retry. Only the Go back button (visible when enableRetry: true) takes the retry route. :::

---

Output data blocks

Route	Data blocks produced
verified	BasicIdentity, ExtendedIdentity, AuthenticationResult
not_verified	AuthenticationResult
retry	AuthenticationResult

---

Example payloads

BasicIdentity — verified

{
  "dataBlockId": "01900000-0000-7000-8000-000000000001",
  "type": "BasicIdentity",
  "givenName": "Jean",
  "familyName": "Dupont",
  "name": "Jean Dupont",
  "birthDate": "1985-03-22",
  "birthPlace": "Paris"
}

ExtendedIdentity — verified

{
  "dataBlockId": "01900000-0000-7000-8000-000000000002",
  "type": "ExtendedIdentity",
  "portrait": { "$ref": "vault", "$id": "020ff369-43d8-4b8a-94e7-6814c0bdc35a" },
  "nationality": "FRA",
  "personalAdministrativeNumber": null,
  "familyNameBirth": "Dupont",
  "givenNameBirth": "Jean",
  "sex": 1,
  "emailAddress": null,
  "mobilePhoneNumber": null,
  "residentAddress": "24 RUE DANTON 35700 RENNES FRANCE",
  "residentStreet": "RUE DANTON",
  "residentHouseNumber": "24",
  "residentHouseName": null,
  "residentCountry": "FR",
  "residentState": "Bretagne",
  "residentCity": "RENNES",
  "residentPostalCode": "35700"
}

AuthenticationResult — verified

{
  "dataBlockId": "01900000-0000-7000-8000-000000000003",
  "type": "AuthenticationResult",
  "result": "success",
  "provider": "france-identite",
  "credentialId": "cred-7f3a2b1c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "credentialType": "eidToken",
  "subjectId": "sub-9e8d7c6b-5a4f-3e2d-1c0b-a9f8e7d6c5b4",
  "requestId": "req-1a2b3c4d-5e6f-7a8b-9c0d-e1f2a3b4c5d6",
  "authenticatedAt": "2026-02-10T14:00:01.000Z"
}

---