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

# Betalingsgezondheid

> Gebruik het Payment health-dashboard om je geschillen- en terugbetalingspercentages te volgen en de beperkingen op je account te bekijken.

Je **Payment health**-dashboard laat zien hoe geschillen en terugbetalingen je account en betalingsbeperkingen beïnvloeden. Je vindt het in je dashboard onder **Payments** → **Payment health**, op [whop.com/dashboard/payments/health](https://whop.com/dashboard/payments/health/).

## Wat een geschillenpercentage is

Een geschil (ook wel chargeback genoemd) ontstaat wanneer een klant zijn bank vraagt een betaling terug te draaien in plaats van jou om een terugbetaling te vragen. Je geschillenpercentage is het aandeel van je betalingen dat in een geschil eindigt.

Een paar geschillen zijn normaal voor elk bedrijf. Het probleem is het percentage. Kaartnetwerken houden elke verkoper aan een maximaal geschillenpercentage, en de grens waar het om draait is **1,5%**. Het programma en de limiet van elk netwerk staan in [Monitoringprogramma's voor geschillen](https://docs.whop.com/nl/trust-and-safety/account-health/dispute-monitoring-programs.md). Blijf eronder en je staat er goed voor. Ga eroverheen en dat heeft gevolgen voor jou en voor Whop.

## Je geschillenpercentage, op twee manieren gemeten

Het dashboard toont je geschillenpercentage in twee modi: **30d window** en **By purchase date**. Ze beantwoorden verschillende vragen.

* **30d window**: geschillen ingediend in de afgelopen 30 dagen ÷ betalingen ontvangen in de afgelopen 30 dagen.
* **By purchase date**: neemt de betalingen uit één periode en kijkt hoeveel daarvan betwist zijn. Geschillen ingediend binnen N dagen na de betaling ÷ betalingen ontvangen in de periode, waarbij N de selector **Disputed within 7 days**, **Disputed within 14 days** of **Disputed within 28 days** is. Het dashboard koppelt elk geschil aan de betaaldatum, niet aan de indieningsdatum.

Stel bijvoorbeeld dat je in de afgelopen 30 dagen 1.000 betalingen hebt ontvangen en dat er in die tijd 10 geschillen binnenkwamen:

3 op betalingen uit de afgelopen 30 dagen
7 op oudere betalingen

Het **30d window**-percentage telt alle 10 geschillen: 10 ÷ 1.000 = **1%**. Het **By purchase date**-percentage telt alleen de 3 die bij de betalingen van deze maand horen: 3 ÷ 1.000 = **0,3%** tot nu toe. Dat percentage blijft stijgen naarmate er meer geschillen over de betalingen van deze maand binnenkomen.

Welke je in de gaten moet houden, hangt af van je situatie:

* **Als je verkopen stabiel zijn**, zien de twee percentages er ongeveer hetzelfde uit.
* **Als je snel groeit**, lijkt het 30d window-percentage laag omdat klanten nog geen tijd hebben gehad om je nieuwste betalingen te betwisten. Houd in plaats daarvan het percentage op aankoopdatum in de gaten: het toont je geschillenpercentage voordat het 30d-cijfer bijtrekt.

> [!NOTE]
>
> De weergave op aankoopdatum telt betalingen pas mee nadat hun volledige
> geschillenperiode is verstreken. Als je bedrijf gisteren een betaling heeft
> ontvangen, is de periode van 28 dagen nog niet verstreken, dus kan de
> weergave die nog niet meetellen.

## Statussen

Elke geschillenpercentage-metriek krijgt een status: **Healthy**, **At risk** of **Critical**. De grafiek tekent de exacte banden voor elke metriek, en elk tabblad voor een betaalmethode heeft zijn eigen banden: American Express, Discover en 'nu kopen, later betalen'-methoden worden aan andere grenzen gehouden dan standaardkaarten. [Monitoringprogramma's voor geschillen](https://docs.whop.com/nl/trust-and-safety/account-health/dispute-monitoring-programs.md) vermeldt elke grens. Als je account nog niet genoeg betalingen of geschillen heeft om te beoordelen, toont de metriek in plaats daarvan **Low data**.

## De beperkingen op je account

Het onderdeel **Controls** van de pagina toont de [betalingsbeperkingen](https://docs.whop.com/nl/trust-and-safety/account-health/controls.md) die momenteel op je account zijn ingesteld: je reserve, drempels voor automatische terugbetaling, wachtperiode, kosten en beschikbaarheid van financiering. Beoordelingen lopen doorlopend, en beperkingen worden automatisch versoepeld of opgeheven naarmate je account herstelt.

## Terugbetalingspercentage

Het dashboard toont ook je terugbetalingspercentage: uitgevoerde terugbetalingen als aandeel van de betalingen. Lees het naast je geschillenpercentage. Een laag terugbetalingspercentage met een hoog geschillenpercentage betekent dat klanten die hun geld terug wilden naar hun bank gingen in plaats van naar jou.

## Waarom klanten betwisten

De kaart **Why customers dispute** splitst je geschillen uit naar reden. Elke reden wijst naar een oplossing:

| Reden | Wat de klant zegt | De oplossing |
| - | - | - |
| **Fraudulent** | "Ik herken deze afschrijving niet" | Gebruik een duidelijke factuuromschrijving en vermeld verlengingen vooraf |
| **Not received** | "Mijn bestelling is nooit aangekomen" | Voeg tracking toe en geef eerlijke levertijden op |
| **Subscription canceled** | "Ik heb opgezegd maar er werd toch afgeschreven" | Maak opzeggen makkelijk en verwerk het snel |
| **Product unacceptable** | "Dit is niet wat mij was beloofd" | Zorg dat je storefront overeenkomt met wat je werkelijk levert |
| **Credit not processed** | "Mij was een terugbetaling beloofd en die heb ik nooit gekregen" | Voer verschuldigde terugbetalingen snel uit |

> [!TIP]
>
> Als één reden de grafiek domineert, begin daar. Het grootste deel aanpakken
> verbetert je percentage het meest.

## Volgende stappen

> [card] [Monitoringprogramma's voor geschillen](https://docs.whop.com/nl/trust-and-safety/account-health/dispute-monitoring-programs.md)
>
> Het programma van elk kaartnetwerk, hoe het geschillen telt en de limiet.

> [card] [Betalingsbeperkingen](https://docs.whop.com/nl/trust-and-safety/account-health/controls.md)
>
> Wat elke beperking op je account doet en hoe beperkingen worden opgeheven.

> [card] [Geschillenpercentages beheren](https://docs.whop.com/nl/trust-and-safety/account-health/managing-dispute-rates.md)
>
> De concrete stappen die een geschillenpercentage omlaag brengen.


## Related topics

- [Programma's voor geschilbewaking](https://docs.whop.com/nl/trust-and-safety/account-health/dispute-monitoring-programs.md)
- [Reserves](https://docs.whop.com/nl/trust-and-safety/account-health/reserves.md)
- [Betalingscontroles](https://docs.whop.com/nl/trust-and-safety/account-health/controls.md)
