Passer au contenu principal
La connexion par portefeuille est l’une des trois méthodes de vérification d’identité. L’utilisateur se connecte avec une identité numérique qu’il détient déjà — une eID nationale ou une identité bancaire — et ce fournisseur partage un ensemble d’attributs signés avec Didit. Le résultat porte le niveau d’assurance cryptographic : un fournisseur d’identité a authentifié la personne et signé les attributs renvoyés. C’est tout ce que ce niveau affirme. Il ne s’agit pas d’un classement par rapport aux deux autres niveaux — ils décrivent des preuves différentes, et non plus ou moins de la même chose — et le temps nécessaire pour une connexion dépend du flux propre au portefeuille, que Didit ne contrôle ni ne garantit.
La disponibilité dépend de votre environnement. Les tableaux ci-dessous décrivent la disponibilité en production, et la console utilise le catalogue de fonctionnalités actives de son environnement lorsque vous enregistrez un workflow. MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID et Mobile-ID sont disponibles. Estonian ID-card, eParaksts mobile, Personalausweis, OneID et ConnectID restent bientôt disponibles en production. Smart-ID prend en charge l’Estonie, la Lettonie, la Lituanie et la Belgique ; Mobile-ID prend en charge l’Estonie et la Lituanie ; Finnish Trust Network prend en charge la Finlande. Consultez le guide d’intégration de Smart-ID et Mobile-ID pour connaître la couverture par pays, la configuration et le flux de vérification. Un portefeuille marqué comme bientôt disponible ne peut pas être activé dans cet environnement.

Choisissez votre intégration

Utilisez les API de portefeuilles d’identité numérique lorsque votre application gère l’interface et les étapes d’authentification. Chaque portefeuille dispose d’un endpoint de démarrage dédié, avec des endpoints partagés pour le résultat, l’interrogation périodique et l’annulation. Vous n’avez pas besoin de créer un workflow. Utilisez l’API Sessions pour le parcours de portefeuille hébergé de Didit, les règles de workflow et le repli documentaire configuré. La disponibilité du portefeuille, l’approbation requise de l’utilisateur et les attributs d’identité vérifiés s’appliquent aux deux méthodes d’intégration.

Prérequis

Chaque portefeuille nécessite une identité active auprès de l’émetteur mentionné ci-dessous et l’accès à sa méthode d’authentification. Le compte doit être éligible aux attributs demandés, et l’utilisateur doit consentir à leur partage. Une signature vérifie l’émetteur et les attributs renvoyés ; elle ne garantit pas que chaque attribut demandé est présent, à jour ou suffisant pour votre politique de conformité. Un portefeuille sans portrait n’inclut pas de comparaison de selfie. L’ensemble des 25 entrées de portefeuilles du catalogue est répertorié ci-dessous, y compris les deux pays BankID, ConnectID, Estonian ID-card et eParaksts mobile. Un repli documentaire configuré exécute une vérification de document distincte. Aucune date de lancement n’est promise. Il s’agit de portefeuilles d’identité. Le filtrage des portefeuilles crypto vérifie les adresses blockchain pour détecter les risques financiers et constitue un produit distinct.

Tarifs

✅ Disponible signifie activé en production. ⏳ Prochainement disponible signifie que ce n’est pas encore activé en production, même si les tests d’intégration ont commencé. Les portefeuilles disponibles apparaissent en premier. Sur demande dans la colonne de prix signifie que le portefeuille est disponible mais ne dispose pas d’un tarif de détail publié ; cela ne signifie pas une vérification gratuite. Voici les prix standard de Didit en USD par vérification de portefeuille effectuée pour les produits d’identité listés ci-dessous. Le prix indiqué inclut la vérification d’identité par portefeuille ; aucuns frais de transaction eID nationaux distincts ne sont ajoutés. Un tarif convenu spécifique à une organisation prévaut. Prochainement dans la colonne des prix signifie que le portefeuille est prévu et que son prix client n’a pas encore été publié. Cela ne signifie pas que la vérification est gratuite. Les drapeaux de pays indiquent la couverture du portefeuille dans le catalogue ; la colonne distincte de disponibilité indique s’il peut actuellement être activé. Un prix publié n’active pas un portefeuille. La disponibilité ci-dessus provient du catalogue de production. Un portefeuille marqué Prochainement ne peut pas encore être sélectionné dans un workflow ; ces tarifs s’appliqueront lorsqu’il deviendra disponible.
  • Une connexion par portefeuille vérifiée est facturée une seule fois par nœud Vérification d’identité dans un workflow, ou une seule fois par requête de vérification via l’API de portefeuille autonome. Les rappels répétés ou les vérifications de statut ne génèrent pas de frais supplémentaires.
  • Les connexions annulées, expirées, refusées ou incomplètes ne génèrent pas de frais de vérification par portefeuille.
  • Les prix des portefeuilles sont des prix catalogue : la remise de votre forfait s’y applique comme pour toute autre vérification.
  • Un repli vers un document constitue une vérification distincte, facturée selon les tarifs de vérification de documents. Les autres fonctionnalités du workflow utilisées sont facturées séparément.
Par exemple, 1 000 vérifications d’identification complète iDIN effectuées au tarif standard coûtent $950, avant les autres fonctionnalités du workflow. Il s’agit d’une identification complète ; ce n’est pas un tarif de reconnexion. Le tarif BankID ci-dessus correspond à Norway High, et le tarif eID allemand correspond à Personalausweis Profile 2.

Ce que fait l’utilisateur

  1. Sélectionne son pays lors de l’étape de vérification d’identité et choisit un portefeuille parmi ceux que vous acceptez.
  2. Se connecte avec ce portefeuille, de la même manière qu’il se connecte à sa banque ou à son portail gouvernemental.
  3. Approuve le partage de ses attributs d’identité avec vous.
  4. Revient vérifié.
La connexion sur le même appareil redirige l’utilisateur vers l’application du portefeuille et le ramène dans le flux de vérification une fois l’opération terminée. La connexion entre appareils affiche un code QR sur l’écran d’ordinateur qu’il scanne avec le téléphone sur lequel le portefeuille est installé. Les deux options sont proposées lorsque le portefeuille les prend en charge ; l’utilisateur choisit. Lorsque Smart-ID ou Mobile-ID est activé pour votre workflow, l’utilisateur saisit son code d’identification personnel sur la page de vérification. Mobile-ID demande également le numéro de téléphone associé à l’identité. La page affiche un code de comparaison, et l’utilisateur n’approuve sur son téléphone que si ce code correspond. L’utilisateur saisit son code PIN sur son téléphone ; Didit ne le demande jamais. Ce flux fonctionne depuis un ordinateur ou un téléphone sans code QR. La disponibilité est déterminée par le catalogue des capacités en production ; un portefeuille marqué Prochainement ne peut pas encore être activé. Une connexion initiée reste valide pendant une fenêtre limitée (10 minutes par défaut). Passé ce délai, l’utilisateur doit recommencer.

Les portefeuilles sont gérés par une liste d’autorisation

wallet.providers est la liste des portefeuilles qu’un pays peut proposer. Il ne s’agit pas d’un classement : l’ordre que vous envoyez n’a aucune importance, il est normalisé selon l’ordre du catalogue lors de l’enregistrement, et l’utilisateur final choisit parmi ce que vous avez accepté. Activez un seul portefeuille ou tous les portefeuilles d’un pays — le choix lui appartient. L’API refuse un workflow qui active un portefeuille non proposé par le catalogue dans ce pays, ou un portefeuille qui est encore marqué Prochainement.
La liste des attributs de chaque portefeuille ci-dessous comprend une attestation signée. Didit vérifie cette signature et indique le verdict dans la session sous wallet_verification.signature_valid ; l’attestation elle-même n’est pas renvoyée, il n’y a donc aucune référence à récupérer ou à stocker. La colonne Sur la session indique laquelle des deux options vous recevez pour chaque attribut.

Portefeuilles pris en charge

Les portefeuilles disponibles sont MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID et Mobile-ID. iDIN est disponible pour l’identification complète aux Pays-Bas. Smart-ID et Mobile-ID sont disponibles dans les pays répertoriés dans le catalogue ci-dessous. La couverture géographique et les informations requises pour Smart-ID et Mobile-ID reflètent l’intégration mise en place ; la disponibilité en production reste gérée séparément. Consultez le guide d’intégration pour connaître les flux Smart-ID et Mobile-ID implémentés.
La Disponibilité est fournie par le catalogue de fonctionnalités et n’est pas mise à jour manuellement ici. Prochainement signifie que le portefeuille est visible dans la console et ne peut pas encore être activé ; aucune date d’engagement n’est définie.

Estonian ID-card et eParaksts mobile

Les deux méthodes sont intégrées au catalogue de portefeuilles mais restent indiquées comme Prochainement en production. Elles ne peuvent pas être activées dans les workflows de production tant que le catalogue de production ne les indique pas comme Disponible. Les identifiants API sont idcard_ee pour l’Estonie (EST) et eparaksts_mobile pour la Lettonie (LVA). Les deux sont au prix de $0.55 par vérification terminée lorsqu’elles sont disponibles ; un tarif publié ne donne pas accès à la production.
  • Estonian ID-card : l’utilisateur continue dans le navigateur sur l’ordinateur connecté à son lecteur de carte à puce et s’authentifie avec sa carte et son code PIN via le logiciel de la carte.
  • eParaksts mobile : l’utilisateur poursuit vers le service de connexion d’identité et approuve avec son compte eParaksts mobile actif. Les utilisateurs sur ordinateur peuvent scanner le code QR pour continuer sur leur téléphone ; les utilisateurs sur téléphone continuent directement.
Les deux utilisent le flux partagé Didit de sélection, de transfert et de retour du portefeuille. L’utilisateur saisit son code PIN d’authentification uniquement dans le service d’identité ou le logiciel de la carte, jamais dans un formulaire Didit. Après l’authentification, Didit vérifie les attributs d’identité signés et poursuit le workflow configuré. L’annulation ou l’échec déclenche le repli configuré vers le document ou l’action de refus du workflow.
La marque blanche s’applique aux écrans de vérification Didit. Les écrans d’authentification externes pour ces deux méthodes conservent l’image de marque de leur service respectif. Les logos personnalisés, noms de service et styles de marque blanche ne sont pas appliqués à ces écrans externes.

Utiliser ces portefeuilles via l’API

Les deux méthodes prennent également en charge la vérification autonome via l’API sans workflow_id. La disponibilité en production est identique pour l’API autonome et les workflows ; vérifiez GET /v3/id-verification/wallets/ avant de proposer l’une ou l’autre méthode aux utilisateurs. Conservez votre x-api-key sur votre backend et enregistrez l’hôte de retour de votre application dans son paramètre allowed_return_hosts. Transmettez une return_url en HTTPS sur cet hôte lors du démarrage d’une vérification. La réponse de démarrage renvoie un request_id et une wallet_verification.next_action.url pour le navigateur de l’utilisateur. Redirigez l’utilisateur vers cette URL afin qu’il puisse s’authentifier avec sa carte ou son application. Après son retour, interrogez GET /v3/id-verification/wallets/verifications/{request_id}/ depuis votre backend pour vérifier le résultat de la vérification, ou traitez le webhook signé status.updated. Ne considérez pas la seule redirection du navigateur comme une preuve de vérification réussie. Le même prix et les mêmes règles de facturation par vérification terminée s’appliquent aux deux options d’intégration.

Google Wallet

Google Wallet permet à une personne de partager une pièce d’identité officielle depuis son téléphone avec votre page ou votre application, par l’intermédiaire de l’API W3C Digital Credentials. Il est disponible en production et en sandbox. Les applications sandbox ne nécessitent aucun enregistrement. Chaque application de production s’enregistre une seule fois avant de pouvoir utiliser Google Wallet : dans la console, ouvrez l’étape de vérification d’identité, trouvez la ligne Google Wallet d’un pays pris en charge, sélectionnez S’enregistrer auprès de Google et terminez la configuration initiale, qui prend environ une minute. Google affiche ensuite votre nom et votre logo lorsque les personnes partagent leur pièce d’identité. Tant que l’application n’est pas enregistrée, l’enregistrement d’un workflow activant Google Wallet est refusé avec le message « Register this application with Google before enabling Google Wallet. » Les utilisateurs finaux de vos clients voient l’option sous le libellé Verify with digital ID, car en plus de Google Wallet, tout autre portefeuille Android prenant en charge la même requête OpenID4VP et contenant une pièce d’identité compatible (un pass d’identité ou un permis de conduire mobile) peut y répondre.
  • Pays : États-Unis, Royaume-Uni, Brésil, Singapour et Taïwan.
  • Justificatifs : le pass d’identité Google Wallet créé à partir d’un passeport, ainsi que les permis de conduire mobiles des États américains pris en charge.
  • Données renvoyées : nom, date de naissance, numéro de document, date d’expiration du document, autorité et pays de délivrance, ainsi que la nationalité pour un pass d’identité. Le résultat comporte également le verdict signature_valid pour le justificatif. Aucun portrait n’est partagé.
  • Confidentialité : Didit ne demande que les champs nécessaires, et seuls ces champs quittent le portefeuille. La personne approuve le partage dans Google Wallet sur son propre appareil.
Il n’y a pas de redirection : la personne confirme dans l’invite de portefeuille propre au navigateur ou à Android, et les navigateurs sur ordinateur affichent leur propre code QR lorsque le portefeuille se trouve sur un téléphone. La vérification est demandée depuis votre page ou votre application, donc l’intégration de l’API nécessite l’origine HTTPS de votre page. Le flux hébergé de l’API Sessions ne propose la méthode que sur les navigateurs et appareils qui la prennent en charge, et conserve sinon le repli sur document. Lorsque vous affichez le flux hébergé à l’intérieur de votre propre page, utilisez le Web SDK 0.5.1 ou version ultérieure, ou ajoutez digital-credentials-get à l’attribut allow de votre iframe : sans cela, le navigateur refusera la requête de portefeuille au sein de l’iframe.

Autres portefeuilles à venir

ConnectID (Australie) est intégré pour les tests en sandbox et apparaît dans le catalogue de portefeuilles sous connectid. La personne sélectionne une banque de test participante à l’aide du sélecteur ConnectID, se connecte avec cette banque et examine la demande de partage. L’ensemble de données d’identité initial demande le prénom, le nom de famille et la date de naissance, avec une référence de transaction pour la vérification. Il ne demande ni adresse, ni numéro de téléphone, ni adresse e-mail, ni solde de compte, ni historique des transactions. L’avis de partage identifie Didit et l’entreprise recevant l’identité vérifiée. Les identifiants bancaires restent auprès de la banque. L’accès en production reste Prochainement ; les tests en sandbox ne permettent pas la vérification d’identité en production. Un cas d’usage approuvé pour la production, l’onboarding des clients, l’acceptation des conditions requises et la certification doivent être finalisés avant l’activation. Les autres portefeuilles marqués Prochainement dans les tableaux restent également indisponibles en production. Aucune date de lancement n’est promise.

Niveau de garantie

Lorsqu’un portefeuille fournit un niveau de garantie eIDAS (low, substantial ou high), Didit enregistre le niveau effectivement déclaré dans le résultat. Un portefeuille sans niveau eIDAS spécifié, tel que ConnectID, est affiché comme Non précisé ; son intégration n’implique aucune revendication de garantie eIDAS. Si un portefeuille renvoie un niveau plus faible que celui demandé, la connexion échoue plutôt que de rétrograder silencieusement le niveau. Vérifiez wallet_verification.level_of_assurance sur la session lorsque vos règles de conformité en dépendent.

Référence par portefeuille

MitID

mitid · Disponible Informations saisies dans Didit : Nom · Date de naissance · Alias CPR (pseudonymisé)

BankID

bankid_se · Disponible Informations saisies dans Didit : Nom · Numéro personnel

iDIN

idin · Disponible Informations saisies dans Didit : Nom · Date de naissance · Adresse

Finnish Trust Network

ftn · Disponible Informations saisies dans Didit : Nom · Code d’identité personnel

Google Wallet

google_wallet · Disponible Informations saisies dans Didit : Aucune information d’identité saisie dans Didit

Smart-ID

smart_id · Disponible Informations saisies dans Didit : Numéro d’identification personnel

Mobile-ID

mobile_id · Disponible Informations saisies dans Didit : Numéro d’identification personnel · Numéro de téléphone Mobile-ID

BankID

bankid_no · Bientôt disponible Informations saisies dans Didit : Nom · Date de naissance · Numéro d’identité national

Vipps

vipps · Bientôt disponible Informations saisies dans Didit : Nom · Date de naissance · Numéro d’identité national

Buypass ID

buypass · Bientôt disponible Informations saisies dans Didit : Nom · Date de naissance · Numéro d’identité national

itsme

itsme · Bientôt disponible Informations saisies dans Didit : Nom · Date de naissance · Numéro de registre national

Personalausweis

personalausweis · Bientôt disponible Informations saisies dans Didit : Nom · Date de naissance · Nationalité · Adresse

Freja eID

frejaid · Bientôt disponible Informations saisies dans Didit : Nom · Date de naissance · Numéro personnel

UAE PASS

uae_pass · Bientôt disponible Informations renseignées dans Didit : Nom · Numéro Emirates ID · Nationalité · Portrait

gov.br

govbr · Bientôt disponible Informations renseignées dans Didit : Nom · CPF

OneID

oneid · Bientôt disponible Informations renseignées dans Didit : Nom · Date de naissance

GOV.UK Wallet

govuk_wallet · Bientôt disponible Informations renseignées dans Didit : Nom · Date de naissance · Portrait

Carte d’identité estonienne

idcard_ee · Bientôt disponible Informations renseignées dans Didit : Nom · Date de naissance · Code d’identification personnel

eParaksts mobile

eparaksts_mobile · Bientôt disponible Informations renseignées dans Didit : Nom · Date de naissance · Code personnel d’identification

Bank iD

bankid_cz · Bientôt disponible Informations renseignées dans Didit : Nom · Date de naissance

MojeID

mojeid · Bientôt disponible Informations renseignées dans Didit : Nom · Date de naissance

Diia

diia · Bientôt disponible Informations renseignées dans Didit : Nom · Date de naissance · Portrait

FranceConnect

franceconnect · Bientôt disponible Informations renseignées dans Didit : Nom · Date de naissance

Auðkenni

audkenni · Bientôt disponible Informations saisies dans Didit : Nom · Kennitala

ConnectID

connectid · Bientôt disponible Informations saisies dans Didit : Aucune donnée d’identité saisie dans Didit

EUDI Wallet

eudi · Bientôt disponible Informations renseignées dans Didit : PID - données d’identification de la personne

Échec et repli

Tout résultat autre que verified suit le paramètre wallet.on_failure du pays : fallback_to_document redirige l’utilisateur vers la capture de document, decline met fin à la session avec un résultat refusé pour la Vérification d’identité. L’option fallback_to_document, lorsque la capture de document est désactivée pour ce pays, entraîne un refus à la place, car il n’existe aucune solution de repli. Pour proposer la capture de document uniquement après l’échec d’une connexion au portefeuille, consultez Proposer la capture de document uniquement en solution de repli. Seule une connexion aboutie est facturée. Les connexions abandonnées, annulées, expirées et échouées ne coûtent rien.

Éléments présents dans la session

attributes contient les déclarations validées du portefeuille, dont les noms varient selon le portefeuille. Utilisez full_name et date_of_birth sur le résultat de la vérification d’identité pour obtenir les champs d’identité normalisés. Le tableau spécifique à chaque portefeuille distingue ces champs normalisés des attributs propres au portefeuille. portrait n’est présent que pour les portefeuilles qui partagent un portrait. signature_valid correspond au résultat de la validation de l’assertion signée retournée par le portefeuille. Il vaut true lors d’une connexion aboutie : une assertion non validée fait échouer la connexion et applique le comportement de wallet.on_failure au lieu de générer un résultat approuvé. L’ensemble des types de champs figure dans le modèle de données de la vérification d’identité.

Configurer les portefeuilles

Il s’agit d’un fragment de configuration à utiliser uniquement lorsque le catalogue de votre environnement indique que chaque portefeuille sélectionné est available dans le pays choisi. L’envoi d’un portefeuille indisponible rejette l’enregistrement de l’ensemble du workflow, y compris les autres méthodes incluses dans la même requête. Pour des exemples avec Smart-ID et Mobile-ID, consultez le guide d’intégration.
Activez au moins un portefeuille lorsque wallet.enabled est à true, sans quoi l’enregistrement est rejeté. La référence complète se trouve dans Configurations des fonctionnalités de workflow.

Voir aussi

Dernière modification le 7 novembre 2026