> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# API de Refunds

> Un Refund es una reversión total o parcial de un pago, emitida con Refund Payment. Registra cuánto se movió, a través de qué proveedor y si se completó correctamente.

Un Refund es una reversión total o parcial de un pago, emitida con [Refund Payment](https://docs.whop.com/es/api-reference/payments/refund-payment.md). Registra cuánto se movió, a través de qué proveedor y si se completó correctamente.

Usa la API de Refunds para listar los reembolsos de un pago o de toda una cuenta, y para obtener un reembolso individual.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Refunds](https://docs.whop.com/es/api-reference/refunds/list-refunds.md) | GET `/refunds` |
| [Obtener Refund](https://docs.whop.com/es/api-reference/refunds/retrieve-refund.md) | GET `/refunds/{id}` |

## Atributos

**id** `string` *required*

ID del reembolso, con el prefijo `rf_`.

**account\_id** `string | null` *required*

La cuenta que emitió el reembolso, con el prefijo `biz_`.

**amount** `object | null` *required*

El importe reembolsado tal como se liquidó, en la divisa de liquidación del pago, para que las páginas de reembolsos se compensen con el `refunded_amount` del pago. Se convierte al tipo de cambio vigente cuando se emitió el reembolso, no al tipo original del pago. Es null solo cuando no hay ningún tipo de cambio registrado para un pago multidivisa heredado.

> [accordion] Propiedades
>
> **amount** `string` *required*
>
> El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"`
> son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
>
> **currency** `string` *required*
>
> Código de divisa ISO 4217 de tres letras, en minúsculas.
>
> **decimals** `integer` *required*
>
> Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta
> el propio cargo.
>
> **display\_decimals** `integer` *required*
>
> Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.

**created\_at** `string` *required*

Cuándo se solicitó el reembolso, como marca de tiempo ISO 8601.

**failure\_message** `string | null` *required*

Una explicación para el comerciante de por qué falló el reembolso, en el idioma
de la solicitud. Es null a menos que el reembolso haya fallado o se haya cancelado.

**failure\_reason** `string | null` *required*

Por qué falló el reembolso, normalizado entre proveedores. Es null a menos que el reembolso haya fallado o se haya cancelado.

Opciones disponibles: `bank_declined`, `expired_or_canceled_card`, `lost_or_stolen_card`, `insufficient_funds`, `charge_disputed`, `not_refundable`, `merchant_request`, `unknown`

**metadata** `object | null` *required*

Tus propios datos clave-valor adjuntados cuando se solicitó el reembolso.

**original\_amount** `object` *required*

El importe reembolsado en la divisa que movió el procesador.

> [accordion] Propiedades
>
> **amount** `string` *required*
>
> El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"`
> son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
>
> **currency** `string` *required*
>
> Código de divisa ISO 4217 de tres letras, en minúsculas.
>
> **decimals** `integer` *required*
>
> Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta
> el propio cargo.
>
> **display\_decimals** `integer` *required*
>
> Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.

**payment\_id** `string` *required*

El pago que revierte este reembolso, con el prefijo `pay_`.

**provider** `string` *required*

El proveedor de pagos que procesó el reembolso, como `paypal` o
`coinbase`.

**provider\_created\_at** `string | null` *required*

Cuándo creó el proveedor el reembolso, como marca de tiempo ISO 8601.

**reason** `string | null` *required*

Por qué se emitió el reembolso, cuando está registrado.

Opciones disponibles: `duplicate`, `fraudulent`, `requested_by_customer`, `expired_uncaptured_charge`, `dispute_alert`

**reference\_status** `string | null` *required*

Si hay disponible una referencia de seguimiento de la red bancaria para este reembolso.

Opciones disponibles: `available`, `pending`, `unavailable`

**reference\_type** `string | null` *required*

El tipo de referencia de seguimiento, como un número de referencia del adquirente.

Opciones disponibles: `acquirer_reference_number`, `retrieval_reference_number`, `system_trace_audit_number`

**reference\_value** `string | null` *required*

La referencia de seguimiento con la que el banco del comprador puede rastrear el reembolso.

**status** `string` *required*

En qué estado está el reembolso con el procesador: `pending`, `requires_action`, `succeeded`, `failed` o `canceled`.

Opciones disponibles: `pending`, `requires_action`, `succeeded`, `failed`, `canceled`

**updated\_at** `string` *required*

Cuándo cambió el reembolso por última vez, como marca de tiempo ISO 8601.

**visa\_rdr** `boolean` *required*

True cuando la red de tarjetas inició el reembolso mediante Rapid Dispute
Resolution.

```json Refund theme={null}
{
	"id": "rf_xxxxxxxxxxxxxx",
	"payment_id": "pay_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"status": "succeeded",
	"amount": {
		"amount": "49.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"original_amount": {
		"amount": "49.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"provider": "stripe",
	"reason": "requested_by_customer",
	"failure_reason": null,
	"failure_message": null,
	"reference_type": "acquirer_reference_number",
	"reference_status": "available",
	"reference_value": "74000006259000123456789",
	"visa_rdr": false,
	"metadata": {
		"refund_id": "ref_8f2k1"
	},
	"provider_created_at": "2026-09-15T14:30:02.000Z",
	"created_at": "2026-09-15T14:30:00.000Z",
	"updated_at": "2026-09-15T14:30:05.000Z"
}
```


## Related topics

- [API de actividad financiera](https://docs.whop.com/es/api-reference/ledgers/ledger-activity.md)
- [Estabilidad de la API](https://docs.whop.com/es/api-reference/stability.md)
- [API de Payments](https://docs.whop.com/es/api-reference/payments/payment.md)
