Saltar al contenido principal
Smart-ID y Mobile-ID permiten a los usuarios verificar su identidad aprobando una solicitud en su teléfono. Usa la API de Smart-ID o la API de Mobile-ID para iniciar la verificación desde tu propia aplicación sin un workflow. Ambos métodos también funcionan dentro del paso de workflow ID Verification de Didit y devuelven un resultado de verificación de wallet con nivel de garantía cryptographic. Para la integración con el flujo alojado que se describe a continuación, usa la misma creación de sesiones e integración de webhooks que en tus otros flujos de Didit.
Smart-ID y Mobile-ID están disponibles. Smart-ID es compatible con Estonia, Letonia, Lituania y Bélgica. Mobile-ID es compatible con Estonia y Lituania. Selecciona en la consola las wallets que acepta tu flujo para cada país. Consulta cobertura y precios de wallets para ver la lista completa.

​
Países y requisitos previos

La integración cubre Smart-ID en Estonia (EST), Letonia (LVA), Lituania (LTU) y Bélgica (BEL). Mobile-ID cubre Estonia (EST) y Lituania (LTU); Mobile-ID no se ofrece para Letonia. Estos códigos de país describen las rutas integradas, no implican que todas las rutas estén activadas en tu entorno. Para Smart-ID, el usuario necesita una identidad Smart-ID activa que cumpla los requisitos, su código de identificación personal y acceso a la aplicación. Para Mobile-ID, el usuario necesita una identidad Mobile-ID activa, su código de identificación personal y el número de teléfono asociado. Introduce el número de teléfono de Mobile-ID en formato internacional: +372 para Estonia o +370 para Lituania. El país seleccionado debe coincidir con la identidad que se utiliza. Ninguno de los dos métodos devuelve un retrato. Si tu flujo requiere una selfie, mantén configurados por separado los pasos de Prueba de vida y Coincidencia facial correspondientes.

​
Lo que ve el usuario

  1. El usuario selecciona su país y elige Smart-ID o Mobile-ID entre las wallets que acepta tu flujo.
  2. La sesión de verificación solicita el código de identificación personal; Mobile-ID también solicita el número de teléfono asociado.
  3. La página muestra un código de comparación mientras la solicitud de autenticación llega al teléfono.
  4. El usuario comprueba que el código del teléfono coincide con el de la página de verificación y luego aprueba con su PIN en el teléfono.
  5. Didit valida el resultado de identidad firmado y continúa con el flujo de verificación.
El formulario de identidad y la pantalla del código de comparación usan el mismo diseño que los demás métodos de verificación. Cuando la personalización de marca blanca está activada, heredan los colores, la tipografía, el estilo de los botones y el logotipo del cliente de la sesión, y permanecen en el dominio de la sesión. Al recargar la página se restaura el código de comparación activo sin iniciar otra solicitud de aprobación. El usuario nunca introduce el PIN de su wallet en la página de verificación. Si los códigos no coinciden o el usuario no inició la solicitud, debe cancelarla. El flujo con código de comparación funciona en un navegador de escritorio o móvil y no requiere un código QR. La página espera el resultado automáticamente y ofrece una opción de cancelación. Una aprobación en el teléfono debe superar igualmente las comprobaciones de identidad y de firma antes de que Didit considere exitosa la verificación de wallet.

​
Configura el flujo

En la consola, abre el nodo ID Verification de tu flujo, elige Countries y abre el país que quieras configurar. En Wallets accepted, selecciona las wallets disponibles y elige el comportamiento ante fallos. Guarda y publica el flujo antes de crear una nueva sesión. Consulta métodos de verificación de identidad en la consola para ver la ruta completa en la consola.
Lo siguiente es un fragmento de configuración de methods, no una solicitud de flujo completa. Úsalo solo cuando tanto smart_id como mobile_id estén marcados como available para Estonia en tu entorno. Una wallet no disponible hace que se rechace el guardado de todo el flujo.
El array providers es una lista de permitidos: los usuarios eligen entre sus wallets, y el orden del array no establece una wallet preferida. Para Lituania, usa LTU con los mismos identificadores de wallet cuando ambas estén disponibles. Para Letonia o Bélgica, usa LVA o BEL solo con smart_id, sujeto a la misma comprobación de disponibilidad. Los países omitidos conservan su comportamiento predeterminado de captura de documentos. El contrato de configuración completo está en Configuración de funciones del flujo.

​
Lee el resultado verificado

Lee la sesión completada mediante la API de decisión de sesión o tu integración de webhooks. Una comprobación de wallet exitosa registra verification_method: "wallet", assurance: "cryptographic" y wallet_provider: "smart_id" o "mobile_id". El objeto wallet_verification identifica la wallet, el país emisor, la hora de verificación, el nivel de garantía y el veredicto de la firma. El resultado de la verificación de identidad expone los campos normalizados full_name y date_of_birth. Para estas dos wallets, wallet_verification.attributes contiene given_name, family_name, birthdate y personal_code de la identidad validada. El país emisor identifica la ruta de identidad; no establece la nacionalidad de la persona. Didit devuelve el veredicto de la firma, no la aserción firmada subyacente. No se devuelve ningún retrato ni el PIN de la wallet. En la consola, la tarjeta Credential de la sesión muestra la wallet y su evidencia verificada. Una comprobación de wallet exitosa completa el paso de verificación de identidad; las comprobaciones posteriores de tu flujo siguen determinando la decisión final de la sesión. Consulta el modelo de datos de verificación de identidad para ver los tipos de campo y la diferencia entre el resultado de una comprobación y la decisión general de la sesión.

​
Gestionar la cancelación y los fallos

Si un usuario cancela, se agota el tiempo o no puede completar la autenticación, Didit aplica la configuración wallet.on_failure del país. fallback_to_document inicia la captura de documentos cuando está habilitada para ese país. decline rechaza el paso de Verificación de identidad. Si la captura de documentos está deshabilitada, no hay alternativa mediante documento disponible. Solo una comprobación de wallet completada y verificada genera el cargo de verificación de wallet. Los intentos de wallet cancelados, expirados o fallidos no lo generan. Una alternativa mediante documento completada es una comprobación independiente sujeta a los precios de verificación de documentos. Consulta la tabla de precios de wallets para ver las tarifas publicadas; un método sin tarifa publicada no debe considerarse gratuito.

​
Pruebas antes de pasar a producción

Prueba cada wallet y cada país que planees ofrecer en el entorno donde esté habilitado. Confirma que aparecen las wallets correctas, que el código de comparación es visible, que la aprobación continúa el flujo y que el resultado de la sesión contiene la evidencia de wallet esperada. Comprueba también la cancelación, la expiración y el comportamiento alternativo que hayas elegido. Las simulaciones en sandbox y las pruebas en staging son distintas de la autenticación en producción. Una aprobación simulada es útil para comprobar tu integración, pero no demuestra que una identidad real pueda autenticarse en producción. Antes del despliegue, confirma la disponibilidad en producción en la consola y completa una verificación autorizada con un dispositivo real para la ruta que pretendes usar.

​
Otras wallets de identidad digital

El catálogo de wallets de identidad digital de Didit incluye la disponibilidad en producción y las próximas wallets, entre ellas la Finnish Trust Network, ya disponible, y las próximas integraciones de BankID y EUDI Wallet. Que una wallet figure en la lista, tenga un precio publicado o se haya completado un formulario de onboarding no habilita por sí solo la autenticación en producción. Usa el catálogo y la consola de tu entorno para determinar qué puedes activar hoy. Consulta también Finnish Trust Network para Finlandia.
Última modificación el 1 de noviembre de 2026