---
title: "Anular un reembolso"
method: POST
path: "/refunds/{id}/void"
tags: ["refunds"]
---

# Anular un reembolso

`POST /refunds/{id}/void`

Anula un reembolso con el proveedor antes del cierre del mismo día. Solo aplica a reembolsos reales; no aplica a anulaciones del pago original.

## Path parameters

- `id` string, required

## Headers

- `X-SECRET-KEY` string, required

## Response `200`

Reembolso anulado

- Refund
  - `id` string — ID del reembolso
  - `status` 'pending' | 'succeeded' | 'failed' | 'voided' — Estado del reembolso
  - `failure_reason` string, nullable — Razón del fallo. `provider_outcome_unknown` indica que el resultado debe reconciliarse antes de reintentar
  - `customer` RefundCustomer
    - `id` string — ID del cliente
    - `email` string, email
    - `full_name` string
  - `user_id` string — ID del usuario
  - `account_id` string — Cuenta dueña del cobro reembolsado
  - `account_refunded_amount_in_cents` integer — Monto debitado de la cuenta del comercio (en centavos)
  - `customer_refunded_amount_in_cents` integer — Monto devuelto al cliente (en centavos)
  - `refund_application_fee` boolean — Si las comisiones de plataforma se devolvieron con el reembolso
  - `transfer_adjustments` RefundTransferAdjustment[] — Transfer setups cancelados o revertidos por este reembolso
    - `action` 'cancel' | 'reverse', required
    - `transfer_setup_id` string, required — Transfer setup afectado
    - `reversal_transfer_id` string, nullable — Transfer inverso creado; `null` cuando solo se canceló un setup pendiente
    - `restoration_transfer_id` string, nullable — Transfer compensatorio creado si el procesador rechazó el reembolso
    - `restored_at` string, date-time, nullable — Momento en que el ajuste se compensó por un rechazo del procesador
    - `amount_in_cents` integer, required
  - `currency` string — Moneda
  - `created_at` string, date-time — Fecha de creación
  - `voided_at` string, date-time, nullable — Fecha de anulación, si el reembolso fue anulado

## Other responses

- `422` — No se pudo anular el reembolso

---

[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)