Passer au contenu principal
Smart-ID et Mobile-ID permettent aux utilisateurs de vérifier leur identité en approuvant une requête sur leur téléphone. Utilisez l’API Smart-ID ou l’API Mobile-ID pour lancer la vérification depuis votre propre application sans passer par un workflow. Ces deux méthodes s’exécutent également au sein de l’étape de workflow de Vérification d’identité de Didit, renvoyant un résultat de vérification de portefeuille avec une assurance cryptographic. Pour l’intégration de workflow hébergé décrite ci-dessous, utilisez le même processus de création de session et la même intégration de webhook que pour vos autres workflows Didit.
Smart-ID et Mobile-ID sont disponibles. Smart-ID prend en charge l’Estonie, la Lettonie, la Lituanie et la Belgique. Mobile-ID prend en charge l’Estonie et la Lituanie. Sélectionnez dans la console les portefeuilles que votre workflow accepte pour chaque pays. Consultez la couverture des portefeuilles et les tarifs pour obtenir la liste complète.

​
Pays et prérequis

L’intégration couvre Smart-ID en Estonie (EST), en Lettonie (LVA), en Lituanie (LTU) et en Belgique (BEL). Mobile-ID couvre l’Estonie (EST) et la Lituanie (LTU) ; Mobile-ID n’est pas proposé pour la Lettonie. Ces codes pays décrivent les routes intégrées, et non la promesse que chaque route est activée dans votre environnement. Pour Smart-ID, l’utilisateur doit disposer d’une identité Smart-ID active et éligible, de son code d’identification personnel et d’un accès à l’application. Pour Mobile-ID, l’utilisateur doit disposer d’une identité Mobile-ID active, de son code d’identification personnel et de son numéro de téléphone associé. Saisissez le numéro de téléphone Mobile-ID au format international : +372 pour l’Estonie ou +370 pour la Lituanie. Le pays sélectionné doit correspondre à l’identité utilisée. Aucune de ces deux méthodes ne renvoie de portrait. Si votre workflow nécessite un selfie, maintenez les étapes appropriées de Détection du vivant et de Correspondance faciale configurées séparément.

​
Ce que voit l’utilisateur

  1. L’utilisateur sélectionne son pays et choisit Smart-ID ou Mobile-ID parmi les portefeuilles acceptés par votre workflow.
  2. La session de vérification demande le code d’identification personnel ; Mobile-ID demande également le numéro de téléphone associé.
  3. La page affiche un code de comparaison pendant que la requête d’authentification parvient au téléphone.
  4. L’utilisateur vérifie que le code sur le téléphone correspond au code figurant sur la page de vérification, puis donne son approbation à l’aide de son code PIN sur le téléphone.
  5. Didit valide le résultat d’identité signé et poursuit le workflow de vérification.
Le formulaire d’identité et l’écran du code de comparaison utilisent la même mise en page que les autres méthodes de vérification. Lorsque la personnalisation en marque blanche est activée, ils héritent des couleurs de la session, de la typographie, du style des boutons et du logo du client, et restent sur le domaine de la session. L’actualisation de la page rétablit le code de comparaison actif sans lancer de nouvelle requête d’approbation. L’utilisateur ne saisit jamais le code PIN de son portefeuille sur la page de vérification. Si les codes diffèrent ou si l’utilisateur n’a pas initié la requête, il doit l’annuler. Le flux du code de comparaison fonctionne avec un navigateur sur ordinateur ou sur téléphone et ne nécessite pas de QR code. La page attend automatiquement le résultat et propose une option d’annulation. Une approbation sur le téléphone doit encore passer avec succès les contrôles d’identité et de signature avant que Didit ne considère la vérification de portefeuille comme réussie.

​
Configurer le workflow

Dans la console, ouvrez le nœud de Vérification d’identité de votre workflow, choisissez Pays, puis ouvrez le pays que vous souhaitez configurer. Sous Portefeuilles acceptés, sélectionnez les portefeuilles disponibles et choisissez le comportement en cas d’échec. Enregistrez et publiez le workflow avant de créer une nouvelle session. Consultez les méthodes de Vérification d’identité dans la console pour connaître le chemin d’accès complet dans la console.
Ce qui suit est un extrait de configuration methods, et non une requête de workflow complète. Ne l’utilisez que si smart_id et mobile_id sont tous deux marqués comme available pour l’Estonie dans votre environnement. Un portefeuille non disponible entraîne le rejet de l’enregistrement de l’ensemble du workflow.
Le tableau providers est une liste d’autorisation : les utilisateurs choisissent parmi ses portefeuilles, et l’ordre du tableau ne définit pas de portefeuille préféré. Pour la Lituanie, utilisez LTU avec les mêmes identifiants de portefeuille lorsque les deux sont disponibles. Pour la Lettonie ou la Belgique, utilisez LVA ou BEL avec smart_id uniquement, sous réserve de la même vérification de disponibilité. Les pays omis conservent leur comportement de capture de document par défaut existant. Le contrat de configuration complet se trouve dans Configurations des fonctionnalités de workflow.

​
Lire le résultat vérifié

Consultez la session terminée via l’API de décision de session ou votre intégration de webhook. Un contrôle de portefeuille réussi enregistre verification_method: "wallet", assurance: "cryptographic" et wallet_provider: "smart_id" ou "mobile_id". L’objet wallet_verification identifie le portefeuille, le pays de délivrance, l’heure de vérification, le niveau d’assurance et le verdict de signature. Le résultat de la vérification d’identité expose les champs normalisés full_name et date_of_birth. Pour ces deux portefeuilles, wallet_verification.attributes contient given_name, family_name, birthdate et personal_code issus de l’identité validée. Le pays de délivrance identifie la route d’identité ; il n’établit pas la nationalité de la personne. Didit renvoie le verdict de signature, et non l’assertion signée sous-jacente. Aucun portrait ni code PIN de portefeuille n’est renvoyé. Dans la console, la carte Justificatif de la session affiche le portefeuille et ses éléments de preuve vérifiés. Un contrôle de portefeuille réussi termine l’étape de Vérification d’identité ; les contrôles ultérieurs de votre workflow déterminent toujours la décision finale de la session. Consultez le modèle de données de vérification d’identité pour connaître les types de champs et la distinction entre le résultat d’un contrôle et la décision globale de la session.

​
Gérer les annulations et les échecs

Si un utilisateur annule, dépasse le délai imparti ou ne parvient pas à terminer l’authentification, Didit applique le paramètre wallet.on_failure du pays. fallback_to_document lance la capture de document lorsqu’elle est activée pour ce pays. decline refuse l’étape de Vérification d’identité. Si la capture de document est désactivée, aucun repli documentaire n’est disponible. Seule une vérification par portefeuille effectuée et validée entraîne la facturation de la vérification par portefeuille. Les tentatives de portefeuille annulées, expirées ou échouées ne sont pas facturées. Un repli documentaire mené à bien constitue une vérification distincte soumise à la tarification de la vérification de documents. Consultez le tableau des tarifs des portefeuilles pour connaître les tarifs publiés ; une méthode sans tarif publié ne doit pas être considérée comme gratuite.

​
Tester avant la production

Testez chaque portefeuille et chaque pays que vous prévoyez de proposer dans l’environnement où il est activé. Confirmez que les portefeuilles appropriés s’affichent, que le code de comparaison est visible, que l’approbation permet de poursuivre le workflow et que le résultat de la session contient les preuves de portefeuille attendues. Vérifiez également l’annulation, l’expiration et le comportement de repli que vous avez choisi. Les simulations en sandbox et les tests en préproduction diffèrent de l’authentification en production. Une approbation simulée est utile pour vérifier votre intégration, mais ne prouve pas qu’une identité réelle peut s’authentifier en production. Avant le déploiement, confirmez la disponibilité en production dans la console et réalisez une vérification autorisée sur un appareil réel pour le parcours que vous prévoyez d’utiliser.

​
Autres portefeuilles d’identité numérique

Le catalogue de portefeuilles d’identité numérique de Didit présente la disponibilité en production et les portefeuilles à venir, y compris le Finnish Trust Network déjà disponible ainsi que les intégrations BankID et EUDI Wallet à venir. La présence d’un portefeuille dans la liste, un tarif publié ou un formulaire d’onboarding rempli ne permet pas à lui seul d’activer l’authentification en production. Utilisez le catalogue et la console de votre environnement pour déterminer ce que vous pouvez activer aujourd’hui. Consultez également Finnish Trust Network pour la Finlande.
Dernière modification le 7 novembre 2026