---
title: Metadatos del Dispositivo
description: Capacidad que devuelve los metadatos del dispositivo utilizado en la captura, como plataforma, IP, ubicación y las señales de riesgo detectadas en él.
canonical: https://developer.unico.io/es/capabilities/device-metadata
locale: es
generated_by: markdown-export
---

# Metadatos del Dispositivo

Esta capacidad devuelve los datos del dispositivo desde el que el usuario realizó la captura, junto con los resultados de los demás productos contratados.

### Qué hace

Recopila los metadatos del dispositivo utilizado en la sesión de captura y las señales de riesgo detectadas en él (detalle de los datos más abajo).

No es una validación: nunca aprueba ni rechaza el proceso, y nunca hace que el proceso falle. Utiliza los datos en tus propias reglas de riesgo o motores de decisión internos.

### Entradas

No se necesita ningún campo adicional. La capacidad utiliza la sesión de captura que el proceso ya tiene.

- **Web:** la captura realizada en el journey de Unico.
- **API con el SDK de Unico:** la captura realizada por el SDK de Unico en tu app.

> **Los metadatos dependen del SDK de Unico:** El SDK de Unico es quien recopila los metadatos, durante la captura. Una integración por API puede usar o no el SDK de Unico:
>
> - **API con el SDK de Unico:** los metadatos se devuelven normalmente.
> - **API sin el SDK de Unico:** no hay metadatos, y la respuesta es `not_found`.

La capacidad se habilita en un flujo contratado para tu cuenta. Habla con tu contacto de Unico para habilitarla.

### Respuestas posibles

El resultado llega en el objeto `authenticationInfo.deviceMetadata` de [Obtener proceso](/es/developers/api-reference/get-process).

| `status` | Significado |
| --- | --- |
| `found` | Se encontraron los metadatos del dispositivo. Los campos siguientes se completan con lo que el dispositivo recopiló. |
| `not_found` | No hay metadatos del dispositivo para esta captura, por ejemplo un proceso por API sin el SDK de Unico. |
| `unavailable` | No fue posible obtener los metadatos en ese momento. El resultado del proceso no se ve afectado. |

Cuando `status` es `found`:

| Campo | Tipo | Descripción |
| --- | --- | --- |
| `deviceId` | string | Identificador del dispositivo. |
| `platform` | string | Plataforma desde la que se realizó la captura, por ejemplo `WEB`, `ANDROID`, `IOS`. |
| `ip` | string | Dirección IP del dispositivo. |
| `ipCountry` | string | País de la dirección IP. |
| `ipGeoCoordinates` | object | Ubicación de la dirección IP (`lat`, `lng`). |
| `gpsCoordinates` | object | Ubicación informada por el GPS del dispositivo (`lat`, `lng`). |
| `osName` | string | Nombre del sistema operativo. |
| `osVersion` | string | Versión del sistema operativo. |
| `browserName` | string | Nombre del navegador. Solo Web. |
| `userAgent` | string | User agent del navegador. Solo Web. |
| `appStore` | string | Tienda de aplicaciones desde la que se instaló tu app. Solo SDK nativo. |
| `detectedSignals` | array of strings | Grupos de señales de riesgo detectadas en el dispositivo. Vacío cuando no se detectó ninguna. |

Un campo ausente significa que el dispositivo no recopiló ese dato.

`detectedSignals` enumera solo los grupos detectados. Un grupo se detecta cuando se encontró al menos una de sus señales:

| Grupo | Qué significa |
| --- | --- |
| `origin_obfuscated` | El origen real del acceso está oculto, por ejemplo por Tor o herramientas anti-fingerprinting. |
| `untrusted_location` | La ubicación puede ser falsa, por ejemplo por un proxy, una VPN o un GPS spoofer. |
| `environment_altered` | El entorno del dispositivo está alterado, por ejemplo un emulador o un dispositivo con root o jailbreak. |
| `app_manipulated` | La app fue manipulada, interceptada (hooking) o depurada. |
| `assisted_session` | Otra persona puede estar conduciendo la sesión, por ejemplo mediante pantalla compartida o un bot. |
| `payload_untrusted` | Los datos enviados por el dispositivo fueron manipulados. |

No todas las señales existen en todas las plataformas, por lo que el mismo dispositivo puede mostrar grupos diferentes en web y en el SDK nativo.

### Disponibilidad

| Componentes de integración requeridos |
| --- |
| SDK  Web or SDK |

### Combinaciones válidas

Metadatos del Dispositivo no forma parte de los flujos precompuestos en [Flujos disponibles](/es/developers/start/flows). Puede habilitarse junto con cualquier otro producto de Unico en integraciones Web y SDK, en un flujo contratado para tu cuenta.

### Productos que utilizan esta capacidad

Puede añadirse a cualquier producto de Unico en integraciones Web y SDK.

Última actualización el **28 oct 2026**