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

# Disputa

> Una disputa es un contracargo o una impugnación de pago presentada contra una empresa, que incluye las pruebas y el estado de la respuesta.

> [!NOTE]
>
> Este recurso tiene un sucesor en la [API de Whop](https://docs.whop.com/es/api-reference/legacy/disputes/list-disputes.md), la API versionada sobre la que deben construirse las nuevas integraciones. Esta página sigue teniendo soporte completo.

```json Example theme={null}
{
	"access_activity_log": "192.168.1.1 - 2024-01-15 12:00:00 UTC",
	"amount": 6.9,
	"billing_address": "123 Main St, New York, NY 10001",
	"cancellation_policy_attachment": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"cancellation_policy_disclosure": "All sales are final. No refunds after 30 days.",
	"company": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "<string>"
	},
	"created_at": "2023-12-01T05:00:00.401Z",
	"currency": "usd",
	"customer_communication_attachment": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"customer_email_address": "customer@example.com",
	"customer_name": "Jane Doe",
	"editable": true,
	"id": "dspt_xxxxxxxxxxxxx",
	"needs_response_by": "2023-12-01T05:00:00.401Z",
	"notes": "Customer used the product for 3 months before disputing.",
	"payment": {
		"billing_reason": "subscription_create",
		"card_brand": "mastercard",
		"card_last4": "4242",
		"created_at": "2023-12-01T05:00:00.401Z",
		"currency": "usd",
		"dispute_alerted_at": "2023-12-01T05:00:00.401Z",
		"id": "pay_xxxxxxxxxxxxxx",
		"member": {
			"id": "<string>",
			"phone": "<string>"
		},
		"membership": {
			"id": "mem_xxxxxxxxxxxxxx",
			"status": "trialing"
		},
		"paid_at": "2023-12-01T05:00:00.401Z",
		"payment_instrument": {
			"display_name": "<string>",
			"icons": {
				"square": {
					"dark": {
						"svg": "<string>"
					},
					"light": {
						"svg": "<string>"
					}
				}
			},
			"installment_count": 42,
			"payment_method_type": "<string>"
		},
		"payment_method_type": "acss_debit",
		"subtotal": 6.9,
		"total": 6.9,
		"usd_total": 6.9,
		"user": {
			"email": "john.doe@example.com",
			"id": "user_xxxxxxxxxxxxx",
			"name": "John Doe",
			"username": "johndoe42"
		}
	},
	"plan": {
		"id": "plan_xxxxxxxxxxxxx"
	},
	"product": {
		"id": "prod_xxxxxxxxxxxxx",
		"title": "Pickaxe Analytics"
	},
	"product_description": "Monthly subscription to premium analytics dashboard.",
	"reason": "Product Not Received",
	"reason_code": "10.4",
	"refund_policy_attachment": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"refund_policy_disclosure": "Refunds available within 14 days of purchase.",
	"refund_refusal_explanation": "The customer exceeded the refund window by 60 days.",
	"service_date": "2024-01-15",
	"status": "warning_needs_response",
	"uncategorized_attachment": {
		"content_type": "image/jpeg",
		"filename": "document.pdf",
		"id": "<string>",
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"visa_rdr": true
}
```

**access\_activity\_log** `string | null` *required*

Un registro de la actividad de acceso basada en IP del cliente en Whop, presentado como prueba en la disputa.

Ejemplo: `192.168.1.1 - 2024-01-15 12:00:00 UTC`

**amount** `number` *required*

El importe disputado en la moneda especificada, con formato decimal.

Ejemplo: `6.9`

**billing\_address** `string | null` *required*

La dirección de facturación del cliente obtenida de sus datos de pago, presentada como prueba en la disputa.

Ejemplo: `123 Main St, New York, NY 10001`

**cancellation\_policy\_attachment** `object | null` *required*

El documento de política de cancelación subido como prueba de la disputa. Null si no se ha proporcionado ninguna política de cancelación.

**atributos secundarios**

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

Tipo MIME del archivo subido, como image/jpeg, video/mp4 o audio/mpeg.

Ejemplo: `image/jpeg`

**filename** `string | null` *required*

El nombre de archivo original del adjunto subido, incluida su extensión.

Ejemplo: `document.pdf`

**id** `string` *required*

**url** `string | null` *required*

Una URL preoptimizada para renderizar este adjunto en el cliente. Debe usarse para mostrar adjuntos en las apps.

Ejemplo: `https://media.whop.com/abc123/optimized.jpg`

**cancellation\_policy\_disclosure** `string | null` *required*

Un texto informativo que describe la política de cancelación de la empresa, presentado como prueba de la disputa.

Ejemplo: `All sales are final. No refunds after 30 days.`

**company** `object | null` *required*

La empresa contra la que se presentó la disputa.

**atributos secundarios**

**id** `string` *required*

El identificador único de la empresa.

Ejemplo: `biz_xxxxxxxxxxxxxx`

**title** `string` *required*

El nombre escrito de la empresa.

**created\_at** `string\<date-time\> | null` *required*

La fecha y hora en que se creó la disputa.

Ejemplo: `2023-12-01T05:00:00.401Z`

**currency** `Currencies` *required*

El código de moneda ISO de tres letras del importe disputado.

Opciones disponibles: `usd`, `sgd`, `inr`, `aud`, `brl`, `cad`, `dkk`, `eur`, `nok`, `gbp`, `sek`, `chf`, `hkd`, `huf`, `jpy`, `mxn`, `myr`, `pln`, `czk`, `nzd`, `aed`, `eth`, `ape`, `cop`, `ron`, `thb`, `bgn`, `idr`, `dop`, `php`, `try`, `krw`, `twd`, `vnd`, `pkr`, `clp`, `uyu`, `ars`, `zar`, `dzd`, `tnd`, `mad`, `kes`, `kwd`, `jod`, `all`, `xcd`, `amd`, `bsd`, `bhd`, `bob`, `bam`, `khr`, `crc`, `xof`, `egp`, `etb`, `gmd`, `ghs`, `gtq`, `gyd`, `ils`, `jmd`, `mop`, `mga`, `mur`, `mdl`, `mnt`, `nad`, `ngn`, `mkd`, `omr`, `pyg`, `pen`, `qar`, `rwf`, `sar`, `rsd`, `lkr`, `tzs`, `ttd`, `uzs`, `rub`, `btc`, `cny`, `usdt`, `kzt`, `awg`, `whop_usd`, `xau`, `hnl`

**customer\_communication\_attachment** `object | null` *required*

Prueba de comunicación con el cliente o de uso del producto, subida como adjunto de la disputa. Null si no se proporcionó.

**atributos secundarios**

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

Tipo MIME del archivo subido, como image/jpeg, video/mp4 o audio/mpeg.

Ejemplo: `image/jpeg`

**filename** `string | null` *required*

El nombre de archivo original del adjunto subido, incluida su extensión.

Ejemplo: `document.pdf`

**id** `string` *required*

**url** `string | null` *required*

Una URL preoptimizada para renderizar este adjunto en el cliente. Debe usarse para mostrar adjuntos en las apps.

Ejemplo: `https://media.whop.com/abc123/optimized.jpg`

**customer\_email\_address** `string | null` *required*

La dirección de correo electrónico del cliente obtenida de sus datos de pago, incluida en el paquete de pruebas enviado al procesador de pagos. Se puede editar antes del envío.

Ejemplo: `customer@example.com`

**customer\_name** `string | null` *required*

El nombre completo del cliente obtenido de sus datos de pago, incluido en el paquete de pruebas enviado al procesador de pagos. Se puede editar antes del envío.

Ejemplo: `Jane Doe`

**editable** `boolean | null` *required*

Indica si las pruebas de la disputa aún se pueden editar y enviar.

**id** `string` *required*

El identificador único de la disputa.

Ejemplo: `dspt_xxxxxxxxxxxxx`

**needs\_response\_by** `string\<date-time\> | null` *required*

La fecha límite en la que deben enviarse las pruebas de la disputa. Null si no se ha establecido una fecha límite de respuesta.

Ejemplo: `2023-12-01T05:00:00.401Z`

**notes** `string | null` *required*

Notas adicionales de formato libre enviadas por la empresa como parte de las pruebas de la disputa.

Ejemplo: `Customer used the product for 3 months before disputing.`

**payment** `object | null` *required*

El pago original que se disputó.

**atributos secundarios**

**billing\_reason** `BillingReasons | null` *required*

El motivo legible por máquina por el que se creó este cargo, como compra inicial de suscripción, ciclo de renovación o pago único.

Opciones disponibles: `subscription_create`, `subscription_cycle`, `subscription_update`, `one_time`, `manual`, `subscription`

**card\_brand** `CardBrands | null` *required*

Red de la tarjeta informada por el procesador (p. ej., 'visa', 'mastercard', 'amex'). Solo está presente cuando el tipo de método de pago es 'card'.

Opciones disponibles: `mastercard`, `visa`, `amex`, `discover`, `unionpay`, `jcb`, `diners`, `link`, `troy`, `visadankort`, `visabancontact`, `china_union_pay`, `rupay`, `jcbrupay`, `elo`, `maestro`, `tarjeta_naranja`, `cirrus`, `nspk_mir`, `verve`, `ebt`, `private_label`, `local_brand`, `uatp`, `wexcard`, `uzcard`, `meeza`, `hrg_store_card`, `girocard`, `fuel_card`, `dankort`, `carnet`, `atm_card`, `china_union_payuzcard`, `codensa`, `cabal`, `hipercard`, `jcblankapay`, `cmi`, `aura`, `accel`, `culiance`, `nyce`, `pulse`, `star`, `eftpos`, `alelo`, `edenred`, `sodexo`, `unknown`

**card\_last4** `string | null` *required*

Los últimos cuatro dígitos de la tarjeta utilizada para realizar este pago. Null si el pago no se realizó con tarjeta.

Ejemplo: `4242`

**created\_at** `string\<date-time\>` *required*

La fecha y hora en que se creó el pago.

Ejemplo: `2023-12-01T05:00:00.401Z`

**currency** `Currencies` *required*

El código de moneda ISO de tres letras de este pago (p. ej., 'usd', 'eur').

Opciones disponibles: `usd`, `sgd`, `inr`, `aud`, `brl`, `cad`, `dkk`, `eur`, `nok`, `gbp`, `sek`, `chf`, `hkd`, `huf`, `jpy`, `mxn`, `myr`, `pln`, `czk`, `nzd`, `aed`, `eth`, `ape`, `cop`, `ron`, `thb`, `bgn`, `idr`, `dop`, `php`, `try`, `krw`, `twd`, `vnd`, `pkr`, `clp`, `uyu`, `ars`, `zar`, `dzd`, `tnd`, `mad`, `kes`, `kwd`, `jod`, `all`, `xcd`, `amd`, `bsd`, `bhd`, `bob`, `bam`, `khr`, `crc`, `xof`, `egp`, `etb`, `gmd`, `ghs`, `gtq`, `gyd`, `ils`, `jmd`, `mop`, `mga`, `mur`, `mdl`, `mnt`, `nad`, `ngn`, `mkd`, `omr`, `pyg`, `pen`, `qar`, `rwf`, `sar`, `rsd`, `lkr`, `tzs`, `ttd`, `uzs`, `rub`, `btc`, `cny`, `usdt`, `kzt`, `awg`, `whop_usd`, `xau`, `hnl`

**dispute\_alerted\_at** `string\<date-time\> | null` *required*

Cuándo llegó una alerta de que esta transacción será disputada

Ejemplo: `2023-12-01T05:00:00.401Z`

**id** `string` *required*

El identificador único del pago.

Ejemplo: `pay_xxxxxxxxxxxxxx`

**member** `object | null` *required*

El miembro vinculado a este pago.

**atributos secundarios**

**id** `string` *required*

El identificador único del miembro de la empresa.

**phone** `string | null` *required*

El número de teléfono del miembro, si está disponible.

**membership** `object | null` *required*

La membresía vinculada a este pago.

**atributos secundarios**

**id** `string` *required*

El identificador único de la membresía.

Ejemplo: `mem_xxxxxxxxxxxxxx`

**status** `MembershipStatus` *required*

El estado de la membresía.

Opciones disponibles: `trialing`, `active`, `past_due`, `completed`, `canceled`, `expired`, `unresolved`, `drafted`, `canceling`

**paid\_at** `string\<date-time\> | null` *required*

La fecha y hora en que este pago se cobró correctamente. Null si el pago aún no se ha completado. Como marca de tiempo Unix.

Ejemplo: `2023-12-01T05:00:00.401Z`

**payment\_instrument** `object | null` *required*

El instrumento con el que se realizó este pago, adaptado para su visualización: el tipo de método, un nombre visible para el comprador, el conjunto de iconos estándar y los datos de la tarjeta cuando se trataba de una tarjeta. Null cuando el recibo no indica ningún método de pago.

**atributos secundarios**

**display\_name** `string` *required*

Nombre del instrumento visible para el comprador: "Visa •••• 4242" cuando se conoce la tarjeta; de lo contrario, el nombre propio 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.

**atributos secundarios**

**square** `object` *required*

El mosaico cuadrado (32x32).

**atributos secundarios**

**dark** `object` *required*

La variante de color para superficies oscuras.

**atributos secundarios**

**svg** `string` *required*

El archivo vectorial. Úsalo preferentemente en todos los lugares donde se renderice SVG.

**light** `object` *required*

La variante de color para superficies claras.

**atributos secundarios**

**svg** `string` *required*

El archivo vectorial. Úsalo preferentemente en todos los lugares donde se renderice SVG.

**installment\_count** `integer | null` *required*

Solo para métodos de pago a plazos: en cuántos pagos se divide el cargo. Es un dato, no un texto: compón y traduce la etiqueta en el cliente.

Ejemplo: `42`

**payment\_method\_type** `string` *required*

El identificador del tipo de método de pago, p. ej., `card`, `klarna`, `apple_pay`.

**payment\_method\_type** `PaymentMethodTypes | null` *required*

El tipo de instrumento de pago utilizado para este pago (p. ej., tarjeta, Cash App, iDEAL, Klarna, cripto). Null cuando el procesador no proporciona un tipo.

Opciones disponibles: `acss_debit`, `addi`, `affirm`, `afterpay_clearpay`, `alipay`, `alipayhk`, `alma`, `amazon_pay`, `apple`, `apple_pay`, `au_bank_transfer`, `au_becs_debit`, `bacs_debit`, `bancolombia`, `bancontact`, `bank_wire`, `billie`, `blik`, `boleto`, `bre_b`, `ca_bank_transfer`, `capchase_pay`, `card`, `card_present`, `card_installments_three`, `card_installments_six`, `card_installments_twelve`, `cashapp`, `claritypay`, `coinbase`, `crypto`, `crypto_subscription`, `custom`, `customer_balance`, `demo_pay`, `duitnow_qr`, `efecty`, `eps`, `eu_bank_transfer`, `fpx`, `flex_pay`, `gb_bank_transfer`, `gcash`, `giropay`, `google_pay`, `gopay`, `grabpay`, `id_bank_transfer`, `ideal`, `interac`, `international_bank_wire`, `kakao_pay`, `klarna`, `klarna_pay_now`, `konbini`, `kr_card`, `kr_market`, `kriya`, `kueski`, `link`, `mb_way`, `m_pesa`, `mercado_pago`, `mercado_pago_ar`, `mercado_pago_mx`, `mobilepay`, `modo`, `mondu`, `multibanco`, `naver_pay`, `nequi`, `netbanking`, `ng_bank`, `ng_bank_transfer`, `ng_card`, `ng_market`, `ng_ussd`, `ng_wallet`, `nupay`, `nz_bank_account`, `oney`, `oney_3x`, `oney_4x`, `opay`, `oxxo`, `p24`, `pago_efectivo`, `pse`, `pay_by_bank`, `payco`, `paynow`, `paypal`, `paypal_express`, `paypay`, `payto`, `payto_email`, `payto_phone`, `payto_bank_account`, `pix`, `pix_automatico`, `platform_balance`, `promptpay`, `qris`, `rapipago`, `rechnung`, `revolut_pay`, `samsung_pay`, `satispay`, `scalapay`, `sencillito`, `sepa_debit`, `sequra`, `servipag`, `sezzle`, `shop_pay`, `shopeepay`, `sofort`, `south_korea_market`, `spei`, `splitit`, `sunbit`, `swish`, `tabby`, `tamara`, `touch_n_go`, `twint`, `upi`, `us_bank_account`, `us_bank_transfer`, `venmo`, `verve`, `vipps`, `webpay`, `wechat_pay`, `whop_pay`, `yape`, `zip`, `coinflow`, `unknown`

**subtotal** `number | null` *required*

El subtotal que se muestra al creador (sin incluir las comisiones del comprador).

Ejemplo: `6.9`

**total** `number | null` *required*

El total que se muestra al creador (sin incluir las comisiones del comprador).

Ejemplo: `6.9`

**usd\_total** `number | null` *required*

El total en USD que se muestra al creador (sin incluir las comisiones del comprador).

Ejemplo: `6.9`

**user** `object | null` *required*

El usuario que realizó este pago.

**atributos secundarios**

**email** `string | null` *required*

La dirección de correo electrónico del usuario. Requiere el permiso member:email:read para acceder. Null si no está autorizado.

Ejemplo: `john.doe@example.com`

**id** `string` *required*

El identificador único del usuario.

Ejemplo: `user_xxxxxxxxxxxxx`

**name** `string | null` *required*

El nombre visible del usuario que se muestra en su perfil público.

Ejemplo: `John Doe`

**username** `string` *required*

El nombre de usuario único que se muestra en su perfil público.

Ejemplo: `johndoe42`

**plan** `object | null` *required*

El plan asociado al pago disputado. Null si la disputa no está vinculada a un plan específico.

**atributos secundarios**

**id** `string` *required*

El identificador único del plan.

Ejemplo: `plan_xxxxxxxxxxxxx`

**product** `object | null` *required*

El producto asociado al pago disputado. Null si la disputa no está vinculada a un producto específico.

**atributos secundarios**

**id** `string` *required*

El identificador único del producto.

Ejemplo: `prod_xxxxxxxxxxxxx`

**title** `string` *required*

El nombre visible del producto que se muestra a los clientes en la página del producto y en los resultados de búsqueda.

Ejemplo: `Pickaxe Analytics`

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

Una descripción del producto o servicio proporcionado, presentada como prueba de la disputa.

Ejemplo: `Monthly subscription to premium analytics dashboard.`

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

Un motivo legible de la disputa.

Ejemplo: `Product Not Received`

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

El código de motivo de la red de tarjetas para la disputa. Null cuando el procesador de pagos no proporcionó uno.

Ejemplo: `10.4`

**refund\_policy\_attachment** `object | null` *required*

El documento de política de reembolso subido como prueba de la disputa. Null si no se ha proporcionado ninguna política de reembolso.

**atributos secundarios**

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

Tipo MIME del archivo subido, como image/jpeg, video/mp4 o audio/mpeg.

Ejemplo: `image/jpeg`

**filename** `string | null` *required*

El nombre de archivo original del adjunto subido, incluida su extensión.

Ejemplo: `document.pdf`

**id** `string` *required*

**url** `string | null` *required*

Una URL preoptimizada para renderizar este adjunto en el cliente. Debe usarse para mostrar adjuntos en las apps.

Ejemplo: `https://media.whop.com/abc123/optimized.jpg`

**refund\_policy\_disclosure** `string | null` *required*

Un texto informativo que describe la política de reembolso de la empresa, presentado como prueba de la disputa.

Ejemplo: `Refunds available within 14 days of purchase.`

**refund\_refusal\_explanation** `string | null` *required*

Una explicación de la empresa sobre por qué se rechazó un reembolso, presentada como prueba de la disputa.

Ejemplo: `The customer exceeded the refund window by 60 days.`

**service\_date** `string | null` *required*

La fecha en que se entregó el producto o servicio al cliente, presentada como prueba de la disputa.

Ejemplo: `2024-01-15`

**status** `DisputeStatuses` *required*

El estado actual del ciclo de vida de la disputa, como needs\_response, under\_review, won o lost.

Opciones disponibles: `warning_needs_response`, `warning_under_review`, `warning_closed`, `needs_response`, `under_review`, `won`, `lost`, `closed`, `other`

**uncategorized\_attachment** `object | null` *required*

Un adjunto adicional que no encaja en las categorías de pruebas estándar. Null si no se proporcionó.

**atributos secundarios**

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

Tipo MIME del archivo subido, como image/jpeg, video/mp4 o audio/mpeg.

Ejemplo: `image/jpeg`

**filename** `string | null` *required*

El nombre de archivo original del adjunto subido, incluida su extensión.

Ejemplo: `document.pdf`

**id** `string` *required*

**url** `string | null` *required*

Una URL preoptimizada para renderizar este adjunto en el cliente. Debe usarse para mostrar adjuntos en las apps.

Ejemplo: `https://media.whop.com/abc123/optimized.jpg`

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

Indica si la disputa se resolvió automáticamente mediante Visa Rapid Dispute Resolution (RDR).


## Related topics

- [Reembolsos y disputas](https://docs.whop.com/es/developer/guides/refunds-and-disputes.md)
- [Alerta de disputa](https://docs.whop.com/es/api-reference/legacy/dispute-alerts/dispute-alert.md)
- [API de actividad financiera](https://docs.whop.com/es/api-reference/ledgers/ledger-activity.md)
