Cómo agregar una nueva capacidad (API)
Esta guía es para clientes que ya se integraron vía API (POST /processes/v1) con Clasificación de Riesgo de Fraude (Trust Network) y que están agregando Verificación de Identidad a su contrato.
Agregar Verificación de Identidad
Esta guía explica la evolución del motor de decisión para fortalecer tus procesos de validación de identidad.
A diferencia de otras integraciones, habilitar esta capacidad requiere actualizar tu API key. Sin este cambio, no podrás recibir las nuevas respuestas de validación de identidad; tu contacto en Unico te las compartirá.
El gran cambio: Verificación de Identidad
La principal mejora es la capacidad de validar la identidad del titular (además de las respuestas de fraude). El sistema ahora verifica si la persona que realiza el proceso es de hecho el titular del documento proporcionado.
Es fundamental que tu equipo comprenda y mapee correctamente la nueva interpretación de las respuestas antes de que se active la capacidad, para no impactar tu operación.
Tabla comparativa de resultados
| Resultado (solo Trust) | Resultado (Trust + IDUnico) | Significado y acción recomendada |
|---|---|---|
| N/A | APPROVED | Nuevo (estado ideal). El usuario es el titular del documento y no hay evidencia de fraude. |
INCONCLUSIVE | INCONCLUSIVE | Cambio de matiz. El usuario es real y no hay evidencia de fraude, pero no hay certeza de que sea el titular del documento. |
REPROVED | REPROVED | Se recomienda rechazo. Indicios de fraude, o el sistema confirmó que el usuario no es el titular del documento. |
HIGH_RISK | HIGH_RISK | Al menos una evidencia fuerte de fraude. El cliente decide la acción. |
CRITICAL_RISK | CRITICAL_RISK | Al menos dos evidencias críticas de fraude. Se recomienda rechazo. |
Cambios clave en la nomenclatura
Asegúrate de que tu sistema esté listo para mapear estos tres cambios fundamentales en tu flujo de aprobación:
- La llegada de
APPROVED— este es ahora el estado "ideal". Si recibes este código, tienes total certeza de la identidad y seguridad del proceso. - El nuevo matiz de
INCONCLUSIVE— anteriormente tu principal luz verde. Ahora significa que la persona es "real" y no hay fraude evidente, pero el sistema no pudo vincularla con la identidad del documento con total certeza. - La severidad de
REPROVED— además de los indicadores de fraude multifactorial, este estado ahora también incluye los casos en que el usuario está suplantando al titular del documento.