Référence API Didit : API REST de vérification d'identité

Didit propose deux approches complémentaires de la vérification d’identité. Comprendre la différence est essentiel pour choisir l’intégration adaptée à votre cas d’usage.

Sessions hébergées (recommandées pour les parcours utilisateur)

Les sessions hébergées constituent l’approche recommandée pour la plupart des intégrations. Lorsque vous créez une session, Didit génère un verification_url que vous présentez à votre utilisateur. L’utilisateur effectue l’ensemble du parcours de vérification dans l’interface optimisée de Didit, et vous recevez les résultats par webhook ou par API.

Fonctionnement

Créer une session

Votre serveur appelle POST /v3/session/ avec un ID de workflow. Didit renvoie un verification_url et un session_token.

Présenter à l'utilisateur

Redirigez l’utilisateur, intégrez l’interface via un iframe ou initialisez un SDK natif avec le token de session.

L'utilisateur termine la vérification

L’utilisateur suit le parcours guidé dans l’interface optimisée de Didit : capture de la pièce d’identité, détection du vivant et étapes supplémentaires éventuelles.

Recevoir les résultats

Didit envoie un webhook à votre serveur avec la décision de vérification, ou vous interrogez l’API de récupération.

Pourquoi les sessions sont recommandées

Avantage	Détails
UX optimisée	L’interface de vérification fait l’objet de tests A/B continus à l’échelle mondiale pour obtenir les taux de finalisation les plus élevés
Gestion de la caméra	Sélection intelligente de la caméra, capture automatique, contrôles de qualité et compatibilité des appareils intégrés
Parcours guidé	Instructions étape par étape, retour en temps réel et récupération en cas d’erreur pour l’utilisateur
Workflows multifonctions	Enchaînez plusieurs fonctionnalités (vérification d’identité + détection du vivant + AML + téléphone + e-mail) dans un seul parcours
Sécurité	Anti-usurpation, détection active du vivant et empreinte de l’appareil intégrées au parcours
Conformité	Journaux d’audit au niveau de la session, recueil du consentement et politiques de conservation des données gérées automatiquement
Localisation	54 langues avec détection automatique du navigateur
Natif mobile	SDK natifs pour iOS, Android, React Native et Flutter
Aucune maintenance	Didit prend en charge toutes les mises à jour de l’interface, les bugs de navigateur et d’appareil, ainsi que les cas limites de la caméra

Quand utiliser les sessions

Onboarding / KYC : de nouveaux utilisateurs s’inscrivent et doivent vérifier leur identité
Vérification de l’âge : confirmer que les utilisateurs remplissent les exigences d’âge minimum
Revérification : revérifier périodiquement les utilisateurs existants
Authentification biométrique : les utilisateurs s’authentifient par leur visage pour les actions sensibles
Conformité multi-étapes : parcours nécessitant vérification d’identité, détection du vivant, AML et téléphone en une seule fois
Tout scénario où l’utilisateur final est présent et interagit directement

Endpoints de session

Endpoint	Finalité
Créer une session	Générer une URL de vérification pour un utilisateur
Récupérer une session	Obtenir les résultats complets et la décision pour une session
Lister les sessions	Interroger et filtrer toutes les sessions
Supprimer une session	Supprimer une session et toutes les données associées
Générer un PDF	Exporter un rapport de vérification au format PDF
Partager une session	Générer un token de partage pour le KYC réutilisable avec un partenaire
Importer une session partagée	Importer une session partagée par un partenaire (KYC réutilisable)

API autonomes (pour le traitement serveur à serveur)

Les API autonomes vous permettent d’appeler des fonctionnalités de vérification individuelles directement depuis votre serveur, sans interface utilisateur. Vous envoyez les données (images, documents, noms) et vous recevez des résultats structurés.

Fonctionnement

Envoyer les données

Votre serveur appelle un endpoint autonome (par exemple POST /v3/id-verification/) avec les données requises : images, documents ou champs JSON.

Recevoir les résultats

Didit traite la requête de manière synchrone et renvoie les résultats de vérification structurés dans la réponse.

Quand utiliser les API autonomes

Cas d’usage	Exemple
Traitement côté serveur	Vous disposez déjà d’images de documents issues de votre propre interface de capture et devez les vérifier
Vérification par lots	Traitement en masse de documents d’identité importés par une équipe opérationnelle
UX personnalisée	Vous avez créé votre propre parcours de capture et souhaitez utiliser Didit uniquement pour l’analyse
Contrôles serveur à serveur	Filtrage AML d’une liste de clients, sans aucune interaction de l’utilisateur
Pipelines automatisés	Revérifications de conformité en CI/CD ou via cron (par exemple, surveillance AML quotidienne)
Intégration aux systèmes existants	Connexion de la vérification Didit à votre système de gestion documentaire existant
Appels à une seule fonctionnalité	Vous n’avez besoin que d’une fonctionnalité (par exemple, uniquement le filtrage AML ou uniquement la correspondance faciale)

API autonomes disponibles

Identité et documents

API	Fonction
Vérification d’identité	Extraire et valider les données des documents d’identité (images recto et verso)
Justificatif de domicile	Vérifier les documents d’adresse (factures de services publics, relevés bancaires, documents gouvernementaux)
Validation d’adresse	Confirmer qu’une adresse existe et la renvoyer normalisée, avec ses coordonnées
Validation en base de données	Recouper les données utilisateur avec les bases de données gouvernementales

Document AI

API	Fonction
Document AI	Extraire les champs que vous définissez à partir de n’importe quel document (PDF ou image), avec correspondance des noms et contrôles d’altération

Biométrie et visage

API	Fonction
Détection passive du vivant	Vérifier qu’une personne réelle est présente (anti-usurpation) à partir d’une seule image
Correspondance faciale	Comparer deux visages pour déterminer s’il s’agit de la même personne
Recherche faciale	Rechercher un visage parmi toutes les sessions vérifiées précédemment (1:N)
Estimation de l’âge	Estimer l’âge d’une personne à partir d’une image de son visage

Conformité et risque

API	Fonction
Filtrage AML	Filtrer des personnes ou des entreprises par rapport aux sanctions, aux PEP et aux listes de surveillance

Vérification bancaire

API	Fonction
Vérification de compte	Vérifier qu’un compte bancaire appartient à la personne ou à l’entreprise que vous indiquez, avant d’envoyer de l’argent vers ce compte

Vérification d’entreprise (KYB)

API	Fonction
Recherche dans les registres KYB	Rechercher dans les registres des sociétés par nom, numéro d’immatriculation et pays ; jusqu’à $0.50 par requête réussie
Sélection dans les registres KYB	Récupérer le profil complet du registre (dirigeants, bénéficiaires effectifs, adresses) pour une entreprise sélectionnée

Comparaison côte à côte

	Sessions hébergées	API autonomes
Effort d’intégration	Faible : redirection, iframe ou SDK	Moyen : vous gérez la capture et l’envoi des données
Interaction utilisateur	Oui : l’utilisateur termine le parcours dans l’interface Didit	Non : communication uniquement serveur à serveur
Caméra et capture	Prises en charge par Didit (optimisées)	Vous fournissez les images et les données
Parcours multi-fonctionnalités	Oui : enchaînez les fonctionnalités dans un workflow	Une fonctionnalité par appel d’API
Optimisation de l’UX	Testée en continu en A/B	Vous contrôlez l’UX
Localisation	54 langues, détectées automatiquement	Non applicable (pas d’interface)
Webhooks	Notifications de statut automatiques	Non applicable (réponse synchrone)
Temps de réponse	Asynchrone (l’utilisateur termine à son rythme)	Synchrone (quelques secondes)
Idéal pour	Onboarding et vérification côté utilisateur	Traitement backend et automatisation
Visibilité dans la console	Cycle de vie complet de la session dans le tableau de bord	Apparaît dans la section Manual Checks

Peut-on utiliser les deux

Oui. De nombreuses équipes combinent les deux approches :

Sessions pour l’onboarding : les nouveaux utilisateurs suivent le parcours de vérification hébergé complet lors de leur inscription
AML autonome pour la surveillance continue : une tâche cron repasse chaque nuit tous les utilisateurs approuvés au crible des listes de surveillance mises à jour
Recherche faciale autonome pour la détection de doublons : lorsqu’une nouvelle session est approuvée, votre serveur appelle l’API de recherche faciale pour vérifier l’existence de doublons
Vérification d’identité autonome pour les opérations : votre équipe des opérations importe manuellement des documents pour l’examen des cas limites

Exemple : architecture combinée

Votre application	API Didit	Type
Parcours d’inscription utilisateur	API Sessions (interface hébergée)	Côté utilisateur
Refiltrage AML nocturne	API AML autonome	Serveur à serveur
Examen des documents par l’équipe des opérations	API Vérification d’identité autonome	Serveur à serveur
Détection de visages en double	API Recherche faciale autonome	Serveur à serveur

Pour commencer

Dernière modification le 7 novembre 2026

​Sessions hébergées (recommandées pour les parcours utilisateur)

​Fonctionnement

​Pourquoi les sessions sont recommandées

​Quand utiliser les sessions

​Endpoints de session

​API autonomes (pour le traitement serveur à serveur)

​Fonctionnement

​Quand utiliser les API autonomes

​API autonomes disponibles

​Comparaison côte à côte

​Peut-on utiliser les deux

​Exemple : architecture combinée

​Pour commencer

Sessions hébergées (recommandées pour les parcours utilisateur)

Fonctionnement

Pourquoi les sessions sont recommandées

Quand utiliser les sessions

Endpoints de session

API autonomes (pour le traitement serveur à serveur)

Fonctionnement

Quand utiliser les API autonomes

API autonomes disponibles

Comparaison côte à côte

Peut-on utiliser les deux

Exemple : architecture combinée

Pour commencer