Cancelar solicitud

PUT

https://api.dev-firmaseguraec.com/signature/request/cancel

Última modificación:2026-07-13 14:01:44

Anula una solicitud de firma electrónica del flujo simplificado antes de que se genere el certificado p12. Está pensado para que el aliado, desde su integración, cancele una solicitud previamente registrada que aún se encuentra en proceso.

La cancelación se identifica mediante uno de dos parámetros de consulta (referenceTransaction o requestId) y debe enviarse exactamente uno de ellos. Solo pueden cancelarse las solicitudes que todavía no han alcanzado un estado final.

CONSEJO

Debe proporcionarse exactamente un identificador: referenceTransaction o requestId. Si se envían ambos o ninguno, la solicitud se rechaza con un error 400.

ADVERTENCIA

Una solicitud que ya se encuentra en un estado final (por ejemplo COMPLETADO, EXPIRADO o ERROR) no puede cancelarse; en ese caso se retorna un error 409.

Solicitud

Autorización

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros de consulta

Respuestas

🟢204Éxito

La solicitud fue cancelada correctamente. La respuesta no incluye cuerpo.

Esta respuesta no tiene un body.

🟠400Bad Request

🟠409Conflict

🟠404Not Found

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.dev-firmaseguraec.com/signature/request/cancel?referenceTransaction=REFERENCE-TRANS-001' \
--header 'Authorization: Bearer <token>'

Ejemplo de Respuesta

400 - Solicitud incorrecta

{
    "timestamp": "2026-06-19T12:57:25.700023139-05:00",
    "status": 400,
    "error": "Bad Request",
    "message": "Debe proporcionar exactamente un identificador: requestId o referenceTransaction",
    "path": "/request/cancel"
}

Modificado en 2026-07-13 14:01:44

Consultar estado

Flujo Por API