Saltar al contingut principal
La biometria facial és fonamental per a cada entitat User. Didit captura una cara durant la prova de vida, genera un embedding vectorial i l’emmagatzema per a quatre funcionalitats posteriors: cerca facial 1:N, detecció de duplicats, aplicació de la llista de bloqueig i reautenticació biomètrica.
Les cares emmagatzemades també serveixen de referència per a l’Autenticació biomètrica: crea una sessió d’autenticació biomètrica amb el vendor_data de l’usuari i omet portrait_image, i Didit reutilitza automàticament la cara emmagatzemada (primer la cara de la prova de vida aprovada, després la foto del xip del passaport electrònic, després el retrat del document d’identitat i, finalment, una cara de perfil inscrita manualment).

Com s’associen les cares a un usuari

1

Capturada durant la prova de vida

Quan un User fa una sessió amb la prova de vida activada, Didit captura un selfie, executa la prova de vida passiva, extreu la cara més gran i genera un embedding vectorial per a la cerca.
2

Emmagatzemada al perfil d'usuari

La cara s’enllaça a la sessió i a l’entitat User pare. La URL del retrat apareix al perfil d’usuari com a portrait_image.
3

Indexada per a la cerca

L’embedding s’afegeix a l’índex de cerca. Les sessions posteriors poden fer cerques 1:N en aquest índex.

Cerca facial (1:N)

La cerca facial et permet trobar un usuari pujant una imatge i comparant-la amb totes les cares inscrites a la teva aplicació. Casos d’ús:
  • Detecció de duplicats durant l’alta: evita que la mateixa persona creï dos comptes.
  • Cerca inversa: identifica l’usuari que hi ha darrere d’un fotograma de CCTV o d’una imatge en una investigació de frau.
  • Reconeixement de clients habituals: omet el KYC per a un client que torna.
La cerca facial s’executa automàticament durant les sessions noves quan el teu flux de treball té la detecció de duplicats activada. També s’ofereix com a API independent:

Detecció de duplicats

Cada cara nova es pot comparar amb les cares inscrites existents per detectar duplicats. Didit assigna a cada cara un approved_duplicate_status: Els fluxos de treball es poden configurar per:
  • Rebutjar automàticament les sessions marcades com a duplicades.
  • Marcar per revisar: enviar la sessió a un analista humà.
  • Només advertir: permetre la sessió però afegir una etiqueta de risc.
Configura-ho a la consola a Workflows → [el teu flux de treball] → Face Match / Liveness → Duplicate detection.

Llista de bloqueig facial

Rebutjar una sessió no afegeix la cara a cap llista de bloqueig. Per rebutjar sessions futures amb la mateixa cara, bloqueja-la tu mateix: afegeix-la des de la pàgina de la llista de bloqueig o amb l’API de llistes. Una sessió nova amb un selfie de prova de vida que coincideixi amb aquesta entrada es rebutja automàticament.

Pujar una cara importada a un perfil d’usuari

Si estàs migrant des d’un altre proveïdor de KYC, pots crear primer el User i després adjuntar-li a aquest perfil una imatge facial fiable. El User continua identificat pel teu vendor_data, però l’endpoint de pujada de cares utilitza l’identificador intern del User de Didit (didit_internal_id) perquè el destí no sigui ambigu.
1

Crea o recupera el User

Crida POST /v3/users/create/ amb el teu vendor_data estable, o crida GET /v3/users/{vendor_data}/ si el User ja existeix.
2

Llegeix didit_internal_id

La resposta del User inclou didit_internal_id. Continua utilitzant vendor_data al teu propi sistema; utilitza didit_internal_id només per als endpoints d’adjunció de perfils.
Les cares importades al perfil s’inscriuen al mateix índex facial que s’utilitza per a la detecció de duplicats i la cerca facial. No s’afegeixen automàticament a cap llista de bloqueig. Per bloquejar un mal actor conegut, puja la cara a una llista de cares.
Puja només cares que tinguis permís per tractar d’acord amb el teu propi avís de privacitat i el teu acord de migració. Conserva els identificadors del proveïdor d’origen a metadata o comment només quan es puguin exposar de manera segura als teus operadors de compliment.

Com es produeix el bloqueig

Pujar una cara a la llista de bloqueig

Per bloquejar un usuari per la seva cara de manera programàtica, puja la imatge de la cara a una llista de bloqueig de tipus facial mitjançant l’endpoint dedicat Pujar cara a la llista. Didit extreu l’embedding biomètric i l’insereix a l’índex de coincidències: qualsevol sessió futura amb un selfie de prova de vida que coincideixi es rebutja automàticament.
Pujar una cara al perfil i pujar una cara a la llista de bloqueig són operacions diferents. Utilitza la pujada al perfil per adjuntar a un User una cara importada fiable com a evidència, per a la detecció de duplicats i per a la cerca facial. Utilitza l’API de llistes per bloquejar una cara perquè les sessions coincidents futures es rebutgin.

Eliminar una cara de la llista de bloqueig

Elimina l’entrada des de la consola a Blocklist → Faces → row actions → Remove, o utilitza l’endpoint Eliminar entrada.

Plantilles biomètriques retingudes després de la supressió de sessions

Si elimines una sessió, se suprimeixen la imatge de la cara i, per defecte, l’embedding facial, de manera que la persona deixa d’aparèixer en la detecció de duplicats i en la Cerca facial. Si elimines sessions poc després de l’aprovació però encara necessites detectar registres repetits, activa la retenció de plantilles biomètriques a l’aplicació o envia retain_face_embeddings: true en la crida de supressió. Aleshores, Didit elimina la sessió i totes les seves dades com de costum, i conserva una única plantilla biomètrica facial gestionada per separat i sense imatge, vinculada a l’Usuari:
  • Conté només la plantilla facial numèrica i les metadades de retenció. Mai no conté la imatge de la cara, el vídeo de prova de vida, les dades del document, els camps d’identitat extrets, la decisió ni l’id de la sessió suprimida.
  • Participa en la detecció de duplicats, la Cerca facial, l’autenticació biomètrica i les teves llistes facials exactament igual que una cara d’una sessió activa. Les coincidències s’informen amb source: "retained_template", el vendor_user_id i el vendor_data de l’Usuari, i un biometric_template_id.
  • És una dada biomètrica amb un expires_at finit. Es purga quan se suprimeix l’Usuari, quan se suprimeix qualsevol sessió d’aquest Usuari amb deletion_instruction: "privacy_erasure", quan caduca, o quan la purgues a Llistes → Plantilles biomètriques o mitjançant l’API de plantilles biomètriques.
  • Una sessió creada sense vendor_data no té cap Usuari al qual vincular una plantilla; en suprimir-la s’informa ineligible_no_vendor_user i l’embedding se suprimeix amb la sessió.
  • Les plantilles retingudes mai no s’inclouen a la llista de bloqueig. Una entrada de la llista de bloqueig creada a partir de la sessió suprimida conserva la seva pròpia entrada biomètrica independent i el seu propi cicle de vida.
Les plantilles vinculades a un Usuari apareixen al perfil de l’Usuari, a Plantilles biomètriques, amb una acció de purga.

Resum del cicle de vida facial

Puja una cara des de la consola

Els operadors de compliment poden pujar cares manualment:
  1. Navega fins a Usuaris → [usuari] → Accions → Puja una cara.
  2. Selecciona una imatge; Didit extreu la cara més gran i emmagatzema un nou registre de cara vinculat a l’usuari.
  3. La cara queda registrada per a l’evidència del perfil, la detecció de duplicats i la cerca facial. Utilitza l’àrea de llistes de bloqueig quan l’objectiu sigui rebutjar les sessions futures que coincideixin.
Això és útil quan:
  • Tens un retrat conegut d’un client verificat per un canal fora de línia.
  • Vols preomplir una llista de bloqueig amb actors maliciosos coneguts de la teva base de dades de frau.

Privacitat i retenció

  • Els embeddings facials són vectors numèrics, no imatges. Les imatges en si s’emmagatzemen en un emmagatzematge d’objectes xifrat, amb accés mitjançant URL signades. Un embedding facial és una dada biomètrica.
  • La retenció segueix la política de conservació de dades de la teva aplicació. Les plantilles biomètriques retingudes segueixen el període finit i més estricte de retenció de plantilles biomètriques.
  • En suprimir una sessió se suprimeixen la imatge i, per defecte, l’embedding. Si la teva aplicació ha optat per la retenció de plantilles biomètriques, en suprimir una sessió es conserva una plantilla sense imatge fins que caduqui o es purgui.
  • Per a una sol·licitud de dret a l’oblit del RGPD / CCPA, suprimeix les sessions de la persona amb deletion_instruction: "privacy_erasure" o suprimeix l’Usuari: en tots dos casos es purguen també totes les plantilles retingudes. Les entrades de la llista de bloqueig facial que gestiones es conserven fins que les eliminis.

Següents passos

Cerca facial

Com funciona la cerca facial 1:N.

Prova de vida

La prova de vida que captura la cara.

API de llista de bloqueig

Puja una cara a una llista de bloqueig.

Plantilles biomètriques

Plantilles retingudes després de la supressió de sessions.

Llista de bloqueig d'usuaris

Com funciona el bloqueig d’un usuari.
Darrera modificació el 7 de novembre del 2026