Ces versions concernent les SDK de vérification d’identité. Les modules et wrappers d’authentification natifs ont une version distincte : voir les guides de démarrage rapide sur l’authentification.
Approche recommandée : pour une expérience utilisateur optimale, utilisez nos SDK natifs plutôt qu’une intégration WebView. Les SDK natifs gèrent d’emblée toute la complexité des autorisations de la caméra, de la lecture NFC et de la détection du vivant.
Disponibilité des SDK
Le consentement biométrique nécessite le SDK natif 4.10.0 ou une version ultérieure. Pour les personnes concernées par la loi de l’Illinois, du Texas ou du Colorado, Didit peut demander un consentement biométrique explicite avant la première capture du visage. Le parcours hébergé (SDK Web, WebView, navigateur) ainsi que les SDK natifs iOS et Android 4.10.0 ou une version ultérieure affichent cette étape ; React Native et Flutter l’affichent dans une version qui épingle le SDK natif 4.10.0 ou une version ultérieure. Un SDK natif inférieur à 4.10.0, ou qui ne signale pas sa version, ne peut pas l’afficher : ses sessions se déroulent comme auparavant, et la décision renvoie
biometric_consent.status: "pending" avec reason: "BIOMETRIC_CONSENT_UNSUPPORTED_SDK". Mettez à niveau si vous vérifiez des personnes dans ces États.Nouveautés de la version 4.13.2
Sur iOS, une photo demandée à partir d’une caméra qui s’ouvre sans délivrer d’images ne fait plus planter votre application : chaque demande de photo vérifie d’abord qu’une session caméra est en cours avec une connexion vidéo active, et l’écran affiche à la place son erreur de caméra ou propose d’ignorer la demande de photo. Sur Android, à l’étape du selfie de recherche d’identité, une demande de photo à partir d’une caméra qui ne délivre aucune image aboutit à l’erreur de caméra de l’écran au bout de 5 secondes, au lieu d’attendre indéfiniment. Sur l’écran d’accueil, lorsque la liste des étapes se poursuit sous son fondu inférieur, un bouton rond « Défiler vers le bas » est centré horizontalement sur la liste (y compris dans les langues écrites de droite à gauche), comme dans le parcours web ; un appui fait défiler la liste vers le bas, et le bouton disparaît en fin de liste ainsi que lorsqu’une feuille est ouverte. La version 4.13.1 pour Android était une version intermédiaire ne contenant que le bouton « Défiler vers le bas » ; la version 4.13.2 l’apporte à iOS, React Native et Flutter. React Native 4.13.2 corrige aussi un plantage au lancement dans les versions Android de production réduites avec R8 etproguard-android-optimize.txt : le package embarque désormais ses propres règles R8.
Flutter 4.13.2 se compile aussi avec Android Gradle Plugin 9 et son Kotlin intégré.
Nouveautés de la version 4.13.0
À l’étape du téléphone, chaque numéro +1 (États-Unis et Canada) affiche une courte mention de l’opérateur sous Envoyer le code (« Des frais de messagerie et de données standard peuvent s’appliquer ») avec des liens vers les conditions d’utilisation des SMS et la politique de confidentialité, dans la langue de la personne. Le cadre de selfie s’adapte désormais au-dessus de ses commandes sur les écrans de faible hauteur, et la pastille verte Terminé, le bouton Compris après une photo de document ainsi que l’écran Selfie pris ont disparu : une photo capturée passe directement à Traitement en cours. Lorsque la capture de document n’est qu’une solution de secours et qu’un portefeuille d’identité numérique est proposé en premier, l’écran de lancement du portefeuille n’affiche que ce portefeuille ; une nouvelle tentative avec le portefeuille maintient la vérification ouverte sans lien vers un document. Un drapeau est affiché pour chaque indicatif pays que Didit peut envoyer, et jamais le mauvais. Un scénario de sandbox armé sur une session déjà démarrée affiche désormais la raison, au lieu d’une erreur générique. Sur Android, le portefeuille Credential Manager affiche « Vérifier avec une identité numérique », car Google Wallet ou tout autre portefeuille Android détenant une identité compatible peut y répondre. iOS ne propose pas cette méthode.Nouveautés de la version 4.12.2
L’écran d’accueil centre le logo au-dessus du titre aligné à gauche, et iOS affiche le logo du client d’une hauteur de 72 pt, comme Android et le web. Dans l’étape des personnes clés KYB, Ajouter un représentant s’ouvre avec un rôle de représentant sélectionné et enregistre la personne parmi les représentants, même lorsque le workflow désactive certains rôles. Dans les questionnaires, « Sécurisé par » reste fixé sous le bouton sur les écrans de faible hauteur et avec les grandes tailles de texte, le sélecteur de pays d’une question d’adresse porte un titre adapté à l’adresse, et une liste déroulante ouverte reprend les coins arrondis des champs.Nouveautés de la version 4.12.1
Sur un iPhone dont le stockage est plein, les captures de document et de selfie conservent désormais leur vidéo : le SDK iOS les enregistre en mémoire et n’envoie jamais un enregistrement sans images vidéo. Une réponse du serveur arrivée après une première réponse ne rouvre plus l’étape qui vient d’être validée (l’étape NFC, selfie ou document), sur iOS et Android.Nouveautés de la version 4.12.0
Logos des portefeuilles d’identité numérique proposés par le parcours web (Mobile-ID, ConnectID, Finnish Trust Network, OneID, Bank iD, MojeID, FranceConnect, Auðkenni, la carte d’identité estonienne et GOV.UK Wallet), sur le même fond blanc ou noir que sur le web. Les conseils de capture indiquent quoi faire lorsque la capture automatique ne fonctionne pas, l’écran d’accueil conserve sa phrase juridique épinglée pour les grandes tailles de texte, et un démarrage de session refusé ne propose plus de nouvelle tentative qui ne pourrait pas aboutir. Les caméras de document et de selfie disposent d’un bouton Changer de caméra à côté du déclencheur, Importer ayant été déplacé dans Conseils, et rien n’est capturé automatiquement lorsqu’une feuille est ouverte par-dessus la caméra. Sur Android, la feuille Sélectionner la caméra désigne les caméras « Caméra avant » et « Caméra arrière » dans toutes les langues.Nouveautés de la version 4.11.0
La version 4.11.0 reprend aussi tout ce qui était prévu pour la 4.10.0, qui n’a jamais été publiée ; passez donc directement de la 4.9.1 à la 4.11.0. Le parcours bénéficie d’une structure redessinée, avec une nouvelle barre supérieure, une progression exprimée en mots et un écran d’accueil reconstruit. La capture automatique du document et du selfie est désormais disponible dans toutes les variantes, grâce aux détecteurs légers de Didit ; les variantesCore et AutoDetection capturent donc de la même manière.
La variante AutoDetection et l’artefact Android didit-sdk-autodetection sont dépréciés et identiques à Core, et l’artefact Android didit-sdk-autodetection-play n’est plus publié.
Nouvelles étapes : Vérification bancaire, Localisation (activée sur demande via les variantes iOS Core-Location, NFC-Location et All-Location), signature électronique et consentement biométrique.
Nouveautés de la version 4.9.1
Les sélecteurs de pays des justificatifs de domicile et des documents s’ouvrent désormais sur le pays détecté à partir de l’adresse IP de l’utilisateur sur iOS et Android, même lorsque cette détection se termine après l’affichage de l’écran. Un pays défini dans la session ou choisi par l’utilisateur n’est jamais remplacé. Sur Android, l’en-tête de section et les champs d’un questionnaire s’affichent dans la langue du SDK, et la numérisation du passeport NFC ne plante plus dans la variante complète. Les textes de vérification en russe et en kirghize sont améliorés sur les deux plateformes.Nouveautés de la version 4.9.0
Tous les SDK mobiles natifs et multiplateformes proposent désormais un sélecteur de langue activable sur l’écran d’accueil de la vérification. DéfinissezshowLanguageSelector sur true pour afficher le même sélecteur compact avec recherche que celui utilisé dans le parcours de vérification web.
Le sélecteur est masqué par défaut, de sorte que les intégrations existantes conservent leur comportement actuel tant que vous ne l’activez pas.
Alternative : si un SDK natif n’est pas encore disponible pour votre plateforme, vous pouvez utiliser l’intégration WebView comme solution de repli.
Fonctionnement d’une session de vérification
Chaque SDK natif utilise la même session de vérification Didit. Le déroulement est le suivant :- Votre backend appelle
POST /v3/session/avecworkflow_idainsi que les éléments de contexte facultatifs (vendor_data,contact_details,expected_details,metadata,callback). - Didit renvoie un
session_id, unsession_tokende courte durée et uneurlhébergée. - Votre application mobile reçoit le
session_tokende votre backend et le transmet au SDK (startVerification(token: …)). - Le SDK natif ouvre l’interface de vérification, l’utilisateur effectue les étapes, puis le SDK renvoie un résultat accompagné du
statusfinal de la session (Approved,Declined,In Review, etc.). - Votre backend reçoit la décision complète via un webhook (
webhook_type: "status.updated") et l’enregistre.
Le résultat du SDK indique l’issue du workflow (statut). La décision complète (champs du document, scores de correspondance faciale, correspondances AML, données NFC, avertissements) est transmise à votre serveur via webhook et peut aussi être récupérée à l’aide de l’endpoint Retrieve Session Decision. Ne vous fiez jamais uniquement au résultat côté client pour prendre des décisions d’autorisation.
SDK iOS
Quand l’utiliser : applications natives Swift / SwiftUI / UIKit ciblant iOS 13+. Un SDK iOS léger, piloté par le serveur, pour la vérification d’identité avec une configuration minimale.Dépôt GitHub
Consultez le code source et les exemples sur GitHub
- Prise en charge de SwiftUI et UIKit
- Lecture NFC du passeport et de la pièce d’identité (iOS 15+ ; les variantes sans NFC
CoreetAutoDetectionretirent NFC et OpenSSL, et se déploient sur iOS 13+) - 54 langues prises en charge
- Thème d’interface personnalisable
- Intégration par token de session ou par ID de workflow
SDK Android
Quand l’utiliser : applications natives Kotlin / Jetpack Compose / Java ciblant Android 6.0 (API 23) ou version ultérieure. Un SDK Android léger, piloté par le serveur, pour la vérification d’identité avec une configuration minimale.Dépôt GitHub
Consultez le code source et les exemples sur GitHub
- Prise en charge de Kotlin et Jetpack Compose
- Lecture NFC du passeport et de la pièce d’identité (l’artefact
me.didit:didit-sdk-coreà activer explicitement retire les dépendances NFC) - Détection automatique du document et du visage par ML sur API 24+ (capture manuelle de secours sur API 23)
- 54 langues prises en charge
- Thème d’interface personnalisable
- Intégration par token de session ou par ID de workflow
SDK React Native
Quand l’utiliser : applications multiplateformes React Native ou Expo qui ont besoin d’une API TypeScript unique pour iOS et Android (RN 0.76+, New Architecture). Un SDK React Native multiplateforme qui encapsule les SDK natifs iOS et Android derrière une API TypeScript unifiée.Dépôt GitHub
Consultez le code source et les exemples sur GitHub
- API TypeScript unique pour iOS et Android
- Prise en charge d’Expo avec plugin de configuration sans configuration manuelle (build de développement requis, Expo Go non pris en charge)
- Prise en charge de la CLI React Native
- Lecture NFC du passeport et de la pièce d’identité (désactivable avec
DIDIT_SDK_IOS_NFC_ENABLED=false/diditSdkAndroidNfcEnabled=false) - 54 langues prises en charge (héritées des SDK natifs)
- Intégration par token de session ou par ID de workflow
SDK Flutter
Quand l’utiliser : applications multiplateformes Flutter qui ont besoin d’une API Dart unique pour iOS et Android (Flutter 3.3+, Dart 3.11+). Un SDK Flutter multiplateforme qui encapsule les SDK natifs iOS et Android derrière une API Dart unifiée.Paquet pub.dev
Consultez le paquet sur pub.dev
- API Dart unique pour iOS et Android
- Intégration aux SDK natifs via des canaux de plateforme
- Lecture NFC du passeport et de la pièce d’identité (désactivable avec
DIDIT_SDK_IOS_NFC_ENABLED=false/diditSdkAndroidNfcEnabled=false) - 54 langues prises en charge (héritées des SDK natifs)
- Intégration par token de session ou par ID de workflow
SDK Web (JavaScript)
Quand l’utiliser : applications web et frameworks web (React, Vue, Angular, Next.js, Nuxt, Svelte, JavaScript natif). Le SDK Web ouvre le parcours de vérification hébergé dans une fenêtre modale ou dans un iframe intégré. Pour les applications mobiles, privilégiez les SDK natifs ci-dessus. Un SDK JavaScript pour applications web, compatible avec React, Vue, Angular, Next.js, Nuxt, Svelte et JavaScript natif.Paquet NPM
Consultez le paquet sur npm
- Gestion programmatique des sessions et callbacks d’événements
- Prise en charge de React, Vue, Angular, Next.js, Nuxt, Svelte et JavaScript natif
- Prise en charge complète de TypeScript
- Modes modal et intégré (inline)
- Gestion d’état pour les interfaces personnalisées