API de coincidència facial 1:1: selfie i document

​

Reintents i indicacions útils

• Límit d’intents — face_match_max_attempts controla el nombre total d’enviaments de coincidència facial per sessió. Per defecte són 3 (un intent inicial més dos reintents), configurable per a cada node del flux de treball (interval d’1 a 3).
• Feedback de reintent — mentre quedin intents, una fallada reintentable manté l’usuari en aquest pas i retorna feedback_codes (els SDK web i mòbil els mostren automàticament com a missatges d’orientació):
  {
    "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
  }
  
• Exhauriment — un cop exhaurit el límit, s’aplica l’estat calculat (Declined o In Review).

​

Com funciona

​

Requisits dels documents

​

Requisits generals

• Emès pel govern i vàlid dins del seu període de validesa configurat
• Físicament intacte (sense danys, rascades o taques que n’ocultin els detalls)
• Tota la informació crítica (nom complet, data de naixement, MRZ, etc.) clarament llegible
• Dades coherents en tots els documents enviats

​

Requisits de les imatges

• Foto original en temps real (sense captures de pantalla, escanejos ni còpies digitals)
• Formats admesos: JPG, JPEG, PNG, PDF
• Mida màxima de fitxer: 5MB
• Imatge en color amb totes les cantonades del document visibles
• Sense reflexos, ombres, edició digital o manipulació
• Es requereixen documents físics (els documents d’identitat digitals només s’admeten en regions seleccionades on estiguin reconeguts oficialment)

​

Configuració addicional per país i tipus de document

• Mode de caducitat: Tria com gestionar els documents amb dates de caducitat superades.
  • Rebutjar caducats: Si la data de caducitat del document és anterior a avui, marca’l com a caducat i rebutja’l.
  • Permetre caducats: No marquis ni bloquegis documents amb una data de caducitat superada.
• Format de caràcters preferit: Selecciona com s’han de normalitzar els noms i els camps extrets.
  • Preferir caràcters llatins (A–Z): Exemple: “Mohammed”
  • Preferir el sistema d’escriptura original (no llatí): Exemple: “محمد”
• Suport regional i subtipus: Habilita documents per regió i especifica els subtipus acceptables quan un tipus de document contingui moltes variacions.
  • Exemple: Per als permisos de conduir dels Estats Units, selecciona els subtipus exactes que acceptes (p. ex., Arizona Commercial Driver License, Indiana Operator License (REAL ID), New York Enhanced Driver License, etc.).
  • Utilitza el control “Accepted subtypes” per incloure o excloure ràpidament moltes variants (p. ex., “128 selected”).

Consell: Aquesta configuració s’aplica per país i tipus de document, de manera que pots ser estricte en alguns mercats i més permissiu en d’altres.