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

# Disputes API

> Een Dispute is een chargeback die een klant via de bank tegen een betaling indient, of een navraag die er een kan worden.

Een dispute bevat de betwiste betaling, een deadline om te reageren, je bewijs en de uitkomst zodra de verwerker een uitspraak doet.

Gebruik de Disputes API om disputes weer te geven, het bewijspakket te bewerken zolang een dispute nog betwistbaar is en het ter beoordeling in te dienen, of om een chargeback te accepteren die je niet wilt betwisten.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Disputes weergeven](https://docs.whop.com/nl/api-reference/disputes/list-disputes.md) | GET `/disputes` |
| [Dispute ophalen](https://docs.whop.com/nl/api-reference/disputes/retrieve-dispute.md) | GET `/disputes/{id}` |
| [Dispute-overzicht ophalen](https://docs.whop.com/nl/api-reference/disputes/retrieve-dispute-summary.md) | GET `/disputes/summary` |
| [Dispute accepteren](https://docs.whop.com/nl/api-reference/disputes/accept-dispute.md) | POST `/disputes/{id}/accept` |
| [Dispute indienen](https://docs.whop.com/nl/api-reference/disputes/submit-dispute.md) | POST `/disputes/{id}/submit` |
| [Dispute-bewijs uploaden](https://docs.whop.com/nl/api-reference/disputes/upload-dispute-evidence.md) | POST `/disputes/{id}/upload_evidence` |
| [Dispute bijwerken](https://docs.whop.com/nl/api-reference/disputes/update-dispute.md) | PATCH `/disputes/{id}` |

## Attributen

**id** `string` *required*

Dispute-ID, met prefix `dspt_`.

**acceptable** `boolean` *required*

Of de dispute aan de klant kan worden toegegeven met `POST /disputes/\{id}
      	/accept`. Alleen true voor een chargeback die nog op een reactie wacht, vóór
`evidence_due_at`, waarvan de betalingsverwerker het accepteren van disputes
ondersteunt. Navragen kunnen nooit worden geaccepteerd.

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

Het account waartegen de dispute is ingediend, met prefix `biz_`.

**amount** `number` *required*

Het betwiste bedrag, in hele eenheden van `currency`.

**buyer** `object` *required*

De klant die de dispute heeft ingediend.

> [accordion] Eigenschappen
>
> **email** `string | null` *required*
>
> Het e-mailadres van de klant. Vereist de scope `member:email:read`; zonder die
> scope `null`.
>
> **member\_id** `string | null` *required*
>
> De ledenregel van de klant op het account, met prefix `mem_`.
>
> **name** `string | null` *required*
>
> De weergavenaam van de klant.
>
> **user\_id** `string | null` *required*
>
> Het gebruikers-ID van de klant, met prefix `user_`. `null` bij een
> gastcheckout.
>
> **username** `string | null` *required*
>
> De Whop-gebruikersnaam van de klant.

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

Wanneer de dispute is geopend, als ISO 8601-tijdstempel.

**currency** `string` *required*

ISO-valutacode van drie letters van het betwiste bedrag.

**evidence** `object` *required*

Het bewijspakket dat naar de verwerker wordt gestuurd om de dispute te betwisten.

> [accordion] Eigenschappen
>
> **access\_activity\_log** `string | null` *required*
>
> Log van de toegang van de klant tot het product, zoals aanmeld- of
> downloadactiviteit.
>
> **billing\_address** `string | null` *required*
>
> Het factuuradres dat de klant bij de checkout heeft opgegeven.
>
> **cancellation\_policy\_attachment** `object | null` *required*
>
> Het document met het annuleringsbeleid. Standaard het annuleringsbeleid van het account, daarna de servicevoorwaarden, daarna het retourbeleid en daarna het platformbeleid van Whop.
>
> > [accordion] Eigenschappen
> >
> > **id** `string | null` *required*
> >
> > Het ID van de bijlage. `null` voor een door Whop gehost beleid, dat geen
> > geüpload bestand is.
> >
> > **content\_type** `string | null` *required*
> >
> > Het MIME-type van het geüploade bestand.
> >
> > **filename** `string | null` *required*
> >
> > De naam van het geüploade bestand.
> >
> > **platform** `boolean` *required*
> >
> > Of dit het eigen gehoste beleid van Whop is, dat wordt gebruikt omdat de
> > verkoper er geen heeft geüpload. Het terugsturen hiervan in een PATCH verandert
> > niets.
> >
> > **url** `string | null` *required*
> >
> > Een URL om de bijlage te downloaden.
>
> **cancellation\_policy\_disclosure** `string | null` *required*
>
> Hoe het annuleringsbeleid vóór de aankoop aan de klant is getoond.
>
> **customer\_communication\_attachment** `object | null` *required*
>
> Correspondentie met de klant, of bewijs dat de klant het product heeft gebruikt.
>
> > [accordion] Eigenschappen
> >
> > **id** `string | null` *required*
> >
> > Het ID van de bijlage. `null` voor een door Whop gehost beleid, dat geen
> > geüpload bestand is.
> >
> > **content\_type** `string | null` *required*
> >
> > Het MIME-type van het geüploade bestand.
> >
> > **filename** `string | null` *required*
> >
> > De naam van het geüploade bestand.
> >
> > **platform** `boolean` *required*
> >
> > Of dit het eigen gehoste beleid van Whop is, dat wordt gebruikt omdat de
> > verkoper er geen heeft geüpload. Het terugsturen hiervan in een PATCH verandert
> > niets.
> >
> > **url** `string | null` *required*
> >
> > Een URL om de bijlage te downloaden.
>
> **customer\_email\_address** `string | null` *required*
>
> Het e-mailadres dat de klant bij de checkout heeft gebruikt.
>
> **customer\_name** `string | null` *required*
>
> De naam van de klant zoals opgegeven bij de checkout.
>
> **documents** `object[]` *required*
>
> Aanvullende bewijsdocumenten, naast de vier vaste plekken — ingesteld via `evidence.documents` op `PATCH /disputes/\{id}`. Elk document gaat onder het eigen `document_type` mee in het ingediende pakket.
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > Het ID van het bestand, met prefix `file_`.
> >
> > **blurhash** `string | null` *required*
> >
> > BlurHash-placeholder voor een afbeelding of video. Null wanneer niet
> > beschikbaar of verwijderd door moderatie.
> >
> > **content\_type** `string | null` *required*
> >
> > Het MIME-type van het geüploade bestand. Uploads zijn beperkt tot de typen die de verwerker accepteert en worden zonder type geweigerd — nooit null.
> >
> > Beschikbare opties: `application/pdf`, `application/json`, `image/jpeg`, `image/png`, `image/webp`
> >
> > **created\_at** `string` *required*
> >
> > Wanneer het bestand is aangemaakt, als ISO 8601-tijdstempel.
> >
> > **document\_type** `string` *required*
> >
> > Wat dit document bewijst. `return_policy`, `cancellation_policy` en `terms_of_service` zijn de beleidsdocumenten van de verkoper. Een beleidsdocument vervangt voor deze dispute het exemplaar van het account. `return_policy`, `cancellation_policy` en `customer_communication` vervangen ook de overeenkomende vaste bewijsplek. `shipping_policy` zijn de verzendvoorwaarden van de verkoper. `customer_communication` is correspondentie met de koper, zoals een supportthread of chatlog. `product_image` is een foto van het product of de dienst die de koper heeft ontvangen. `physical_fulfillment` is bewijs dat een fysieke bestelling is verzonden en aangekomen. `digital_fulfillment` is bewijs dat de koper een digitaal product heeft geopend. `customer_order_history` zijn de eerdere bestellingen van de koper bij deze verkoper. `prior_transactions` is de betalingsgeschiedenis van de koper op het hele platform, voor een verweer tegen fraude. `customer_session` zijn checkoutgegevens, zoals IP-adres, apparaatvingerafdruk, AVS- en CVV-resultaten en het 3D Secure-resultaat. `subscription` is bewijs over de levenscyclus van het lidmaatschap, zoals verlengingen, annulering en verzonden herinneringen. `complete_evidence` is het volledige antwoord van de verkoper als één PDF van maximaal 19 pagina's, en moet het enige document zijn. Whop stuurt een `complete_evidence`-document naar de verwerker in plaats van elk ander bewijsveld, elke bijlage en elk document.
> >
> > Beschikbare opties: `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*
> >
> > Duur van audio of video in seconden. Null wanneer niet beschikbaar of
> > verwijderd door moderatie.
> >
> > **filename** `string | null` *required*
> >
> > De oorspronkelijke bestandsnaam, inclusief extensie.
> >
> > **height** `integer | null` *required*
> >
> > Hoogte van afbeelding of video in pixels. Null wanneer niet beschikbaar of
> > verwijderd door moderatie.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > De grootte in bytes die elk deel (behalve het laatste) moet hebben. Alleen
> > aanwezig bij aanmaken, en alleen voor multipart-uploads.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > Het ID van de multipart-upload, terug te geven aan `complete`. Alleen aanwezig
> > bij aanmaken, en alleen voor multipart-uploads.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > De vooraf ondertekende URL voor elk deel. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
> >
> > > [accordion] Eigenschappen
> > >
> > > **part\_number** `integer` *required*
> > >
> > > De op 1 gebaseerde index van dit deel binnen de multipart-upload.
> > >
> > > **url** `string` *required*
> > >
> > > De vooraf ondertekende URL waarnaar de bytes van dit deel met PUT worden verzonden.
> >
> > **object** `string` *required*
> >
> > Het type van dit object, altijd `file`.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > Of moderatie het bestand heeft verwijderd. Bij `true` levert `url` een
> > vervangende afbeelding. `filename`, `size` en `content_type` beschrijven nog
> > steeds het originele bestand.
> >
> > **size** `integer | null` *required*
> >
> > De bestandsgrootte in bytes. `null` totdat de upload is voltooid.
> >
> > **upload\_headers** `object`
> >
> > Headers om mee te sturen met de upload-PUT. Alleen aanwezig bij aanmaken.
> >
> > **upload\_status** `string` *required*
> >
> > Waar het bestand zich in de uploadlevenscyclus bevindt.
> >
> > Beschikbare opties: `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > Vooraf ondertekende URL waarnaar de bytes van het bestand met PUT worden
> > verzonden. Alleen aanwezig bij aanmaken, en alleen voor uploads in één deel.
> >
> > **url** `string | null` *required*
> >
> > Een URL om het bestand te downloaden. Openbare bestanden krijgen een permanente
> > CDN-URL en privébestanden een ondertekende URL die verloopt. `null` totdat de
> > upload is voltooid. Wanneer moderatie het bestand verwijdert, een URL van een
> > vervangende afbeelding.
> >
> > **visibility** `string` *required*
> >
> > `public`-bestanden worden geleverd vanaf een niet-ondertekende CDN-URL. `private`-bestanden worden geleverd vanaf een ondertekende URL die verloopt.
> >
> > Beschikbare opties: `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > URL van de audiogolfvorm. Null wanneer niet beschikbaar of verwijderd door
> > moderatie.
> >
> > **width** `integer | null` *required*
> >
> > Breedte van afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **notes** `string | null` *required*
>
> Eventuele aanvullende context voor de verwerker die de dispute beoordeelt.
>
> **product\_description** `string | null` *required*
>
> Wat de klant heeft gekocht, in de eigen woorden van de verkoper.
>
> **refund\_policy\_attachment** `object | null` *required*
>
> Het document met het terugbetalingsbeleid. Standaard het retourbeleid van het account, daarna de servicevoorwaarden en daarna het platformbeleid van Whop.
>
> > [accordion] Eigenschappen
> >
> > **id** `string | null` *required*
> >
> > Het ID van de bijlage. `null` voor een door Whop gehost beleid, dat geen
> > geüpload bestand is.
> >
> > **content\_type** `string | null` *required*
> >
> > Het MIME-type van het geüploade bestand.
> >
> > **filename** `string | null` *required*
> >
> > De naam van het geüploade bestand.
> >
> > **platform** `boolean` *required*
> >
> > Of dit het eigen gehoste beleid van Whop is, dat wordt gebruikt omdat de
> > verkoper er geen heeft geüpload. Het terugsturen hiervan in een PATCH verandert
> > niets.
> >
> > **url** `string | null` *required*
> >
> > Een URL om de bijlage te downloaden.
>
> **refund\_policy\_disclosure** `string | null` *required*
>
> Hoe het terugbetalingsbeleid vóór de aankoop aan de klant is getoond.
>
> **refund\_refusal\_explanation** `string | null` *required*
>
> Waarom een terugbetaling is geweigerd, wanneer erom werd gevraagd en deze werd
> afgewezen.
>
> **service\_date** `string | null` *required*
>
> Wanneer het product of de dienst is geleverd.
>
> **uncategorized\_attachment** `object | null` *required*
>
> Ondersteunend bewijs dat niet in de andere categorieën past.
>
> > [accordion] Eigenschappen
> >
> > **id** `string | null` *required*
> >
> > Het ID van de bijlage. `null` voor een door Whop gehost beleid, dat geen
> > geüpload bestand is.
> >
> > **content\_type** `string | null` *required*
> >
> > Het MIME-type van het geüploade bestand.
> >
> > **filename** `string | null` *required*
> >
> > De naam van het geüploade bestand.
> >
> > **platform** `boolean` *required*
> >
> > Of dit het eigen gehoste beleid van Whop is, dat wordt gebruikt omdat de
> > verkoper er geen heeft geüpload. Het terugsturen hiervan in een PATCH verandert
> > niets.
> >
> > **url** `string | null` *required*
> >
> > Een URL om de bijlage te downloaden.

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

De deadline om bewijs in te dienen, als ISO 8601-tijdstempel. `null` wanneer
het netwerk de dispute al automatisch heeft afgehandeld (Visa RDR) zonder
bewijsronde, of wanneer de verwerker voor deze dispute geen deadline heeft
gerapporteerd.

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

Of `evidence` nog kan worden gewijzigd en ingediend.

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

Waarom het bewijs niet meer kan worden bewerkt. `null` zolang `evidence_editable` true is.

Beschikbare opties: `submitted`, `response_window_closed`, `not_contestable`

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

Wanneer het bewijs bij de verwerker is ingediend, als ISO 8601-tijdstempel.

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

De disputekosten die aan het account in rekening zijn gebracht, in de valuta waarin ze zijn geïnd. `null` wanneer `fee_charged` false is.

> [accordion] Eigenschappen
>
> **amount** `string` *required*
>
> Het bedrag in hoofdeenheden, als exacte decimale string. Bijvoorbeeld `"10.00"`
> is tien dollar. Het is een string zodat geen float het onderweg afrondt.
>
> **currency** `string` *required*
>
> ISO 4217-valutacode van drie letters, in kleine letters.
>
> **decimals** `integer` *required*
>
> Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de afschrijving
> zelf wordt uitgevoerd.
>
> **display\_decimals** `integer` *required*
>
> Hoeveel decimalen er moeten worden GETOOND. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgeschreven maar in hele peso's geschreven, dus is het `2` en `0`. Gebruik dit om het getal in je eigen locale op te maken.

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

Of Whop het account voor deze dispute disputekosten in rekening heeft
gebracht. `false` wanneer de betaling volledig was terugbetaald voordat de
dispute werd geopend, bij een Visa RDR-afhandeling en bij een navraag.

**inquiry** `boolean` *required*

Of dit een navraag voorafgaand aan een dispute is in plaats van een formele
chargeback.
Navragen volgen dezelfde levenscyclus maar verplaatsen geen geld, tenzij er een escaleert.

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

Wat de kaartuitgever zei bij het indienen van de dispute. Alleen gevuld wanneer de uitgever opmerkingen aanlevert, en weergegeven in de volgorde waarin ze zijn ontvangen.

> [accordion] Eigenschappen
>
> **received\_at** `string | null` *required*
>
> Wanneer de opmerking is ontvangen, als ISO 8601-tijdstempel.
>
> **text** `string` *required*
>
> Wat de uitgever schreef, zoals ontvangen.

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

Alles waarvoor de betwiste betaling in rekening bracht, in aankoopvolgorde. `product_id` en `variant_id` verwijzen naar het eerste item; latere items in een winkelwagen verschijnen alleen hier. Een betaling die is gedaan voordat items werden vastgelegd, toont het ene item dat de variant impliceert. Leeg wanneer de betaling niet aan een variant is gekoppeld.

> [accordion] Eigenschappen
>
> **id** `string | null` *required*
>
> Regelitem-ID, met prefix `li_`. Null wanneer de betaling van vóór de
> itemsnapshots is en het item uit de variant van de betaling wordt gelezen.
>
> **label** `string | null` *required*
>
> De naam van het item zoals getoond bij de checkout (de producttitel, anders de
> varianttitel).
>
> **product\_id** `string | null` *required*
>
> Het product waartoe de variant behoort, met prefix `prod_`. Bij een betaling
> van vóór de itemsnapshots valt dit terug op het product van de variant, dus
> het kan zijn ingesteld waar de eigen `product_id` van het bovenliggende object
> null is. Null voor een variant zonder product.
>
> **product\_title** `string | null` *required*
>
> De huidige titel van het product, of `null` wanneer het item geen product
> heeft.
>
> **quantity** `number` *required*
>
> Hoeveel eenheden er zijn gekocht.
>
> **sku** `string | null` *required*
>
> De stock keeping unit van de variant, vrije tekst ingesteld door de verkoper
> (bijv. `TSHIRT-LARGE-BLUE`). Accounts waarvoor SKU-achtervoegsels op basis van
> factureringsreden zijn ingeschakeld, ontvangen deze met een stempel van de
> reden van de afschrijving: `-S` voor een eerste abonnementsbetaling, `-R` voor
> een verlenging, `-C` voor een eenmalige aankoop, `-U` wanneer de eigen
> metadata van de betaling `upsell: true` bevat, `-F` wanneer er niets in
> rekening is gebracht. Andere factureringsredenen bevatten de kale SKU. `null`
> wanneer de variant geen SKU heeft of is verwijderd.
>
> **subtotal** `object | null` *required*
>
> Het vastgelegde bedrag voor de volledige hoeveelheid van dit item, vóór kortingen, belasting en kosten, in de aankoopvaluta. Retourneert `null` wanneer er geen itembedrag is vastgelegd.
>
> > [accordion] Eigenschappen
> >
> > **amount** `string` *required*
> >
> > Het bedrag in hoofdeenheden, als exacte decimale string. Bijvoorbeeld `"10.00"`
> > is tien dollar. Het is een string zodat geen float het onderweg afrondt.
> >
> > **currency** `string` *required*
> >
> > ISO 4217-valutacode van drie letters, in kleine letters.
> >
> > **decimals** `integer` *required*
> >
> > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de afschrijving
> > zelf wordt uitgevoerd.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hoeveel decimalen er moeten worden GETOOND. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgeschreven maar in hele peso's geschreven, dus is het `2` en `0`. Gebruik dit om het getal in je eigen locale op te maken.
>
> **variant\_id** `string | null` *required*
>
> De gekochte variant, met prefix `plan_`. Null wanneer de variant inmiddels is
> verwijderd.
>
> **variant\_title** `string | null` *required*
>
> De huidige titel van de variant, of `null` wanneer de variant is verwijderd of geen titel heeft.

**payment** `object` *required*

De betaling die wordt betwist.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Betalings-ID, met prefix `pay_`.
>
> **amount** `number | null` *required*
>
> Wat de klant in rekening is gebracht, in hele eenheden van de valuta van de
> betaling.
>
> **card\_brand** `string | null` *required*
>
> Kaartmerk, wanneer de klant met een kaart heeft betaald.
>
> **card\_last4** `string | null` *required*
>
> Laatste vier cijfers van de kaart, wanneer de klant met een kaart heeft
> betaald.
>
> **created\_at** `string` *required*
>
> Wanneer de betaling is gedaan, als ISO 8601-tijdstempel.
>
> **currency** `string | null` *required*
>
> ISO-valutacode van drie letters van de betaling. Kan afwijken van de valuta van
> de dispute wanneer de verwerker in een andere valuta afrekent.
>
> **payment\_instrument** `object | null` *required*
>
> Het betaalinstrument waarmee deze betaling is gedaan, opgemaakt voor weergave: het type betaalmethode, een naam voor de koper, de standaard pictogrammenset en de kaartgegevens, inclusief het netwerktransactie-ID dat het account voor de kaart gebruikt, als het een kaart was. Null wanneer de betaling geen methode vermeldt.
>
> > [accordion] Eigenschappen
> >
> > **card** `object | null` *required*
> >
> > Alleen voor betalingen met kaart, Apple Pay en Google Pay: het netwerk, de laatste vier cijfers, het issuer identification number, de vervaldatum en het netwerktransactie-ID van de kaart.
> >
> > > [accordion] Eigenschappen
> > >
> > > **brand** `string | null` *required*
> > >
> > > De netwerkidentificatie (`visa`, `amex`, …), overeenkomend met items in
> > > `card.networks` en opgeslagen kaartbetaalmethoden. Null wanneer de vault het
> > > netwerk niet heeft vastgelegd.
> > >
> > > **exp\_month** `number | null` *required*
> > >
> > > De vervalmaand van de kaart, 1 tot en met 12. Null wanneer de vault deze niet
> > > heeft vastgelegd.
> > >
> > > **exp\_year** `number | null` *required*
> > >
> > > Het viercijferige vervaljaar van de kaart. Null wanneer de vault dit niet heeft
> > > vastgelegd.
> > >
> > > **issuer\_identification\_number** `string | null` *required*
> > >
> > > Het issuer identification number, ook wel de BIN genoemd: de eerste zes of
> > > acht cijfers van de kaart, die de uitgevende bank identificeren. Null wanneer
> > > de verwerker dit niet heeft gerapporteerd.
> > >
> > > **last4** `string | null` *required*
> > >
> > > De laatste vier cijfers van de kaart, indien vastgelegd.
> > >
> > > **network\_transaction\_id** `string | null` *required*
> > >
> > > Het netwerktransactie-ID dat dit account voor de kaart gebruikt. Dit is het eigen ID van dit account, afkomstig van de eerste afschrijving of verificatie met aanwezige klant op de kaart, als Whop er een heeft. Anders is het een eerder netwerktransactie-ID voor deze kaart, dat afkomstig kan zijn van een transactie van een ander account of met de kaart is meegebracht. Vermeld het als de voorgaande transactie bij een latere door de merchant geïnitieerde afschrijving van deze kaart bij dit account. Null totdat er een is. Een webhook die wordt verzonden wanneer een betaling voor het eerst wordt vastgelegd, kan `null` bevatten; haal de betaling op om het te lezen.
> >
> > **display\_name** `string` *required*
> >
> > Naam van het instrument voor de koper — "Visa •••• 4242" wanneer de kaart
> > bekend is, anders de eigen naam van de methode ("Klarna").
> >
> > **icons** `object` *required*
> >
> > De standaard pictogrammenset: vierkante en kaartvormen, elk in lichte en donkere kleurvarianten.
> >
> > > [accordion] Eigenschappen
> > >
> > > **card** `object` *required*
> > >
> > > De tegel met creditcardverhoudingen (48x30).
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **dark** `object` *required*
> > > >
> > > > De kleurvariant voor donkere achtergronden.
> > > >
> > > > > [accordion] Eigenschappen
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Rasterterugval op de oorspronkelijke grootte van de vorm.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Rasterterugval op dubbele dichtheid.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Rasterterugval op viervoudige dichtheid.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > Het vectorbestand. Gebruik dit bij voorkeur overal waar SVG wordt weergegeven.
> > > >
> > > > **light** `object` *required*
> > > >
> > > > De kleurvariant voor lichte achtergronden.
> > > >
> > > > > [accordion] Eigenschappen
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Rasterterugval op de oorspronkelijke grootte van de vorm.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Rasterterugval op dubbele dichtheid.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Rasterterugval op viervoudige dichtheid.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > Het vectorbestand. Gebruik dit bij voorkeur overal waar SVG wordt weergegeven.
> > >
> > > **square** `object` *required*
> > >
> > > De vierkante tegel (32x32).
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **dark** `object` *required*
> > > >
> > > > De kleurvariant voor donkere achtergronden.
> > > >
> > > > > [accordion] Eigenschappen
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Rasterterugval op de oorspronkelijke grootte van de vorm.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Rasterterugval op dubbele dichtheid.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Rasterterugval op viervoudige dichtheid.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > Het vectorbestand. Gebruik dit bij voorkeur overal waar SVG wordt weergegeven.
> > > >
> > > > **light** `object` *required*
> > > >
> > > > De kleurvariant voor lichte achtergronden.
> > > >
> > > > > [accordion] Eigenschappen
> > > > >
> > > > > **png\_1x** `string` *required*
> > > > >
> > > > > Rasterterugval op de oorspronkelijke grootte van de vorm.
> > > > >
> > > > > **png\_2x** `string` *required*
> > > > >
> > > > > Rasterterugval op dubbele dichtheid.
> > > > >
> > > > > **png\_4x** `string` *required*
> > > > >
> > > > > Rasterterugval op viervoudige dichtheid.
> > > > >
> > > > > **svg** `string` *required*
> > > > >
> > > > > Het vectorbestand. Gebruik dit bij voorkeur overal waar SVG wordt weergegeven.
> >
> > **installment\_count** `number | null` *required*
> >
> > Alleen voor betaalmethoden in termijnen: in hoeveel betalingen de afschrijving
> > wordt opgesplitst. Data, geen tekst — stel het label aan de clientzijde samen en
> > vertaal het daar.
> >
> > **payment\_method\_type** `string` *required*
> >
> > De identificatie van het type betaalmethode, bijv. `card`, `klarna`, `apple_pay`.
>
> **payment\_method\_type** `string | null` *required*
>
> Hoe de klant heeft betaald, zoals `card` of `paypal`.
>
> **payment\_processor** `string | null` *required*
>
> Verouderd: wordt niet meer gevuld. Altijd `null`. VEROUDERD: wordt niet meer gevuld. Altijd null.

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

Het product waarvoor de betwiste betaling was, met prefix `prod_`.

**reason** `string` *required*

Waarom de klant zegt de betaling te betwisten, genormaliseerd over verwerkers en kaartnetwerken heen. `other` omvat een reden van de verwerker die Whop nog niet heeft gecategoriseerd.

Beschikbare opties: `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*

De ruwe redencode van het kaartnetwerk of de verwerker, zoals `10.4`. Alleen
ter informatie — `reason` wordt er niet van afgeleid.

**status** `string` *required*

`needs_response` wacht op bewijs (nadat een verwerker een indiening heeft geweigerd, geeft `submission_failure_reason` de reden); `generating_response` heeft bewijs bij de verwerker dat nog niet is geaccepteerd; `under_review` ligt bij de verwerker; `won`/`lost` zijn de uitspraken; `prevented` wordt afgewikkeld zoals `lost`. De `warning_`-statussen zijn de niveaus voor navragen. Na `evidence_due_at` rapporteert een openstaande dispute `under_review`.

Beschikbare opties: `needs_response`, `warning_needs_response`, `under_review`, `warning_under_review`, `generating_response`, `won`, `lost`, `prevented`, `warning_closed`

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

Waarom de betalingsverwerker de laatste indiening heeft geweigerd, in gewone
taal (Engels), terwijl de dispute weer in `needs_response` staat. Los op wat
er wordt genoemd en dien opnieuw in. Alleen bij ophalen: `dispute.updated`
meldt de terugkeer naar `needs_response`; lees dit veld daarna hier.

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

Wanneer de dispute voor het laatst is gewijzigd, als ISO 8601-tijdstempel.

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

De variant waarop de betwiste betaling is gedaan, met prefix `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"
}
```
