Passer au contenu principal
Chaque document qu’un utilisateur téléverse pendant la vérification est lié de façon permanente à son entité User. Cette page explique ce qui est collecté, comment le récupérer et comment téléverser manuellement des documents supplémentaires.

Ce que Didit collecte

Types de documents pris en charge couvrent l’ensemble de la matrice pays × documents (14,000+ documents dans 220+ pays).

Récupérer les documents

Les documents sont associés à la session qui les a collectés, et non directement à l’utilisateur. Pour lister tous les documents d’un utilisateur :
1

Lister les sessions de l'utilisateur

2

Récupérer la décision de chaque session

Chaque décision de session contient des URL vers les documents collectés.
Inspectez les champs id_verification.document_images, proof_of_address.document_images et liveness.images de la réponse.
3

Utiliser les URL signées

Les URL des images dans la réponse sont des URL signées de courte durée. Mettez-les en cache côté client pendant leur utilisation, ou récupérez à nouveau la décision lorsqu’elles expirent.

Générer un rapport PDF

Pour un export lisible de tout ce qui a été collecté pour une session, y compris tous les documents, utilisez : GET /v3/session/{session_id}/generate-pdf/ Renvoie un PDF contenant les détails de la session, les résultats des fonctionnalités et les images des documents intégrées. Utile pour les audits de conformité, les pièces jointes de déclarations d’activité suspecte (SAR) et les dépôts réglementaires.

Téléverser des documents depuis la console

Les opérateurs de conformité peuvent téléverser des documents supplémentaires pour un utilisateur ou une session active :
  1. Accédez à Users → [user] → Documents → Upload document.
  2. Choisissez un type de document (ID, POA, personnalisé).
  3. Téléversez un fichier ; l’OCR s’exécute automatiquement pour les types pris en charge.
  4. Le document est rattaché à la session la plus récente (ou vous pouvez créer une session de remédiation).
L’interface de téléversement de documents n’est disponible que dans la console : il n’existe aucun point d’accès API public permettant de rattacher directement un document à un utilisateur. Utilisez les sessions comme point d’entrée pour toute capture de document.

Recoupement des documents

Lorsqu’une session collecte plusieurs types de documents, Didit les recoupe :
  • ID ↔ Détection du vivant : le visage de la pièce d’identité correspond au selfie de détection du vivant.
  • ID ↔ POA : le nom figurant sur le justificatif de domicile correspond au nom extrait de la pièce d’identité.
  • ID ↔ NFC : les données MRZ ou visuelles correspondent aux données de la puce NFC.
Les incohérences sont signalées sous forme d’avertissements dans la décision de session et peuvent être configurées pour déclencher un examen manuel.

Surveillance des documents et revérification

Pour les cas d’usage qui exigent une validité continue des documents (par exemple, les pièces d’identité expirées) :
  • L’expiration du document est suivie pour chaque pièce d’identité vérifiée. Interrogez la décision de session pour le champ expiration_date.
  • Surveillance des documents : activée par défaut et automatique, rien n’a besoin d’être activé. Lorsque la date d’expiration de la pièce d’identité est dépassée, une session "Approved" passe à "Kyc Expired", le résultat de la vérification d’identité reçoit un avertissement DOCUMENT_EXPIRED et un webhook status.updated est déclenché. Aucun avertissement n’est envoyé avant la date d’expiration.
  • Pour la désactiver, définissez Expiration mode sur Allow expired pour ce pays et ce type de document dans les paramètres de vérification d’identité. Reject expired, valeur par défaut, est le mode qui active la surveillance. Un document accepté avec Allow expired n’est jamais surveillé.
  • Revérification : lancez une nouvelle session avec le même vendor_data pour actualiser les documents.

Géolocalisation du document

La vérification de géolocalisation du document d’identité compare la localisation IP de la personne qui soumet le document au pays de délivrance de la pièce d’identité. Les résultats sont joints à la décision de session.

Confidentialité et conservation

  • Tous les documents sont chiffrés au repos.
  • L’accès aux images se fait via des URL signées de courte durée.
  • La conservation suit la politique de conservation des données de l’application.
  • Les utilisateurs ont le droit de demander la suppression ; la suppression efface les images, les extraits OCR et les données NFC.

Prochaines étapes

Vérification d'identité

Fonctionnement de la capture de la pièce d’identité et de l’OCR.

Justificatif de domicile

Collecte des justificatifs de domicile.

Décision de session

Référence de GET /v3/session//decision/.
Dernière modification le 7 novembre 2026