Passer au contenu principal
La Vérification d’identité est une fonctionnalité unique dotée de trois méthodes. Vous choisissez quelles méthodes un pays peut utiliser ; l’utilisateur final se voit proposer celles applicables au pays qu’il sélectionne, et la session enregistre la méthode ayant réellement produit le résultat. La Capture du document reste inchangée. Tout ce que vous configurez déjà via documents_allowed — types acceptés, sous-types, règles de capture, seuils, avertissements — continue de fonctionner exactement comme auparavant, et un workflow qui ne spécifie rien sur les méthodes reste limité à la capture de document.

​
Comment fonctionne chaque méthode

​
Capture du document

Ce que détaille le reste de cette section : l’utilisateur photographie le document, Didit le lit, en vérifie l’authenticité et renvoie les champs extraits. Disponible dans tous les pays pris en charge par Didit, à $0.15 par vérification. Commencez par la Vue d’ensemble de la Vérification d’identité.

​
Recherche sans document

L’utilisateur saisit son numéro d’identité national et quelques informations personnelles, et Didit les vérifie auprès de la source faisant autorité pour ce pays. Aucune photo de document n’est impliquée. Cette source est un registre gouvernemental dans la plupart des pays, mais pas dans tous : au Canada, en France, en Indonésie, aux Pays-Bas, en Norvège, à Singapour, au Royaume-Uni et aux États-Unis, il s’agit plutôt d’un fichier d’agence d’évaluation du crédit, de services financiers, de services publics ou de registres de résidence. Dans la mesure où la provenance et le régime de consentement applicable diffèrent en conséquence, la source exacte est précisée par pays dans le tableau ci-dessous et sur Recherche sans document — sans jamais être généralisée. Lorsque la source renvoie un portrait — en Afrique du Sud, au Nigeria, en Argentine et au Panama aujourd’hui, quatre registres gouvernementaux —, un selfie est également demandé à l’utilisateur. Une détection du vivant passive est effectuée sur ce selfie, qui fait ensuite l’objet d’une correspondance faciale avec le portrait du registre, le tout intégré à la recherche et inclus dans son prix. Lorsque la source renvoie uniquement des données, il n’y a aucun élément de comparaison pour la correspondance faciale ; aucun selfie n’est donc pris. Exécutez Détection du vivant et Correspondance faciale en tant qu’étapes de workflow dédiées si vous en avez besoin. L’intégralité des champs de requête par pays, des règles de format et des régimes de consentement figure sur la page Recherche sans document.

​
Portefeuille

L’utilisateur se connecte à l’aide d’une identité numérique dont il dispose déjà, comme un eID national ou une identité bancaire. Le portefeuille l’authentifie, puis partage des attributs d’identité signés avec Didit. Selon le portefeuille, l’utilisateur peut saisir un code d’identification personnel ou un numéro de téléphone ; aucune photographie de document n’est requise pour la vérification par portefeuille. L’expérience de connexion dépend du portefeuille : redirection vers une application, code QR ou code de comparaison confirmé sur le téléphone de l’utilisateur. Smart-ID and Mobile-ID utilisent un code de comparaison. Les attributs par portefeuille, la disponibilité en production et la sémantique des échecs sont détaillés sur la page Portefeuilles d’identité numérique.

​
Niveaux d’assurance

Chaque résultat de Vérification d’identité comporte un niveau d’assurance dérivé de la méthode qui l’a produit. Ce niveau constitue une description fidèle de ce qui a réellement été prouvé, et non un classement :
Les niveaux d’assurance sont un libellé destiné aux administrateurs. Ils apparaissent dans le payload de la session, dans la console et dans les exports. Les utilisateurs finaux ne voient jamais le niveau, le prix ni le nom de la source interrogée.

​
Configurer les méthodes par pays

Les méthodes sont définies sous la clé methods de la configuration de la fonctionnalité de Vérification d’identité (OCR), indexées par le code pays ISO 3166-1 alpha-3. Si vous omettez la clé, omettez un pays ou omettez une méthode pour un pays, ce pays utilisera uniquement la capture du document.
Les deux pays ci-dessus sont indiqués comme available pour la recherche dans le catalogue publié. L’exemple laisse les portefeuilles désactivés afin de ne pas dépendre de l’activation d’un portefeuille dans votre environnement. Un workflow qui active un portefeuille marqué Prochainement est rejeté, tout comme le reste de la configuration soumise lors de cet enregistrement. Dès que le catalogue indique un portefeuille comme available dans un pays, le bloc portefeuille pour ce pays se présente ainsi :
Vérifiez le catalogue avant de l’envoyer. Prérequis : le portefeuille doit être indiqué comme disponible pour ce pays, comme répertorié sur la page Portefeuilles d’identité numérique. Deux règles imposées par l’API lors de l’enregistrement :
  • La disponibilité est déterminée par le serveur. Une méthode ou un portefeuille que le catalogue de capacités n’indique pas comme available pour ce pays est rejeté. Consultez d’abord le catalogue — via l’onglet Pays de la console ou à l’aide de l’outil MCP didit_workflow_get_id_verification_methods_catalog.
  • Les portefeuilles forment une liste d’autorisation, jamais un classement. providers indique les portefeuilles qu’un pays peut proposer. L’ordre envoyé n’a aucune importance et est normalisé ; c’est l’utilisateur final qui choisit.
La référence complète champ par champ, y compris les valeurs par défaut et la validation, se trouve dans Configurations des fonctionnalités de workflow.

​
Solution de repli : que se passe-t-il lorsqu’une méthode sans document n’aboutit pas

Quatre commutateurs déterminent la suite des événements. Chacun d’eux prend soit la valeur fallback_to_document (rediriger l’utilisateur vers la capture de document), soit decline (mettre fin à la session avec une Vérification d’identité refusée) ; wallet.on_failure accepte également retry, décrit ci-dessous. Tous les quatre sont définis par défaut sur fallback_to_document. wallet.on_failure accepte également une troisième valeur, retry, pour un pays qui accepte uniquement le portefeuille (capture de document désactivée) : retry est réservé aux portefeuilles : les commutateurs de recherche prennent fallback_to_document ou decline, car un registre ayant répondu « aucune correspondance » n’a rien à réessayer. Elle est refusée en combinaison avec document.fallback_only, qui nécessite un échec aboutissant à la capture de document. Un portefeuille connecté qui a renvoyé des données échouant aux contrôles de votre workflow (âge, correspondance du nom, etc.) constitue une connexion vérifiée : ce sont les règles du workflow qui tranchent, wallet.on_failure ne s’applique pas. Une connexion dont le token est authentique mais inacceptable (niveau de garantie incorrect, signature invalide, revendications requises manquantes) est considérée comme un échec et suit wallet.on_failure. id_lookup.max_attempts (1 à 5, valeur par défaut 1) correspond au nombre de recherches ayant obtenu une réponse dont bénéficie l’utilisateur avant le déclenchement du commutateur. Un numéro qui ne passe pas le contrôle de format côté client n’atteint jamais le registre et ne consomme donc pas de tentative — l’utilisateur est simplement invité à le corriger. Un portefeuille ou une recherche ne peut basculer vers la capture de document que si la capture de document est activée pour ce pays et qu’au moins un type de document y est accepté. Si la capture de document est désactivée, ou si aucun type de document n’est accepté pour le pays, la session est refusée en cas d’échec de connexion ou de recherche sans correspondance, même si le commutateur indique fallback_to_document. L’exception est wallet.on_failure: retry, qui ne refuse jamais : l’utilisateur reste sur l’étape du portefeuille. Il n’y a aucune solution de repli possible. Quelle méthode a produit le résultat : fallback_from verification_method désigne toujours la méthode ayant produit le résultat vérifié : wallet, id_lookup ou document. fallback_from explique pourquoi une méthode sans document n’a pas finalisé l’étape d’identité, dans les deux cas de figure :
  • Repli appliqué. L’utilisateur est redirigé vers la capture de document. La vérification de document qui suit comporte verification_method: "document" et fallback_from précisant la méthode qui a échoué, par exemple { "method": "wallet", "reason": "cancelled", "action": "fallback_to_document" }. Une session vérifiée par le portefeuille comporte verification_method: "wallet" et fallback_from: null.
  • Refus. Le commutateur est configuré sur decline, ou il n’y a aucun document vers lequel se replier. La Vérification d’identité refusée comporte fallback_from avec "action": "decline".
method vaut wallet ou id_lookup, et reason indique le résultat qui y a mis fin (cancelled, timeout, no_match, provider_error, etc.). Les mêmes champs apparaissent dans la décision de la session et sur le webhook status.updated. Un registre qui ne répond pas (délai d’attente dépassé ou panne) constitue une exception : il ne refuse jamais l’utilisateur de lui-même. La recherche n’est pas facturée et aucune tentative n’est décomptée ; l’utilisateur est invité à réessayer. Après trois recherches sans réponse lors de cette étape, id_lookup.on_provider_error s’applique : decline entraîne un refus et fallback_to_document redirige l’utilisateur vers la capture de document. Lorsque ce commutateur est défini sur fallback_to_document mais que le pays ne dispose d’aucun document de repli, la recherche reste ouverte et l’utilisateur peut continuer à essayer ; la session n’est pas refusée.

​
Proposer la capture de document uniquement comme solution de repli

Par défaut, un pays proposant un portefeuille ou une recherche d’identité en plus de la capture de document les affiche côte à côte sur le premier écran. Définissez document.fallback_only sur true pour maintenir la capture de document activée pour le pays sans la proposer d’emblée. Les utilisateurs commencent par le portefeuille ou la recherche d’identité du pays. S’il n’y a qu’un seul portefeuille, l’utilisateur arrive directement sur celui-ci. Seuls les utilisateurs dont la connexion au portefeuille échoue, est annulée ou expire, ou dont la recherche ne correspond pas, sont dirigés vers la capture de document. Les issues menant à la capture de document dépendent toujours des commutateurs ci-dessus ; au moins l’un d’entre eux doit donc être défini sur fallback_to_document.
fallback_only est optionnel et défini par défaut sur false. Il est rejeté à moins que document.enabled soit défini sur true et qu’au moins un portefeuille ou une recherche d’identité dans ce pays ne bascule vers la capture de document. Activez les types de documents que la solution de repli doit proposer dans documents_allowed, par exemple le passeport et la carte d’identité pour la Finlande.

​
Ce que coûte chaque méthode

Il s’agit des prix catalogue : la réduction de votre forfait s’applique aux deux méthodes. Une recherche utilise les tarifs publics au détail de la Validation en base de données pour les services qu’elle exécute ; plusieurs services peuvent contribuer à une même tentative. Le Nigeria sélectionne soit le NIN, soit le BVN. Le tableau des pays indique le prix total d’une tentative configurée, chaque nouvelle tentative ayant reçu une réponse étant facturée séparément.

​
Règles de facturation

  • Un registre qui a répondu facture la recherche. Correspondance, correspondance partielle ou absence de correspondance sont toutes prises en compte — la requête a été exécutée et la réponse constitue le produit.
  • Un registre qui n’a jamais répondu n’est pas facturé. Une erreur de fournisseur ne coûte rien.
  • Un numéro qui échoue au contrôle de format côté client n’est jamais facturé et n’est jamais décompté de max_attempts, car il n’a jamais atteint le registre.
  • La capture de document est facturée en supplément lorsque l’utilisateur passe à la solution de repli. Une recherche qui a répondu puis a basculé vers un document donne lieu à deux facturations, car deux vérifications ont été exécutées.

​
Couverture

La capture de document est disponible dans chaque pays pris en charge par Didit et n’est pas répétée ci-dessous : $0.15 par vérification. Ce tableau répertorie uniquement les pays où une méthode sans document existe. Un pays non répertorié, ou une case indiquant Non prévu, correspond à la capture de document uniquement.
La couverture est générée à partir du catalogue de fonctionnalités fourni par le backend, ce tableau est donc la même source sur laquelle la console et l’API s’appuient pour effectuer leurs validations. Prochainement signifie que l’entrée est visible dans la console mais ne peut pas encore être activée ; il ne s’agit pas d’une fonctionnalité active et aucune date n’est engagée.

​
Ce qui apparaît dans la session

Chaque résultat de Vérification d’identité contient la méthode qui l’a produit, son niveau d’assurance et — lorsqu’une méthode sans document a été exécutée — un bloc de preuves propre à la méthode. Les sessions avec document restent exactement comme auparavant, avec les nouvelles clés à null. Les types et exemples champ par champ pour les trois méthodes se trouvent dans le modèle de données de vérification d’identité, et les mêmes clés sont transmises sur le webhook status.updated.

​
Liens associés

Dernière modification le 7 novembre 2026