1. Flujo simplificado
Firmasegura
  • Inicio
    • Introducción
    • Autenticación
  • Firmas Regulares
    • Firmas Regulares
    • Registrar solicitud
      POST
    • Consulta de estado de solicitud
      GET
    • Corrección de código dactilar y/o adjuntos
      PATCH
    • Schemas
      • RequestResult
      • RequestStatusValidation
      • RevocationRequest
  • Firmas Transaccionales
    • Firmas Transaccionales
    • Eventos webhook
    • Registrar solicitud
      POST
    • Consulta estado de validación
      GET
    • Obtención de certificado y resultados
      GET
    • Schemas
      • TransactionalSignatureValidationStatus
      • TransactionalSignatureProcessResult
  • Tercero Vinculado
    • Tercero Vinculado
    • Eventos webhook
    • Registrar solicitud
      POST
    • Reintentar proceso de generación
      POST
    • Cancelación de solicitud
      POST
    • Reenviar correo para reclamar certificado
      POST
    • Consultar estado de solicitud
      GET
    • Schemas
      • LinkedPartnerRequest
      • LinkedPartnerResult
      • linkedPartnerRequest
      • RAIZ
  • Flujo simplificado
    • Introducción
    • Eventos Webhook
    • Registrar solicitud
      POST
    • Consultar estado
      GET
  • Flujo por API
    • Flujo Por API
    • Consulta de TyC
    • Solicitud de Firma
    • Validación de Identidad
    • Solicitud de FaceLiveness
    • FaceLiveness
    • Emisión
    • Schemas
      • ApiError
  • Recursos Adicionales
    • Lista de ciudades y provincias
    • Lista de periodos de firmas
    • Lista de estados de revocación
    • Lista de estados de solicitud FR
    • Lista de tipos de solicitud FR
    • Estados de validación de solicitudes FR
    • Tipos de validación de solicitudes FR
    • Códigos de error de validación FR
    • Lista de estados de solicitud FT
    • Lista de estados de validacion FT
    • Lista de tipos de validación FT
    • Lista de tipos de Certificado TV
    • Lista de estados de solicitud TV
    • Tipo de Evidencias TV
    • Lista de Estados de FS
    • Tipos de Solicitudes
  1. Flujo simplificado

Eventos Webhook

Los eventos enviados mediante webhook se generan en distintas etapas del proceso. Cada evento incluye los datos correspondientes según el estado alcanzado.
INFORMACIÓN
Para recibir webhooks, se debe proporcionar la URL en el campo callbackUrl, donde se enviarán los eventos mediante http POST. Este campo se especifica al momento de registrar la solicitud de firma de flujo simplificado.

Flujo de Validación#

El proceso de firma tradicional contempla las siguientes etapas:
1
Registro Civil
Se valida la información del solicitante contra el Registro Civil.
2
Inicio de Sesión
El solicitante inicia la sesión de firma con sus credenciales.
3
Prueba de Vida (Liveness)
El solicitante realiza una prueba de vida para la verificación biométrica de identidad.
4
Contraseña y Confirmación de Datos
El solicitante define su contraseña y confirma que sus datos estan correctos previo a la generación del certificado de firma electrónica.
5
Emisión del Certificado
Se genera el certificado de firma electrónica y se le da la opción al solicitante de descargarlo.
6
Contrato y Envío
Se genera el contrato y se envía al solicitante el certificado y el contrato a través de su correo electrónico. Este proceso se realiza de manera asincrónica luego de generarse el certificado de firma electrónica.

Eventos#

A continuación, se describen los eventos enviados por webhook durante el proceso.

SESSION_COMPLETED#

Se emite cuando el proceso de firma tradicional ha concluido exitosamente en todas sus etapas.
{
  "sessionId": "b3f1a2d4-7c8e-4f0a-9b2d-1e3c5f7a9b0d",
  "event": "SESSION_COMPLETED"
}

SESSION_REJECTED#

Se emite cuando la sesión es rechazada de forma definitiva por una regla de negocio. No es posible continuar el proceso; se debe generar una nueva solicitud.
{
    "sessionId": "b3f1a2d4-7c8e-4f0a-9b2d-1e3c5f7a9b0d",
    "event": "SESSION_REJECTED",
    "errorCode": "FACE_LIVENESS_EXHAUSTED",
    "message": "Se agotaron todos los intentos de verificación facial, la solicitud ha sido rechazada, por favor genera una nueva"
}
Los posibles valores de errorCode para este evento son:
errorCodeDescripción
FACE_LIVENESS_EXHAUSTEDSe agotaron todos los intentos de verificación biométrica
DATA_REJECTED_BY_USEREl titular rechazó sus datos personales
OTP_TOTAL_LIMIT_EXCEEDEDSe superó el límite máximo de intentos de verificación de correo

SESSION_ERROR#

Se emite cuando ocurre un error técnico en una etapa del proceso. La sesión queda en estado de error; dependiendo del caso puede reintentarse la tarea fallida.
{
    "sessionId": "b3f1a2d4-7c8e-4f0a-9b2d-1e3c5f7a9b0d",
    "event": "SESSION_ERROR",
    "errorCode": "CERTIFICATE_GENERATION_FAILED",
    "message": "No pudimos generar tu certificado digital, por favor intenta de nuevo"
}
Los posibles valores de errorCode para este evento son:
errorCodeDescripción
PASSWORD_ENCRYPTION_FAILEDError al procesar la contraseña del solicitante
CERTIFICATE_GENERATION_FAILEDError al generar el certificado de firma electrónica
CONTRACT_GENERATION_FAILEDError al generar la documentación del contrato
SEND_FAILEDError al enviar los documentos al solicitante
NOTA
Los errores corregibles por el usuario (código OTP incorrecto, contraseña débil, obstrucción en selfie, etc.) no generan webhook. Solo se notifican los eventos que representan un cambio de estado definitivo de la sesión.
Modificado en 2026-04-08 05:59:23
Anterior
Introducción
Siguiente
Registrar solicitud
Built with