Guía para Desarrolladores: Flujos de Reserva Dinámicos para APIs de Verificación de Identidad (ES)

Manejo Proactivo de ErroresImplemente mecanismos robustos de manejo de errores y reintentos dentro de sus integraciones de API IDV para evitar que las fallas de verificación afecten la experiencia del usuario.

Verificación MulticapaDiseñe flujos de trabajo que incorporen múltiples métodos de verificación, permitiendo transiciones fluidas a comprobaciones alternativas si un método principal falla o produce resultados no concluyentes.

Experiencia de Usuario OptimizadaUtilice reservas dinámicas para guiar a los usuarios a través de rutas de verificación alternativas, minimizando la fricción y asegurando una incorporación o finalización de transacciones exitosa.

Flujos de Trabajo Orquestados de DiditAproveche la plataforma modular y nativa de IA de Didit para construir y gestionar flujos de trabajo de reserva dinámicos y complejos con un creador visual sin código o APIs limpias, asegurando máxima flexibilidad y fiabilidad.

La Importancia de los Flujos de Trabajo de Reserva Dinámicos en IDV

En el mundo de la verificación de identidad en línea, depender de una sola llamada a la API para confirmar la identidad de un usuario es una receta para el posible fracaso y una mala experiencia de usuario. Factores como la mala calidad de la imagen del documento, la latencia de la red, los límites de tasa de la API o incluso las interrupciones temporales del servicio pueden interrumpir el proceso de verificación. Aquí es donde los flujos de trabajo de reserva dinámicos se vuelven indispensables. Una estrategia de reserva bien diseñada asegura que si un método de verificación primario falla, el sistema pueda pivotar inteligentemente a una alternativa, manteniendo un viaje de usuario fluido y manteniendo altas tasas de éxito de verificación. Esto no solo mejora la satisfacción del cliente, sino que también impacta directamente en las tasas de conversión y la eficiencia operativa.

Para los desarrolladores, construir sistemas resilientes significa anticipar fallas y tener un plan B, C e incluso D. Los flujos de verificación estáticos y rígidos a menudo llevan a que los usuarios abandonen el proceso al encontrar un error. Las reservas dinámicas, por otro lado, proporcionan flexibilidad, permitiendo a las empresas adaptarse a las condiciones en tiempo real y a la entrada del usuario. Esto es particularmente crítico para aplicaciones que involucran procesos sensibles como la incorporación de clientes, la verificación de edad para contenido regulado o transacciones de alto valor donde una sólida garantía de identidad es primordial.

Diseño de Lógica de Reserva Efectiva

La implementación de flujos de trabajo de reserva dinámicos requiere una planificación cuidadosa y una comprensión profunda de sus necesidades de verificación. La idea central es definir una secuencia de pasos de verificación y una lógica condicional que dicte el flujo en función del resultado de cada paso. Así es como se aborda:

1. Identifique Puntos de Falla Potenciales

Antes de diseñar reservas, necesita saber qué puede salir mal. Los puntos de falla comunes en IDV incluyen:

• Problemas de Escaneo de Documentos: Imágenes borrosas, reflejos, tipo de documento incorrecto o documentos caducados pueden provocar fallas en la Verificación de ID (OCR, MRZ, códigos de barras).
• Fallas en la Detección de Vida: Usuarios que fallan las comprobaciones de vida debido a poca iluminación, deepfakes o incumplimiento de las instrucciones.
• Desajustes de Coincidencia Facial: Discrepancias entre la foto del documento y la selfie en vivo.
• Desajustes de Datos: Información extraída de un documento que no coincide con los registros de la base de datos o los datos proporcionados por el usuario.
• Alertas de Detección de AML: Un usuario que aparece en una lista de vigilancia que requiere una revisión manual adicional.
• Interrupciones del Servicio de API: Indisponibilidad temporal o errores de un proveedor de verificación de identidad.

2. Defina Lógica Condicional y Rutas Alternativas

Una vez identificados los puntos de falla, mapee las rutas alternativas. Por ejemplo:

• Si una Verificación de ID inicial (OCR) falla debido a la mala calidad de la imagen, solicite al usuario que vuelva a tomar la foto o cambie a un tipo de documento diferente.
• Si la detección de vida Pasiva y Activa indica un alto riesgo de fraude, active una revisión manual o solicite pruebas adicionales como un Comprobante de Domicilio.
• Si una Coincidencia Facial 1:1 falla, quizás ofrezca una alternativa como Verificación de Teléfono y Correo Electrónico combinada con preguntas específicas de autenticación basadas en el conocimiento.
• Para escenarios de verificación de edad, si la Estimación de Edad no es concluyente, solicite un escaneo de identificación física.
• Si una comprobación de Detección y Monitoreo de AML devuelve una coincidencia potencial, dirija automáticamente al usuario a un oficial de cumplimiento para una investigación adicional sin interrumpir el flujo del usuario.

Los Flujos de Trabajo Orquestados de Didit, accesibles a través de su Consola de Negocios sin código, están diseñados precisamente para esto, permitiéndole construir visualmente árboles de decisión complejos y pasos condicionales sin escribir una sola línea de código. Este enfoque modular significa que puede mezclar y combinar comprobaciones de identidad y definir fácilmente umbrales de éxito o fracaso.

3. Priorice la Experiencia del Usuario

Las reservas no deben sentirse como un castigo. El objetivo es mantener al usuario comprometido y reducir la fricción. Proporcione instrucciones claras y concisas cuando se active una reserva. Por ejemplo, en lugar de un error genérico, dígale al usuario: "La foto de su documento estaba borrosa. Por favor, inténtelo de nuevo en un área bien iluminada." o "No pudimos confirmar su identidad con este método. ¿Le gustaría intentar verificar con un documento diferente o contactar a soporte?" Minimizar el número de pasos y asegurar una interfaz de usuario/experiencia de usuario consistente en todas las rutas de verificación es crucial.

Estrategias de Implementación Técnica

Desde un punto de vista técnico, la implementación de flujos de trabajo de reserva dinámicos implica varias consideraciones clave:

1. Orquestación de API y Gestión de Estado

Su sistema backend necesita orquestar llamadas a varias APIs IDV y gestionar el estado del proceso de verificación. Esto incluye el seguimiento de qué pasos se han completado, cuáles han fallado y qué rutas de reserva se han iniciado. El enfoque de Didit primero con la API y el uso de 'sesiones' simplifican esto. Cuando crea una sesión con un ID de flujo de trabajo específico, Didit maneja toda la experiencia del usuario, la gestión del estado y los pasos condicionales. Solo necesita consultar el estado de la sesión para conocer el resultado.

GET /v3/workflows/
    - uuid: a1b2c3d4-5678-90ab-cdef-111111111111
      workflow_label: KYC Estándar
      workflow_type: kyc
      features:
        - OCR
        - LIVENESS
        - FACE_MATCH
    - uuid: b2c3d4e5-6789-01bc-defg-222222222222
      workflow_label: Verificación Completa + AML
      workflow_type: kyc
      features:
        - OCR
        - LIVENESS
        - FACE_MATCH
        - AML

Este ejemplo de API muestra cómo se pueden definir y acceder a diferentes flujos de trabajo, cada uno con características distintas como OCR, Detección de Vida, Coincidencia Facial y AML. Luego puede seleccionar dinámicamente el flujo de trabajo apropiado en función de los resultados de verificación iniciales o la demografía del usuario.

2. Cliente API Robusto y Manejo de Errores

Su cliente API debe estar construido para manejar varios códigos de estado HTTP y respuestas de error de manera elegante. Implemente mecanismos de reintento con retroceso exponencial para errores transitorios. Diferencie entre errores transitorios (por ejemplo, problemas de red) y errores permanentes (por ejemplo, entrada inválida) para evitar reintentos innecesarios. Registre todas las interacciones de la API y las respuestas de error a fondo para fines de depuración y auditoría.

3. Comprobaciones de Identidad Modulares y Componibles

Adopte una arquitectura modular donde cada comprobación de identidad (Verificación de ID, Detección de Vida, Coincidencia Facial, Detección de AML, Comprobante de Domicilio, Estimación de Edad, Verificación de Teléfono y Correo Electrónico) sea un componente distinto y "plug-and-play". Esto le permite intercambiar o agregar fácilmente nuevos métodos de verificación sin reestructurar todo su sistema. La plataforma de Didit se basa en este principio, ofreciendo primitivas de identidad componibles a través de APIs limpias, lo que facilita la creación de flujos de trabajo personalizados.

Cómo Ayuda Didit

Didit está diseñado desde cero para empoderar a los desarrolladores con las herramientas para construir flujos de trabajo de verificación de identidad sofisticados y dinámicos. Nuestra plataforma nativa de IA, orientada al desarrollador, proporciona una capa de identidad abierta y modular que simplifica la implementación de reservas y viajes de verificación complejos.

• Flujos de Trabajo Orquestados: El creador visual sin código de Didit en la Consola de Negocios le permite diseñar flujos de verificación de identidad de varios pasos, incluyendo nodos de lógica condicional para KYC, comprobaciones de edad y detección de AML. Usted define la lógica una vez, y Didit maneja la experiencia del usuario, la gestión del estado y los pasos condicionales. Esto significa que puede configurar fácilmente métodos primarios y de reserva, como comenzar con la Verificación de ID (OCR) y la Detección de Vida, y si no se cumple un umbral, activar automáticamente una solicitud de Comprobante de Domicilio o una revisión manual.
• Suite de Productos Integral: Con Didit, tiene acceso a un espectro completo de herramientas de verificación, incluyendo Verificación de ID (OCR, MRZ, códigos de barras), Detección de Vida Pasiva y Activa, Coincidencia Facial 1:1 y Búsqueda Facial, Detección y Monitoreo de AML, Comprobante de Domicilio, Estimación de Edad (preservando la privacidad), Verificación de Teléfono y Correo Electrónico, y Verificación NFC (ePassport/eID). Este extenso conjunto de herramientas le permite construir prácticamente cualquier escenario de reserva imaginable.
• Enfoque Primero en el Desarrollador: Didit ofrece un sandbox instantáneo, documentación pública y APIs limpias, lo que hace que la integración sea perfecta. Puede listar, crear, actualizar y eliminar flujos de trabajo programáticamente, dándole control total sobre su lógica de verificación.
• KYC Básico Gratuito: Didit ofrece KYC Básico Gratuito, lo que permite a las empresas comenzar y construir flujos de trabajo robustos sin costos iniciales. Nuestro modelo de pago por verificación exitosa y sin tarifas de configuración significa que solo paga cuando la verificación es exitosa, alineando los costos con el valor.
• Automatización Nativa de IA: Al aprovechar la IA, Didit automatiza gran parte del proceso de toma de decisiones dentro de los flujos de trabajo, reduciendo la necesidad de revisión manual y acelerando los tiempos de verificación, incluso cuando se activan las reservas.

¿Listo para Empezar?

¿Listo para ver Didit en acción? Obtenga una demostración gratuita hoy mismo.

Comience a verificar identidades de forma gratuita con el nivel gratuito de Didit.