> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API de huella de dispositivo y riesgo de IP para KYC

> Didit detecta dispositivos duplicados, redes de fraude, VPN, proxies, Tor y discrepancias de ubicación mediante huella de dispositivo durante el KYC.

El análisis de dispositivo e IP de Didit combina la huella de dispositivo, la recuperación de dispositivos duplicados, la inteligencia de IP y las comprobaciones de geolocalización dentro del flujo de verificación. Ayuda a detectar cuándo el mismo dispositivo físico intenta acceder a varias cuentas, incluso cuando el usuario cambia de sesión, borra el almacenamiento del navegador, abre una ventana de incógnito o rota la información de red.

Prompt de integración del análisis de dispositivo e IP
        Copy prompt to clipboard



      
      

\<pre>

\````# Goal
Integrate Didit Device & IP Analysis (device fingerprinting + IP intelligence + geolocation) into your app.

\# Delivery mode
IP Analysis is **session-only**. The Web/Mobile SDK collects the device fingerprint and IP during the hosted flow — there is no standalone /v3/ip-analysis/ endpoint. It runs automatically on every session and does not require a workflow feature toggle for the basic signal set.

\# Steps
1\. (Optional) In the Business Console enable strict-mode rules for IP / device — e.g. "decline on VPN", "review on duplicate device", "decline on country mismatch with document".
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user — the SDK collects fingerprint + IP in-band.
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

curl (create session):
\```bash
curl -X POST 'https://verification.didit.me/v3/session/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"workflow_id": "YOUR_WORKFLOW_ID",
"vendor_data": "user-123",
"callback": "https://yourapp.com/post-kyc"
}'
\```

\# Decision surface
The result lands under `ip_analyses[]` on the decision payload (one entry per IP/device collection point in the workflow). Each entry carries the resolved geo, ASN, VPN / proxy / Tor flags, device fingerprint id, duplicate-device matches, and the warnings array.

\# Status enum (per ip_analyses[].status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.LOCATION)
Heads-up: IP Analysis emits warnings under the **LOCATION** bucket (not "IP_ANALYSIS"). Risk codes include:
VPN_DETECTED, PROXY_DETECTED, TOR_DETECTED, DATACENTER_IP, HIGH_RISK_COUNTRY, LOCATION_MISMATCH_WITH_DOCUMENT, DUPLICATED_DEVICE, POSSIBLE_DUPLICATED_DEVICE, IMPOSSIBLE_TRAVEL, DEVICE_FINGERPRINT_BLOCKLISTED, DEVICE_LINKED_TO_LIVENESS_ATTACK, DEVICE_MODEL_INCONSISTENT.
Full catalogue: /core-technology/ip-analysis/warnings-ip-analysis.

\# Failure modes to handle
\- ip_analyses[] empty — the user blocked the SDK fingerprinting script (privacy extensions, content blockers). Decide whether to fail-closed or fall back to soft signals.
\- VPN_DETECTED / PROXY_DETECTED / TOR_DETECTED — treat per your fraud policy (decline, manual review, additional liveness step).
\- DUPLICATED_DEVICE — same device previously enrolled under a different vendor_data; merge accounts or block per policy.
\- LOCATION_MISMATCH_WITH_DOCUMENT — the IP country does not match the document's issuing country; route to review.

\# See also
\- Canonical schema: /reference/data-models#ip-analysis
\- Per-feature report: /core-technology/ip-analysis/report-ip-analysis
\- Risk catalogue: /core-technology/ip-analysis/warnings-ip-analysis
\- Full integration playbook: /integration/integration-prompt````

\</pre>



      
      

Paste into

La función está pensada para decisiones de prevención de fraude en las que los falsos positivos son costosos. Las coincidencias exactas de dispositivos duplicados usan identificadores persistentes estables. Las coincidencias de dispositivos recuperados usan el vector de señales de la huella v2 y umbrales de alta confianza, de modo que Didit puede detectar reutilizaciones sospechosas sin fusionar usuarios no relacionados de forma demasiado agresiva.En la lección de Academy sobre cómo leer el resultado de una verificación, el capítulo del minuto 9:49 recorre las señales del análisis de dispositivo e IP.[Análisis de dispositivo e IP — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=589\&rel=0\&playsinline=1)![Resumen del análisis de dispositivo e IP de Didit con geolocalización, huella de dispositivo, inteligencia de dispositivos y detección de VPN](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/ip-analysis.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=a2fbbbdd3d6fed3d759e54f362bf4762)![Diagrama de arquitectura del análisis de dispositivo e IP de Didit que contrasta la IP, la huella de dispositivo y la ubicación declarada](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/ip-analysis-how-it-works.jpg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=3519ad9ad50091a00db5e09d5197fdfe)## Cómo funcionaEl análisis de dispositivo e IP se ejecuta automáticamente durante la sesión de verificación y reúne el contexto del dispositivo, la red y la identidad en una única superficie de riesgo.**1. Captura de la huella de dispositivo**El cliente de verificación envía un payload de huella v2 que respeta la privacidad, con señales del dispositivo web o móvil:| Dato | Descripción |
| - | - |
| **ID de dispositivo persistente** | Identificador propio usado para detectar exactamente el mismo dispositivo cuando el almacenamiento persiste. |
| **Hash compuesto** | Hash estable de señales agrupadas, usado en comprobaciones deterministas de duplicados con salvaguardas frente a colisiones. |
| **Vector de señales** | Atributos del dispositivo y del navegador o la app, vectorizados para una recuperación de alta confianza. |
| **Contexto de plataforma** | Navegador, sistema operativo, app, hardware, WebGL/canvas, multimedia, idioma, zona horaria y señales de integridad móvil cuando están disponibles. |**2. Análisis de la IP y de la conexión**Didit enriquece los datos de conexión observados con información de riesgo de red:- Geolocalización de la IP por país, región, ciudad y coordenadas
- Detección de VPN, proxy, Tor, centros de datos y redes privadas
- Comprobaciones de IP esperada cuando indicas una IP permitida para la sesión
- Comprobaciones de la lista de bloqueo de IP configurada en tu aplicación**3. Coincidencia de duplicados y recuperación**Didit comprueba si la sesión actual coincide con sesiones anteriores de otro `vendor_data`:| Comprobación | Finalidad |
| - | - |
| **IP duplicada** | Detecta la misma dirección IP en distintos usuarios. |
| **Huella de dispositivo duplicada** | Detecta la reutilización exacta de la misma identidad persistente del dispositivo. |
| **Dispositivo recuperado** | Detecta una recuperación de huella v2 de alta confianza cuando el ID persistente ha cambiado. |
| **Protección frente a colisiones** | Suprime los hashes agrupados de baja calidad en lugar de fusionar dispositivos no relacionados. |**4. Comprobaciones cruzadas de ubicación**El análisis de dispositivo e IP compara el contexto de ubicación con puntos de referencia de confianza:- País y coordenadas de la dirección del documento
- Dirección IP esperada de la sesión
- País y ciudad de la IP
- Distancia y dirección entre la dirección y la ubicación de la IP**5. Acción e informes**Puedes configurar cada categoría de riesgo de forma independiente y consumir el resultado en cada salida de Didit:| Canal | Descripción |
| - | - |
| **Acciones del flujo** | Aprobar, revisar o rechazar por VPN/proxy, discrepancia de ubicación, IP duplicada, dispositivo duplicado exacto y dispositivo recuperado. |
| **Panel** | Revisa advertencias, sesiones coincidentes, información del dispositivo y detalles de red en la consola de Didit. |
| **Webhooks y APIs** | Recibe advertencias y coincidencias estructuradas en los payloads de decisión. |
| **Informes** | Exporta los detalles del análisis de dispositivo e IP en los PDF de verificación. |## Modelo de coincidenciaEl análisis de dispositivo e IP separa las coincidencias exactas de las recuperadas para que puedas ajustar con seguridad la respuesta al fraude:| Capa | Qué detecta | Postura frente a falsos positivos |
| - | - | - |
| **ID persistente exacto** | La misma identidad propia de dispositivo aparece en la sesión de otro usuario. | Señal más fuerte. Se usa para `DUPLICATED_DEVICE_FINGERPRINT`. |
| **Hash compuesto** | El mismo hash determinista de dispositivo aparece en la sesión de otro usuario. | Protegido por detección de colisiones, de modo que se suprimen los grupos comunes de WebView o navegador. |
| **Dispositivo recuperado v2** | El ID persistente cambió, pero señales ricas del dispositivo coinciden con un dispositivo anterior con alta confianza. | Conservadora. Se usa para `DEVICE_RECOVERED_HIGH_CONFIDENCE` solo después de superar controles estrictos. |
| **Reutilización de IP** | La misma dirección IP aparece en varios usuarios. | Contextual. Útil para redes de fraude, pero las oficinas compartidas, los hogares y los operadores móviles pueden ser legítimos. |La coincidencia de dispositivos recuperados usa un índice vectorial de recuperación dedicado. Si ese índice no está disponible, Didit continúa con las comprobaciones exactas de duplicados y no emite candidatos de recuperación aproximados.En **Networks**, Didit también destaca la reutilización de proxies residenciales cuando la misma inteligencia de IP no procedente de un centro de datos aparece en varios usuarios o empresas distintos. El grafo muestra la señal de riesgo agregada, el número de sujetos, el tipo de conexión y el contexto de ISP y ASN; no expone la dirección IP en bruto ni los datos de perfil de otra organización.## Patrones de fraude detectadosEl análisis de dispositivo e IP ayuda a identificar y reducir:- Multicuentas y creación de cuentas duplicadas
- Intentos de evadir el KYC usando el mismo dispositivo con distintas identidades
- Redes de fraude que coordinan muchas cuentas desde dispositivos o infraestructura compartidos
- Abuso de bonos, de referidos, de promociones y de pruebas gratuitas
- Altas de identidades sintéticas desde dispositivos repetidos
- Patrones de alta de mulas de dinero
- Riesgo de apropiación de cuentas desde dispositivos desconocidos o de alto riesgo
- Relleno de credenciales e intentos de registro automatizados
- Pruebas de tarjetas, abuso de contracargos y de reembolsos respaldados por patrones repetidos de dispositivo o red
- Evasión mediante VPN, proxy, Tor, centros de datos y proxies residenciales
- Manipulación de dispositivos, uso de emuladores, riesgo de jailbreak/root y clonación de apps cuando hay señales móviles disponibles
- Suplantación de ubicación y discrepancias entre el documento, la IP, la zona horaria, el operador y el contexto del dispositivo
- Intentos de verificación impulsados por bots mediante navegadores sin interfaz o clientes con scripts## Capacidades clave#### Huella de dispositivo y recuperación- **Detección exacta de dispositivos duplicados**: detecta la misma identidad de dispositivo en sesiones con distintos valores de `vendor_data`.
- **Recuperación de alta confianza**: recupera relaciones probables de mismo dispositivo cuando los cambios de almacenamiento o la navegación de incógnito o privada cambian el ID persistente.
- **Protección frente a colisiones**: evita fusionar usuarios no relacionados cuando un hash de dispositivo parece demasiado común entre muchos ID persistentes distintos.
- **Cobertura móvil y web**: usa señales del navegador web y señales móviles nativas, incluidos campos relacionados con la integridad cuando están disponibles.#### Inteligencia de IP y de red- **Detección de VPN y proxy**: identifica conexiones enmascaradas o anonimizadas.
- **Detección de Tor y centros de datos**: marca infraestructura de alto riesgo.
- **Reutilización de proxies residenciales**: detecta el uso repetido de la misma red de apariencia residencial entre sujetos distintos sin exponer el valor de IP en bruto en el grafo de Networks.
- **Listas de bloqueo de IP**: rechaza automáticamente cuando la IP aparece en la lista de bloqueo de tu aplicación.
- **Aplicación de IP esperada**: compara la IP observada con una IP esperada indicada al crear la sesión.#### Geolocalización y comparación con el documento- **Detección de discrepancias de país**: compara el país del documento con el país de la IP.
- **Geovallado**: acepta solo sesiones de los países permitidos, con excepciones por estado o región para países como Estados Unidos, según la geolocalización de la IP.
- **Comprobaciones de distancia de dirección**: compara las coordenadas de la dirección del documento con la geolocalización de la IP.
- **Contexto de sesiones coincidentes**: devuelve las sesiones coincidentes con detalles de dispositivo y ubicación para la revisión del personal.## Configurar accionesUsa los ajustes del flujo para elegir la acción de cada riesgo. Los clientes conservadores suelen establecer primero `recovered_device_action` en `REVIEW`, inspeccionar las advertencias de dispositivo recuperado durante unas semanas y pasar a `DECLINE` solo tras confirmar su perfil local de falsos positivos.| Ajuste | Acción inicial recomendada | Por qué |
| - | - | - |
| `vpn_detection_action` | `REVIEW` o `DECLINE` | Depende de si tu producto permite el uso de VPN. |
| `ip_mismatch_action` | `REVIEW` | La discrepancia de ubicación es un contexto fuerte, pero puede ser legítima. |
| `duplicated_ip_action` | `REVIEW` | Las redes compartidas pueden generar falsos positivos. |
| `duplicated_device_action` | `REVIEW` o `DECLINE` | La reutilización exacta del mismo dispositivo entre usuarios es una señal de fraude fuerte. |
| `recovered_device_action` | `REVIEW` | La recuperación de alta confianza es conservadora a propósito, pero conviene monitorizarla antes de rechazar automáticamente. |
| `ip_geofencing_action` | `DECLINE` | El geovallado suele expresar una regla jurisdiccional estricta; usa `REVIEW` si prefieres una clasificación manual de las ubicaciones restringidas. |Consulta las [advertencias del análisis de dispositivo e IP](https://docs.didit.me/core-technology/ip-analysis/warnings-ip-analysis.md) para ver todas las etiquetas de riesgo y las [configuraciones de funciones del flujo](https://docs.didit.me/management-api/workflows/feature-configs.md#device-&-ip-analysis) para ver los campos de la API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.