> ## 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 d'empremta de dispositius i risc d'IP per a KYC > Didit detecta dispositius duplicats, xarxes de frau, VPN, proxies, Tor i empremtes sospitoses durant la verificació KYC. L'Anàlisi de dispositiu i IP de Didit combina l'empremta digital del dispositiu, la recuperació de dispositius duplicats, la intel·ligència d'IP i les comprovacions de geolocalització en el flux de verificació. Ajuda a detectar quan el mateix dispositiu físic intenta accedir a diversos comptes, fins i tot quan l'usuari canvia de sessió, esborra l'emmagatzematge del navegador, obre una finestra d'incògnit o canvia la informació de xarxa. Prompt d'integració de l'Anàlisi de dispositiu i IP Copia el prompt al porta-retalls \

\````# 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````

\
Enganxa a Aquesta funcionalitat està dissenyada per a decisions de prevenció del frau on els falsos positius són costosos. Les coincidències exactes de dispositiu duplicat utilitzen identificadors persistents estables. Les coincidències de dispositiu recuperat utilitzen el vector de senyals d'empremta digital v2 i filtres d'alta confiança, de manera que Didit pot detectar la reutilització sospitosa sense fusionar usuaris no relacionats de manera massa agressiva.A la lliçó de l'Academy sobre com interpretar el resultat d'una verificació, el capítol del minut 9:49 repassa els senyals de l'anàlisi de dispositiu i IP.[Anàlisi de dispositiu i IP — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=589\&rel=0\&playsinline=1)![Visió general de l'Anàlisi de dispositiu i IP de Didit que mostra geolocalització, empremta digital de dispositiu, intel·ligència de dispositiu i detecció 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 d'arquitectura de l'Anàlisi de dispositiu i IP de Didit que creua IP, empremta digital de dispositiu i ubicació 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)## Com funcionaL'Anàlisi de dispositiu i IP s'executa automàticament durant la sessió de verificació i vincula el context del dispositiu, de la xarxa i de la identitat en una única superfície de risc.**1. Captura de l'empremta digital del dispositiu**El client de verificació envia un payload d'empremta digital v2 que preserva la privacitat amb senyals de dispositiu web o mòbil:| Punt de dades | Descripció | | - | - | | **ID de dispositiu persistent** | Identificador propi utilitzat per detectar exactament el mateix dispositiu quan l'emmagatzematge es conserva. | | **Hash compost** | Hash agrupat de senyals estables utilitzat per a comprovacions deterministes de duplicats amb mecanismes de protecció contra col·lisions. | | **Vector de senyals** | Atributs del dispositiu i del navegador/aplicació vectoritzats per a una recuperació d'alta confiança. | | **Context de la plataforma** | Senyals de navegador, SO, aplicació, maquinari, WebGL/canvas, mèdia, configuració regional, zona horària i integritat mòbil quan estiguin disponibles. |**2. Anàlisi d'IP i connexió**Didit enriqueix les dades de connexió observades amb informació sobre el risc de la xarxa:- Geolocalització de la IP per país, regió, ciutat i coordenades - Detecció de VPN, proxy, Tor, centre de dades i xarxa privada - Comprovacions de l'adreça IP esperada quan proporciones una IP permesa per a la sessió - Comprovacions de la llista de bloqueig d'IP configurades a la teva aplicació**3. Coincidència de duplicats i recuperació**Didit comprova si la sessió actual coincideix amb sessions anteriors d'un altre `vendor_data`:| Comprovació | Propòsit | | - | - | | **IP duplicada** | Detecta la mateixa adreça IP entre usuaris diferents. | | **Empremta digital de dispositiu duplicada** | Detecta la reutilització exacta de la mateixa identitat persistent del dispositiu. | | **Dispositiu recuperat** | Detecta una recuperació d'empremta digital v2 d'alta confiança quan l'ID persistent ha canviat. | | **Protecció contra col·lisions** | Suprimeix els hashos agrupats de baixa qualitat en comptes de fusionar dispositius no relacionats. |**4. Comprovacions creuades d'ubicació**L'Anàlisi de dispositiu i IP compara el context d'ubicació amb punts de referència de confiança:- País del document i coordenades de l'adreça - Adreça IP esperada de la sessió - País i ciutat de la IP - Distància i direcció entre l'adreça i la ubicació de la IP**5. Acció i informes**Pots configurar cada categoria de risc de manera independent i consumir el resultat en totes les sortides de Didit:| Canal | Descripció | | - | - | | **Accions del flux de treball** | Aprovar, revisar o rebutjar per VPN/proxy, discrepància d'ubicació, IP duplicada, dispositiu duplicat exacte i dispositiu recuperat. | | **Tauler** | Revisa advertències, sessions coincidents, informació del dispositiu i detalls de xarxa a la consola de Didit. | | **Webhooks i API** | Rep advertències estructurades i coincidències en els payloads de decisió. | | **Informes** | Exporta els detalls de l'Anàlisi de dispositiu i IP en documents PDF de verificació. |## Model de coincidènciaL'Anàlisi de dispositiu i IP separa les coincidències exactes de les coincidències recuperades perquè puguis ajustar la resposta davant del frau de manera segura:| Capa | Què detecta | Criteri davant de falsos positius | | - | - | - | | **ID persistent exacte** | La mateixa identitat pròpia del dispositiu apareix a la sessió d'un altre usuari. | Senyal més sòlid. S'utilitza per a `DUPLICATED_DEVICE_FINGERPRINT`. | | **Hash compost** | El mateix hash determinista de dispositiu apareix a la sessió d'un altre usuari. | Protegit per detecció de col·lisions de manera que se suprimeixen els conjunts comuns de WebView/navegador. | | **Dispositiu recuperat v2** | L'ID persistent ha canviat, però un conjunt ric de senyals del dispositiu coincideix amb un dispositiu anterior amb alta confiança. | Conservador. S'utilitza per a `DEVICE_RECOVERED_HIGH_CONFIDENCE` només després de superar filtres estrictes. | | **Reutilització d'IP** | La mateixa adreça IP apareix entre diferents usuaris. | Contextual. Útil per a xarxes de frau, però les oficines compartides, llars i operadors mòbils poden ser legítims. |La coincidència de dispositius recuperats utilitza un índex de recuperació vectorial dedicat. Si aquest índex no està disponible, Didit continua fent comprovacions de duplicats exactes i no emet candidats de recuperació aproximats.A **Xarxes**, Didit també destaca la reutilització de proxys residencials quan la mateixa informació d'IP que indica que no és una IP d'un centre de dades apareix entre diversos usuaris o empreses diferents. El graf mostra el senyal de risc agregat, el nombre de subjectes, el tipus de connexió i el context d'ISP i ASN; no exposa l'adreça IP en brut ni les dades de perfil d'una altra organització.## Patrons de frau detectatsL'anàlisi de dispositiu i IP ajuda a identificar i reduir:- La creació de multicomptes i comptes duplicats - Els intents d'elusió de KYC utilitzant el mateix dispositiu en diferents identitats - Les xarxes de frau que coordinen molts comptes des de dispositius o infraestructures compartides - L'abús de bonificacions, de referits, de promocions i de períodes de prova gratuïts - L'alta d'identitats sintètiques des de dispositius reutilitzats - Els patrons d'alta de mules financeres - El risc de presa de control de comptes des de dispositius desconeguts o d'alt risc - Els atacs d'emplenament de credencials i els intents de registre automatitzats - Les proves de targetes, l'abús de contracàrrecs i l'abús de reemborsaments recolzats en patrons repetits de dispositius o de xarxa - L'evasió mitjançant VPN, proxy, Tor, centres de dades i proxys residencials - La manipulació de dispositius, l'ús d'emuladors, el risc de jailbreak/root i la clonació d'aplicacions quan hi hagi senyals mòbils disponibles - La suplantació d'ubicació i les discrepàncies entre document, IP, zona horària, operador i context del dispositiu - Els intents de verificació basats en bots mitjançant navegadors sense interfície gràfica o clients amb scripts## Funcionalitats clau#### Empremta digital de dispositiu i recuperació- **Detecció exacta de dispositius duplicats**: detecta la mateixa identitat de dispositiu en diverses sessions a partir de valors de `vendor_data` diferents. - **Recuperació d'alta confiança**: recupera relacions que probablement corresponen al mateix dispositiu quan canvis en l'emmagatzematge o la navegació d'incògnit/privada modifiquen l'ID persistent. - **Protecció contra col·lisions**: evita fusionar usuaris no relacionats quan un hash de dispositiu sembla massa comú entre molts ID persistents diferents. - **Cobertura web i mòbil**: utilitza senyals de navegadors web i senyals mòbils natius, incloent-hi camps relacionats amb la integritat quan estiguin disponibles.#### Intel·ligència d'IP i de xarxa- **Detecció de VPN i proxy**: identifica connexions emmascarades o anonimitzades. - **Detecció de Tor i centres de dades**: marca la infraestructura d'alt risc. - **Reutilització de proxy residencial**: detecta l'ús repetit de la mateixa xarxa d'aparença residencial entre diferents subjectes sense exposar el valor en brut de la IP al graf de xarxes. - **Llistes de bloqueig d'IP**: rebutja automàticament quan la IP apareix a la llista de bloqueig de la teva aplicació. - **Verificació d'IP esperada**: compara la IP observada amb una IP esperada proporcionada durant la creació de la sessió.#### Geolocalització i comparació de documents- **Detecció de discrepàncies de país**: compara el país del document i el país de la IP. - **Restricció geogràfica**: accepta només sessions de països permesos —amb excepcions per estat o regió en països com els Estats Units— a partir de la geolocalització de la IP. - **Comprovacions de distància de l'adreça**: compara les coordenades de l'adreça del document i la geolocalització de la IP. - **Context de coincidència de sessions**: retorna sessions coincidents amb detalls de dispositiu i ubicació per a la revisió per part de l'equip.## Configurar accionsUtilitza la configuració del flux de treball per triar l'acció per a cada risc. Els clients més conservadors solen establir inicialment `recovered_device_action` a `REVIEW`, inspeccionar les advertències de dispositius recuperats durant unes quantes setmanes i passar a `DECLINE` només després de confirmar el perfil local de falsos positius.| Configuració | Acció inicial recomanada | Motiu | | - | - | - | | `vpn_detection_action` | `REVIEW` o `DECLINE` | Depèn de si l'ús de VPN està permès al teu producte. | | `ip_mismatch_action` | `REVIEW` | La discrepància d'ubicació és un context sòlid, però pot ser legítima. | | `duplicated_ip_action` | `REVIEW` | Les xarxes compartides poden generar falsos positius. | | `duplicated_device_action` | `REVIEW` o `DECLINE` | La reutilització exacta del mateix dispositiu entre usuaris és un senyal fort de frau. | | `recovered_device_action` | `REVIEW` | La recuperació d'alta confiança és conservadora per disseny, però s'hauria de monitorar abans de rebutjar automàticament. | | `ip_geofencing_action` | `DECLINE` | La restricció geogràfica sol expressar una regla jurisdiccional estricta; utilitza `REVIEW` si prefereixes fer un triatge manual de les ubicacions restringides. |Consulta les [advertències d'Anàlisi de dispositiu i IP](https://docs.didit.me/ca/core-technology/ip-analysis/warnings-ip-analysis.md) per veure totes les etiquetes de risc i les [Configuracions de funcionalitats del flux de treball](https://docs.didit.me/ca/management-api/workflows/feature-configs.md#anàlisi-de-dispositiu-i-ip) per conèixer els camps de l'API. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.