Eventos webhook

Los eventos enviados mediante webhook se generan en distintas etapas del proceso. Cada evento incluirá la información correspondiente según el estado alcanzado.

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 una solicitud de firma bajo el modelo de Tercero Vinculado.

Evento: Respuesta Exitosa

Se genera cuando el certificado es emitido exitosamente.

Ejemplo:

{
    "referenceTransaction": "TRANS-TEST-00010",
    "file": "MIACAQMwgAYJKoZIhvcNAQcB...",
    "password": "8g9qUSss",
    "serialNumber": "FEEB75BBD543D1A0372EDC35B6EAE364"
}

Evento: Respuesta de Error

Se genera cuando ocurre un error durante el proceso, ya sea en la validación, generación del certificado o en la integración con algún servicio externo.

Ejemplo:

{
    "linkedPartnerRequestId": "c20d731f-b22a-4695-8ecf-ffd43533b044",
    "referenceTransaction": "TRANS-TEST-00010",
    "message": "Connection refused: no further information POST http://localhost:7520/request/legal-representative?validityPresenter=TWO_YEARS&requestId=c20d731f-b22a-4695-8ecf-ffd43533b044"
}

Evento: Respuesta de Error y Solicitud Rechazada

Se genera cuando se utiliza el endpoint de Reintento de Proceso y se superan los dos (2) intentos permitidos sin que sea posible emitir la firma.

En este caso, la solicitud queda automáticamente rechazada y se notificará mediante el webhook correspondiente.

Ejemplo:

{
    "linkedPartnerRequestId": "c20d731f-b22a-4695-8ecf-ffd43533b044",
    "referenceTransaction": "TRANS-ONE-00103",
    "status": "REFUSED",
    "message": "Límite de reintentos alcanzado, por favor realice otra solicitud: Connection refused: no further information  POST http://localhost:7520/request/legal-representative?validityPresenter=TWO_YEARS&requestId=c20d731f-b22a-4695-8ecf-ffd43533b044"
}

Evento: Respuesta Exitosa#

Evento: Respuesta de Error#

Evento: Respuesta de Error y Solicitud Rechazada#

Evento: Respuesta Exitosa

Evento: Respuesta de Error

Evento: Respuesta de Error y Solicitud Rechazada