> ## 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 Dispute Alerts

> Una Dispute alert es una alerta temprana de un emisor de tarjeta de que un pago liquidado está siendo cuestionado, antes de cualquier contracargo.

`type` distingue los reportes de fraude (`early_fraud_warning`), los avisos previos a una disputa (`dispute_alert`) y los casos de Visa RDR que la red ya cerró mediante un reembolso (`rapid_dispute_resolution`).

Usa la API de Dispute alerts para listar las alertas de una cuenta, filtrarlas por tipo o por pago, y leer `actionable` para ver si un reembolso todavía puede evitar el contracargo.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Dispute Alerts](https://docs.whop.com/es/api-reference/dispute-alerts/list-dispute-alerts.md) | GET `/dispute_alerts` |
| [Recuperar Dispute Alert](https://docs.whop.com/es/api-reference/dispute-alerts/retrieve-dispute-alert.md) | GET `/dispute_alerts/{id}` |

## Atributos

**id** `string` *required*

ID de la alerta de disputa, con el prefijo `dspa_`.

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

La cuenta a la que pertenece el pago alertado, con el prefijo `biz_`. `null` mientras la alerta no está asociada.

**amount** `number` *required*

El importe alertado, en unidades enteras de `currency`. Es lo que informó el emisor, que puede diferir del importe del propio pago.

**auto\_refunded** `boolean` *required*

Si Whop reembolsó automáticamente el pago alertado. Refleja el pago, por lo que puede ser `true` para un reembolso emitido por otro flujo (RDR, resolución) sobre el mismo pago.

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

La red de la tarjeta tal como la informó el emisor, en minúsculas, como `visa` o `mastercard`. `unknown` cuando el reporte no incluye ni una red ni un BIN reconocible.

**category** `string | null` *required*

Lo que alega el titular de la tarjeta. `fraud` cuando dice que no realizó el pago: siempre para un `early_fraud_warning`, y para alertas de fraude de Ethoca y casos de Visa RDR presentados con un motivo de fraude. `customer_dispute` cuando realizó el pago pero lo disputa, como un producto no recibido o una suscripción cancelada. `null` cuando la alerta no incluye ninguna reclamación, como una solicitud del emisor de documentos de la transacción.

Opciones disponibles: `fraud`, `customer_dispute`

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

Cuándo recibió Whop la alerta, como marca de tiempo ISO 8601.

**currency** `string` *required*

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

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

La tarifa de alerta 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 alerta por esta. Siempre `false` para `early_fraud_warning`, por la que a Whop no se le factura y que nunca repercute.

**issuer** `string | null` *required*

Obsoleto: siempre `null` fuera del propio panel de Whop. Nombre del banco que emitió la tarjeta y presentó el reporte. OBSOLETO: siempre null fuera del propio panel de Whop.

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

El pago que informó el emisor, con el prefijo `pay_`. `null` cuando Whop no pudo asociar el reporte a un pago.

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

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

**reported\_at** `string` *required*

Cuándo presentó el emisor el reporte, como marca de tiempo ISO 8601. Anterior a `created_at`, que es cuando Whop lo recibió.

**source** `string | null` *required*

El programa de la red que envió la alerta, que `type` por sí solo no distingue. `ethoca` para Mastercard Ethoca, `cdrn` para Visa Verifi CDRN, `rdr` para Visa RDR, `tc40` / `safe` para un reporte de fraude de Visa / Mastercard, `paypal` para una alerta de PayPal. `null` cuando la red no lo indicó.

Opciones disponibles: `ethoca`, `cdrn`, `rdr`, `tc40`, `safe`, `paypal`

**transaction\_at** `string | null` *required*

Cuándo se realizó la transacción informada, como marca de tiempo ISO 8601; si el propio reporte del emisor no la incluía, se usa la fecha en que se realizó el pago asociado. No debería ser `null` en la práctica; trata un valor nulo como un problema de datos y no como un comportamiento esperado.

**type** `string` *required*

Lo que envió el emisor. `early_fraud_warning` es un reporte de fraude sobre un pago liquidado (Visa TC40 / Mastercard SAFE): un reembolso todavía evita el contracargo y Whop nunca cobra una tarifa por ello. `dispute_alert` es un aviso previo a una disputa de la red de alertas del emisor, que Whop paga y repercute como tarifa. `rapid_dispute_resolution` es un caso de Visa RDR que la red ya cerró reembolsando el pago: no queda nada por hacer.

Opciones disponibles: `early_fraud_warning`, `dispute_alert`, `rapid_dispute_resolution`

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

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

```json DisputeAlert theme={null}
{
	"id": "dspa_xxxxxxxxxxxxx",
	"type": "dispute_alert",
	"source": "ethoca",
	"category": "fraud",
	"amount": 69.95,
	"currency": "usd",
	"card_brand": "visa",
	"issuer": null,
	"account_id": "biz_xxxxxxxxxxxxxx",
	"payment_id": "pay_xxxxxxxxxxxxxx",
	"product_id": "prod_xxxxxxxxxxxxx",
	"fee_charged": true,
	"fee": {
		"amount": "20.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"auto_refunded": false,
	"reported_at": "2026-08-10T17:37:09.000Z",
	"transaction_at": "2026-08-02T00:00:00.000Z",
	"created_at": "2026-08-10T21:39:26.668Z",
	"updated_at": "2026-08-10T21:39:28.137Z"
}
```
