---
title: "Cancelar un retiro"
method: POST
path: "/withdrawals/{id}/cancel"
tags: ["withdrawals"]
deprecated: true
---

# Cancelar un retiro

`POST /withdrawals/{id}/cancel`

> **Deprecated.**

> **Obsoleto:** usa el endpoint unificado [`POST /transfers/{id}/cancel`](/api-reference/transfers/cancelar-un-movimiento), que acepta IDs `wi_`. Este endpoint sigue funcionando para integraciones existentes.

Cancela un retiro que aún puede cancelarse (pendiente, o aprobado sin lote).

## Path parameters

- `id` string, required

## Headers

- `X-SECRET-KEY` string, required

## Response `200`

Retiro cancelado

- Withdrawal — Retiro bancario asíncrono. Para retiros locales, `sent` es un estado terminal exitoso; no esperes `completed` para continuar tu flujo. `completed` puede aparecer como confirmación adicional en retiros históricos o rails que la reportan.
  - `id` string
  - `status` 'pending' | 'approved' | 'in_review' | 'review_requested' | 'sent' | 'completed' | 'rejected' | 'cancelled'
  - `amount_in_cents` integer
  - `currency` string
  - `bank_name` string
  - `note` string, nullable — Nota del retiro
  - `created_at` string, date-time
  - `bank_account` BankAccount
    - `id` string — ID único de la cuenta bancaria
    - `bank_name` string, nullable — Nombre del banco
    - `holder_name` string — Nombre del titular
    - `created_at` string, date-time — Fecha de creación
    - `status` 'active' | 'archived' — Estado de la cuenta bancaria
    - `currency` 'GTQ' | 'USD' — Moneda de la cuenta bancaria
    - `account_type` 'checking' | 'savings' — Tipo de cuenta bancaria
    - `is_preferred` boolean — Indica si es la cuenta preferida para su moneda
    - `ownership_type` 'external' | 'virtual' — Tipo de cuenta bancaria

## Other responses

- `422` — El retiro ya no puede cancelarse

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) · [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recurrente/referencia-api/revisions/f494a078482c/schema)