Saltar al contenido principal
POST
Cancelar una Transferencia

Autorizaciones

Authorization
string
header
requerido

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

X-Organization-Id
string<uuid>
requerido

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.

X-Idempotency
string
requerido

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.

Maximum string length: 255

Parámetros de ruta

transferId
string<uuid>
requerido

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.

transferId
string<uuid>
requerido
Ejemplo:

"019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d"

status
enum<string>
requerido
Opciones disponibles:
CANCELLED
Ejemplo:

"CANCELLED"

cancelledAt
string<date-time>
requerido
Ejemplo:

"2026-02-01T15:35:00-03:00"