Skip to content
FirmEasy
← Inicio

Validation Failed

signer_authentication_failed (example)

This webhook event is triggered when the signer reaches the maximum allowed attempts (usually 3) to validate their identity using the available methods in Firmeasy:
Facial Recognition or Identity Validation.

When this notification is received, it means the signer cannot continue with the electronic signing process until you, as the client, take action to unblock or reassign the flow.

Possible actions the client can take

Section titled “Possible actions the client can take”

  • Change the authentication method: you can use the Update signer endpoint to set another alternative method, such as OTP or email validation.

  • Retry validation: you can use the corresponding endpoint to reset the attempts. The signer will receive a new opportunity to authenticate.

event_type: "signer_authentication_failed"

Section titled “event_type: "signer_authentication_failed"”

Payload example

Section titled “Payload example”
{
  "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"
  }
}