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

> Un Dispute est une rétrofacturation qu'un client dépose contre un paiement auprès de sa banque, ou une demande de renseignements susceptible d'en devenir une.

Il comprend le paiement contesté, un délai de réponse, vos preuves et le résultat une fois que le processeur a statué.

Utilisez l'API Disputes pour lister les litiges, modifier le dossier de preuves tant qu'un litige est encore contestable et le soumettre pour examen, ou accepter une rétrofacturation que vous ne souhaitez pas contester.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les litiges](https://docs.whop.com/fr/api-reference/disputes/list-disputes.md) | GET `/disputes` |
| [Récupérer un litige](https://docs.whop.com/fr/api-reference/disputes/retrieve-dispute.md) | GET `/disputes/{id}` |
| [Récupérer le récapitulatif des litiges](https://docs.whop.com/fr/api-reference/disputes/retrieve-dispute-summary.md) | GET `/disputes/summary` |
| [Accepter un litige](https://docs.whop.com/fr/api-reference/disputes/accept-dispute.md) | POST `/disputes/{id}/accept` |
| [Soumettre un litige](https://docs.whop.com/fr/api-reference/disputes/submit-dispute.md) | POST `/disputes/{id}/submit` |
| [Importer des preuves de litige](https://docs.whop.com/fr/api-reference/disputes/upload-dispute-evidence.md) | POST `/disputes/{id}/upload_evidence` |
| [Mettre à jour un litige](https://docs.whop.com/fr/api-reference/disputes/update-dispute.md) | PATCH `/disputes/{id}` |

## Attributs

**id** `string` *required*

ID du litige, préfixé par `dspt_`.

**acceptable** `boolean` *required*

Indique si le litige peut être concédé au client avec `POST /disputes/\{id}
      	/accept`. Vrai uniquement pour une rétrofacturation toujours en attente de
réponse, avant `evidence_due_at`, dont le processeur de paiement prend en
charge l'acceptation des litiges. Les demandes de renseignements ne sont
jamais acceptables.

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

Le compte contre lequel le litige a été déposé, préfixé par `biz_`.

**amount** `number` *required*

Le montant contesté, en unités entières de `currency`.

**buyer** `object` *required*

Le client qui a déposé le litige.

> [accordion] Propriétés
>
> **email** `string | null` *required*
>
> L'adresse e-mail du client. Nécessite le scope `member:email:read` ; `null`
> sans celui-ci.
>
> **member\_id** `string | null` *required*
>
> La ligne membre du client sur le compte, préfixée par `mem_`.
>
> **name** `string | null` *required*
>
> Le nom d'affichage du client.
>
> **user\_id** `string | null` *required*
>
> L'ID utilisateur du client, préfixé par `user_`. `null` pour un paiement en
> tant qu'invité.
>
> **username** `string | null` *required*
>
> Le nom d'utilisateur Whop du client.

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

Date d'ouverture du litige, sous forme d'horodatage ISO 8601.

**currency** `string` *required*

Code de devise ISO à trois lettres du montant contesté.

**evidence** `object` *required*

Le dossier de preuves envoyé au processeur pour contester le litige.

> [accordion] Propriétés
>
> **access\_activity\_log** `string | null` *required*
>
> Journal des accès du client au produit, comme l'activité de connexion ou de
> téléchargement.
>
> **billing\_address** `string | null` *required*
>
> L'adresse de facturation fournie par le client lors du paiement.
>
> **cancellation\_policy\_attachment** `object | null` *required*
>
> Le document de politique d'annulation. Par défaut, la politique d'annulation du compte, puis ses conditions d'utilisation, puis sa politique de retour, puis la politique de la plateforme Whop.
>
> > [accordion] Propriétés
> >
> > **id** `string | null` *required*
> >
> > L'ID de la pièce jointe. `null` pour une politique hébergée par Whop, qui
> > n'est pas un fichier importé.
> >
> > **content\_type** `string | null` *required*
> >
> > Le type MIME du fichier importé.
> >
> > **filename** `string | null` *required*
> >
> > Le nom du fichier importé.
> >
> > **platform** `boolean` *required*
> >
> > Indique s'il s'agit de la politique hébergée par Whop elle-même, utilisée à la
> > place car le vendeur n'en a importé aucune. La renvoyer dans un PATCH ne
> > modifie rien.
> >
> > **url** `string | null` *required*
> >
> > Une URL pour télécharger la pièce jointe.
>
> **cancellation\_policy\_disclosure** `string | null` *required*
>
> La manière dont la politique d'annulation a été présentée au client avant
> l'achat.
>
> **customer\_communication\_attachment** `object | null` *required*
>
> Correspondance avec le client, ou preuve qu'il a utilisé le produit.
>
> > [accordion] Propriétés
> >
> > **id** `string | null` *required*
> >
> > L'ID de la pièce jointe. `null` pour une politique hébergée par Whop, qui
> > n'est pas un fichier importé.
> >
> > **content\_type** `string | null` *required*
> >
> > Le type MIME du fichier importé.
> >
> > **filename** `string | null` *required*
> >
> > Le nom du fichier importé.
> >
> > **platform** `boolean` *required*
> >
> > Indique s'il s'agit de la politique hébergée par Whop elle-même, utilisée à la
> > place car le vendeur n'en a importé aucune. La renvoyer dans un PATCH ne
> > modifie rien.
> >
> > **url** `string | null` *required*
> >
> > Une URL pour télécharger la pièce jointe.
>
> **customer\_email\_address** `string | null` *required*
>
> L'adresse e-mail utilisée par le client lors du paiement.
>
> **customer\_name** `string | null` *required*
>
> Le nom du client tel qu'indiqué lors du paiement.
>
> **documents** `object[]` *required*
>
> Documents de preuve supplémentaires, au-delà des quatre emplacements fixes — définis via `evidence.documents` sur `PATCH /disputes/\{id}`. Chacun est inclus dans le dossier soumis sous son `document_type`.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > L'ID du fichier, préfixé par `file_`.
> >
> > **blurhash** `string | null` *required*
> >
> > Placeholder BlurHash pour une image ou une vidéo. Null lorsqu'il n'est pas
> > disponible ou a été supprimé par la modération.
> >
> > **content\_type** `string | null` *required*
> >
> > Le type MIME du fichier importé. Les importations sont limitées aux types acceptés par le processeur et rejetées en l'absence de type — jamais null.
> >
> > Options disponibles : `application/pdf`, `application/json`, `image/jpeg`, `image/png`, `image/webp`
> >
> > **created\_at** `string` *required*
> >
> > Date de création du fichier, sous forme d'horodatage ISO 8601.
> >
> > **document\_type** `string` *required*
> >
> > Ce que prouve ce document. `return_policy`, `cancellation_policy` et `terms_of_service` sont les documents de politique du vendeur. Un document de politique remplace la copie du compte pour ce litige. `return_policy`, `cancellation_policy` et `customer_communication` remplacent également l'emplacement de preuve fixe correspondant. `shipping_policy` correspond aux conditions d'expédition du vendeur. `customer_communication` est la correspondance avec l'acheteur, comme un fil de support ou un historique de chat. `product_image` est une photo du produit ou du service reçu par l'acheteur. `physical_fulfillment` est la preuve qu'une commande physique a été expédiée et est arrivée. `digital_fulfillment` est la preuve que l'acheteur a accédé à un produit numérique. `customer_order_history` correspond aux commandes passées de l'acheteur auprès de ce vendeur. `prior_transactions` est l'historique de paiement de l'acheteur sur la plateforme, pour une défense contre la fraude. `customer_session` correspond aux données de paiement, comme l'adresse IP, l'empreinte de l'appareil, les résultats AVS et CVV, et le résultat 3D Secure. `subscription` correspond aux preuves du cycle de vie de l'adhésion, comme les renouvellements, l'annulation et les rappels envoyés. `complete_evidence` est la réponse complète du vendeur sous forme d'un seul PDF de 19 pages au maximum, et il doit être le seul document. Whop envoie un document `complete_evidence` au processeur à la place de tous les autres champs de preuve, pièces jointes et documents.
> >
> > Options 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*
> >
> > Durée de l'audio ou de la vidéo en secondes. Null lorsqu'elle n'est pas
> > disponible ou a été supprimée par la modération.
> >
> > **filename** `string | null` *required*
> >
> > Le nom de fichier d'origine, extension comprise.
> >
> > **height** `integer | null` *required*
> >
> > Hauteur de l'image ou de la vidéo en pixels. Null lorsqu'elle n'est pas
> > disponible ou a été supprimée par la modération.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > La taille en octets que doit avoir chaque partie (sauf la dernière). Présent
> > uniquement lors de la création, et uniquement pour les importations multipart.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > L'ID de l'importation multipart, à renvoyer à `complete`. Présent uniquement
> > lors de la création, et uniquement pour les importations multipart.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > L'URL présignée de chaque partie. Présent uniquement lors de la création, et uniquement pour les importations multipart.
> >
> > > [accordion] Propriétés
> > >
> > > **part\_number** `integer` *required*
> > >
> > > L'index (à partir de 1) de cette partie au sein de l'importation multipart.
> > >
> > > **url** `string` *required*
> > >
> > > L'URL présignée vers laquelle envoyer (PUT) les octets de cette partie.
> >
> > **object** `string` *required*
> >
> > Le type de cet objet, toujours `file`.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > Indique si la modération a supprimé le fichier. Lorsque `true`, `url` sert une
> > image de remplacement. `filename`, `size` et `content_type` décrivent toujours
> > le fichier d'origine.
> >
> > **size** `integer | null` *required*
> >
> > La taille du fichier en octets. `null` tant que l'importation n'est pas
> > terminée.
> >
> > **upload\_headers** `object`
> >
> > En-têtes à envoyer avec le PUT d'importation. Présent uniquement lors de la
> > création.
> >
> > **upload\_status** `string` *required*
> >
> > L'étape où se trouve le fichier dans son cycle de vie d'importation.
> >
> > Options disponibles : `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présent
> > uniquement lors de la création, et uniquement pour les importations en une
> > seule partie.
> >
> > **url** `string | null` *required*
> >
> > Une URL pour télécharger le fichier. Les fichiers publics obtiennent une URL
> > CDN permanente, et les fichiers privés une URL signée qui expire. `null` tant
> > que l'importation n'est pas terminée. Lorsque la modération supprime le
> > fichier, une URL d'image de remplacement.
> >
> > **visibility** `string` *required*
> >
> > Les fichiers `public` sont servis depuis une URL CDN non signée. Les fichiers `private` sont servis depuis une URL signée qui expire.
> >
> > Options disponibles : `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > URL de la forme d'onde audio. Null lorsqu'elle n'est pas disponible ou a été
> > supprimée par la modération.
> >
> > **width** `integer | null` *required*
> >
> > Largeur de l'image ou de la vidéo en pixels. Null lorsqu'elle n'est pas disponible ou a été supprimée par la modération.
>
> **notes** `string | null` *required*
>
> Tout contexte supplémentaire destiné au processeur qui examine le litige.
>
> **product\_description** `string | null` *required*
>
> Ce que le client a acheté, selon les termes du vendeur.
>
> **refund\_policy\_attachment** `object | null` *required*
>
> Le document de politique de remboursement. Par défaut, la politique de retour du compte, puis ses conditions d'utilisation, puis la politique de la plateforme Whop.
>
> > [accordion] Propriétés
> >
> > **id** `string | null` *required*
> >
> > L'ID de la pièce jointe. `null` pour une politique hébergée par Whop, qui
> > n'est pas un fichier importé.
> >
> > **content\_type** `string | null` *required*
> >
> > Le type MIME du fichier importé.
> >
> > **filename** `string | null` *required*
> >
> > Le nom du fichier importé.
> >
> > **platform** `boolean` *required*
> >
> > Indique s'il s'agit de la politique hébergée par Whop elle-même, utilisée à la
> > place car le vendeur n'en a importé aucune. La renvoyer dans un PATCH ne
> > modifie rien.
> >
> > **url** `string | null` *required*
> >
> > Une URL pour télécharger la pièce jointe.
>
> **refund\_policy\_disclosure** `string | null` *required*
>
> La manière dont la politique de remboursement a été présentée au client avant
> l'achat.
>
> **refund\_refusal\_explanation** `string | null` *required*
>
> La raison pour laquelle un remboursement a été refusé, lorsqu'il a été demandé
> et refusé.
>
> **service\_date** `string | null` *required*
>
> Date à laquelle le produit ou le service a été fourni.
>
> **uncategorized\_attachment** `object | null` *required*
>
> Preuves complémentaires qui n'entrent pas dans les autres catégories.
>
> > [accordion] Propriétés
> >
> > **id** `string | null` *required*
> >
> > L'ID de la pièce jointe. `null` pour une politique hébergée par Whop, qui
> > n'est pas un fichier importé.
> >
> > **content\_type** `string | null` *required*
> >
> > Le type MIME du fichier importé.
> >
> > **filename** `string | null` *required*
> >
> > Le nom du fichier importé.
> >
> > **platform** `boolean` *required*
> >
> > Indique s'il s'agit de la politique hébergée par Whop elle-même, utilisée à la
> > place car le vendeur n'en a importé aucune. La renvoyer dans un PATCH ne
> > modifie rien.
> >
> > **url** `string | null` *required*
> >
> > Une URL pour télécharger la pièce jointe.

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

La date limite de soumission des preuves, sous forme d'horodatage ISO 8601.
`null` lorsque le réseau a déjà résolu automatiquement le litige (Visa RDR)
sans phase de preuves, ou lorsque le processeur n'a pas communiqué de date
limite pour ce litige.

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

Indique si `evidence` peut encore être modifié et soumis.

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

La raison pour laquelle les preuves ne peuvent plus être modifiées. `null` tant que `evidence_editable` est true.

Options disponibles : `submitted`, `response_window_closed`, `not_contestable`

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

Date à laquelle les preuves ont été soumises au processeur, sous forme
d'horodatage ISO 8601.

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

Les frais de litige 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 de litige pour celui-ci. `false`
lorsque le paiement a été intégralement remboursé avant l'ouverture du litige,
pour une résolution Visa RDR, et pour une demande de renseignements.

**inquiry** `boolean` *required*

Indique s'il s'agit d'une demande de renseignements préalable plutôt que d'une
rétrofacturation formelle. Les demandes de renseignements suivent le même
cycle de vie mais ne déplacent aucun fonds, sauf si elles sont escaladées.

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

Ce que l'émetteur de la carte a indiqué lors du dépôt du litige. Renseigné uniquement lorsque l'émetteur les fournit, et listé dans l'ordre de réception.

> [accordion] Propriétés
>
> **received\_at** `string | null` *required*
>
> Date de réception du commentaire, sous forme d'horodatage ISO 8601.
>
> **text** `string` *required*
>
> Ce que l'émetteur a écrit, tel que reçu.

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

Tout ce que le paiement contesté a facturé, dans l'ordre d'achat. `product_id` et `variant_id` désignent le premier de ces éléments ; les éléments suivants d'un panier n'apparaissent qu'ici. Un paiement effectué avant l'enregistrement des éléments liste l'élément unique qu'implique sa variante. Vide lorsque le paiement n'est lié à aucune variante.

> [accordion] Propriétés
>
> **id** `string | null` *required*
>
> ID de la ligne, préfixé par `li_`. Null lorsque le paiement est antérieur aux
> instantanés d'éléments et que l'élément est lu à partir de la variante du
> paiement.
>
> **label** `string | null` *required*
>
> Le nom de l'élément tel qu'affiché lors du paiement (le titre du produit, à
> défaut le titre de la variante).
>
> **product\_id** `string | null` *required*
>
> Le produit auquel appartient la variante, préfixé par `prod_`. Sur un paiement
> antérieur aux instantanés d'éléments, il se rabat sur le produit de la
> variante, de sorte qu'il peut être défini alors que le `product_id` du parent
> est null. Null pour une variante sans produit.
>
> **product\_title** `string | null` *required*
>
> Le titre actuel du produit, ou `null` lorsque l'élément n'a pas de produit.
>
> **quantity** `number` *required*
>
> Nombre d'unités achetées.
>
> **sku** `string | null` *required*
>
> L'unité de gestion de stock (SKU) de la variante, texte libre défini par le
> vendeur (par ex. `TSHIRT-LARGE-BLUE`). Les comptes pour lesquels les suffixes
> SKU de motif de facturation sont activés la reçoivent accompagnée de la raison
> du prélèvement : `-S` pour un premier prélèvement d'abonnement, `-R` pour un
> renouvellement, `-C` pour un achat unique, `-U` lorsque les métadonnées du
> paiement contiennent `upsell: true`, `-F` lorsque rien n'a été facturé. Les
> autres motifs de facturation portent le SKU seul. `null` lorsque la variante
> n'a pas de SKU ou a été supprimée.
>
> **subtotal** `object | null` *required*
>
> Le montant enregistré pour la quantité totale de cet élément, avant remises, taxes et frais, dans sa devise d'achat. Renvoie `null` lorsqu'aucun montant d'élément n'a été enregistré.
>
> > [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.
>
> **variant\_id** `string | null` *required*
>
> La variante achetée, préfixée par `plan_`. Null lorsque la variante a depuis
> été supprimée.
>
> **variant\_title** `string | null` *required*
>
> Le titre actuel de la variante, ou `null` lorsque la variante a été supprimée ou n'a pas de titre.

**payment** `object` *required*

Le paiement contesté.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du paiement, préfixé par `pay_`.
>
> **amount** `number | null` *required*
>
> Le montant facturé au client, en unités entières de la devise du paiement.
>
> **card\_brand** `string | null` *required*
>
> Marque de la carte, lorsque le client a payé par carte.
>
> **card\_last4** `string | null` *required*
>
> Quatre derniers chiffres de la carte, lorsque le client a payé par carte.
>
> **created\_at** `string` *required*
>
> Date du paiement, sous forme d'horodatage ISO 8601.
>
> **currency** `string | null` *required*
>
> Code de devise ISO à trois lettres du paiement. Peut différer de la devise du
> litige lorsque le processeur règle dans une autre devise.
>
> **payment\_instrument** `object | null` *required*
>
> L'instrument avec lequel ce paiement a été effectué, mis en forme pour l'affichage : le type de moyen de paiement, un nom destiné à l'acheteur, le jeu d'icônes standard et les informations de la carte, y compris l'id de transaction réseau que le compte utilise pour la carte, lorsqu'il s'agissait d'une carte. Null lorsque le paiement ne mentionne aucun moyen de paiement.
>
> > [accordion] Propriétés
> >
> > **card** `object | null` *required*
> >
> > Paiements par carte, Apple Pay et Google Pay uniquement : le réseau de la carte, les quatre derniers chiffres, le numéro d'identification de l'émetteur, la date d'expiration et l'id de transaction réseau.
> >
> > > [accordion] Propriétés
> > >
> > > **brand** `string | null` *required*
> > >
> > > L'identifiant du réseau (`visa`, `amex`, …), correspondant aux entrées de
> > > `card.networks` et aux moyens de paiement par carte enregistrés. Null lorsque
> > > le coffre-fort n'a pas enregistré le réseau.
> > >
> > > **exp\_month** `number | null` *required*
> > >
> > > Le mois d'expiration de la carte, de 1 à 12. Null lorsque le coffre-fort ne
> > > l'a pas enregistré.
> > >
> > > **exp\_year** `number | null` *required*
> > >
> > > L'année d'expiration de la carte à quatre chiffres. Null lorsque le
> > > coffre-fort ne l'a pas enregistrée.
> > >
> > > **issuer\_identification\_number** `string | null` *required*
> > >
> > > Le numéro d'identification de l'émetteur, également appelé BIN : les six ou
> > > huit premiers chiffres de la carte, qui identifient la banque émettrice. Null
> > > lorsque le processeur ne l'a pas communiqué.
> > >
> > > **last4** `string | null` *required*
> > >
> > > Les quatre derniers chiffres de la carte, lorsqu'ils ont été capturés.
> > >
> > > **network\_transaction\_id** `string | null` *required*
> > >
> > > L'id de transaction réseau que ce compte utilise pour la carte. Il s'agit de l'id propre à ce compte, issu de son premier prélèvement ou de sa première vérification en présence du client sur la carte, lorsque Whop en dispose. Sinon, il s'agit d'un id de transaction réseau antérieur pour cette carte, qui peut provenir de la transaction d'un autre compte ou avoir été apporté avec la carte. Citez-le comme transaction antérieure lors d'un prélèvement ultérieur initié par le marchand sur cette carte pour ce compte. Null tant qu'il n'en existe pas. Un webhook envoyé lors du premier enregistrement d'un paiement peut contenir `null` ; récupérez donc le paiement pour le lire.
> >
> > **display\_name** `string` *required*
> >
> > Nom de l'instrument destiné à l'acheteur — "Visa •••• 4242" lorsque la carte
> > est connue, sinon le nom propre du moyen de paiement ("Klarna").
> >
> > **icons** `object` *required*
> >
> > Le jeu d'icônes standard : formes carrée et carte, chacune en variantes claire et sombre.
> >
> > > [accordion] Propriétés
> > >
> > > **card** `object` *required*
> > >
> > > La vignette aux proportions d'une carte bancaire (48x30).
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **dark** `object` *required*
> > > >
> > > > La variante de couleurs pour les surfaces sombres.
> > > >
> > > > > [accordion] Propriétés
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Image matricielle de secours à la taille native de la forme.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Image matricielle de secours en double densité.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Image matricielle de secours en quadruple densité.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > Le fichier vectoriel. À privilégier partout où le SVG s'affiche.
> > > >
> > > > **light** `object` *required*
> > > >
> > > > La variante de couleurs pour les surfaces claires.
> > > >
> > > > > [accordion] Propriétés
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Image matricielle de secours à la taille native de la forme.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Image matricielle de secours en double densité.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Image matricielle de secours en quadruple densité.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > Le fichier vectoriel. À privilégier partout où le SVG s'affiche.
> > >
> > > **square** `object` *required*
> > >
> > > La vignette carrée (32x32).
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **dark** `object` *required*
> > > >
> > > > La variante de couleurs pour les surfaces sombres.
> > > >
> > > > > [accordion] Propriétés
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Image matricielle de secours à la taille native de la forme.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Image matricielle de secours en double densité.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Image matricielle de secours en quadruple densité.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > Le fichier vectoriel. À privilégier partout où le SVG s'affiche.
> > > >
> > > > **light** `object` *required*
> > > >
> > > > La variante de couleurs pour les surfaces claires.
> > > >
> > > > > [accordion] Propriétés
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Image matricielle de secours à la taille native de la forme.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Image matricielle de secours en double densité.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Image matricielle de secours en quadruple densité.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > Le fichier vectoriel. À privilégier partout où le SVG s'affiche.
> >
> > **installment\_count** `number | null` *required*
> >
> > Moyens de paiement échelonnés uniquement : le nombre de paiements en lesquels
> > le prélèvement est divisé. Il s'agit d'une donnée, pas d'un texte — composez et
> > traduisez le libellé côté client.
> >
> > **payment\_method\_type** `string` *required*
> >
> > L'identifiant du type de moyen de paiement, par ex. `card`, `klarna`, `apple_pay`.
>
> **payment\_method\_type** `string | null` *required*
>
> La manière dont le client a payé, comme `card` ou `paypal`.
>
> **payment\_processor** `string | null` *required*
>
> Obsolète : n'est plus renseigné. Toujours `null`. OBSOLÈTE : n'est plus renseigné. Toujours null.

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

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

**reason** `string` *required*

La raison pour laquelle le client affirme contester, normalisée entre les processeurs et les réseaux de cartes. `other` couvre un motif de processeur que Whop n'a pas encore catégorisé.

Options 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*

Le code de motif brut du réseau de cartes ou du processeur, comme `10.4`. À
titre informatif uniquement — `reason` n'en est pas dérivé.

**status** `string` *required*

`needs_response` attend des preuves (après le refus d'un dépôt par un processeur, `submission_failure_reason` en indique la raison) ; `generating_response` signifie que les preuves sont chez le processeur, mais pas encore acceptées ; `under_review` est en cours d'examen par le processeur ; `won`/`lost` sont les décisions ; `prevented` se règle comme `lost`. Les statuts `warning_` correspondent aux niveaux des demandes de renseignements. Après `evidence_due_at`, un litige ouvert indique `under_review`.

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

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

La raison pour laquelle le processeur de paiement a refusé le dernier dépôt,
en langage clair, tant que le litige est revenu à `needs_response`. Corrigez
ce qui est indiqué et soumettez à nouveau. Uniquement lors de la récupération :
`dispute.updated` signale le retour à `needs_response`, puis lisez ce champ
ici.

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

Date de dernière modification du litige, sous forme d'horodatage ISO 8601.

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

La variante sur laquelle le paiement contesté a été effectué, préfixée par
`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"
}
```
