Saltar al contenido principal

Verificación silenciosa

La Verificación silenciosa permite que una identidad recurrente, previamente validada, complete una transacción de Verificación de Tarjeta No Presente sin una pantalla de captura visible. En lugar de pedirle al usuario una nueva selfie, la tecnología de Unico evalúa señales y recurrencia en segundo plano para decidir si la transacción puede aprobarse de forma silenciosa.

La Verificación silenciosa no es un producto separado — es un paso adicional sobre el mismo flujo de creación de transacciones descrito en Transacciones de pago y en Onboarding de tarjeta de crédito. Recopilar señales de contexto con el SDK y enviar esa misma clave externa al crear la transacción es lo que habilita la posibilidad de una aprobación silenciosa.

Cuándo aplica
  • La Verificación silenciosa aplica cuando hay suficiente historial para que la tecnología de Unico evalúe la identidad mediante señales.
  • Cuando esa evaluación no es posible — por falta de historial o por otras razones — la transacción recurre al flujo visual estándar. Esto puede ocurrir, por ejemplo, la primera vez que se ve una identidad determinada en la red.
1. Recopila los metadatos del dispositivo con el SDK

Instala e inicializa el SDK de Captura para tu plataforma como de costumbre — la Verificación silenciosa no cambia esa configuración. Sigue la guía de Recopilación de Datos de Monitoreo de la plataforma para enviar externalUserId:

información

Flutter aún no es compatible con la Verificación silenciosa.

Esto no es solo un metadato de observabilidad aquí

Las guías de Recopilación de Datos de Monitoreo describen externalUserId como telemetría opcional que "no cambia el comportamiento de captura del SDK ni la respuesta de la API". Eso es cierto para el SDK por sí solo. En Verificación de Tarjeta No Presente, este mismo campo es lo que el backend usa para decidir si la transacción puede aprobarse silenciosamente. Enviarlo es lo que habilita la Verificación silenciosa para esa transacción — aquí no es inerte.

Se requieren dos ajustes en la configuración de captura estándar para mantener el flujo silencioso:

  • Móvil (Android / iOS): usa la sobrecarga de prepareCamera / prepareSelfieCamera que recibe un objeto PrepareInfo con externalUserId, y no llames al método de apertura de cámara dentro del callback de éxito — a menos que realmente quieras el flujo visual completo para esa sesión.
unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
        // No es necesario llamar a cameraOpener?.open() aquí — la recopilación en segundo plano ya comenzó.
    }
    override fun onCameraFailed(message: String?) { /* handle error */ }
}, PrepareInfo("YOUR_EXTERNAL_USER_ID"))
  • Web: llama a setSilentInfo(externalUserId, useCase) en la instancia de UnicoCheckBuilder antes de llamar a prepareCamera / prepareSelfieCamera, y de igual manera evita abrir la cámara en el callback de éxito.
unicoCamera.setSilentInfo("YOUR_EXTERNAL_USER_ID");
await unicoCamera.prepareSelfieCamera(config, SelfieCameraTypes.SMART);
// No es necesario abrir la cámara aquí — la recopilación en segundo plano ya comenzó.
Ventana de tiempo

El SDK recopila datos en segundo plano, así que debe haber un intervalo mínimo antes de crear la transacción:

  • Inicia la preparación del SDK al menos 4 segundos antes de llamar a la API de transacción — si es demasiado pronto, la recopilación puede no haber finalizado.
  • Los datos recopilados son válidos durante hasta 5 minutos — si es demasiado tarde, habrán expirado para cuando se cree la transacción.
2. Crea la transacción con el mismo externalUserID

externalUserID es opcional — pero sin él, la Verificación silenciosa no puede ocurrir para esa transacción. Al crear la transacción — mediante Transacciones de pago o Onboarding de tarjeta de crédito — envía el mismo externalUserID usado en el SDK, dentro de additionalInfo:

{
  "additionalInfo": {
    "externalUserID": "YOUR_EXTERNAL_USER_ID"
  }
}

Omitirlo no causa ningún error — la transacción igualmente se crea con normalidad, simplemente siempre sigue el flujo estándar con fricción visual.

3. Gestiona la respuesta

Si la transacción califica y se aprueba silenciosamente, no se necesita ninguna otra acción:

{
  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
  "status": "approved"
}

De lo contrario, la respuesta incluye un link para completar el flujo visual estándar, exactamente igual que una transacción creada sin Verificación silenciosa:

{
  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
  "status": "waiting",
  "link": "https://aces.so/example",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cC[...]Ok6yJV_adQssw5c"
}

Para cualquier otro estado, sigue el flujo estándar usando el link devuelto — consulta Control de la experiencia y Enumerados para ver la lista completa de estados.

Última actualización el