Changelog de Identity Link API

Este changelog documenta todas las versiones publicadas de la Identity Link API de VU. Las entradas más recientes aparecen primero. Revisa esta página antes de actualizar tu integración para identificar cambios de comportamiento que puedan afectar tu flujo.

​

v2.4.1 (versión actual)

​

VU Cloud Services disponible

• Api-keys autogestionadas para todas las cuentas Premium y Pro: la sección Cloud Services del portal ya está habilitada. ID Analysis, Face Analysis y Antispoofing Facial se integran con api-keys que se crean, rotan, pausan y revocan desde el portal, sin abrir un ticket. Connection Fingerprint se contrata con un comercial y no usa api-keys. Mirá la documentación.
• Período de prueba: hasta 5 api-keys por servicio, con 10.000 llamadas de prueba cada una. Durante el período de lanzamiento el consumo no se factura.
• Motivo visible al rechazar una api-key: si el servicio no está habilitado para la cuenta, el portal explica por qué en lugar de mostrar un error genérico.

​

Cambios de comportamiento

• GET /verifications/{size}/{page} aplica el máximo de 100 por página: un size mayor a 100 se sirve como 100, y un size ausente, cero o negativo también se sirve como 100 (antes, un size negativo respondía 500). Si pedías más de 100 por página, recorré las páginas.

​

Nuevas funciones

• Volver a la pantalla pedida después de iniciar sesión: un link a cualquier pantalla del portal lleva a esa pantalla después de entrar.

​

Mejoras

• Link de verificación con una sesión del portal vencida: si el navegador de la persona tenía una sesión vencida del portal, el link de verificación la mandaba a la pantalla de inicio de sesión. Ahora la verificación sigue.
• Correo de contacto con soporte: llegaba con el asunto de confirmación de cuenta. Ahora tiene el asunto de soporte.

​

v2.3.2

​

Nuevas funciones

• Botón Compartir al crear un link: aparece al lado de Copiar, en la pantalla del link recién creado. En el celular abre la hoja de compartir del sistema. En escritorio abre un menú con Email, WhatsApp, Copiar link corto y Mostrar QR. El QR se genera en el navegador, sin enviar el link a ningún servicio externo.
• Documentación desde el menú lateral: nuevo ítem Documentación, visible en todos los planes, con dos entradas: las guías de docs.vu-one.com y la referencia de la API (Swagger).

​

Mejoras

• Compartir el link desde el QR hand-off en Android: a veces el link no se compartía ni se copiaba, y no aparecía ningún aviso. Ahora el link se copia antes de abrir la hoja de compartir. Si la hoja falla o se cancela, un mensaje confirma que el link quedó copiado. Si tampoco se pudo copiar, el link aparece en pantalla para copiarlo a mano.

​

v2.3.1

​

Mejoras

• Volver a pagar después de que vence la tarjeta: cargar un método de pago fallaba cuando la cuenta ya no tenía una tarjeta asociada. Ahora POST /billing/paymentMethod funciona sin tarjeta previa y, si la suscripción tiene una factura impaga, la cobra. Si el emisor rechaza el pago, la cuenta queda como estaba y el portal muestra el motivo.
• Mapa de ubicación del cliente: mostraba el aviso “Access blocked” de OpenStreetMap en lugar del mapa. Ahora el mapa carga.

​

v2.3.0

​

VU Cloud Services (muy pronto)

Estas funciones ya están en la plataforma y se habilitan cuando VU Cloud Services esté disponible para todas las cuentas. La documentación ya está publicada.

• Sección VU Cloud Services en el portal: nueva sección con el catálogo de servicios disponibles —ID Analysis, Face Analysis, Antispoofing Facial y Connection Fingerprint—, cada uno con su descripción, su precio y su documentación de integración, en español, inglés y portugués.
• Api-keys autogestionadas: alta, rotación, pausa y revocación de api-keys desde el portal, sin abrir un ticket. El secreto se muestra una sola vez, al crear la key o al confirmar la rotación. Connection Fingerprint se contrata con un comercial y no utiliza api-keys.
• Consumo por api-key: cada api-key tiene su pantalla de uso, con lo consumido, el límite del período de prueba, el saldo restante y su valorización. Durante el período de lanzamiento el consumo no se factura.
• Aviso al 80 % de la cuota: cuando una api-key supera el 80 % de su cuota, el titular de la cuenta recibe un correo con el servicio, el consumo y el límite. No hace falta seguir la pantalla de consumo para enterarse.
• Solicitud de contacto comercial desde el producto: disponible en el catálogo, en la pantalla de consumo y al agotarse el período de prueba. Es idempotente por compañía: una vez enviada la solicitud, una nueva pulsación devuelve la misma y no genera otra.

​

Cambios de comportamiento

• Bajar de plan o cancelarlo avisa antes de confirmar: la pantalla detalla qué integraciones dejan de estar disponibles y qué ocurre con cada api-key.

​

Mejoras

• iOS y el permiso de ubicación: a quien ya había rechazado la ubicación se le indicaba que el navegador había bloqueado el pedido, y en los flujos donde la ubicación es obligatoria quedaba sin salida. Ahora el mensaje explica la situación real y siempre hay camino de vuelta.
• Traductor automático del navegador: deformaba los textos del flujo de verificación. El flujo declara su idioma correctamente y el traductor lo respeta.
• Nombre de negocio en Configuración: la ficha de la empresa mostraba un identificador interno bajo la etiqueta “Id de Negocio”. Ahora la etiqueta dice Nombre de Negocio y muestra el nombre de la cuenta.
• Selector de idioma en el celular: vuelve a estar accesible en el inicio de sesión, el registro, la confirmación de e-mail y el encabezado del panel.
• Ajustes visuales del portal: tipografías que se veían distorsionadas, el menú lateral que se superponía en pantallas de ancho intermedio, la navegación en pantallas angostas, el mensaje de la solicitud de contacto y el acceso a una URL del portal sin sesión iniciada, que ahora lleva al inicio de sesión en lugar de a una pantalla vacía.

​

v2.2.1

​

Cambios

• Términos y Condiciones de usuario final y Política de Privacidad actualizados a su versión 2.1.
• Documentos legales en portugués: el flujo de verificación en portugués ya sirve los Términos y Condiciones y la Política de Privacidad en ese idioma.

​

v2.2.0

​

Nuevas funciones

• Flujo adaptativo: nuevo campo adaptiveFlow en POST /links que permite re-verificar a un cliente conocido solo con selfie, omitiendo la captura documental. Es un campo de tres estados: omitido aplica la configuración de la compañía, true y false la anulan para ese Link. Requiere externalUserId para tener efecto.
• Configuración de compañía linkConfig.adaptiveFlow: interruptor por compañía, desactivado por defecto, que define el comportamiento de los Links que no lo anulan explícitamente. Disponible en GET y PATCH /users/me/company.
• Rama resuelta en el Link: GET /links/{id} ahora devuelve adaptiveFlow con la rama ya resuelta (link.adaptiveFlow o la configuración de la compañía), no el valor de tres estados.
• PATCH /verifications/identify: nuevo endpoint público que permite a un Link adaptativo sin externalUserId recibir el email de la persona durante el flujo y volver a resolver la rama adaptativa.
• GET /verifications/{id}/related: nuevo endpoint autenticado que lista las demás verificaciones del mismo cliente (misma compañía y mismo externalUserId), de la más reciente a la más antigua, con el indicador dataExpired para las filas ya anonimizadas por retención.
• method en el polling de estado: GET /verifications/{id}/status?include=operationGuid ahora devuelve también method, con valores FACE (rama adaptativa) o DOCUMENT (flujo completo), o null mientras no se haya resuelto.
• Reglas de gateo en el Link: GET /links/{id} expone company.gateRules, un conjunto de reglas resuelto y de solo lectura que decide qué cohortes de dispositivos quedan gateadas, junto con defaultTemplateVersion, la versión de la plantilla global activa.
• locationPermission: nueva política, siempre resuelta en el servidor, con valores never, optional y required. Aparece en company.locationPermission dentro de GET /links/{id} y en verificationConfig.locationPermission de la compañía. Los planes FREE siempre resuelven a never.
• onboardingBusinessId restaurado: GET /users/me/company vuelve a incluir el identificador de negocio de la integración de onboarding, que se había retirado en el pentest #30. Settings tiene ahora una necesidad documentada de mostrarlo para soporte y depuración.
• POST /vuone/contact-request: nuevo endpoint para solicitar contacto comercial desde la propia cuenta. Es idempotente por compañía: una segunda pulsación devuelve la solicitud existente (200) en lugar de crear otra (201). Compañía, plan y cuota se derivan de la sesión autenticada, nunca del body.

​

Cambios de comportamiento

• linkId requerido en estado: GET /verifications/{id}/status es un endpoint público y ahora exige linkId como query param obligatorio. Omitirlo, o enviar uno que no corresponda a la verificación, devuelve 403.
• PATCH /verifications devuelve 404: si la verificación no existe o expiró, el endpoint devuelve 404 en lugar de 200 sin cambios.
• PATCH /verifications/error devuelve 404: igual que el punto anterior.
• PATCH /verifications devuelve 409: si el estado de la verificación no permite la operación solicitada, devuelve 409 en lugar de 200 sin cambios.
• PATCH /verifications/error devuelve 409: igual que el punto anterior.
• Validación estricta de geolocalización: tier, policy, ipDistanceKm y serverIp se derivan en el servidor y ya no se aceptan como entrada; enviarlos devuelve 400. Un capturedAt que se aparte más de 24 horas del reloj del servidor también devuelve 400.
• GET /billing/{idSubscription} devuelve 403: además de la falta de token, ahora también responde 403 cuando la suscripción no pertenece a la compañía del llamador.

​

Recomendación de migración

1. Añade linkId a todas tus llamadas a GET /verifications/{id}/status y quita el header Authorization: el endpoint es público.
2. Maneja los códigos 404 y 409 en PATCH /verifications y PATCH /verifications/error. En versiones anteriores a 2.2.0 respondían 200 incluso cuando no realizaban ninguna acción.
3. Revisa tu cliente de geolocalización: mueve todos los campos dentro del objeto geolocation y deja de enviar los campos derivados en el servidor.
4. Si vas a usar el flujo adaptativo, asegúrate de enviar externalUserId al crear el Link o de invocar PATCH /verifications/identify durante el flujo.

​

v2.1.0

​

Nuevas funciones

• Reporte de geolocalización: endpoint PATCH /verifications (público, sin autenticación) para que el cliente reporte la ubicación del dispositivo durante el flujo de verificación.
• Objeto VerificationGeolocation: estructura completa de geolocalización con ip, accuracyRadius (km), latitude/longitude (derivados de IP, tipo string), country, city, subdivisions, accuracy (metros, del dispositivo), source (gps/wifi/cell/ip/none), tier (precise/approximate/coarse/unknown, derivado del servidor), permission (granted/denied/prompt), capturedAt, deviceLatitude/deviceLongitude (números, cuando hay fix del dispositivo).
• Campos de geolocalización autenticados: GET /verifications/{id} y similares exponen policy, ipDistanceKm y serverIp cuando se consultan con autenticación. Estos campos nunca aparecen en las respuestas públicas ni en los webhooks.
• Polling ligero con operationGuid: GET /verifications/{id}/status acepta ?include=operationGuid para devolver un objeto en lugar del string de estado.
• Inferencia de origen: el campo source se infiere entre gps, wifi y cell según la precisión y los datos del dispositivo.
• handoffMode en compañía: el objeto de compañía incluye handoffMode (never, suggest, require) para controlar el traspaso entre dispositivos.

​

Mejoras

• Respuestas de error más descriptivas para solicitudes de geolocalización inválidas.
• Validación estricta de coordenadas del dispositivo cuando source es gps, wifi o cell.

​

v2.0.x y anteriores

​

Funcionalidad base

• Creación y gestión de enlaces de verificación (POST /links, GET /links, GET /links/{id}).
• Flujos de verificación FULL FLOW (captura de documento + prueba de vida) e ID ONLY (solo documento).
• Consulta de verificaciones con datos extraídos por OCR (GET /verifications, GET /verifications/{id}, GET /verifications/{id}/status).
• Webhooks para notificaciones en tiempo real de eventos del ciclo de vida de verificación.
• Gestión de usuarios (GET /users/me, PATCH /users/me) y compañías (GET /users/me/company, PATCH /users/me/company).
• Carga de logo de marca (POST /users/me/company/logo).
• Estadísticas de uso y cuotas (GET /users/me/stats).
• Logs de actividad paginados (GET /users/me/logs).
• Gestión de endpoints de webhook (GET /webhook-endpoints, POST /webhook-endpoints, GET/PATCH/DELETE /webhook-endpoints/{id}).
• Verificaciones de la última hora (GET /verifications/last-hour).
• Paginación de verificaciones (GET /verifications/{size}/{page}).
• Imágenes de verificación (GET /verifications/{verificationId}/images, GET /verifications/images/{id}).
• Feedback manual de verificaciones (POST /verifications/feedback, GET /verification-feedback/reasons).
• Facturación (POST /billing/paymentMethod, GET /billing/{idSubscription}).
• Verificación de estado del servicio (GET /health/status).