Verificação de localização: campos geolocation_checks

Visão geral

A decisão da sessão devolve o resultado de cada passo de verificação de localização em duas listas: geolocation_checks[] contém a tentativa aceite de cada passo e geolocation_attempts[] lista todas as tentativas por ordem. Ambas estão presentes em GET /v3/session/{sessionId}/decision/ (consulte Obter sessão) e no webhook status.updated. Um fluxo sem nenhum passo de localização devolve null ou uma lista vazia para 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[]`

Um item por passo de localização (node_id), obtido a partir da sua tentativa mais recente.

{
  "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	Descrição
`node_id`	string	O nó do fluxo que produziu o resultado, para que um fluxo com dois passos de localização permaneça legível.
`status`	string	`Approved`, `In Review`, `Declined` ou `Not Finished`, determinado a partir dos avisos.
`outcome`	string	O que aconteceu na tentativa aceite. Consulte resultados.
`permission`	string	O que o sistema concedeu: `granted_precise`, `granted_approximate`, `denied`, `restricted`, `unavailable`, `timeout`, `dismissed` ou `not_requested` (passo apenas com IP).
`latitude`, `longitude`	number or null	Posição WGS84. `null` quando não existe posição.
`accuracy_m`	number or null	Raio de incerteza em metros.
`accuracy_confidence`	string or null	Nível de confiança do raio: `p95` (web), `p68` (Android) ou `unspecified` (iOS). As plataformas diferem, pelo que é registado em vez de normalizado.
`measured_at`	datetime or null	Quando o dispositivo mediu a posição, de acordo com o relógio do dispositivo.
`age_seconds`	integer or null	Tempo decorrido entre a medição e o momento em que a Didit a recebeu.
`source`	string or null	`gps`, `fused`, `network`, `wifi`, `cell`, `browser`, `unknown` ou `ip` num passo apenas com IP.
`platform`	string or null	`web`, `ios`, `android`, `react_native` ou `flutter`.
`sdk_version`	string or null	A versão do SDK que produziu a posição.
`is_mock`	boolean or null	O sistema comunicou uma posição simulada. `null` significa que a plataforma não consegue determinar (web), e não `false`.
`produced_by_accessory`	boolean or null	Apenas iOS: a posição proveio de um acessório externo.
`integrity`	string	Atestação do dispositivo: `attested`, `not_attested`, `failed`, `unsupported` (web) ou `not_determined`.
`country_code`, `region_code`, `city`	string or null	O local correspondente à posição, calculado offline: ISO 3166-1 alpha-2, ISO 3166-2 e a localidade povoada mais próxima. A cidade é uma etiqueta para revisores, nunca uma entrada para regras.
`geofence`	object	`enabled` e `result`: `inside`, `outside` ou `undetermined`. `result` é `null` quando o geofencing está desativado.
`inside_geofence`	boolean or null	`true` ou `false`, e `null` quando o geofencing está desativado ou quando o círculo de precisão intersecta um limite.
`geofence_basis`	string or null	Que posição foi utilizada no veredito da área: `device` ou `ip`.
`inside_areas`, `blocked_areas`	array	`id`s das áreas permitidas onde todo o círculo de precisão se encontra dentro e das áreas bloqueadas onde se encontra dentro.
`position_source`	string or null	O `geolocation_position_source` do nó quando a tentativa foi executada.
`anonymizers`	object or null	`vpn`, `proxy`, `tor`, `spoofing` e `emulator`, cada um `true`, `false` ou `null` quando a fonte não consegue determinar.
`ip_distance_km`	number or null	Distância até à localização do IP após subtrair ambos os raios de incerteza. 0 significa que se sobrepõem.
`ip_distance_uncertainty_km`	number or null	O raio combinado que foi subtraído.
`ip_consistent`	boolean or null	`ip_distance_km` está dentro de `geolocation_ip_distance_km`. `null` quando algum dos lados é desconhecido.
`document_distance_km`	number or null	Distância até à morada geocodificada do documento. `null` quando não existe nenhuma morada registada.
`travel_excused`	boolean or null	A tolerância de deslocação justificou a distância. `null` quando a tolerância está desativada.
`consecutive_mismatches`	integer or null	Numa tentativa final, esta verificação somada às discrepâncias consecutivas anteriores da mesma pessoa.
`attempts`	integer	O número da tentativa.
`consent`	object or null	`accepted_at`, `version` e `locale` do aviso de localização que a pessoa aceitou.
`warnings`	array	Os avisos do passo.

`geolocation_attempts[]`

Todas as tentativas de cada passo de localização, da mais antiga para a mais recente, com os mesmos campos de medição, incerteza, área e distância que geolocation_checks[], exceto warnings, mais:

Campo	Tipo	Descrição
`received_at`	datetime	Quando a Didit recebeu a tentativa.
`created_at`	datetime	Quando a tentativa foi registada.

As tentativas que uma nova submissão invalidou são omitidas. A submissão não processada do cliente e o desafio nunca são devolvidos.

Campos para regras de estado e ramificações

As status_rules personalizadas e as regras de ramificação podem ler estes 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) e geolocation.consecutive_mismatches. Um valor em falta corresponde apenas a is_empty, pelo que uma regra criada para um sinal de fraude nunca é acionada com dados em falta.

Relacionado

Verificação de localização - como funciona o passo e quanto custa.
Avisos de verificação de localização - todos os códigos LOCATION_*.
Webhooks - o evento status.updated inclui as listas.
Modelos de dados - Objeto de aviso - a estrutura de cada entrada em warnings[].

Autenticação

Verificação

Monitorização

Plataforma

Verificação de localização: campos geolocation_checks

Visão geral

`geolocation_checks[]`

`geolocation_attempts[]`

Campos para regras de estado e ramificações

Relacionado

​Visão geral

​geolocation_checks[]

​geolocation_attempts[]

​Campos para regras de estado e ramificações

​Relacionado

Visão geral

`geolocation_checks[]`

`geolocation_attempts[]`

Campos para regras de estado e ramificações

Relacionado