> For the complete documentation index, see [llms.txt](https://docs.zapsign.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zapsign.com.br/espanol/webhooks/eventos/signer/authentication_failure.md). # Validación Fallida Este evento del webhook se dispara cuando el firmante alcanza el máximo permitido de intentos (3 intentos) para validar su identidad utilizando los métodos de autenticación disponibles en ZapSign: Reconocimiento Facial y 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 el cliente tome una acción. ### Acciones posibles que puede realizar el cliente: * Cambiar el método de autenticación: Utilizar el endpoint [Actualizar firmante](/espanol/firmantes/atualizar-signatario.md) para cambiar el método de autenticación por uno alternativo (por ejemplo, OTP por SMS o email). * [Reiniciar intentos de validación: ](/espanol/firmantes/reset-signer-attempts.md)Con éste endpoint el firmante tendrá tres nuevos intentos para realizar la validación. Este evento permite que el cliente tome decisiones oportunas y rápidas para asegurar la continuidad y la seguridad del proceso de firma electrónica. {% hint style="warning" %} En la respuesta el parámetro `authentication_failure_reason` explica la razón de falla de la validación {% endhint %} ```json { "sandbox": false, "external_id": "", "open_id": 256, "token": "514ca933-f995-443f-b940-7e82ee5f7c5", "name": "Documento ejemplo", "folder_path": "/", "status": "pending", "rejected_reason": null, "lang": "en", "original_file": "https://zapsign.s3.amazonaws.com/dev/2025/3/docs/92b22e27-b091-4398-940d-6d9976ecdbed/b3871a48-2636-4562-9919-e9dae326db55.pdf?AWSAccessKeyId=AKIASUFZJ7JCTI2ZRGWX&Signature=h7Fab%2F%2F1TggGxgbztlXaDcrxHCg%3D&Expires=1742339713", "signed_file": null, "extra_docs": [], "created_through": "web", "deleted": false, "deleted_at": null, "signed_file_only_finished": false, "disable_signer_emails": false, "brand_logo": "", "brand_primary_color": "", "created_at": "2025-03-18T22:12:37.843154Z", "last_update_at": "2025-03-18T22:12:37.843171Z", "created_by": { "email": "silvana@zapsign.com.br" }, "template": null, "signers": [{ "external_id": "", "sign_url": "https://app.zapsign.com.br/verificar/8XX394fa-cXXX48c2-8d50-2935f5XXX363", "token": "821394fa-c7af-48c2-8d50-2935f5f39363", "status": "link-opened", "name": "Silvana Alvarez", "lock_name": false, "email": "email@email.com", "lock_email": false, "hide_email": false, "blank_email": false, "phone_country": "55", "phone_number": "", "lock_phone": false, "hide_phone": false, "blank_phone": true, "times_viewed": 1, "last_view_at": "2025-03-18T22:12:45.255310Z", "signed_at": null, "auth_mode": "assinaturaTela", "qualification": "", "require_selfie_photo": false, "require_document_photo": false, "geo_latitude": null, "geo_longitude": null, "redirect_link": "", "signature_image": null, "visto_image": null, "document_photo_url": "", "document_verse_photo_url": "", "selfie_photo_url": "", "selfie_photo_url2": "", "send_via": "", "resend_attempts": null, "cpf": "", "cnpj": "", "send_automatic_whatsapp_signed_file": null, "liveness_photo_url": "", "selfie_validation_type": "identity-verification-global", "ip": null }], "answers": [], "auto_reminder": 0, "signature_report": null, "tsa_country": null, "use_timestamp": true, "metadata": [], "event_type": "signer_authentication_failed", "unauthenticated_signer": { "external_id": "", "sign_url": "https://app.zapsign.com.br/verificar/8XX394fa-cXXX48c2-8d50-2935f5XXX363", "token": "821394fa-c7af-48c2-8d50-2935f5f39363", "status": "link-opened", "name": "Paula Ochoa", "lock_name": false, "email": "email@email.com", "lock_email": false, "hide_email": false, "blank_email": false, "phone_country": "55", "phone_number": "", "lock_phone": false, "hide_phone": false, "blank_phone": true, "times_viewed": 1, "last_view_at": "2025-03-18T22:12:45.255310Z", "signed_at": null, "auth_mode": "assinaturaTela", "qualification": "", "require_selfie_photo": false, "require_document_photo": false, "geo_latitude": null, "geo_longitude": null, "redirect_link": "", "signature_image": null, "visto_image": null, "document_photo_url": "", "document_verse_photo_url": "", "selfie_photo_url": "", "selfie_photo_url2": "", "send_via": "", "resend_attempts": null, "cpf": "", "cnpj": "", "send_automatic_whatsapp_signed_file": null, "liveness_photo_url": "", "selfie_validation_type": "identity-verification-global", "ip": null, "max_attempts": 2, "attempts_used": 2, "authentication_failure_reason": "Unsuccessful validation of Paola Ochoa due to Attempted deceit, device screen used" } } ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.zapsign.com.br/espanol/webhooks/eventos/signer/authentication_failure.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.