Correspondance faciale 1:1 : API selfie et ID

​

Nouvelles tentatives et retours exploitables

• Budget de tentatives — face_match_max_attempts contrôle le nombre total de soumissions de correspondance faciale par session. Par défaut 3 (une tentative initiale plus deux nouvelles tentatives), configurable par nœud de workflow (plage de 1 à 3).
• Retour lors d’une nouvelle tentative — tant qu’il reste des tentatives, un échec rectifiable maintient l’utilisateur sur l’étape et renvoie feedback_codes (les SDK Web et Mobile affichent automatiquement ces éléments sous forme de messages de guidage) :
  {
    "detail": "Make sure your face matches your document photo, improve lighting and try again.",
    "error": "LOW_FACE_MATCH_SIMILARITY",
    "feedback_codes": ["LOW_FACE_MATCH_SIMILARITY"],
    "attempts_used": 1,
    "max_attempts": 3
  }
  
• Épuisement — une fois le budget épuisé, le statut calculé est appliqué (Declined ou In Review).

​

Fonctionnement

​

Exigences relatives aux documents

​

Exigences générales

• Délivré par un gouvernement et valide au cours de sa période de validité configurée
• Physiquement intact (aucun dommage, rayure ou tache ne masquant les détails)
• Toutes les informations essentielles (nom complet, date de naissance, MRZ, etc.) doivent être clairement lisibles
• Données cohérentes sur l’ensemble des documents soumis

​

Exigences relatives aux images

• Photo originale prise en temps réel (pas de captures d’écran, de scans ou de copies numériques)
• Formats pris en charge : JPG, JPEG, PNG, PDF
• Taille maximale du fichier : 5MB
• Image en couleur avec tous les coins du document visibles
• Sans reflet, ombre, retouche numérique ou manipulation
• Documents physiques requis (pièces d’identité numériques prises en charge uniquement dans certaines régions où elles sont officiellement reconnues)

​

Paramètres supplémentaires par pays et type de document

• Mode d’expiration : Choisissez comment traiter les documents dont la date d’expiration est dépassée.
  • Refuser les documents expirés : Si la date d’expiration du document est antérieure à aujourd’hui, marquez-le comme expiré et refusez-le.
  • Autoriser les documents expirés : Ne signalez ni ne bloquez les documents dont la date d’expiration est dépassée.
• Format de caractères préféré : Sélectionnez le mode de normalisation des noms et des champs extraits.
  • Privilégier les caractères latins (A–Z) : Exemple : “Mohammed”
  • Privilégier le système d’écriture d’origine (non latin) : Exemple : “محمد”
• Prise en charge régionale et sous-types : Activez les documents par région et spécifiez les sous-types acceptables lorsqu’un type de document comporte de nombreuses variantes.
  • Exemple : Pour les permis de conduire des États-Unis, sélectionnez les sous-types exacts que vous acceptez (par ex., Arizona Commercial Driver License, Indiana Operator License (REAL ID), New York Enhanced Driver License, etc.).
  • Utilisez le contrôle “Sous-types acceptés” pour inclure ou exclure rapidement de nombreuses variantes (par ex., “128 sélectionnés”).

Conseil : Ces paramètres s’appliquent par pays et type de document, ce qui vous permet d’être strict sur certains marchés tout en étant plus permissif sur d’autres.