Informe de verificación de ubicación: geolocation_checks

Descripción general

La decisión de la sesión devuelve el resultado de cada paso de verificación de ubicación en dos listas: geolocation_checks[] contiene el intento aceptado de cada paso y geolocation_attempts[] enumera todos los intentos en orden. Ambas están en GET /v3/session/{sessionId}/decision/ (consulta Recuperar sesión) y en el webhook status.updated. Un flujo de verificación (workflow) sin paso de ubicación devuelve null o una lista vacía en ambas.

GET /v3/session/{sessionId}/decision/
  --> { "geolocation_checks": [ { node_id, status, outcome, permission, latitude, longitude, accuracy_m, ... } ],
        "geolocation_attempts": [ { node_id, outcome, attempts, received_at, ... } ] }

`geolocation_checks[]`

Un elemento por cada paso de ubicación (node_id), tomado de su intento más reciente.

{
  "node_id": "geolocation_1",
  "status": "Declined",
  "outcome": "outside_geofence",
  "permission": "granted_precise",
  "latitude": 48.8566,
  "longitude": 2.3522,
  "accuracy_m": 35.0,
  "accuracy_confidence": "p95",
  "measured_at": "2026-11-03T10:15:02Z",
  "age_seconds": 2,
  "source": "browser",
  "platform": "web",
  "sdk_version": null,
  "is_mock": null,
  "produced_by_accessory": null,
  "integrity": "unsupported",
  "country_code": "FR",
  "region_code": "FR-IDF",
  "city": "Paris",
  "geofence": { "enabled": true, "result": "outside" },
  "inside_geofence": false,
  "geofence_basis": "device",
  "inside_areas": [],
  "blocked_areas": [],
  "position_source": "device_and_ip",
  "anonymizers": { "vpn": false, "proxy": false, "tor": false, "spoofing": null, "emulator": null },
  "ip_distance_km": 0,
  "ip_distance_uncertainty_km": 12.4,
  "ip_consistent": true,
  "document_distance_km": null,
  "travel_excused": null,
  "consecutive_mismatches": 1,
  "attempts": 3,
  "consent": { "accepted_at": "2026-11-03T10:14:55Z", "version": "hosted-web-1", "locale": "en" },
  "warnings": [
    {
      "risk": "LOCATION_OUTSIDE_GEOFENCE",
      "log_type": "error",
      "short_description": "Device location outside the allowed area",
      "node_id": "geolocation_1"
    }
  ]
}

Campo	Tipo	Descripción
`node_id`	string	El nodo del flujo que produjo el resultado, para que un flujo con dos pasos de ubicación siga siendo legible.
`status`	string	`Approved`, `In Review`, `Declined` o `Not Finished`, determinado a partir de las advertencias.
`outcome`	string	Lo que ocurrió en el intento aceptado. Consulta los resultados.
`permission`	string	Lo que concedió el sistema: `granted_precise`, `granted_approximate`, `denied`, `restricted`, `unavailable`, `timeout`, `dismissed` o `not_requested` (paso solo por IP).
`latitude`, `longitude`	number o null	Posición WGS84. `null` cuando no hay posición.
`accuracy_m`	number o null	Radio de incertidumbre en metros.
`accuracy_confidence`	string o null	Nivel de confianza del radio: `p95` (web), `p68` (Android) o `unspecified` (iOS). Cada plataforma es distinta, por lo que se registra en lugar de normalizarse.
`measured_at`	datetime o null	Cuándo midió el dispositivo la posición, según el reloj del dispositivo.
`age_seconds`	integer o null	Tiempo entre la medición y el momento en que Didit la recibió.
`source`	string o null	`gps`, `fused`, `network`, `wifi`, `cell`, `browser`, `unknown` o `ip` en un paso solo por IP.
`platform`	string o null	`web`, `ios`, `android`, `react_native` o `flutter`.
`sdk_version`	string o null	La versión del SDK que produjo la posición.
`is_mock`	boolean o null	El sistema informó de una posición simulada. `null` significa que la plataforma no puede saberlo (web), no `false`.
`produced_by_accessory`	boolean o null	Solo iOS: la posición provino de un accesorio externo.
`integrity`	string	Atestación del dispositivo: `attested`, `not_attested`, `failed`, `unsupported` (web) o `not_determined`.
`country_code`, `region_code`, `city`	string o null	El lugar al que corresponde la posición, calculado sin conexión: ISO 3166-1 alpha-2, ISO 3166-2 y la localidad poblada más cercana. La ciudad es una etiqueta para los revisores, nunca una entrada de reglas.
`geofence`	object	`enabled` y `result`: `inside`, `outside` o `undetermined`. `result` es `null` cuando la geovalla está desactivada.
`inside_geofence`	boolean o null	`true` o `false`, y `null` cuando la geovalla está desactivada o el círculo de precisión cruza un límite.
`geofence_basis`	string o null	Qué posición usó el veredicto del área: `device` o `ip`.
`inside_areas`, `blocked_areas`	array	Los `id` de las áreas permitidas que contienen todo el círculo de precisión y de las áreas bloqueadas en las que se encuentra la posición.
`position_source`	string o null	El `geolocation_position_source` del nodo cuando se ejecutó el intento.
`anonymizers`	object o null	`vpn`, `proxy`, `tor`, `spoofing` y `emulator`, cada uno `true`, `false` o `null` cuando la fuente no puede saberlo.
`ip_distance_km`	number o null	Distancia a la ubicación de la IP tras restar ambos radios de incertidumbre. 0 significa que se solapan.
`ip_distance_uncertainty_km`	number o null	El radio combinado que se restó.
`ip_consistent`	boolean o null	`ip_distance_km` está dentro de `geolocation_ip_distance_km`. `null` cuando se desconoce cualquiera de los dos lados.
`document_distance_km`	number o null	Distancia a la dirección geocodificada del documento. `null` cuando no hay ninguna dirección registrada.
`travel_excused`	boolean o null	La tolerancia de viaje justificó la distancia. `null` cuando la tolerancia está desactivada.
`consecutive_mismatches`	integer o null	En un intento final, esta comprobación más las discrepancias anteriores consecutivas de la misma persona.
`attempts`	integer	El número del intento.
`consent`	object o null	`accepted_at`, `version` y `locale` del aviso de ubicación que aceptó la persona.
`warnings`	array	Las advertencias del paso.

`geolocation_attempts[]`

Todos los intentos de todos los pasos de ubicación, del más antiguo al más reciente, con los mismos campos de medición, incertidumbre, área y distancia que geolocation_checks[] excepto warnings, además de:

Campo	Tipo	Descripción
`received_at`	datetime	Cuándo recibió Didit el intento.
`created_at`	datetime	Cuándo se registró el intento.

Se omiten los intentos sustituidos por un nuevo envío. Los datos sin procesar enviados por el cliente y el desafío nunca se devuelven.

Campos para reglas de estado y ramas

Las status_rules personalizadas y las reglas de rama pueden leer estos campos: geolocation.status, geolocation.outcome, geolocation.permission, geolocation.latitude, geolocation.longitude, geolocation.accuracy_m, geolocation.accuracy_confidence, geolocation.age_seconds, geolocation.measured_at, geolocation.source, geolocation.platform, geolocation.country (ISO 3166-1 alpha-3), geolocation.region, geolocation.city, geolocation.is_mock, geolocation.integrity, geolocation.inside_geofence, geolocation.ip_distance_km, geolocation.ip_consistent, geolocation.document_distance_km, geolocation.attempts, geolocation.consent_at, geolocation.inside_areas, geolocation.blocked_areas, geolocation.anonymizers (vpn, proxy, tor, spoofing, emulator) y geolocation.consecutive_mismatches. Un valor ausente solo coincide con is_empty, de modo que una regla escrita para una señal de fraude nunca se activa por datos ausentes.

Contenido relacionado

Verificación de ubicación: cómo funciona el paso y cuánto cuesta.
Advertencias de verificación de ubicación: todos los códigos LOCATION_*.
Webhooks: status.updated incluye las listas.
Modelos de datos: objeto Warning: la estructura de cada entrada de warnings[].

Autenticación

Verificación

Monitorización

Plataforma

Informe de verificación de ubicación: geolocation_checks

Descripción general

`geolocation_checks[]`

`geolocation_attempts[]`

Campos para reglas de estado y ramas

Contenido relacionado

​Descripción general

​geolocation_checks[]

​geolocation_attempts[]

​Campos para reglas de estado y ramas

​Contenido relacionado

Descripción general

`geolocation_checks[]`

`geolocation_attempts[]`

Campos para reglas de estado y ramas

Contenido relacionado