1. Firmas Transaccionales
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. Firmas Transaccionales

Eventos webhook

Webhooks - Firma Transaccional#

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. Este campo se especifica al momento de registrar la solicitud de firma transaccional.

Flujo de Validación#

El proceso de firma transaccional contempla las siguientes etapas:
1
Registro Civil
Se valida la información del solicitante contra el Registro Civil.
2
Prueba de Vida (Liveness)
El solicitante realiza una prueba de vida para la verificación biométrica de identidad.
3
Generación de Certificado
Una vez aprobadas las validaciones, se genera el certificado de firma electrónica.

Eventos#

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

REGISTERED - Inicio de Validación#

Se genera cuando el solicitante ha iniciado el proceso de validación.
Ejemplo de respuesta
CampoTipoDescripción
responseIntegerCodigo de respuesta HTTP
referenceTransactionStringReferencia única de la transacción proporcionada por el partner
statusStringEstado del evento: REGISTERED
responseDateStringFecha y hora del evento. Formato: yyyy-MM-dd HH:mm:ss (America/Guayaquil)

ERROR - Error en el Proceso de Validación#

Se genera cuando falla alguna etapa del proceso de validación.
Ejemplo de respuesta
CampoTipoDescripción
responseIntegerCódigo de respuesta HTTP del error (ej: 400, 500)
referenceTransactionStringReferencia única de la transacción proporcionada por el partner
statusStringEstado del evento: ERROR
responseDateStringFecha y hora del evento. Formato: yyyy-MM-dd HH:mm:ss (America/Guayaquil)
errorStringMensaje descriptivo del error

Errores posibles#

A continuación, se detallan los posibles mensajes que pueden recibirse en el campo error, agrupados por categoría.
Validación
Sesión y Solicitud
Errores Internos
Errores relacionados con la validación del solicitante.
MensajeHTTPDescripcion
La validación de prueba de vida ha fallado412El solicitante no superó la prueba de vida
La validación biométrica ha fallado400La comparación biométrica no fue exitosa
Se detectó un objeto que obstruye el rostro en la imagen412La imagen de prueba de vida contiene obstrucciones
Se han agotado los intentos de validación. La solicitud ha sido rechazada412Se superó el número máximo de intentos permitidos
El número de identificación no existe en el Registro Civil409La cédula proporcionada no fue encontrada

GENERATED - Certificado Generado#

Este evento se genera cuando el proceso de validación finaliza exitosamente. Incluye el certificado emitido junto con los resultados de validación.
CONSEJO
El certificado se encuentra en el campo indicator.metadata.result.certificate, codificado en Base64.
La contraseña del certificado está disponible en indicator.metadata.result.password.
Ejemplo de respuesta
Campos Principales
Objeto data
Objeto indicator
CampoTipoDescripción
responseIntegerCódigo de respuesta HTTP: 200
referenceTransactionStringReferencia única de la transacción
statusStringEstado del evento: GENERATED
responseDateStringFecha y hora del evento. Formato: yyyy-MM-dd HH:mm:ss (America/Guayaquil)

Resumen de Estados#

EstadoDescripción
REGISTEREDEl solicitante ha iniciado el proceso de validación
ERRORHa ocurrido un error durante el proceso de validación
GENERATEDEl certificado ha sido generado exitosamente
NOTA
El score de confianza (indicator.confidence) se calcula sobre dos validaciones: documento vigente (currentDocument) y prueba de vida (selfie).
Un resultado exitoso tendrá un valor de "2/2".
Modificado en 2026-02-25 16:20:41
Anterior
Firmas Transaccionales
Siguiente
Registrar solicitud
Built with