Consentiment biomètric per a BIPA, CUBI i Colorado

Illinois (BIPA), Texas (CUBI) i Colorado exigeixen un avís i una autorització explícita abans que una empresa recopili la geometria facial, a partir d’una selfie o de la foto d’un document d’identitat. Didit pot mostrar un pas de consentiment abans de la primera captura facial a les persones cobertes per aquestes lleis, i guarda la resposta a la sessió com a prova. Aquesta pàgina explica quan apareix el pas, quines aplicacions el poden mostrar i com arriba la resposta a la teva decisió i als webhooks.

Didit mostra el pas i registra la resposta. Tu decideixes si el recorregut d’usuari compleix les lleis biomètriques que s’apliquen al teu negoci. Aquesta pàgina no constitueix assessorament legal: revisa la teva implementació amb el teu assessor legal.

Quan apareix el pas

Una sessió mostra el pas de consentiment quan es compleixen totes dues condicions:

El flux de treball captura una cara. Un pas de Prova de vida, Coincidència facial o Estimació d’edat, la selfie que captura el pas de Verificació d’identitat amb la càmera frontal (tret que l’hagis desactivat), o l’enregistrament de vídeo de la sessió completa.
El mode de consentiment de l’aplicació ho demana. En mode Automàtic, s’aplica un dels activadors següents. En mode Sempre, ho demanen totes les sessions que capturen una cara.

El pas apareix abans de la primera captura facial. Quan només el document d’identitat mostra un estat cobert, apareix just després de la captura del document i abans de la selfie, i no es calcula cap geometria facial a partir de les imatges de captura del document fins que la persona hi doni el consentiment. Didit comprova el requisit quan la persona obre el flux i novament a cada pas fins que s’aplica. Un cop una sessió requereix consentiment, el continua requerint.

Modes de consentiment

Tria el mode a la consola, a Settings > Data and privacy > Biometric consent de l’aplicació. Cada canvi es registra al registre d’auditoria.

Mode	Què passa
Automàtic (per defecte, recomanat)	Mostra el pas només quan s’aplica un activador. Tota la resta veu l’avís estàndard d’una línia.
Sempre	Totes les persones a qui es captura la cara veuen el pas, siguin on siguin. La decisió registra `trigger: "forced"`.
Mai	Didit mai no mostra el pas. On la legislació estatal requereix consentiment, l’has de recollir tu mateix abans de la selfie i conservar el registre.

Què activa el pas en mode Automàtic

Didit comprova aquestes regles per ordre i registra la primera que s’aplica a biometric_consent.trigger:

Activador	Quan s’aplica
`declared_state`	Has declarat un estat cobert en crear la sessió: `user_state`, o una adreça dels EUA a `expected_details`.
`ip_state`	La IP de la persona està ubicada a Illinois, Texas o Colorado.
`ip_unknown`	Sembla que la persona és als EUA (una IP dels EUA, un document dels EUA o dades dels EUA que has enviat), però no es pot determinar el seu estat: la IP és dels EUA sense cap estat associat, o no es pot localitzar mentre que les teves dades o el document situen la persona als EUA.
`document_issuer`	El document d’identitat llegit durant la captura del document ha estat emès per un estat cobert.

Les VPN, els servidors intermediaris i les xarxes d’allotjament no ho demanen per si mateixos. Didit localitza la IP de la persona com qualsevol altra: una a Illinois, Texas o Colorado mostra el pas, i una en qualsevol altre lloc no ho fa. El pas només es demana si hi ha evidència clara d’un estat cobert (la IP, l’estat que ha emès el document d’identitat o un estat que hagis declarat), o quan la persona se situa als EUA sense cap estat (ip_unknown). A una persona d’un estat cobert que utilitzi una VPN amb sortida a un altre lloc, amb un document d’identitat que no hagi estat emès per cap estat cobert, no se li demana; fes servir el mode Sempre, o envia user_state, si necessites cobrir aquest cas. Dos valors més descriuen com s’ha resolt el consentiment d’una sessió en lloc del motiu pel qual s’ha demanat:

Activador	Significat
`forced`	El mode de l’aplicació és Sempre.
`customer_collected`	Has enviat el consentiment que ja havies recollit en crear la sessió (mira més avall).

Indica a Didit el que ja saps

Create Session admet dos camps opcionals per a això:

Camp	Què fa
`user_state`	On viu la persona, si ho saps: un codi de subdivisió ISO 3166-2 (`US-IL`, `ES-M`) o un codi o nom d’estat dels EUA (`IL`, `Illinois`). Un estat cobert mostra el pas amb `trigger: "declared_state"`. Un valor desconegut retorna `400`.
`biometric_consent`	Consentiment que ja has recollit: `{ "given_at": "<ISO 8601>", "text_version": "<your version id>" }`. El flux no ho torna a demanar i la decisió registra `status: "given"` amb `trigger: "customer_collected"`. `given_at` no pot estar en el futur.

{
  "workflow_id": "YOUR_WORKFLOW_ID",
  "vendor_data": "user-42",
  "user_state": "US-IL",
  "biometric_consent": {
    "given_at": "2026-10-13T09:12:00Z",
    "text_version": "consent-v3"
  }
}

Quines aplicacions mostren el pas

El pas necessita una aplicació que el pugui mostrar. Didit ho determina a cada sol·licitud que fa l’aplicació:

On es verifica la persona	Mostra el pas
El flux de verificació allotjat: un navegador, el Web SDK o una WebView	Sí
SDK natiu 4.10.0 o posterior (iOS, Android i versions de React Native o Flutter que incloguin la versió nativa 4.10.0 o posterior)	Sí
Un SDK natiu inferior a 4.10.0, o un que no informi de la seva versió	No

SDKs natius inferiors a 4.10.0

Els SDKs natius publicats abans de la versió 4.10.0 no coneixen el pas de consentiment, de manera que Didit mai no els el demana. La verificació s’executa exactament com abans: el selfie i les altres captures facials s’accepten i es processen, i la sessió arriba a la decisió com de costum. Didit mai no registra un consentiment que no s’hagi donat. Quan la sessió requeria consentiment i un SDK anterior ha capturat una cara, la decisió mostra:

"biometric_consent": {
  "required": true,
  "trigger": "ip_state",
  "status": "pending",
  "given_at": null,
  "reason": "BIOMETRIC_CONSENT_UNSUPPORTED_SDK"
}

Actualitza a l’SDK natiu 4.10.0 o posterior si verifiques persones a Illinois, Texas o Colorado en una aplicació nativa. Fins que no ho facis, aquestes sessions finalitzaran sense consentiment explícit, i recollir-lo abans del selfie és responsabilitat teva.

Si la persona continua la mateixa sessió en el flux allotjat (en un altre dispositiu, o en una WebView que l’aplicació obre per a determinats tipus de prova de vida), el flux allotjat mostra el pas i no hi captura cap cara fins que no respongui. El consentiment donat allà manté reason: "BIOMETRIC_CONSENT_UNSUPPORTED_SDK", perquè les cares ja s’havien capturat sense aquest.

Què veu la persona

El pas informa la persona de què es recull, per què, qui ho té i quant de temps es conserva, i enllaça a la Política de dades biomètriques. Té un únic botó: Accepto i continuo, que roman desactivat fins que la persona marca la casella d’acceptació. Didit conserva la resposta com a prova: quan es va donar, la versió i el hash del text mostrat, l’idioma, el pas del flux de treball i la IP, la ubicació i l’agent d’usuari de la sol·licitud. Un cop la persona accepta, la resposta és definitiva.

Quan la persona no hi està d’acord

El pas no té cap botó per rebutjar. Una persona que no vulgui donar el consentiment surt del flux: no es captura cap cara i la sessió finalitza com a Abandoned com qualsevol altra sessió que la persona no acaba (consulta Estats de verificació). Ofereix-li una altra manera de verificar-se.

Consentiment rebutjat a l’API

La decisió manté un estat declined i el motiu BIOMETRIC_CONSENT_DECLINED com a valors de l’API. Actualment cap pantalla de Didit ofereix l’opció de rebutjar, de manera que el flux allotjat i els SDKs natius no en registren cap. Una sessió que registra un rebuig:

Finalitza com a Declined, i el webhook status.updated es dispara com amb qualsevol altre rebuig.
Mostra biometric_consent.status com a declined, reason i decline_reason com a BIOMETRIC_CONSENT_DECLINED, i declined_at amb l’hora.
No captura cap cara després del rebuig. Totes les imatges facials i plantilles facials que la sessió ja contingui s’eliminen: els selfies, el selfie amb la càmera frontal de la captura del document d’identitat, el retall facial del retrat del document i els vídeos de prova de vida i de sessió completa. face_data_deleted_at registra quan. La decisió ja no els retorna, i l’eliminació és irreversible.
Conserva les imatges dels documents i les dades que se n’han extret: el rebuig no els afecta.

A la decisió i als webhooks

Cada decisió de Verificació d’usuaris conté un objecte biometric_consent, a Recuperar la sessió i al camp decision dels webhooks de sessió. És null quan la sessió mai no s’ha avaluat, per exemple en un flux de treball sense captura facial.

`status`	Significat
`not_required`	La sessió no requeria consentiment.
`pending`	El consentiment és obligatori i no s’ha donat. Consulta `reason` per distingir un SDK anterior d’una persona que encara no ha respost.
`given`	La persona ha acceptat en el flux, o has enviat `biometric_consent` en crear-la.
`declined`	S’ha registrat un rebuig i la sessió ha finalitzat com a `Declined`. Actualment cap pantalla de Didit ofereix l’opció de rebutjar (consulta més amunt).

`reason`	Significat
`BIOMETRIC_CONSENT_UNSUPPORTED_SDK`	Un SDK natiu inferior a 4.10.0, o un que no ha informat de la seva versió, ha capturat una cara sense el pas.
`BIOMETRIC_CONSENT_DECLINED`	S’ha registrat un rebuig. Actualment cap pantalla de Didit ofereix l’opció de rebutjar.
`null`	Res a explicar. Sempre `null` quan la sessió no requeria consentiment.

Una sessió en què la persona ha acceptat en el flux allotjat:

"biometric_consent": {
  "required": true,
  "trigger": "declared_state",
  "status": "given",
  "given_at": "2026-10-13T18:31:07.412000Z",
  "declined_at": null,
  "text_version": "bio-consent-2026-10-12",
  "locale": "en",
  "policy_url": "https://didit.me/legal/biometric-data-policy",
  "step": "LIVENESS",
  "ip_address": "198.51.100.23",
  "ip_country_code": "ES",
  "detected_ip_address": "198.51.100.23",
  "detected_country_code": "ES",
  "jurisdictions": ["IL"],
  "retention_months": 36,
  "reason": null,
  "decline_reason": null,
  "face_data_deleted_at": null
}

L’exemple està abreujat. Tots els camps, amb el seu tipus, es troben a Models de dades.

Contingut relacionat

Crear la sessió: user_state i biometric_consent.
Recuperar la sessió: la decisió que conté biometric_consent.
SDKs natius: versions i passos d’actualització.
Seguretat i compliment: les teves responsabilitats en els fluxos de verificació.

Visió general

Preus

Fluxos de treball i verificació

Revisió i operacions

Entitats (usuaris i empreses)

Configuració i personalització

Seguretat i compliment

Didit Academy

Recursos

Consentiment biomètric per a BIPA, CUBI i Colorado

Quan apareix el pas

Modes de consentiment

Què activa el pas en mode Automàtic

Indica a Didit el que ja saps

Quines aplicacions mostren el pas

SDKs natius inferiors a 4.10.0

Què veu la persona

Quan la persona no hi està d’acord

Consentiment rebutjat a l’API

A la decisió i als webhooks

Contingut relacionat

​Quan apareix el pas

​Modes de consentiment

​Què activa el pas en mode Automàtic

​Indica a Didit el que ja saps

​Quines aplicacions mostren el pas

​SDKs natius inferiors a 4.10.0

​Què veu la persona

​Quan la persona no hi està d’acord

​Consentiment rebutjat a l’API

​A la decisió i als webhooks

​Contingut relacionat

Quan apareix el pas

Modes de consentiment

Què activa el pas en mode Automàtic

Indica a Didit el que ja saps

Quines aplicacions mostren el pas

SDKs natius inferiors a 4.10.0

Què veu la persona

Quan la persona no hi està d’acord

Consentiment rebutjat a l’API

A la decisió i als webhooks

Contingut relacionat