> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Identité vérifiée : vérification à l'inscription et réauthentification avant les versements

> Avec Didit, exigez une détection du vivant ou une vérification d'identité avant la création d'un compte, puis avant versements et actions sensibles.

La fonctionnalité Verified identity de Didit Authentication demande aux personnes de prouver qui elles sont aux moments que vous choisissez : avant la création de leur compte, puis à nouveau avant une action sensible, comme un versement.
Votre application reçoit le résultat et les attributs vérifiés que vous avez sélectionnés, comme `over_18` ou un nom vérifié, dans les tokens de la personne, jamais ses documents ni ses photos.

Configurez-le dans la console, sous **Authentication > Verified identity**, ou par API avec [`verified/`](#configuration-par-api).

![La page Verified identity dans la Didit Business Console, avec les niveaux de vérification à l'inscription et leurs tarifs, ainsi que les règles de vérification renforcée avant les actions sensibles](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-verified-identity.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=98544caeedf5ffaf68484cace19f9b3f)

Authentication > Verified identity : la vérification à l'inscription et les règles avant les actions sensibles.

## Fonctionnement

Chaque contrôle s'exécute comme une session de vérification de votre propre application, créée avec les `vendor_data` de la personne.
Elle apparaît donc dans vos vérifications et est associée à la même personne que ses connexions et ses transactions, passe en examen manuel comme toute autre vérification, et est facturée au prix de cette vérification.

| Contrôle | Ce que fait la personne | Tarif public |
| - | - | - |
| Détection du vivant | Prend un selfie, vérifié pour la détection du vivant. | \$0.10 |
| Connexion par selfie | Prend un selfie que Didit compare au visage déjà enregistré pour la personne. | \$0.10 |
| Pièce d'identité complète | Scanne un document d'identité et prend un selfie : vérification du document, détection du vivant et correspondance faciale. | \$0.33 |

Didit exécute chaque contrôle avec son workflow par défaut, ou avec l'un de vos propres workflows que vous choisissez pour ce contrôle.
Consultez les [tarifs](https://docs.didit.me/fr/getting-started/pricing.md) pour connaître le prix de chaque vérification.

## À l'inscription

Choisissez le niveau qu'une personne doit franchir avant que son compte ne soit créé :

| Niveau | Valeur | Signification |
| - | - | - |
| Aucune vérification | `none` | Toute personne disposant d'une adresse e-mail, d'un téléphone ou d'une clé d'accès peut s'inscrire. Par défaut. |
| Détection du vivant | `liveness` | Une personne réelle s'inscrit : un seul selfie, vérifié par détection du vivant. |
| Vérification d'identité complète | `full_id` | Document, détection du vivant et correspondance faciale, avant que le compte n'existe. |

Un nouveau niveau ne s'applique qu'aux personnes qui s'inscrivent à partir de ce moment, jamais aux comptes existants.

Sur les pages hébergées, Didit fait passer la personne par la vérification pendant l'inscription.
Sur vos propres écrans, l'appel d'inscription renvoie `verification_required` avec un `verification_url` valable 30 minutes : envoyez-y la personne.
Didit n'émet le code de connexion qu'une fois la vérification approuvée.

## Vérification renforcée avant les actions sensibles

Une vérification renforcée demande à la personne de se vérifier à nouveau, uniquement lorsqu'une action présente un risque suffisant.
Vous activez les règles, et votre application demande à Didit avant chaque action sensible si l'une d'elles s'applique.

![Un téléphone affichant une vérification renforcée qui demande à la personne de confirmer son identité avec un selfie](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/step-up-preview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=dd5087d0ba5f20b49bbd4252149ef8ca)

Ce qu'une personne voit lorsqu'une vérification renforcée demande un selfie.

| Règle | Demandée lorsque | Vérification par défaut |
| - | - | - |
| `payout` | Un retrait ou un virement dépasse votre seuil, par exemple 500 dans votre devise. Un versement dans une autre devise est toujours vérifié. | Connexion par selfie |
| `device` | Un versement est effectué dans une session sur un appareil qu'aucune des sessions précédentes de la personne n'a utilisé. | Connexion par selfie |
| `bank` | La personne ajoute ou modifie un compte bancaire. | Vérification d'identité complète |
| `contact` | La personne modifie son adresse e-mail ou son numéro de téléphone. | Détection du vivant |

Vous pouvez remplacer la vérification de chaque règle par une détection du vivant, une connexion par selfie ou une vérification d'identité complète.
Lorsque plusieurs règles s'appliquent, Didit demande la vérification la plus stricte.
Lorsque Didit n'a encore aucune donnée faciale pour la personne, une connexion par selfie devient une vérification d'identité complète.

### Demander une vérification renforcée

Votre application appelle `POST {issuer}/step-up/` avec le jeton d'accès de la personne, ou la méthode `stepUp()` des SDK :

```bash theme={null}
curl --fail-with-body "${DIDIT_AUTH_ISSUER}/step-up/" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "payout", "amount": "900.00", "currency": "USD", "return_to": "https://app.example.com/payouts/confirm"}'
```

| Champ | Règle |
| - | - |
| `action` | `payout`, `bank` ou `contact`. Un versement applique aussi la règle `device`. |
| `amount` | Obligatoire pour `payout`, avec deux décimales au maximum. |
| `currency` | Code ISO 4217. Par défaut, la devise de votre règle de versement. |
| `return_to` | Page où la personne revient après la vérification. Lorsqu'une règle s'applique, elle doit faire partie de vos [URL de redirection](https://docs.didit.me/fr/authentication/overview.md#url-de-redirection) enregistrées. |

* `200 {"required": false}` : aucune règle ne s'applique, vous pouvez poursuivre l'action.
* `201` avec `verification_url` : envoyez la personne à cette adresse. La vérification renforcée reste ouverte pendant 30 minutes (`expires_in: 1800`).

### Lire le résultat côté serveur

La personne revient à `return_to` avec `step_up=<id>&status=approved` ajouté, mais ces paramètres de requête ne prouvent rien.
Votre backend lit la vérification renforcée avec `GET {issuer}/step-up/{step_up_id}/` et un jeton d'accès de la même session, et n'agit que lorsque `status` vaut `approved`.

| Statut | Signification |
| - | - |
| `pending` | La personne n'a pas encore terminé la vérification. |
| `approved` | La personne a réussi. Vous pouvez poursuivre l'action. |
| `review` | La vérification attend l'examen de votre équipe. |
| `declined` | La personne n'a pas réussi. Ce n'est pas définitif tant que `verification_url` reste active : elle peut réessayer, et la vérification renforcée repasse à `pending`. |
| `expired` | Les 30 minutes sont écoulées. Créez une nouvelle vérification renforcée. |
| `superseded` | Une autre vérification a pris le relais, ou le résultat ne concernait pas cette vérification renforcée. Créez-en une nouvelle. |

Une vérification renforcée ne laisse jamais passer une action en cas d'échec : lorsque la vérification est indisponible, l'action reste bloquée.
Les démarrages rapides [JavaScript](https://docs.didit.me/fr/authentication/quickstarts/javascript.md#step-up-et-réauthentification), [Next.js](https://docs.didit.me/fr/authentication/quickstarts/nextjs.md#authentification-renforcée-avant-les-actions-sensibles) et [iOS](https://docs.didit.me/fr/authentication/quickstarts/ios.md#authentification-renforcée-avant-les-actions-sensibles) montrent le côté SDK, et la [référence API](https://docs.didit.me/fr/authentication/api-reference/create-step-up.md) contient le contrat complet.

## Ce que reçoit votre application

Choisissez les revendications vérifiées à inclure dans les tokens de la personne :

| Revendication | Valeur |
| - | - |
| `over_18`, `over_21` | Indique si la personne a au moins 18 ans, ou 21 ans, d'après la date de naissance vérifiée. |
| `given_name`, `family_name` | Le prénom et le nom vérifiés. |
| `birthdate` | La date de naissance figurant sur le document, au format `YYYY-MM-DD`. |
| `nationality` | Code ISO 3166-1 alpha-2. |
| `country` | Code ISO 3166-1 alpha-2 du pays du document. |
| `document_verified` | Indique si un document d'identité a été vérifié. |
| `liveness` | Indique si la vérification de détection du vivant a été réussie. |

Les tokens d'accès et les tokens ID les contiennent dans `verified`, avec `level`, le niveau le plus élevé que la personne a atteint : `liveness`, `liveness_face_match` ou `full_id`.
Il vaut `{}` lorsque la personne n'en a réussi aucun, et `GET /session/` renvoie `null` à la place.

```json theme={null}
{
  "verified": {
    "level": "full_id",
    "over_18": true,
    "given_name": "Alex",
    "country": "ES"
  }
}
```

* Une vérification approuvée pendant une session est reportée dans les tokens lors du prochain renouvellement, dans un délai de 5 minutes.
* Toute entité qui détient le token peut lire ces revendications, y compris votre front-end ; ne sélectionnez donc que les revendications personnelles dont votre application a besoin.
* Votre application ne reçoit que des revendications, jamais le document, le selfie ni les données faciales.

## Configuration par API

Les méthodes `GET` et `PATCH` sur `verified/` de l'[API de gestion de l'authentification](https://docs.didit.me/fr/authentication/set-up-by-api.md) de votre application lisent et modifient les mêmes paramètres que la console :

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}verified/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signup_level": "liveness",
    "rules": [
      {"rule": "payout", "enabled": true, "method": "selfie", "threshold": "500.00", "currency": "USD"},
      {"rule": "bank", "enabled": true, "method": "full_id"}
    ],
    "claims": ["over_18", "given_name", "country"]
  }'
```

| Champ | Valeurs |
| - | - |
| `signup_level` | `none`, `liveness` ou `full_id`. |
| `rules` | Une entrée par règle que vous modifiez : `rule` (`payout`, `device`, `bank` ou `contact`), `enabled`, `method` (`liveness`, `selfie` ou `full_id`), et, pour `payout` uniquement, `threshold` et `currency`. |
| `claims` | Les revendications à inclure dans les tokens, parmi celles du tableau ci-dessus. |
| `workflows` | Facultatif : votre propre identifiant de workflow pour `liveness`, `selfie` ou `full_id`, ou `null` pour le workflow par défaut de Didit. |

Une règle que vous omettez conserve ses paramètres actuels.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.