Cancelar una Transferencia
Utilice este endpoint para cancelar una transferencia que aún no ha sido enviada para procesamiento. Solo las transferencias en estado CREATED o PENDING pueden ser canceladas. Cancelar una transferencia libera los fondos retenidos en Midaz y establece el estado en CANCELLED. Llamar a cancelar en una transferencia ya cancelada devuelve éxito.
Este endpoint no recibe cuerpo de solicitud — la transferencia se identifica únicamente mediante el parámetro de ruta.
Autorizaciones
Autenticación mediante token JWT Bearer. El tenantId se deriva del token bearer o del contexto autenticado de la solicitud y no se proporciona a través de X-Organization-Id.
Encabezados
Alcance de organización Midaz para la solicitud, utilizado para las llamadas posteriores a CRM, Fees y Midaz. Es obligatorio en las rutas de transferencia con alcance de organización en todos los modos de despliegue; un valor faltante o que no sea un UUID devuelve 400. Este no es el identificador del tenant — el tenantId se deriva del JWT bearer o del contexto autenticado, nunca de este header. Los workers en segundo plano (poller de TED IN, conciliación) no tienen header de solicitud y, en modo single-tenant, recurren a la variable de entorno ORGANIZATION_ID del despliegue.
Clave de idempotencia requerida para reintentos seguros. Utilice un UUID v4 o un identificador de negocio único. Si se envía la misma clave nuevamente y la solicitud original ya fue procesada, se devuelve la respuesta almacenada en caché.
Consulte Reintentos e idempotencia para más detalles.
255Parámetros de ruta
El identificador único de la transferencia a cancelar.
Respuesta
Indica que la transferencia fue cancelada exitosamente y los fondos fueron liberados.
Las llamadas repetidas con la misma clave X-Idempotency reproducen la respuesta en caché.
Consulte Reintentos e idempotencia para más detalles.

