> ## 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 Disputes

> Una Dispute es un contracargo que un cliente presenta contra un pago a través de su banco, o una consulta que puede convertirse en uno.

Incluye el pago disputado, una fecha límite para responder, tu evidencia y el resultado una vez que el procesador resuelve.

Usa la API de Disputes para listar disputas, editar el paquete de evidencia mientras una disputa todavía se puede impugnar y enviarlo para revisión, o aceptar un contracargo que no quieras impugnar.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Disputes](https://docs.whop.com/es/api-reference/disputes/list-disputes.md) | GET `/disputes` |
| [Recuperar Dispute](https://docs.whop.com/es/api-reference/disputes/retrieve-dispute.md) | GET `/disputes/{id}` |
| [Recuperar resumen de Dispute](https://docs.whop.com/es/api-reference/disputes/retrieve-dispute-summary.md) | GET `/disputes/summary` |
| [Aceptar Dispute](https://docs.whop.com/es/api-reference/disputes/accept-dispute.md) | POST `/disputes/{id}/accept` |
| [Enviar Dispute](https://docs.whop.com/es/api-reference/disputes/submit-dispute.md) | POST `/disputes/{id}/submit` |
| [Subir evidencia de Dispute](https://docs.whop.com/es/api-reference/disputes/upload-dispute-evidence.md) | POST `/disputes/{id}/upload_evidence` |
| [Actualizar Dispute](https://docs.whop.com/es/api-reference/disputes/update-dispute.md) | PATCH `/disputes/{id}` |

## Atributos

**id** `string` *required*

ID de la disputa, con el prefijo `dspt_`.

**acceptable** `boolean` *required*

Si la disputa puede concederse al cliente con `POST /disputes/\{id} /accept`. Verdadero solo para un contracargo que aún espera respuesta, antes de `evidence_due_at`, cuyo procesador de pagos admite aceptar disputas. Las consultas nunca se pueden aceptar.

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

La cuenta contra la que se presentó la disputa, con el prefijo `biz_`.

**amount** `number` *required*

El importe disputado, en unidades enteras de `currency`.

**buyer** `object` *required*

El cliente que presentó la disputa.

> [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*
>
> La fila de miembro del cliente en la cuenta, con el prefijo `mem_`.
>
> **name** `string | null` *required*
>
> El nombre para mostrar del cliente.
>
> **user\_id** `string | null` *required*
>
> El ID de usuario del cliente, con el prefijo `user_`. `null` para un checkout como invitado.
>
> **username** `string | null` *required*
>
> El nombre de usuario de Whop del cliente.

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

Cuándo se abrió la disputa, como marca de tiempo ISO 8601.

**currency** `string` *required*

Código de moneda ISO de tres letras del importe disputado.

**evidence** `object` *required*

El paquete de evidencia enviado al procesador para impugnar la disputa.

> [accordion] Propiedades
>
> **access\_activity\_log** `string | null` *required*
>
> Registro del acceso del cliente al producto, como actividad de inicio de sesión o de descarga.
>
> **billing\_address** `string | null` *required*
>
> La dirección de facturación que proporcionó el cliente en el checkout.
>
> **cancellation\_policy\_attachment** `object | null` *required*
>
> El documento de la política de cancelación. De forma predeterminada, se usa la política de cancelación de la cuenta, luego sus términos de servicio, luego su política de devoluciones y luego la política de la plataforma de Whop.
>
> > [accordion] Propiedades
> >
> > **id** `string | null` *required*
> >
> > El ID del adjunto. `null` para una política alojada por Whop, que no es un archivo subido.
> >
> > **content\_type** `string | null` *required*
> >
> > El tipo MIME del archivo subido.
> >
> > **filename** `string | null` *required*
> >
> > El nombre del archivo subido.
> >
> > **platform** `boolean` *required*
> >
> > Si se trata de la política alojada por el propio Whop, que se usa en su lugar porque el vendedor no subió ninguna. Devolverla en un PATCH no cambia nada.
> >
> > **url** `string | null` *required*
> >
> > Una URL para descargar el adjunto.
>
> **cancellation\_policy\_disclosure** `string | null` *required*
>
> Cómo se mostró la política de cancelación al cliente antes de la compra.
>
> **customer\_communication\_attachment** `object | null` *required*
>
> Correspondencia con el cliente, o prueba de que usó el producto.
>
> > [accordion] Propiedades
> >
> > **id** `string | null` *required*
> >
> > El ID del adjunto. `null` para una política alojada por Whop, que no es un archivo subido.
> >
> > **content\_type** `string | null` *required*
> >
> > El tipo MIME del archivo subido.
> >
> > **filename** `string | null` *required*
> >
> > El nombre del archivo subido.
> >
> > **platform** `boolean` *required*
> >
> > Si se trata de la política alojada por el propio Whop, que se usa en su lugar porque el vendedor no subió ninguna. Devolverla en un PATCH no cambia nada.
> >
> > **url** `string | null` *required*
> >
> > Una URL para descargar el adjunto.
>
> **customer\_email\_address** `string | null` *required*
>
> La dirección de correo electrónico que usó el cliente en el checkout.
>
> **customer\_name** `string | null` *required*
>
> El nombre del cliente tal como lo indicó en el checkout.
>
> **documents** `object[]` *required*
>
> Documentos de evidencia adicionales, más allá de los cuatro espacios fijos; se establecen mediante `evidence.documents` en `PATCH /disputes/\{id}`. Cada uno se incluye en el paquete enviado bajo su `document_type`.
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > El ID del archivo, con el prefijo `file_`.
> >
> > **blurhash** `string | null` *required*
> >
> > Marcador de posición BlurHash para una imagen o un video. Null cuando no está disponible o fue eliminado por moderación.
> >
> > **content\_type** `string | null` *required*
> >
> > El tipo MIME del archivo subido. Las subidas están restringidas a los tipos que acepta el procesador y se rechazan si no tienen uno; nunca es null.
> >
> > Opciones disponibles: `application/pdf`, `application/json`, `image/jpeg`, `image/png`, `image/webp`
> >
> > **created\_at** `string` *required*
> >
> > Cuándo se creó el archivo, como marca de tiempo ISO 8601.
> >
> > **document\_type** `string` *required*
> >
> > Lo que demuestra este documento. `return_policy`, `cancellation_policy` y `terms_of_service` son los documentos de políticas del vendedor. Un documento de política reemplaza la copia de la cuenta para esta disputa. `return_policy`, `cancellation_policy` y `customer_communication` también reemplazan el espacio de evidencia fijo correspondiente. `shipping_policy` son las condiciones de envío del vendedor. `customer_communication` es la correspondencia con el comprador, como un hilo de soporte o un registro de chat. `product_image` es una foto del producto o servicio que recibió el comprador. `physical_fulfillment` es la prueba de que un pedido físico se envió y llegó. `digital_fulfillment` es la prueba de que el comprador accedió a un producto digital. `customer_order_history` son los pedidos anteriores del comprador con este vendedor. `prior_transactions` es el historial de pagos del comprador en toda la plataforma, para una defensa contra fraude. `customer_session` son los datos del checkout, como la dirección IP, la huella del dispositivo, los resultados de AVS y CVV y el resultado de 3D Secure. `subscription` es la evidencia del ciclo de vida de la membresía, como renovaciones, cancelación y recordatorios enviados. `complete_evidence` es la respuesta completa del vendedor como un único PDF de 19 páginas como máximo, y debe ser el único documento. Whop envía un documento `complete_evidence` al procesador en lugar de todos los demás campos de evidencia, adjuntos y documentos.
> >
> > Opciones disponibles: `return_policy`, `shipping_policy`, `cancellation_policy`, `terms_of_service`, `physical_fulfillment`, `customer_order_history`, `product_image`, `prior_transactions`, `customer_session`, `digital_fulfillment`, `subscription`, `customer_communication`, `complete_evidence`
> >
> > **duration\_seconds** `number | null` *required*
> >
> > Duración del audio o video en segundos. Null cuando no está disponible o fue eliminado por moderación.
> >
> > **filename** `string | null` *required*
> >
> > El nombre de archivo original, incluida su extensión.
> >
> > **height** `integer | null` *required*
> >
> > Altura de la imagen o el video en píxeles. Null cuando no está disponible o fue eliminado por moderación.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > El tamaño en bytes que debe tener cada parte (excepto la última). Presente solo al crear y solo para subidas multiparte.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > El ID de la subida multiparte, que se devuelve a `complete`. Presente solo al crear y solo para subidas multiparte.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > La URL prefirmada de cada parte. Presente solo al crear y solo para subidas multiparte.
> >
> > > [accordion] Propiedades
> > >
> > > **part\_number** `integer` *required*
> > >
> > > El índice, empezando en 1, de esta parte dentro de la subida multiparte.
> > >
> > > **url** `string` *required*
> > >
> > > La URL prefirmada a la que hacer PUT de los bytes de esta parte.
> >
> > **object** `string` *required*
> >
> > El tipo de este objeto, siempre `file`.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > Si la moderación eliminó el archivo. Cuando es `true`, `url` sirve una imagen de reemplazo. `filename`, `size` y `content_type` siguen describiendo el archivo original.
> >
> > **size** `integer | null` *required*
> >
> > El tamaño del archivo en bytes. `null` hasta que termina la subida.
> >
> > **upload\_headers** `object`
> >
> > Encabezados que se deben enviar con el PUT de la subida. Presente solo al crear.
> >
> > **upload\_status** `string` *required*
> >
> > En qué punto de su ciclo de vida de subida se encuentra el archivo.
> >
> > Opciones disponibles: `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > URL prefirmada a la que hacer PUT de los bytes del archivo. Presente solo al crear y solo para subidas de una sola parte.
> >
> > **url** `string | null` *required*
> >
> > Una URL para descargar el archivo. Los archivos públicos obtienen una URL de CDN permanente y los privados una URL firmada que caduca. `null` hasta que termina la subida. Cuando la moderación elimina el archivo, una URL de imagen de reemplazo.
> >
> > **visibility** `string` *required*
> >
> > Los archivos `public` se sirven desde una URL de CDN sin firmar. Los archivos `private` se sirven desde una URL firmada que caduca.
> >
> > Opciones disponibles: `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > URL de la forma de onda del audio. Null cuando no está disponible o fue eliminada por moderación.
> >
> > **width** `integer | null` *required*
> >
> > Ancho de la imagen o el video en píxeles. Null cuando no está disponible o fue eliminado por moderación.
>
> **notes** `string | null` *required*
>
> Cualquier contexto adicional para el procesador que revisa la disputa.
>
> **product\_description** `string | null` *required*
>
> Lo que compró el cliente, en palabras del propio vendedor.
>
> **refund\_policy\_attachment** `object | null` *required*
>
> El documento de la política de reembolsos. De forma predeterminada, se usa la política de devoluciones de la cuenta, luego sus términos de servicio y luego la política de la plataforma de Whop.
>
> > [accordion] Propiedades
> >
> > **id** `string | null` *required*
> >
> > El ID del adjunto. `null` para una política alojada por Whop, que no es un archivo subido.
> >
> > **content\_type** `string | null` *required*
> >
> > El tipo MIME del archivo subido.
> >
> > **filename** `string | null` *required*
> >
> > El nombre del archivo subido.
> >
> > **platform** `boolean` *required*
> >
> > Si se trata de la política alojada por el propio Whop, que se usa en su lugar porque el vendedor no subió ninguna. Devolverla en un PATCH no cambia nada.
> >
> > **url** `string | null` *required*
> >
> > Una URL para descargar el adjunto.
>
> **refund\_policy\_disclosure** `string | null` *required*
>
> Cómo se mostró la política de reembolsos al cliente antes de la compra.
>
> **refund\_refusal\_explanation** `string | null` *required*
>
> Por qué se rechazó un reembolso, cuando se solicitó y se denegó.
>
> **service\_date** `string | null` *required*
>
> Cuándo se entregó el producto o servicio.
>
> **uncategorized\_attachment** `object | null` *required*
>
> Evidencia de respaldo que no encaja en las demás categorías.
>
> > [accordion] Propiedades
> >
> > **id** `string | null` *required*
> >
> > El ID del adjunto. `null` para una política alojada por Whop, que no es un archivo subido.
> >
> > **content\_type** `string | null` *required*
> >
> > El tipo MIME del archivo subido.
> >
> > **filename** `string | null` *required*
> >
> > El nombre del archivo subido.
> >
> > **platform** `boolean` *required*
> >
> > Si se trata de la política alojada por el propio Whop, que se usa en su lugar porque el vendedor no subió ninguna. Devolverla en un PATCH no cambia nada.
> >
> > **url** `string | null` *required*
> >
> > Una URL para descargar el adjunto.

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

La fecha límite para enviar evidencia, como marca de tiempo ISO 8601. `null` cuando la red ya resolvió automáticamente la disputa (Visa RDR) sin ronda de evidencia, o cuando el procesador no ha informado una fecha límite para esta disputa.

**evidence\_editable** `boolean` *required*

Si `evidence` todavía se puede cambiar y enviar.

**evidence\_locked\_reason** `string | null` *required*

Por qué ya no se puede editar la evidencia. `null` mientras `evidence_editable` es true.

Opciones disponibles: `submitted`, `response_window_closed`, `not_contestable`

**evidence\_submitted\_at** `string | null` *required*

Cuándo se envió la evidencia al procesador, como marca de tiempo ISO 8601.

**fee** `object | null` *required*

La tarifa de disputa cobrada a la cuenta, en la moneda en la que se cobró. `null` cuando `fee_charged` es false.

> [accordion] Propiedades
>
> **amount** `string` *required*
>
> El importe en unidades principales, como una 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 moneda ISO 4217 de tres letras, en minúsculas.
>
> **decimals** `integer` *required*
>
> Cuántos decimales lleva el importe. Es la precisión con la que se ejecuta el propio cargo.
>
> **display\_decimals** `integer` *required*
>
> Cuántos decimales MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: el COP se cobra en centavos pero se escribe en pesos enteros, así que es `2` y `0`. Usa este valor para formatear el número en tu propia configuración regional.

**fee\_charged** `boolean` *required*

Si Whop cobró a la cuenta una tarifa de disputa por esta. `false` cuando el pago se reembolsó por completo antes de abrirse la disputa, para una resolución de Visa RDR y para una consulta.

**inquiry** `boolean` *required*

Si se trata de una consulta previa a la disputa y no de un contracargo formal. Las consultas siguen el mismo ciclo de vida, pero no mueven fondos a menos que escalen.

**issuer\_comments** `object[]` *required*

Lo que dijo el emisor de la tarjeta al presentar la disputa. Solo se rellena cuando el emisor lo proporciona, y se lista en el orden en que se recibió.

> [accordion] Propiedades
>
> **received\_at** `string | null` *required*
>
> Cuándo se recibió el comentario, como marca de tiempo ISO 8601.
>
> **text** `string` *required*
>
> Lo que escribió el emisor, tal como se recibió.

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

Todo lo que cobró el pago disputado, en orden de compra. `product_id` y `variant_id` nombran el primero de estos; 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 partida, con el prefijo `li_`. 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 mostró en el checkout (el título del producto o, si no, 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, se usa el producto de la variante, por lo que puede estar establecido cuando el propio `product_id` del padre es null. 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*
>
> El código de referencia (SKU) de la variante, texto libre establecido por el vendedor (p. ej., `TSHIRT-LARGE-BLUE`). Las cuentas con sufijos de SKU por motivo de facturación habilitados lo reciben marcado con el motivo del cargo: `-S` para un primer cargo de 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 completa de este artículo, antes de descuentos, impuestos y tarifas, en su moneda de compra. Devuelve `null` cuando no se registró ningún importe para el artículo.
>
> > [accordion] Propiedades
> >
> > **amount** `string` *required*
> >
> > El importe en unidades principales, como una 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 moneda ISO 4217 de tres letras, en minúsculas.
> >
> > **decimals** `integer` *required*
> >
> > Cuántos decimales lleva el importe. Es la precisión con la que se ejecuta el propio cargo.
> >
> > **display\_decimals** `integer` *required*
> >
> > Cuántos decimales MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: el COP se cobra en centavos pero se escribe en pesos enteros, así que es `2` y `0`. Usa este valor para formatear el número en tu propia configuración regional.
>
> **variant\_id** `string | null` *required*
>
> La variante comprada, con el prefijo `plan_`. 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.

**payment** `object` *required*

El pago que se disputa.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del pago, con el prefijo `pay_`.
>
> **amount** `number | null` *required*
>
> Lo que se cobró al cliente, en unidades enteras de la moneda del pago.
>
> **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.
>
> **currency** `string | null` *required*
>
> Código de moneda ISO de tres letras del pago. Puede diferir de la moneda de la disputa cuando el procesador liquida en otra moneda.
>
> **payment\_instrument** `object | null` *required*
>
> El instrumento con el que se realizó este pago, preparado para mostrarse: el tipo de método, un nombre orientado al comprador, el conjunto de iconos estándar y los datos de la tarjeta, incluido el ID de transacción de red que la cuenta usa para la tarjeta, cuando se trató de una tarjeta. Null cuando el pago no indica ningún método.
>
> > [accordion] Propiedades
> >
> > **card** `object | null` *required*
> >
> > Solo para pagos con tarjeta, Apple Pay y Google Pay: la red de la tarjeta, los últimos cuatro dígitos, el número de identificación del emisor, el vencimiento y el ID de transacción de red.
> >
> > > [accordion] Propiedades
> > >
> > > **brand** `string | null` *required*
> > >
> > > El identificador de red (`visa`, `amex`, …), coincidente con las entradas de `card.networks` y los métodos de pago con tarjeta guardados. Null cuando la bóveda no registró la red.
> > >
> > > **exp\_month** `number | null` *required*
> > >
> > > El mes de vencimiento de la tarjeta, del 1 al 12. Null cuando la bóveda no lo registró.
> > >
> > > **exp\_year** `number | null` *required*
> > >
> > > El año de vencimiento de cuatro dígitos de la tarjeta. Null cuando la bóveda no lo registró.
> > >
> > > **issuer\_identification\_number** `string | null` *required*
> > >
> > > El número de identificación del emisor, también llamado BIN: los seis u ocho primeros dígitos de la tarjeta, que identifican al banco emisor. Null cuando el procesador no lo informó.
> > >
> > > **last4** `string | null` *required*
> > >
> > > Los últimos cuatro dígitos de la tarjeta, cuando se capturaron.
> > >
> > > **network\_transaction\_id** `string | null` *required*
> > >
> > > El ID de transacción de red que esta cuenta usa para la tarjeta. Es el ID propio de esta cuenta, de su primer cargo o verificación con el cliente presente en la tarjeta, cuando Whop tiene uno. De lo contrario, es un ID de transacción de red anterior de esta tarjeta, que puede provenir de la transacción de otra cuenta o haber llegado con la tarjeta. Cítalo como la transacción previa en un cargo posterior iniciado por el comercio con esta tarjeta en esta cuenta. Null hasta que haya uno. Un webhook enviado cuando un pago se registra por primera vez puede llevar `null`, así que recupera el pago para leerlo.
> >
> > **display\_name** `string` *required*
> >
> > Nombre del instrumento orientado al comprador: "Visa •••• 4242" cuando se mostró la tarjeta o, si no, el propio nombre del método ("Klarna").
> >
> > **icons** `object` *required*
> >
> > El conjunto de iconos estándar: formas cuadrada y de tarjeta, cada una en variantes de color claras y oscuras.
> >
> > > [accordion] Propiedades
> > >
> > > **card** `object` *required*
> > >
> > > El mosaico con proporciones de tarjeta de crédito (48x30).
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **dark** `object` *required*
> > > >
> > > > La variante de color para superficies oscuras.
> > > >
> > > > > [accordion] Propiedades
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Alternativa rasterizada al tamaño nativo de la forma.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Alternativa rasterizada a doble densidad.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Alternativa rasterizada a cuádruple densidad.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > El archivo vectorial. Dale preferencia en cualquier lugar donde se renderice SVG.
> > > >
> > > > **light** `object` *required*
> > > >
> > > > La variante de color para superficies claras.
> > > >
> > > > > [accordion] Propiedades
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Alternativa rasterizada al tamaño nativo de la forma.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Alternativa rasterizada a doble densidad.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Alternativa rasterizada a cuádruple densidad.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > El archivo vectorial. Dale preferencia en cualquier lugar donde se renderice SVG.
> > >
> > > **square** `object` *required*
> > >
> > > El mosaico cuadrado (32x32).
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **dark** `object` *required*
> > > >
> > > > La variante de color para superficies oscuras.
> > > >
> > > > > [accordion] Propiedades
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Alternativa rasterizada al tamaño nativo de la forma.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Alternativa rasterizada a doble densidad.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Alternativa rasterizada a cuádruple densidad.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > El archivo vectorial. Dale preferencia en cualquier lugar donde se renderice SVG.
> > > >
> > > > **light** `object` *required*
> > > >
> > > > La variante de color para superficies claras.
> > > >
> > > > > [accordion] Propiedades
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Alternativa rasterizada al tamaño nativo de la forma.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Alternativa rasterizada a doble densidad.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Alternativa rasterizada a cuádruple densidad.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > El archivo vectorial. Dale preferencia en cualquier lugar donde se renderice SVG.
> >
> > **installment\_count** `number | null` *required*
> >
> > Solo métodos a plazos: en cuántos pagos se divide el cargo. Son datos, no texto: compón y traduce la etiqueta en el cliente.
> >
> > **payment\_method\_type** `string` *required*
> >
> > El identificador del tipo de método de pago, p. ej., `card`, `klarna`, `apple_pay`.
>
> **payment\_method\_type** `string | null` *required*
>
> Cómo pagó el cliente, como `card` o `paypal`.
>
> **payment\_processor** `string | null` *required*
>
> Obsoleto: ya no se rellena. Siempre `null`. OBSOLETO: ya no se rellena. Siempre null.

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

El producto por el que se realizó el pago disputado, con el prefijo `prod_`.

**reason** `string` *required*

Por qué dice el cliente que disputa, normalizado entre procesadores y redes de tarjetas. `other` cubre un motivo del procesador que Whop aún no ha categorizado.

Opciones disponibles: `fraudulent`, `unrecognized`, `declined_authorization`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, `credit_not_processed`, `duplicate`, `processing_error`, `documentation_request`, `bank_cannot_process`, `other`

**reason\_code** `string | null` *required*

El código de motivo sin procesar de la red de tarjetas o del procesador, como `10.4`. Solo informativo: `reason` no se deriva de él.

**status** `string` *required*

`needs_response` espera evidencia (después de que un procesador rechazara una presentación, `submission_failure_reason` indica por qué); `generating_response` tiene evidencia en el procesador, aún no aceptada; `under_review` está con el procesador; `won`/`lost` son las resoluciones; `prevented` se liquida como `lost`. Los estados `warning_` son los niveles de consulta. Pasado `evidence_due_at`, una disputa abierta informa `under_review`.

Opciones disponibles: `needs_response`, `warning_needs_response`, `under_review`, `warning_under_review`, `generating_response`, `won`, `lost`, `prevented`, `warning_closed`

**submission\_failure\_reason** `string | null` *required*

Por qué el procesador de pagos rechazó la última presentación, en lenguaje claro, mientras la disputa vuelve a estar en `needs_response`. Corrige lo que indica y envíala de nuevo. Solo al recuperar: `dispute.updated` informa el regreso a `needs_response`; luego lee este campo aquí.

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

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

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

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

```json Dispute theme={null}
{
	"id": "dspt_xxxxxxxxxxxxx",
	"acceptable": true,
	"account_id": "biz_xxxxxxxxxxxxxx",
	"amount": 49.99,
	"buyer": {
		"email": "alex@example.com",
		"member_id": "mem_xxxxxxxxxxxxx",
		"name": "Alex Rivera",
		"user_id": "user_xxxxxxxxxxxxx",
		"username": "alex"
	},
	"created_at": "2026-06-01T12:00:00Z",
	"currency": "usd",
	"evidence": {
		"access_activity_log": "2026-05-02 14:11 UTC signed in and opened the course; 2026-05-04 09:32 UTC downloaded lesson materials",
		"billing_address": "123 Main St, Austin, TX 78701, US",
		"cancellation_policy_attachment": null,
		"cancellation_policy_disclosure": "Shown on the checkout page beneath the pay button.",
		"customer_communication_attachment": {
			"id": "att_xxxxxxxxxxxxx",
			"content_type": "application/pdf",
			"filename": "support-thread.pdf",
			"platform": false,
			"url": "https://assets.whop.com/uploads/att_xxxxxxxxxxxxx/support-thread.pdf"
		},
		"customer_email_address": "alex@example.com",
		"customer_name": "Alex Rivera",
		"notes": "Customer accessed the product for four weeks before disputing.",
		"product_description": "Monthly membership to the Pickaxe trading community, including the full course library.",
		"refund_policy_attachment": {
			"id": null,
			"content_type": "application/pdf",
			"filename": "refund-policy.pdf",
			"platform": true,
			"url": "https://whop.com/policies/refund-policy.pdf"
		},
		"refund_policy_disclosure": "Linked in the order confirmation email and on the checkout page.",
		"refund_refusal_explanation": "Refund was refused because the membership had been used past the 7-day refund window.",
		"service_date": "2026-05-01",
		"uncategorized_attachment": null,
		"documents": [
			{
				"id": "file_xxxxxxxxxxxxxx",
				"object": "file",
				"document_type": "product_image",
				"filename": "before-and-after-coating.png",
				"content_type": "image/png",
				"size": 48213,
				"url": "https://cdn.whop.com/attachments/before-and-after-coating.png",
				"upload_status": "ready",
				"visibility": "private",
				"created_at": "2026-06-01T12:00:00Z",
				"width": null,
				"height": null,
				"blurhash": null,
				"duration_seconds": null,
				"waveform_url": null,
				"removed_by_moderation": false
			}
		]
	},
	"evidence_due_at": "2026-06-15T00:00:00Z",
	"evidence_editable": true,
	"evidence_locked_reason": null,
	"submission_failure_reason": null,
	"evidence_submitted_at": null,
	"fee": {
		"amount": "15.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"fee_charged": true,
	"inquiry": false,
	"issuer_comments": [
		{
			"received_at": "2026-06-01T12:00:00Z",
			"text": "Cardholder states they did not authorize this transaction."
		}
	],
	"payment": {
		"id": "pay_xxxxxxxxxxxxx",
		"amount": 49.99,
		"card_brand": "visa",
		"card_last4": "4242",
		"created_at": "2026-05-01T09:30:00Z",
		"currency": "usd",
		"payment_method_type": "card",
		"payment_processor": null,
		"payment_instrument": {
			"payment_method_type": "card",
			"display_name": "Visa •••• 4242",
			"icons": {
				"square": {
					"light": {
						"svg": "https://content.whop.com/payment_methods/visa/square_light.svg",
						"png_1x": "https://content.whop.com/payment_methods/visa/square_light_32.png",
						"png_2x": "https://content.whop.com/payment_methods/visa/square_light_64.png",
						"png_4x": "https://content.whop.com/payment_methods/visa/square_light_128.png"
					},
					"dark": {
						"svg": "https://content.whop.com/payment_methods/visa/square_dark.svg",
						"png_1x": "https://content.whop.com/payment_methods/visa/square_dark_32.png",
						"png_2x": "https://content.whop.com/payment_methods/visa/square_dark_64.png",
						"png_4x": "https://content.whop.com/payment_methods/visa/square_dark_128.png"
					}
				},
				"card": {
					"light": {
						"svg": "https://content.whop.com/payment_methods/visa/card_light.svg",
						"png_1x": "https://content.whop.com/payment_methods/visa/card_light_30.png",
						"png_2x": "https://content.whop.com/payment_methods/visa/card_light_60.png",
						"png_4x": "https://content.whop.com/payment_methods/visa/card_light_120.png"
					},
					"dark": {
						"svg": "https://content.whop.com/payment_methods/visa/card_dark.svg",
						"png_1x": "https://content.whop.com/payment_methods/visa/card_dark_30.png",
						"png_2x": "https://content.whop.com/payment_methods/visa/card_dark_60.png",
						"png_4x": "https://content.whop.com/payment_methods/visa/card_dark_120.png"
					}
				}
			},
			"card": {
				"brand": "visa",
				"last4": "4242",
				"issuer_identification_number": "41111111",
				"exp_month": 11,
				"exp_year": 2030,
				"network_transaction_id": "016153570198200"
			},
			"installment_count": null
		}
	},
	"line_items": [
		{
			"id": "li_xxxxxxxxxxxxx",
			"label": "Ceramic Coating Package",
			"variant_id": "plan_xxxxxxxxxxxxx",
			"variant_title": "One-time",
			"product_id": "prod_xxxxxxxxxxxxx",
			"product_title": "Ceramic Coating Package",
			"quantity": 1,
			"sku": "CERAMIC-COAT-3YR",
			"subtotal": {
				"amount": "299.00",
				"currency": "usd",
				"decimals": 2,
				"display_decimals": 2
			}
		}
	],
	"variant_id": "plan_xxxxxxxxxxxxx",
	"product_id": "prod_xxxxxxxxxxxxx",
	"reason": "fraudulent",
	"reason_code": "10.4",
	"status": "needs_response",
	"updated_at": "2026-06-01T12:00:00Z"
}
```


## Related topics

- [API de Dispute Alerts](https://docs.whop.com/es/api-reference/dispute-alerts/dispute-alert.md)
- [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)
