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 :- Accédez à Users → [user] → Documents → Upload document.
- Choisissez un type de document (ID, POA, personnalisé).
- Téléversez un fichier ; l’OCR s’exécute automatiquement pour les types pris en charge.
- 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.
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 avertissementDOCUMENT_EXPIREDet un webhookstatus.updatedest 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_datapour 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/.