Saltar al contenido principal
La Verificación de identidad es una sola función con tres métodos. Tú eliges qué métodos puede usar cada país; el usuario final recibe los que correspondan al país que elija, y la sesión registra qué método produjo realmente el resultado. La captura del documento no cambia. Todo lo que ya configuras mediante documents_allowed (tipos aceptados, subtipos, reglas de captura, umbrales, advertencias) sigue funcionando exactamente igual que antes, y un flujo de verificación (workflow) que no indique nada sobre los métodos sigue usando solo la captura del documento.

​
Cómo funciona cada método

​
Captura del documento

El resto de esta sección documenta lo siguiente: el usuario fotografía el documento, Didit lo lee, comprueba su autenticidad y devuelve los campos extraídos. Está disponible en todos los países que admite Didit, a $0.15 por comprobación. Empieza por la descripción general de la Verificación de identidad.

​
Consulta sin documento

El usuario escribe su número de identificación nacional y algunos datos personales, y Didit los coteja con la fuente autorizada de ese país. No interviene ninguna fotografía de un documento. En la mayoría de los países esa fuente es un registro gubernamental, pero no en todos: en Canadá, Francia, Indonesia, los Países Bajos, Noruega, Singapur, el Reino Unido y Estados Unidos es, en su lugar, un archivo de una agencia de crédito, de servicios financieros, de servicios públicos o de registros residenciales. Como la procedencia y el régimen de consentimiento aplicable varían según la fuente, la fuente exacta se indica por país en la tabla siguiente y en Consulta sin documento, sin generalizar nunca. Cuando la fuente devuelve un retrato (hoy en Sudáfrica, Nigeria, Argentina y Panamá, los cuatro registros gubernamentales), también se pide al usuario una selfie. Se realiza una prueba de vida pasiva con esa selfie y se compara el rostro con el retrato del registro, todo dentro de la consulta y todo incluido en el precio de la consulta. Cuando la fuente solo devuelve datos, no hay nada con qué comparar el rostro, así que no se toma ninguna selfie; ejecuta la Prueba de vida y la Coincidencia facial como pasos propios del flujo si las necesitas. Los campos de solicitud, las reglas de formato y los regímenes de consentimiento completos por país están en Consulta sin documento.

​
Wallet

El usuario inicia sesión con una identidad digital que ya tiene, como una eID nacional o una identidad bancaria. La wallet lo autentica y luego comparte con Didit atributos de identidad firmados. Según la wallet, el usuario puede tener que introducir un código de identificación personal o un número de teléfono; la comprobación por wallet no requiere ninguna fotografía de un documento. La experiencia de inicio de sesión depende de la wallet: una redirección a una app, un código QR o un código de comparación que se confirma en el teléfono del usuario. Smart-ID y Mobile-ID usan un código de comparación. Los atributos de cada wallet, su disponibilidad en producción y el comportamiento en caso de error están en Wallets de identidad digital.

​
Niveles de garantía

Cada resultado de la Verificación de identidad lleva un nivel de garantía derivado del método que lo produjo. El nivel es una descripción honesta de lo que realmente se demostró, no una clasificación:
Los niveles de garantía son etiquetas para administradores. Aparecen en el payload de la sesión, en la consola y en las exportaciones. Los usuarios finales nunca ven el nivel, el precio ni el nombre de la fuente consultada.

​
Configuración de métodos por país

Los métodos se definen bajo la clave methods en la configuración de la función de Verificación de identidad (OCR), identificados por el código de país ISO 3166-1 alfa-3. Si omites la clave, un país o un método dentro de un país, ese país usa solo la captura del documento.
Los dos países anteriores están marcados como available para consulta en el catálogo publicado. El ejemplo deja las wallets desactivadas para no depender de que haya una wallet habilitada en tu entorno. Un flujo que habilite una wallet marcada como Próximamente se rechaza, incluida cualquier otra configuración de esa operación de guardado. Cuando el catálogo marca una wallet como available en un país, el bloque de wallets de ese país tiene este aspecto:
Consulta el catálogo antes de enviarlo. Requisito previo: la wallet figura como disponible para ese país en Wallets de identidad digital. Dos reglas que la API aplica al guardar:
  • La disponibilidad la determina el servidor. Se rechaza cualquier método o wallet que el catálogo de capacidades no marque como available para ese país. Consulta primero el catálogo, en la pestaña Países de la consola o con la herramienta MCP didit_workflow_get_id_verification_methods_catalog.
  • Las wallets son una lista de permitidos, nunca una clasificación. providers indica qué wallets puede ofrecer un país. El orden en que las envías no tiene significado y se normaliza; el usuario final elige.
La referencia completa campo por campo, con los valores predeterminados y la validación, está en Configuraciones de funciones del flujo.

​
Respaldo: qué ocurre cuando un método sin documento no se completa

Cuatro interruptores deciden qué ocurre después. Cada uno vale fallback_to_document (envía al usuario a la captura de documento) o decline (termina la sesión con una Verificación de identidad rechazada). Los cuatro tienen fallback_to_document como valor predeterminado. id_lookup.max_attempts (de 1 a 5, 1 por defecto) es el número de consultas respondidas que tiene el usuario antes de que se active el interruptor. Un número que no supera la comprobación de formato en el cliente nunca llega al registro, así que no consume un intento: simplemente se le pide al usuario que lo corrija. Una wallet o una consulta solo puede recurrir a la captura de documento cuando la captura de documento está habilitada para ese país y se acepta al menos un tipo de documento en él. Con la captura de documento desactivada, o sin ningún tipo de documento aceptado para el país, un inicio de sesión fallido o una consulta sin coincidencia rechaza la sesión, aunque el interruptor indique fallback_to_document. No hay ninguna alternativa a la que recurrir. Un rechazo registra fallback_from en la Verificación de identidad rechazada, con el método que falló y el motivo. La implementación actual en staging también traslada esa evidencia a la verificación de documento creada tras recurrir al respaldo. Confirma el despliegue en producción antes de depender de esa evidencia adicional. Un registro que no responde (por agotarse el tiempo de espera o una caída) es la excepción: nunca rechaza al usuario por sí solo. La consulta no se factura y no se gasta ningún intento; se le pide al usuario que vuelva a intentarlo. Tras tres consultas sin respuesta en el paso, se aplica id_lookup.on_provider_error: decline rechaza, y fallback_to_document envía al usuario a la captura de documento. Cuando ese interruptor es fallback_to_document pero el país no tiene ningún documento al que recurrir, la consulta sigue abierta y el usuario puede seguir intentándolo; la sesión no se rechaza.

​
Ofrecer la captura de documento solo como respaldo

De forma predeterminada, un país que ofrece una wallet o una consulta de ID junto con la captura de documento muestra ambas opciones una junto a la otra en la primera pantalla. Establece document.fallback_only en true para mantener la captura de documento habilitada en el país sin ofrecerla de entrada. Los usuarios empiezan con la wallet o la consulta de ID del país. Con una sola wallet, el usuario llega directamente a esa wallet. Solo los usuarios cuyo inicio de sesión con la wallet falla, se cancela o expira por tiempo, o cuya consulta no coincide, pasan a la captura de documento. Cuáles de esos resultados llevan a la captura de documento lo siguen decidiendo los interruptores anteriores, así que al menos uno de ellos debe ser fallback_to_document.
fallback_only es opcional y su valor predeterminado es false. Se rechaza salvo que document.enabled sea true y al menos una wallet o consulta de ID de ese país recurra a la captura de documento. Habilita en documents_allowed los tipos de documento que debe ofrecer el respaldo, por ejemplo pasaporte y documento de identidad para Finlandia.

​
Cuánto cuesta cada método

Son precios de lista: el descuento de tu plan se aplica a ambos métodos. Una consulta usa las tarifas públicas de venta de Validación de base de datos para los servicios que ejecuta; varios servicios pueden contribuir a un mismo intento. Nigeria selecciona NIN o BVN. La tabla de países muestra el precio completo configurado por intento, y cada reintento respondido se factura por separado.

​
Reglas de facturación

  • Un registro que respondió factura la consulta. La coincidencia, la coincidencia parcial y la ausencia de coincidencia cuentan: la consulta se ejecutó y la respuesta es el producto.
  • Un registro que nunca respondió no se factura. Un error del proveedor no cuesta nada.
  • Un número que no supera la comprobación de formato en el cliente nunca se factura y nunca cuenta para max_attempts, porque nunca llegó al registro.
  • La captura de documento se factura adicionalmente cuando el usuario recurre a un documento. Si una consulta recibe respuesta y luego el usuario recurre a un documento, se aplican dos cargos, porque se ejecutaron dos comprobaciones.

​
Cobertura

La captura de documentos está disponible en todos los países que admite Didit y no se repite a continuación: $0.15 por comprobación. Esta tabla solo incluye los países en los que existe un método sin documento. Si un país no aparece en la lista, o una celda indica No previsto, solo admite captura de documentos.
La cobertura se genera a partir del catálogo de capacidades que sirve el backend, por lo que esta tabla procede de la misma fuente con la que validan la consola y la API. Próximamente significa que la entrada es visible en la consola pero todavía no se puede activar; no es una capacidad disponible y no tiene una fecha confirmada.

​
Qué se registra en la sesión

Cada resultado de verificación de identidad incluye el método que lo generó, su nivel de garantía y, cuando se ejecutó un método no documental, un bloque de evidencias específico del método. Las sesiones con documento se muestran exactamente igual que antes, con las nuevas claves en null. Los tipos y ejemplos campo por campo de los tres métodos están en el modelo de datos de verificación de identidad, y las mismas claves llegan en el webhook status.updated.

​
Relacionado

Última modificación el 1 de noviembre de 2026