Ubicación del usuario (V3)

Solo disponible en V3

Con esta opción, la sesión de verificación pide la ubicación del dispositivo antes de abrir la cámara y la incluye en el resultado: coordenadas, precisión, fecha de captura y una dirección aproximada. Sirve como evidencia adicional de dónde se realizó la verificación.

Nota

Es una opción opcional y con costo adicional: no se pide a menos que la actives explícitamente al crear la sesión. No cambia el result de la verificación.

Cómo activarla

Envía capture_user_location: true en el cuerpo de la solicitud al crear la sesión:

JSON

{
    "validations": ["INE", "CURP"],
    "capture_user_location": true
}

cURL

curl -X POST https://api.verificamex.com/identity/v3/identity/sessions \
  -H "Authorization: Bearer {TU_TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "validations": ["INE", "CURP"],
    "capture_user_location": true
  }'

La respuesta de creación confirma la opción con "capture_user_location": true.

Tiene un costo adicional

Consume 5 tokens extra por sesión, solo si se obtiene la ubicación. Si la ubicación no se obtiene, user_location llega en null y no se cobran.

Estructura de la respuesta

Tanto el detalle de la sesión como el webhook incluyen el campo user_location. Es null si la sesión no pidió la ubicación o si no se obtuvo.

Campo	Tipo	Descripción
lat	Number	Latitud.
lng	Number	Longitud.
precision_m	Number	Precisión estimada de la ubicación, en metros.
capturada_en	String	Fecha y hora de la captura (ISO-8601, UTC).
altitud_m	Number	Altitud en metros, o null si el dispositivo no la proporciona.
rumbo_grados	Number	Dirección de movimiento en grados, o null.
velocidad_kmh	Number	Velocidad en km/h, o null.
utc_offset_min	Number	Diferencia horaria del dispositivo respecto a UTC, en minutos (por ejemplo -360 para la Ciudad de México).
google_maps_url	String	Enlace para ver la ubicación en Google Maps.
direccion	Object	Dirección aproximada obtenida de las coordenadas (por ejemplo colonia, codigo_postal, estado). Sus campos pueden variar según la zona.

Consejo

Toma en cuenta precision_m al interpretar la ubicación: depende del dispositivo y de la señal disponible, y puede ir de unos cuantos metros a varios cientos.

Ejemplo

{
    "lat": 19.4326,
    "lng": -99.1332,
    "precision_m": 12.0,
    "capturada_en": "2026-10-08T18:02:13.000Z",
    "altitud_m": 2240.3,
    "rumbo_grados": null,
    "velocidad_kmh": null,
    "utc_offset_min": -360,
    "google_maps_url": "https://www.google.com/maps/search/?api=1&query=19.4326000,-99.1332000",
    "direccion": {
        "colonia": "Centro",
        "codigo_postal": "06060",
        "estado": "Ciudad de México"
    }
}

Solo V3

Esta opción no existe en las sesiones creadas con la V2.

Cobro condicionado

5 tokens extra, solo si se obtiene la ubicación.

No afecta el resultado

Es evidencia adicional: no cambia el result de la verificación.