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

> Une Dispute alert est un avertissement précoce d'un émetteur de carte indiquant qu'un paiement réglé est contesté, avant toute rétrofacturation.

`type` distingue les signalements de fraude (`early_fraud_warning`), les avis de pré-litige (`dispute_alert`) et les cas Visa RDR que le réseau a déjà clôturés par un remboursement (`rapid_dispute_resolution`).

Utilisez l'API Dispute alerts pour lister les alertes d'un compte, les filtrer par type ou par paiement, et lire `actionable` pour savoir si un remboursement peut encore éviter la rétrofacturation.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les alertes de litige](https://docs.whop.com/fr/api-reference/dispute-alerts/list-dispute-alerts.md) | GET `/dispute_alerts` |
| [Récupérer une alerte de litige](https://docs.whop.com/fr/api-reference/dispute-alerts/retrieve-dispute-alert.md) | GET `/dispute_alerts/{id}` |

## Attributs

**id** `string` *required*

ID de l'alerte de litige, préfixé par `dspa_`.

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

Le compte auquel appartient le paiement concerné par l'alerte, préfixé par
`biz_`. `null` tant que l'alerte n'est pas rapprochée.

**amount** `number` *required*

Le montant concerné par l'alerte, en unités entières de `currency`. Il s'agit
du montant déclaré par l'émetteur, qui peut différer du montant du paiement
lui-même.

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

Indique si Whop a automatiquement remboursé le paiement concerné. Reflète
l'état du paiement, et peut donc être `true` pour un remboursement émis par un
autre processus (RDR, résolution) sur le même paiement.

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

Le réseau de la carte tel que déclaré par l'émetteur, en minuscules, comme
`visa` ou `mastercard`. `unknown` lorsque le signalement ne comporte ni réseau
ni BIN reconnaissable.

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

Ce que le titulaire de la carte affirme. `fraud` lorsqu'il déclare ne pas avoir effectué le paiement : toujours pour un `early_fraud_warning`, ainsi que pour les alertes de fraude Ethoca et les cas Visa RDR déposés pour un motif de fraude. `customer_dispute` lorsqu'il a effectué le paiement mais le conteste, par exemple pour un produit non reçu ou un abonnement annulé. `null` lorsque l'alerte ne comporte aucune réclamation, comme une demande de documents de transaction par l'émetteur.

Options disponibles : `fraud`, `customer_dispute`

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

Date à laquelle Whop a reçu l'alerte, sous forme d'horodatage ISO 8601.

**currency** `string` *required*

Code de devise ISO à trois lettres du montant concerné par l'alerte.

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

Les frais d'alerte facturés au compte, dans la devise dans laquelle ils ont été prélevés. `null` lorsque `fee_charged` est false.

> [accordion] Propriétés
>
> **amount** `string` *required*
>
> Le montant en unités principales, sous forme de chaîne décimale exacte. Par
> exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin
> qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transit.
>
> **currency** `string` *required*
>
> Code de devise ISO 4217 à trois lettres, en minuscules.
>
> **decimals** `integer` *required*
>
> Nombre de décimales du montant. Il s'agit de la précision avec laquelle le
> prélèvement lui-même est effectué.
>
> **display\_decimals** `integer` *required*
>
> Nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est facturé en centavos mais s'écrit en pesos entiers, il vaut donc `2` et `0`. Formatez le nombre dans votre propre locale à l'aide de cette valeur.

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

Indique si Whop a facturé au compte des frais d'alerte pour celle-ci. Toujours
`false` pour `early_fraud_warning`, qui n'est pas facturé à Whop et n'est
jamais répercuté.

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

Obsolète : toujours `null` en dehors du tableau de bord de Whop. Nom de la
banque qui a émis la carte et déposé le signalement. OBSOLÈTE : toujours null
en dehors du tableau de bord de Whop.

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

Le paiement signalé par l'émetteur, préfixé par `pay_`. `null` lorsque Whop
n'a pas pu rapprocher le signalement d'un paiement.

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

Le produit auquel correspondait le paiement concerné, préfixé par `prod_`.

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

Date à laquelle l'émetteur a déposé le signalement, sous forme d'horodatage
ISO 8601. Antérieure à `created_at`, qui correspond à sa réception par Whop.

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

Le programme réseau qui a envoyé l'alerte, ce que `type` seul ne permet pas de distinguer. `ethoca` pour Mastercard Ethoca, `cdrn` pour Visa Verifi CDRN, `rdr` pour Visa RDR, `tc40` / `safe` pour un signalement de fraude Visa / Mastercard, `paypal` pour une alerte PayPal. `null` lorsque le réseau ne l'a pas précisé.

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

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

Date à laquelle la transaction signalée a été effectuée, sous forme
d'horodatage ISO 8601 — à défaut, date du paiement rapproché si le
signalement de l'émetteur n'en comportait pas. Ne devrait pas être `null` en
pratique ; considérez une telle valeur comme un problème de données plutôt
que comme un comportement attendu.

**type** `string` *required*

Ce que l'émetteur a envoyé. `early_fraud_warning` est un signalement de fraude sur un paiement réglé (Visa TC40 / Mastercard SAFE) — un remboursement permet encore d'éviter la rétrofacturation, et Whop ne facture jamais de frais pour ce type. `dispute_alert` est un avis de pré-litige provenant du réseau d'alertes de l'émetteur, que Whop paie et répercute sous forme de frais. `rapid_dispute_resolution` est un cas Visa RDR que le réseau a déjà clôturé en remboursant le paiement — il n'y a plus rien à faire.

Options disponibles : `early_fraud_warning`, `dispute_alert`, `rapid_dispute_resolution`

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

Date de dernière modification de l'alerte, sous forme d'horodatage 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"
}
```


## Related topics

- [List dispute alerts](https://docs.whop.com/fr/api-reference/legacy/dispute-alerts/list-dispute-alerts.md)
- [Retrieve dispute alert](https://docs.whop.com/fr/api-reference/legacy/dispute-alerts/retrieve-dispute-alert.md)
- [Dispute alert created](https://docs.whop.com/fr/api-reference/dispute-alerts/dispute-alert-created.md)
