Cuando un partner evalúa nuestra arquitectura, la pregunta no es qué hace el módulo de identidad, sino cómo encaja en un pipeline existente. Esta sección responde eso: qué expone el framework, qué espera del lado del integrador y dónde están los límites operativos.
El endpoint principal acepta una imagen capturada y devuelve una decisión de coincidencia en menos de 300 ms bajo carga normal. El contrato es JSON sobre HTTPS, con un esquema fijo de campos de error que permite mapear fallos a códigos propios sin ambigüedad. No hay reintentos automáticos: el integrador decide la política de reintento según su tolerancia a latencia.
El SDK de cliente no solo toma la foto: valida la calidad de la imagen antes de enviarla, detecta ojos cerrados, reflejos y ángulos extremos. Eso reduce el ruido en la cola de verificación y baja la tasa de falsos rechazos. Está disponible para Android, iOS y navegadores web, con el mismo comportamiento de validación en las tres plataformas.
El framework guarda cada intento de verificación como un evento inmutable: timestamp, hash de la imagen, resultado, umbral usado y versión del modelo. Ese registro no se reescribe ni se borra por API; solo se consulta. Para partners que operan bajo regulación, esto simplifica la trazabilidad sin requerir una base de datos separada.
Antes de conectar el entorno productivo, el framework ofrece un sandbox con rostros sintéticos y escenarios de error predefinidos. Sirve para validar la integración sin depender de un proveedor de imágenes reales. El sandbox replica los mismos códigos de respuesta que producción, así que el código de integración no cambia al migrar.
Si tu equipo necesita revisar el contrato técnico antes de firmar, la documentación de referencia está disponible en la sección de casos de uso. Para una revisión de arquitectura conjunta, el equipo de integración responde por el canal de contacto habitual.
Lo que un socio técnico gana al integrar nuestros módulos de identificación no es solo un endpoint más. Es la diferencia entre mantener una cola de verificación manual y cerrar el ciclo de registro en segundos.
Esto es lo que cambia cuando conectas tu backend a nuestra API o SDK, sin importar si trabajas con PostgreSQL, MongoDB o un esquema de eventos distribuidos.
El flujo de verificación pasa de minutos a menos de dos segundos por solicitud. Tus tablas de usuarios dejan de acumular registros pendientes de aprobación manual.
El manejo de biometría, hash y comparación de plantillas queda del lado del SDK. Tu equipo no necesita escribir ni auditar esa capa crítica.
La respuesta de la API incluye un identificador de verificación estable. Puedes usarlo como clave foránea directa en tu modelo de identidad sin tablas auxiliares frágiles.
El sandbox devuelve estados deterministas para cada tipo de documento. Escribir tests de aceptación deja de depender de datos reales o de adivinar respuestas.
¿Necesitas ver el flujo completo antes de decidir? Revisa los casos de uso por industria o vuelve a la documentación principal.