> ## 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 Resolution Center Cases

> Un comprador abre un Resolution Center Case cuando algo va mal con una compra, como una renovación no deseada, un artículo que nunca llegó o un cargo que no reconoce.

Es el paso previo a un contracargo: el comprador y el comerciante lo resuelven directamente, y Whop decide el caso si no logran ponerse de acuerdo.

Usa la API de Resolution Center Cases desde cualquiera de los dos lados: como comprador, abre, responde, apela o retira un caso; como comerciante, acéptalo (reembolsando el pago), recházalo o pide más información al comprador.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Resolution Center Cases](https://docs.whop.com/es/api-reference/resolution-center-cases/list-resolution-center-cases.md) | GET `/resolution_center_cases` |
| [Obtener Resolution Center Case](https://docs.whop.com/es/api-reference/resolution-center-cases/retrieve-resolution-center-case.md) | GET `/resolution_center_cases/{id}` |
| [Listar eventos de un Resolution Center Case](https://docs.whop.com/es/api-reference/resolution-center-cases/list-resolution-center-case-events.md) | GET `/resolution_center_cases/{id}/events` |
| [Obtener resumen de Resolution Center Cases](https://docs.whop.com/es/api-reference/resolution-center-cases/retrieve-resolution-center-case-summary.md) | GET `/resolution_center_cases/summary` |
| [Abrir un caso como cliente](https://docs.whop.com/es/api-reference/resolution-center-cases/open-a-case-as-the-customer.md) | POST `/resolution_center_cases` |
| [Aceptar un caso](https://docs.whop.com/es/api-reference/resolution-center-cases/accept-a-case.md) | POST `/resolution_center_cases/{id}/accept` |
| [Apelar un caso](https://docs.whop.com/es/api-reference/resolution-center-cases/appeal-a-case.md) | POST `/resolution_center_cases/{id}/appeal` |
| [Rechazar un caso](https://docs.whop.com/es/api-reference/resolution-center-cases/deny-a-case.md) | POST `/resolution_center_cases/{id}/deny` |
| [Responder a un caso](https://docs.whop.com/es/api-reference/resolution-center-cases/reply-to-a-case.md) | POST `/resolution_center_cases/{id}/reply` |
| [Solicitar información al cliente](https://docs.whop.com/es/api-reference/resolution-center-cases/request-information-from-the-customer.md) | POST `/resolution_center_cases/{id}/request_info` |
| [Retirar un caso](https://docs.whop.com/es/api-reference/resolution-center-cases/withdraw-a-case.md) | POST `/resolution_center_cases/{id}/withdraw` |

## Atributos

**id** `string` *required*

ID del caso del centro de resolución, con el prefijo `reso_`.

**account** `object | null` *required*

La cuenta contra la que se presentó el caso.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la cuenta, con el prefijo `biz_`.
>
> **title** `string` *required*
>
> Nombre visible de la cuenta.

**amount** `number` *required*

El importe en cuestión, en unidades enteras de `currency`.

**available\_actions** `string[]` *required*

Lo que puedes hacer con este caso en este momento, nombrado según el endpoint que lo hace. Se resuelve para la credencial que hace la llamada, de modo que un comerciante y un cliente que leen el mismo caso ven sus propias opciones.

Opciones disponibles: `accept`, `deny`, `request_info`, `reply`, `appeal`, `withdraw`

**buyer** `object` *required*

El cliente que abrió el caso.

> [accordion] Propiedades
>
> **email** `string | null` *required*
>
> La dirección de correo electrónico del cliente. Requiere el scope `member:email:read`; `null`
> sin él.
>
> **member\_id** `string | null` *required*
>
> El registro de miembro del cliente en la cuenta, con el prefijo `mem_`.
>
> **name** `string | null` *required*
>
> El nombre visible del cliente.
>
> **user\_id** `string | null` *required*
>
> El ID de usuario del cliente, con el prefijo `user_`.
>
> **username** `string | null` *required*
>
> El nombre de usuario de Whop del cliente.

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

Cuándo se abrió el caso, como marca de tiempo ISO 8601.

**currency** `string | null` *required*

Código de divisa ISO de tres letras del importe.

**customer\_appealed** `boolean` *required*

Si el cliente ha apelado una decisión sobre este caso.

**escalated** `boolean` *required*

Si Whop está involucrado, ya sea revisando el caso o esperando a que la parte
indicada por `status` aporte algo que solicitó durante la revisión.

**line\_items** `object[]` *required*

Todo lo que cobró el pago en disputa, en el orden de compra. `product_id` y `variant_id` identifican el primero de ellos; los artículos posteriores de un carrito solo aparecen aquí. Un pago realizado antes de que se registraran los artículos lista el único artículo que implica su variante. Vacío cuando el pago no está vinculado a una variante.

> [accordion] Propiedades
>
> **id** `string | null` *required*
>
> ID de la línea, con el prefijo `li_`. Es null cuando el pago es anterior a las instantáneas de artículos
> y el artículo se lee de la variante del pago.
>
> **label** `string | null` *required*
>
> El nombre del artículo tal como se muestra en el checkout (el título del producto o, en su defecto, el
> título de la variante).
>
> **product\_id** `string | null` *required*
>
> El producto al que pertenece la variante, con el prefijo `prod_`. En un pago
> anterior a las instantáneas de artículos, recurre al producto de la variante, por lo que puede estar
> definido aunque el `product_id` del objeto padre sea null. Es null para una variante sin
> producto.
>
> **product\_title** `string | null` *required*
>
> El título actual del producto, o `null` cuando el artículo no tiene producto.
>
> **quantity** `number` *required*
>
> Cuántas unidades se compraron.
>
> **sku** `string | null` *required*
>
> La unidad de mantenimiento de stock (SKU) de la variante, texto libre definido por el vendedor (p. ej.
> `TSHIRT-LARGE-BLUE`). Las cuentas con sufijos de SKU por motivo de facturación activados
> la reciben marcada con el motivo del cargo: `-S` para el primer cargo de una
> suscripción, `-R` para una renovación, `-C` para una compra única, `-U` cuando los
> propios metadatos del pago incluyen `upsell: true`, `-F` cuando no se cobró nada.
> Otros motivos de facturación llevan el SKU sin sufijo. `null` cuando la variante no tiene SKU
> o se ha eliminado.
>
> **subtotal** `object | null` *required*
>
> El importe registrado para la cantidad total de este artículo, antes de descuentos, impuestos y comisiones, en su divisa de compra. Devuelve `null` cuando no se registró ningún importe del artículo.
>
> > [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.
>
> **variant\_id** `string | null` *required*
>
> La variante comprada, con el prefijo `plan_`. Es null cuando la variante se ha
> eliminado desde entonces.
>
> **variant\_title** `string | null` *required*
>
> El título actual de la variante, o `null` cuando la variante se ha eliminado o no tiene título.

**outcome** `string | null` *required*

Quién prevaleció en la reclamación. `null` hasta que se cierra el caso. Consulta `refund` para saber si realmente se movió dinero.

Opciones disponibles: `customer_won`, `merchant_won`, `withdrawn`

**payment** `object` *required*

El pago contra el que se abrió el caso.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del pago, con el prefijo `pay_`.
>
> **card\_brand** `string | null` *required*
>
> Marca de la tarjeta, cuando el cliente pagó con tarjeta.
>
> **card\_last4** `string | null` *required*
>
> Últimos cuatro dígitos de la tarjeta, cuando el cliente pagó con tarjeta.
>
> **created\_at** `string` *required*
>
> Cuándo se realizó el pago, como marca de tiempo ISO 8601.
>
> **payment\_method\_type** `string | null` *required*
>
> Cómo pagó el cliente, como `card` o `paypal`.

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

El producto por el que se hizo el pago, con el prefijo `prod_`.

**reason** `string` *required*

Lo que el cliente dice que salió mal. Comparte el vocabulario de `/disputes`, de modo que un caso que luego se convierte en contracargo informa la misma queja.

Opciones disponibles: `fraudulent`, `product_not_received`, `not_as_described`, `product_unacceptable`, `subscription_canceled`

**refund** `string | null` *required*

Si se movió dinero y de qué saldo: `none`, `merchant` o `platform` (Whop reembolsó al cliente y el comerciante conservó los fondos). Es independiente de `outcome`: un caso que ganó el comerciante puede tener igualmente un reembolso de la plataforma. `null` mientras el caso está abierto, y en casos cerrados más antiguos anteriores a que se registrara este dato.

Opciones disponibles: `none`, `merchant`, `platform`

**response\_due\_at** `string | null` *required*

Cuándo vence la próxima respuesta, como marca de tiempo ISO 8601.

**status** `string` *required*

A quién está esperando el caso. `awaiting_merchant` y `awaiting_customer` indican la parte que debe responder, `under_review` significa que Whop está decidiendo y `closed` significa que está resuelto; consulta `outcome` para saber cómo.

Opciones disponibles: `awaiting_merchant`, `awaiting_customer`, `under_review`, `closed`

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

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

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

La variante en la que se realizó el pago, con el prefijo `plan_`.

```json ResolutionCenterCase theme={null}
{
	"id": "reso_xxxxxxxxxxxxxx",
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Shine Time Auto Detailing"
	},
	"amount": 249,
	"available_actions": ["accept", "deny", "request_info", "reply"],
	"buyer": {
		"email": "dana@example.com",
		"member_id": "mber_xxxxxxxxxxxxxx",
		"name": "Dana Whitfield",
		"user_id": "user_xxxxxxxxxxxxxx",
		"username": "danawhitfield"
	},
	"created_at": "2026-09-15T14:30:00.000Z",
	"currency": "usd",
	"customer_appealed": false,
	"escalated": false,
	"line_items": [
		{
			"id": "li_xxxxxxxxxxxxxx",
			"label": "Ceramic Coating Package",
			"variant_id": "plan_xxxxxxxxxxxxxx",
			"variant_title": "Ceramic Coating — Full Vehicle",
			"product_id": "prod_xxxxxxxxxxxxxx",
			"product_title": "Ceramic Coating Package",
			"quantity": 1,
			"sku": null,
			"subtotal": {
				"amount": "249.00",
				"currency": "usd",
				"decimals": 2,
				"display_decimals": 2
			}
		}
	],
	"outcome": null,
	"payment": {
		"id": "pay_xxxxxxxxxxxxxx",
		"card_brand": "visa",
		"card_last4": "4242",
		"created_at": "2026-09-02T10:00:00.000Z",
		"payment_method_type": "card"
	},
	"variant_id": "plan_xxxxxxxxxxxxxx",
	"product_id": "prod_xxxxxxxxxxxxxx",
	"reason": "product_not_received",
	"refund": null,
	"response_due_at": "2026-09-18T14:30:00.000Z",
	"status": "awaiting_merchant",
	"updated_at": "2026-09-15T14:30:00.000Z"
}
```
