SDK de vérification d'identité web : JavaScript et iframe

Ces guides portent sur la vérification d’identité. Pour la connexion des utilisateurs finaux, utilisez les guides de la plateforme d’authentification ; les nouveaux packages d’authentification dépendent de la version publiée.

Intégrez la vérification Didit à votre application web. Nous proposons sept méthodes d’intégration pour s’adapter à votre architecture et à vos exigences en matière d’expérience utilisateur : choisissez celle qui correspond à votre stack.

Choisissez votre méthode d’intégration : des iframes sans code en quelques minutes jusqu’au contrôle programmatique complet avec notre SDK JavaScript, ou des plugins prêts à l’emploi pour WordPress, Shopify et Salesforce.

Méthodes d’intégration

Méthode	Durée de configuration	Backend ?	Idéal pour
SDK JavaScript	3 minutes	Facultatif	Contrôle total : React/Vue/Angular/Next.js/Nuxt/Svelte/JS natif
InContext (Iframe)	< 1 minute	Facultatif	Expérience intégrée sans redirection
Redirection	5 minutes	Oui	Compatibilité maximale, parcours multi-appareils
WebView (iOS/Android)	15 minutes	Oui	Solution de repli mobile lorsqu’aucun SDK natif est disponible
WordPress + WooCommerce	5 minutes	Non, sans code	Sites WordPress, boutiques WooCommerce
Shopify	5 minutes	Non, sans code	Boutiques Shopify : vérification au paiement ou du compte
Salesforce	10 minutes	Non, sans code	CRM Salesforce : vérification des fiches Contact et Lead

Recommandation : pour les applications web en production, utilisez le SDK JavaScript pour la meilleure expérience utilisateur et un contrôle programmatique complet. Utilisez l’iframe InContext pour la mise en place la plus rapide, la Redirection lorsqu’une vérification multi-appareils est nécessaire, et les intégrations dédiées WordPress / Shopify / Salesforce si vous travaillez sur ces plateformes.

SDK JavaScript

Le SDK JavaScript de Didit permet d’intégrer la vérification de manière programmatique, avec un contrôle total sur l’expérience utilisateur. Fonctionnalités clés :

Gestion des sessions et callbacks d’événements
Prise en charge de React, Vue, Angular, NextJS, Nuxt, Svelte et du JavaScript natif
Prise en charge complète de TypeScript
Modes modal et intégré

Démarrage rapide :

import { DiditSdk } from '@didit-protocol/sdk-web';

DiditSdk.shared.onComplete = (result) => {
  switch (result.type) {
    case 'completed':
      console.log('Verification completed!');
      console.log('Session ID:', result.session?.sessionId);
      console.log('Status:', result.session?.status);
      break;
    case 'cancelled':
      console.log('User cancelled verification');
      break;
    case 'failed':
      console.error('Verification failed:', result.error?.message);
      break;
  }
};

// Start verification with the `url` returned by POST /v3/session/ (or your UniLink)
DiditSdk.shared.startVerification({
  url: 'https://verify.didit.me/session/3FaJ9wLqX2Mz'
});

→ Documentation complète du SDK JavaScript

InContext (Iframe)

Intégrez le parcours de vérification directement dans votre application à l’aide d’une iframe. Une expérience fluide, sans rediriger les utilisateurs hors de votre site. Fonctionnalités clés :

UniLink (sans backend requis) : configuration en < 1 minute
Session API (avec backend) : personnalisation complète
Implémentations modales et intégrées
Exemples de composants React

Démarrage rapide :

<iframe 
  src="https://verify.didit.me/u/YOUR_WORKFLOW_ID_BASE64"
  style="width: 100%; height: 700px; border: none;" 
  allow="camera; microphone; geolocation; clipboard-write; fullscreen; autoplay; encrypted-media; digital-credentials-get"
></iframe>

→ Documentation complète InContext

Redirection

Redirigez les utilisateurs vers la page de vérification hébergée par Didit. Une fois la vérification terminée, les utilisateurs reviennent vers votre URL de rappel. Fonctionnalités clés :

Compatibilité maximale avec les navigateurs
Prise en charge de la vérification multi-appareils
Intégration simple
Fonctionne lorsque l’accès à la caméra dans l’iframe pose problème

Démarrage rapide :

// After creating a session via your backend
window.location.href = verificationUrl;

→ Documentation complète de la Redirection

Comparaison

Critère	SDK JavaScript	InContext (Iframe)	Redirection
Durée de configuration	3 min	< 1 min	5 min
Backend requis	Facultatif	Facultatif	Oui
Reste sur votre domaine	Oui	Oui	Non
Prise en charge multi-appareils	Oui	Oui	Oui
Contrôle programmatique complet	Oui	Limité	Callback uniquement
Callbacks d’événements	En temps réel	`postMessage`	Callback uniquement
Marque blanche	Oui	Oui	Oui
Compatibilité navigateurs	Tous	Tous	Tous

Les trois méthodes transmettent des résultats finaux et signés via des webhooks : le tableau ci-dessus décrit l’expérience dans le navigateur, et non la manière dont vous recevez la décision de vérification.

Configuration

Autorisations requises pour l’iframe

Pour les intégrations par iframe InContext, incluez toujours ces autorisations :

allow="camera; microphone; geolocation; clipboard-write; fullscreen; autoplay; encrypted-media; digital-credentials-get"

Dépôts d’exemples

Exemples SDK Web

Exemples React, Vue, Angular, Next.js, Nuxt, Svelte et JavaScript natif

Exemple d'iframe

Exemples d’iframe UniLink et de session API

Démo Next.js complète

Intégration Next.js de bout en bout

Package NPM

@didit-protocol/sdk-web sur npm

Voir aussi

Webhooks : recevez les résultats de vérification signés sur votre backend
API de création de session : l’endpoint sur lequel repose chaque SDK web
SDK natifs : iOS, Android, React Native, Flutter

Guides

Authentification

Model Context Protocol (MCP)

SDK web

SDK natifs

SDK serveur

Intégrations

SDK de vérification d'identité web : JavaScript et iframe

Méthodes d’intégration

SDK JavaScript

InContext (Iframe)

Redirection

Comparaison

Configuration

Autorisations requises pour l’iframe

Dépôts d’exemples

Exemples SDK Web

Exemple d'iframe

Démo Next.js complète

Package NPM

Voir aussi

​Méthodes d’intégration

​SDK JavaScript

​InContext (Iframe)

​Redirection

​Comparaison

​Configuration

​Autorisations requises pour l’iframe

​Dépôts d’exemples

Exemples SDK Web

Exemple d'iframe

Démo Next.js complète

Package NPM

​Voir aussi

Méthodes d’intégration

SDK JavaScript

InContext (Iframe)

Redirection

Comparaison

Configuration

Autorisations requises pour l’iframe

Dépôts d’exemples

Voir aussi