> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.recurrente.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.recurrente.com/_mcp/server. # Cancelar un movimiento POST https://app.recurrente.com/api/transfers/{id}/cancel Cancela un movimiento que aún puede cancelarse: una transferencia a teléfono no reclamada (`tr_`), o un retiro pendiente que no ha entrado a un lote de pago (`wi_`). Los envíos de stablecoin (`sw_`) no se pueden cancelar. Reference: https://docs.recurrente.com/referencia-api/api-reference/transfers/cancel-transfer ## Authentication - `X-SECRET-KEY` header (required) — Tu clave secreta de API. Una llave de cuenta (`sk_live_...`, `sk_test_...`) opera sobre su propia cuenta y, con `X-ACCOUNT-ID`, sobre sus cuentas conectadas. La llave también fija el ambiente: una `sk_test_` solo lista y resuelve objetos de prueba (`live_mode: false`) y una `sk_live_` solo objetos reales. Un ID del otro ambiente responde `404` (`401` en `/customers`). Una llave de organización (`sk_org_live_...`, `sk_org_test_...`) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con `X-ACCOUNT-ID`; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde `403` con `code: organization_key_unsupported`. ## Request ### Path parameters - `id` (string, required) ## Response ### 200 Movimiento cancelado - `id` (string, optional) — ID del movimiento (tr_ / wi_ / sw_) - `status` (enum, optional) — Estado canónico del movimiento - Allowed values: `pending`, `in_review`, `processing`, `sent`, `unclaimed`, `completed`, `failed`, `cancelled` - `status_detail` (string, optional) — Estado crudo del registro subyacente (p. ej. `approved`, `rejected`, `review_requested`) - `amount_in_cents` (integer, optional) — Monto en centavos debitado del balance - `currency` (string, optional) — Moneda del balance de origen - `fee_in_cents` (integer, optional) — Comisión en centavos (retiros instantáneos / internacionales; 0 para p2p) - `net_amount_in_cents` (integer, optional) — Monto neto que llega al destino después de comisiones - `note` (string, optional, nullable) — Nota del movimiento - `recipient_email` (string, optional, nullable) — Correo del beneficiario al que le avisamos el estado del retiro. Solo aplica a movimientos `wi_`. - `tracking_url` (string, optional, nullable) — Página pública de seguimiento para el beneficiario (monto que recibe, cuenta enmascarada, estado y fecha estimada de llegada). Solo aplica a movimientos `wi_`; compártela con quien recibe el dinero. - `account_id` (string, optional) — Cuenta cuyo balance movió este envío. Siempre presente, para que una lista que abarca varias cuentas de una organización siga siendo atribuible. - `sent_at` (datetime, optional, nullable) — Momento en que Recurrente envió el retiro al banco; solo aplica a retiros bancarios (`wi_`). - `settled_at` (datetime, optional, nullable) — Momento de liquidación bancaria confirmada. Solo está presente para retiros bancarios confirmados o completados (`wi_`). - `bank_reference` (string, optional, nullable) — Referencia que devolvió el riel de envío, cuando ese riel devuelve una. Solo aplica a movimientos `wi_`; no identifica ni enumera transacciones que conformen el retiro. - `bank_reference_status` (enum, optional, nullable) — Qué esperar de `bank_reference`: `available` si ya existe, `pending` si el retiro aún no sale y podría traerla, y `unsupported` si ya salió por un riel que nunca devuelve una. Con `unsupported`, concilia el depósito por `statement_descriptor`. - Allowed values: `available`, `pending`, `unsupported` - `statement_descriptor` (string, optional, nullable) — Lo que le pedimos al banco que imprima en el estado de cuenta del beneficiario. Solo aplica a movimientos `wi_`. Es el id `wi_`, o la `note` seguida del id cuando caben en 30 caracteres; si la nota sola llena el espacio, no incluye el id. Se fija al crear el retiro. En destinos internacionales es siempre el id, porque esos rieles todavía no llevan referencia. - `balance_transaction_id` (string, optional, nullable) — Fila del ledger que registró este movimiento (`GET /api/balance_transactions/{id}`). Vacío mientras el dinero no haya salido del balance. - `destination` (TransferDestination, optional) — Destino del movimiento. Los campos presentes dependen de `type`. - `currency_conversion` (CurrencyConversion, optional, nullable) — (Solo registros wi_) La conversión que pagó el retiro cuando el balance de origen está en otra moneda que la cuenta bancaria (por ejemplo, de tu balance en USD a una cuenta en GTQ). `source_amount_in_cents` es lo que salió de tu balance; `amount_in_cents` del retiro es lo convertido. `null` si no hubo conversión. Si el retiro se rechaza o se cancela dentro de las 72 horas, la conversión pasa a `reverted` y el monto vuelve a tu balance en la moneda de origen. - `created_at` (datetime, optional) — Fecha de creación - `sender` (TransferSender, optional) — (Solo registros tr_) Cuenta emisora — campo legado - `recipient` (TransferRecipient, optional) — (Solo registros tr_) Destinatario — campo legado - `reversal_of_id` (string, optional) — ID del transfer original; solo aparece en reversos por reembolso - `refund_id` (string, optional) — ID del reembolso que originó el reverso ## Errors ### 422 Unprocessable Entity Error El movimiento ya no puede cancelarse (transfer_not_cancellable) - `message` (string, optional) — Mensaje de error - `code` (string, optional) — Código estable legible por máquinas, cuando aplica - `refund_id` (string, optional) — ID del reembolso relacionado cuando aplica - `endpoint` (string, optional) — Acción de API rechazada, cuando aplica - `errors` (ErrorErrors, optional) — Detalles de errores por campo ## Types ### TransferDestination Destino del movimiento. Los campos presentes dependen de `type`. - `type` (enum, optional) - Allowed values: `bank_account`, `account`, `phone_number`, `crypto_address` - `id` (string, optional, nullable) — ID del recurso destino (`ba_` cuenta bancaria, `ac_` cuenta, `cr_` dirección cripto) - `bank_name` (string, optional) — bank_account: banco destino - `holder_name` (string, optional) — bank_account: titular de la cuenta bancaria - `currency` (string, optional) — bank_account: moneda de la cuenta bancaria. crypto_address: stablecoin enviada - `name` (string, optional) — account: nombre de la cuenta destinataria - `number` (string, optional) — phone_number: teléfono del destinatario - `address` (string, optional) — crypto_address: dirección on-chain - `chain` (string, optional) — crypto_address: red del envío - `amount` (integer, optional) — crypto_address: monto en unidades menores de la stablecoin que llega al destino ### CurrencyConversion - `id` (string, optional) - `status` (enum, optional) - Allowed values: `awaiting_confirmation`, `pending`, `processed`, `reverted` - `source_currency` (string, optional) - `source_amount_in_cents` (integer, optional) - `destination_currency` (string, optional) - `destination_amount_in_cents` (integer, optional) - `exchange_rate` (double, optional) - `expires_at` (datetime, optional, nullable) - `created_at` (datetime, optional) ### TransferSender (Solo registros tr_) Cuenta emisora — campo legado - `id` (string, optional) - `name` (string, optional) - `type` (string, optional) ### TransferRecipient (Solo registros tr_) Destinatario — campo legado - `id` (string, optional, nullable) - `name` (string, optional) - `type` (string, optional) ### ErrorErrors Detalles de errores por campo - map from string to ErrorErrorsOneOf0 - list of string - string ### ErrorErrorsOneOf0 - list of string - string ## Examples **Response** ```json { "id": "tr_nr4yplup", "status": "completed", "status_detail": "completed", "amount_in_cents": 100, "currency": "GTQ", "fee_in_cents": 0, "net_amount_in_cents": 100, "note": "string", "recipient_email": "maria@example.com", "tracking_url": "https://app.recurrente.com/t/3xK9mPq2vLn8RtWz4Yb7Hc", "account_id": "ac_merchant1", "sent_at": "2024-01-15T09:30:00Z", "settled_at": "2024-01-15T09:30:00Z", "bank_reference": "REC-123-abcdef12", "bank_reference_status": "unsupported", "statement_descriptor": "Factura 1043 wi_ab12cd34", "balance_transaction_id": "txn_ab12cd34", "destination": { "type": "bank_account", "id": "string", "bank_name": "string", "holder_name": "string", "currency": "string", "name": "string", "number": "string", "address": "string", "chain": "string", "amount": 1 }, "currency_conversion": { "id": "cu_ab12cd34", "status": "awaiting_confirmation", "source_currency": "USD", "source_amount_in_cents": 10000, "destination_currency": "GTQ", "destination_amount_in_cents": 75000, "exchange_rate": 7.5, "expires_at": "2024-01-15T09:30:00Z", "created_at": "2024-01-15T09:30:00Z" }, "created_at": "2024-01-15T09:30:00Z", "sender": { "id": "string", "name": "string", "type": "account" }, "recipient": { "id": "string", "name": "string", "type": "account" }, "reversal_of_id": "string", "refund_id": "string" } ``` **SDK Code** ```python import requests url = "https://app.recurrente.com/api/transfers/id/cancel" headers = {"X-SECRET-KEY": ""} response = requests.post(url, headers=headers) print(response.json()) ``` ```javascript const url = 'https://app.recurrente.com/api/transfers/id/cancel'; const options = {method: 'POST', headers: {'X-SECRET-KEY': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://app.recurrente.com/api/transfers/id/cancel" req, _ := http.NewRequest("POST", url, nil) req.Header.Add("X-SECRET-KEY", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://app.recurrente.com/api/transfers/id/cancel") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["X-SECRET-KEY"] = '' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://app.recurrente.com/api/transfers/id/cancel") .header("X-SECRET-KEY", "") .asString(); ``` ```php request('POST', 'https://app.recurrente.com/api/transfers/id/cancel', [ 'headers' => [ 'X-SECRET-KEY' => '', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://app.recurrente.com/api/transfers/id/cancel"); var request = new RestRequest(Method.POST); request.AddHeader("X-SECRET-KEY", ""); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["X-SECRET-KEY": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://app.recurrente.com/api/transfers/id/cancel")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```