Saltar al contingut principal
La Verificació d’identitat és una funcionalitat amb tres mètodes. Tu tries quins mètodes pot utilitzar un país; l’usuari final rep els que s’apliquin al país que triï, i la sessió registra quin mètode ha produït realment el resultat. La captura del document no canvia. Tot el que ja configures mitjançant documents_allowed —tipus acceptats, subtipus, regles de captura, llindars, advertències— continua funcionant exactament com abans, i un flux de treball que no especifica res sobre mètodes es manté només amb captura del document.

​
Com funciona cada mètode

​
Captura del document

El que documenta la resta d’aquesta secció: l’usuari fotografia el document, Didit el llegeix, en comprova l’autenticitat i retorna els camps extrets. Disponible a tots els països que Didit admet, a $0.15 per comprovació. Comença per la Visió general de la Verificació d’identitat.

​
Consulta sense document

L’usuari introdueix el seu número d’identificació nacional i algunes dades personals, i Didit les verifica contra la font fidedigna d’aquell país. No requereix cap fotografia d’un document. Aquesta font és un registre governamental a la majoria de països, però no a tots: al Canadà, França, Indonèsia, els Països Baixos, Noruega, Singapur, el Regne Unit i els Estats Units és un fitxer d’una agència d’informació creditícia, de serveis financers, de subministraments o de registres residencials. Com que la procedència i el règim de consentiment aplicable varien segons la font, la font exacta s’especifica per país a la taula següent i a Consulta sense document —mai es generalitza. Quan la font retorna un retrat —avui Sud-àfrica, Nigèria, l’Argentina i Panamà, tots quatre registres governamentals—, també es demana una selfie a l’usuari. S’executa una prova de vida passiva sobre aquesta selfie i es fa una coincidència facial amb el retrat del registre, tot dins de la consulta i tot inclòs en el preu de la consulta. Quan la font només retorna dades, no hi ha res amb què comparar facialment, de manera que no es pren cap selfie; executa la Prova de vida i la Coincidència facial com a passos independents del flux de treball si els necessites. Tots els camps de sol·licitud per país, les regles de format i els règims de consentiment es troben a Consulta sense document.

​
Cartera

L’usuari inicia sessió amb una identitat digital que ja té, com ara un eID nacional o una identitat bancària. La cartera l’autentica i després comparteix els atributs d’identitat signats amb Didit. Segons la cartera, l’usuari pot introduir un codi d’identificació personal o un número de telèfon; no cal cap fotografia del document per a la verificació amb cartera. L’experiència d’inici de sessió depèn de la cartera: una transferència a una aplicació, un codi QR o un codi de comparació confirmat al telèfon de l’usuari. Smart-ID i Mobile-ID utilitzen un codi de comparació. Els atributs per cartera, la disponibilitat a producció i la semàntica d’errors es troben a Carteres d’identitat digital.

​
Nivells de garantia

Cada resultat de la Verificació d’identitat inclou un nivell de garantia derivat del mètode que l’ha produït. El nivell és una descripció honesta del que realment s’ha demostrat, no pas una classificació:
Els nivells de garantia són una etiqueta adreçada als administradors. Apareixen al payload de la sessió, a la consola i a les exportacions. Els usuaris finals mai veuen el nivell, el preu ni el nom de la font que s’ha consultat.

​
Configuració dels mètodes per país

Els mètodes es troben sota la clau methods a la configuració de la funcionalitat de Verificació d’identitat (OCR), indexats pel codi de país ISO 3166-1 alpha-3. Si ometes la clau, ometes un país o ometes un mètode dins d’un país, aquest país només admetrà la captura del document.
Tots dos països anteriors estan available per a la consulta al catàleg publicat. L’exemple deixa les carteres desactivades perquè no depengui de tenir una cartera activada al teu entorn. Un flux de treball que activi una cartera marcada com a Properament és rebutjat, inclosa la resta de la configuració d’aquella operació de desat. Un cop el catàleg marca una cartera com a available en un país, el bloc de cartera per a aquest país té aquest aspecte:
Comprova el catàleg abans d’enviar-lo. Requisit previ: la cartera figura com a disponible per a aquest país, llistada a Carteres d’identitat digital. Dues regles que l’API aplica en desar:
  • La disponibilitat la determina el servidor. Un mètode o una cartera que el catàleg de capacitats no marqui com a available per a aquest país és rebutjat. Consulta primer el catàleg —mitjançant la pestanya Països de la consola o amb l’eina de MCP didit_workflow_get_id_verification_methods_catalog.
  • Les carteres formen una llista d’acceptació, mai una classificació. providers indica quines carteres pot oferir un país. L’ordre que enviïs no té cap rellevància i s’elimina en la normalització; qui tria és l’usuari final.
La referència completa camp per camp, inclosos els valors per defecte i la validació, es troba a Configuracions de funcionalitats del flux de treball.

​
Fallback: què passa quan un mètode sense document no arriba a bon port

Quatre commutadors decideixen què passa a continuació. Cadascun és fallback_to_document (enviar l’usuari a la captura de documents) o decline (finalitzar la sessió amb una Verificació d’identitat rebutjada); wallet.on_failure també admet retry, que es descriu més avall. Tots quatre tenen com a valor predeterminat fallback_to_document. wallet.on_failure també admet un tercer valor, retry, per a un país que només accepta la cartera (captura de documents desactivada): retry és només per a carteres: els commutadors de consulta admeten fallback_to_document o decline, perquè un registre que ha respost “sense coincidència” no té res a reintentar. Es rebutja juntament amb document.fallback_only, que necessita una fallada que desemboqui en la captura de documents. Una cartera que ha iniciat sessió i ha retornat dades que no superen les comprovacions del teu flux de treball (edat, coincidència de nom, etc.) és un inici de sessió verificat: les regles del flux de treball decideixen, wallet.on_failure no s’aplica. Un inici de sessió el token del qual és autèntic però inacceptable (nivell de garantia incorrecte, signatura incorrecta, absència de declaracions obligatòries) compta com una fallada i segueix wallet.on_failure. id_lookup.max_attempts (d’1 a 5, per defecte 1) indica quantes consultes amb resposta pot fer l’usuari abans que s’activi el commutador. Un número que no supera la comprovació de format del costat del client mai arriba al registre, de manera que no consumeix cap intent; simplement es demana a l’usuari que el corregeixi. Una cartera o una cerca només pot recórrer a la captura de documents quan la captura de documents està habilitada per a aquest país i s’hi accepta almenys un tipus de document. Amb la captura de documents desactivada, o sense cap tipus de document acceptat per al país, es rebutja la sessió si l’inici de sessió falla o si la cerca no coincideix, fins i tot si el commutador indica fallback_to_document. L’excepció és wallet.on_failure: retry, que mai rebutja: l’usuari roman al pas de la cartera. No hi ha cap lloc on recórrer com a alternativa. Quin mètode ha produït el resultat: fallback_from verification_method sempre indica el mètode que ha produït el resultat verificat: wallet, id_lookup o document. fallback_from explica per què un mètode sense document no ha finalitzat el pas d’identificació, en tots dos resultats:
  • Alternativa adoptada. S’envia l’usuari a la captura de documents. La verificació de documents posterior té verification_method: "document" i fallback_from especificant el mètode que ha fallat, per exemple { "method": "wallet", "reason": "cancelled", "action": "fallback_to_document" }. Una sessió que ha estat verificada per la cartera té verification_method: "wallet" i fallback_from: null.
  • Rebuig. El commutador és decline, o no hi ha cap document alternatiu al qual recórrer. La Verificació d’identitat rebutjada té fallback_from amb "action": "decline".
method és wallet o id_lookup, i reason és el resultat que l’ha finalitzat (cancelled, timeout, no_match, provider_error, etc.). Els mateixos camps s’inclouen en la decisió de la sessió i al webhook status.updated. Un registre que no respon (un temps d’espera esgotat o una caiguda del servei) és l’excepció: mai rebutja l’usuari per si sol. La cerca no es factura i no es gasta cap intent; es demana a l’usuari que ho torni a provar. Després de tres cerques sense resposta en aquest pas, s’aplica id_lookup.on_provider_error: decline rebutja, i fallback_to_document envia l’usuari a la captura de documents. Quan aquest commutador és fallback_to_document però el país no té cap document alternatiu al qual recórrer, la cerca roman oberta i l’usuari pot continuar provant-ho; la sessió no es rebutja.

​
Oferir la captura de documents només com a alternativa

Per defecte, un país que ofereix una cartera o una cerca d’identitat juntament amb la captura de documents els mostra un al costat de l’altre a la primera pantalla. Defineix document.fallback_only com a true per mantenir la captura de documents habilitada per al país sense oferir-la des del principi. Els usuaris comencen amb la cartera o la cerca d’identitat del país. Amb una única cartera, l’usuari accedeix directament a aquesta cartera. Només els usuaris l’inici de sessió amb cartera dels quals falli, es cancel·li o esgoti el temps d’espera, o la cerca dels quals no coincideixi, són redirigits a la captura de documents. Quins d’aquests resultats condueixen a la captura de documents encara ho decideixen els commutadors anteriors, de manera que almenys un d’ells ha de ser fallback_to_document.
fallback_only és opcional i per defecte és false. Es rebutja tret que document.enabled sigui true i almenys una cartera o cerca d’identitat en aquest país tingui com a alternativa la captura de documents. Habilita els tipus de document que l’alternativa hauria d’oferir a documents_allowed, per exemple el passaport i el document d’identitat per a Finlàndia.

​
Què costa cada mètode

Aquests són preus de catàleg: el teu descompte de pla s’aplica a tots dos mètodes. Una consulta utilitza les tarifes públiques minoristes de Validació en bases de dades per als serveis que executa; diversos serveis poden contribuir a un intent. Nigèria selecciona o bé NIN o bé BVN. La taula de països mostra el preu complet de l’intent configurat, i cada reintent que rep resposta es factura per separat.

​
Regles de facturació

  • La consulta es factura quan el registre respon. Coincidència, coincidència parcial o sense coincidència compten: la consulta s’ha executat i la resposta és el producte.
  • Un registre que mai no ha respost no es factura. Un error del proveïdor no costa res.
  • Un número que no supera la comprovació de format del costat del client mai no es factura ni es computa contra max_attempts, perquè mai no ha arribat al registre.
  • La captura de documents es factura a part quan l’usuari passa al mètode alternatiu. Una consulta que ha obtingut resposta i després ha passat a document suposa dos càrrecs, perquè s’han executat dues comprovacions.

​
Cobertura

La captura de documents està disponible a tots els països que Didit admet i no es repeteix a continuació: $0.15 per comprovació. Aquesta taula només inclou els països on existeix un mètode sense document. Un país que no hi aparegui, o una cel·la on s’indiqui No planificat, només admet captura de documents.
La cobertura es genera a partir del catàleg de capacitats que ofereix el backend, de manera que aquesta taula és la mateixa font amb què validen la consola i l’API. Properament significa que l’entrada és visible a la consola i que encara no es pot activar; no és una capacitat activa i no té cap data compromesa.

​
Què arriba a la sessió

Cada resultat de Verificació d’identitat conté el mètode que l’ha generat, el seu nivell de garantia i, quan s’ha executat un mètode no documental, un bloc d’evidències específic del mètode. Les sessions documentals es mostren exactament com abans, amb les claus noves com a null. Els tipus de cada camp i els exemples per a tots tres mètodes es troben al model de dades de verificació d’identitat, i les mateixes claus arriben al webhook status.updated.

​
Relacionat

Darrera modificació el 7 de novembre del 2026