Validación Fallida

signer_authentication_failed (ejemplo)

Este evento del webhook se dispara cuando el firmante alcanza el máximo permitido de intentos (generalmente 3) para validar su identidad utilizando los métodos disponibles en Firmeasy:
Reconocimiento Facial o Validación de Identidad.

Cuando se recibe esta notificación, significa que el firmante no puede continuar con el proceso de firma electrónica hasta que tú, como cliente, tomes una acción para desbloquear o reasignar el flujo.

---

Acciones posibles que puede realizar el cliente

• Cambiar el método de autenticación: puedes utilizar el endpoint Actualizar firmante para definir otro método alternativo, como validación por OTP o email.

• Reintentar validación: puedes usar el endpoint correspondiente para reiniciar los intentos. El firmante recibirá una nueva oportunidad para autenticarse.

Consejo

Estos ajustes permiten que el proceso continúe sin reiniciar el documento, mejorando la experiencia del usuario y reduciendo fricciones.

---

event_type: "signer_authentication_failed"

Ejemplo de payload

{
  "event_type": "signer_authentication_failed",
  "sandbox": false,
  "token": "514ca933-f995-443f-b940-7e82ee5f7c5",
  "name": "Documento ejemplo",
  "created_by": { "email": "[email protected]" },
  "signers": [
    {
      "name": "Silvana Alvarez",
      "email": "[email protected]",
      "auth_mode": "assinaturaTela",
      "selfie_validation_type": "identity-verification-global"
    }
  ],
  "unauthenticated_signer": {
    "name": "Paula Ochoa",
    "email": "[email protected]",
    "max_attempts": 2,
    "attempts_used": 2,
    "authentication_failure_reason": "Validación fallida por intento de suplantación utilizando pantalla"
  }
}