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

# Reserves

> Waarom Whop een deel van je saldo in reserve houdt, hoe elk type reserve werkt en wanneer Whop vastgehouden geld vrijgeeft

Een reserve is een deel van je saldo dat Whop gedurende een bepaalde periode niet uitbetaalt. Gereserveerd geld is nog steeds jouw geld. Het telt mee voor je totale saldo, is nooit een vergoeding en komt automatisch terug in je beschikbare saldo.

## Waarom reserves nodig zijn

Wanneer een klant een betaling betwist, trekt Whop het betalingsbedrag en eventuele geschilkosten van het kaartnetwerk af van je saldo. Als merchant of record is Whop verantwoordelijk voor die bedragen, ook wanneer een bedrijf zijn geld al heeft opgenomen of zijn bestellingen niet kan leveren.

Het kan gebeuren dat het saldo van een account niet genoeg is om toekomstige geschillen en terugbetalingen te dekken. Om die situatie te voorkomen, plaatst Whop reserves waar het verliezen verwacht. De reserve bestaat om die verliezen te dekken. Als de verliezen nooit optreden, geeft Whop het geld volledig vrij en heft de reserve op. Dit proces kan lastig zijn, maar het beschermt zowel je bedrijf als je klanten.

## Wanneer een reserve wordt geplaatst

Whop beoordeelt elk account doorlopend. Het stemt reserves af op het specifieke risico van elk account. Dat risico omvat hoeveel van je recente volume nog blootstaat aan terugbetalingen of geschillen en hoe waarschijnlijk die uitkomsten zijn, op basis van je staat van dienst. Whop kan een reserve plaatsen of verhogen wanneer:

* Je account nieuw is of nog weinig verkoopgeschiedenis heeft
* Terugbetalingen en geschillen hoog zijn ten opzichte van je verkopen, of je geschillenpercentage richting de drempels van kaartnetwerken gaat
* Je een hoog percentage onopgeloste zaken in het [Resolution Center](https://docs.whop.com/nl/payments/resolution-center.md) hebt
* Je lang na de betaling van de klant levert, zoals bij pre-orders, boekingen of diensten van meerdere maanden, zodat betalingen lang na de verkoop betwistbaar blijven
* Een plotselinge verandering in je verkooppatronen de blootstelling aan terugbetalingen of geschillen vergroot

Dezelfde beoordeling werkt in beide richtingen. Je reserve krimpt en verdwijnt uiteindelijk naarmate deze omstandigheden verbeteren. Je geschillenpercentage kan bijvoorbeeld dalen, of oudere verkopen kunnen buiten hun geschillenperiode vallen.

> [!NOTE]
>
> Je kunt elke reserve op je account bekijken, uitgesplitst naar type met
> bedragen en vrijgavedatums, op de pagina
> [Balances](https://whop.com/dashboard/balance/) van je dashboard.

## Doorlopende reserve

Whop houdt een percentage van elke verkoop een vast aantal dagen vast en geeft het daarna vrij. Whop koppelt elke inhouding aan de verkoop waaruit die ontstond, zodat geld doorlopend terugkomt naarmate elke verkoop zijn inhoudingsperiode voorbij is. Je krijgt ouder geld terug in hetzelfde tempo waarin Whop geld van nieuwe verkopen vasthoudt.

Bijvoorbeeld, met een reserve van 10% en een inhoudingsperiode van 90 dagen:

| Verkoop | Bedrag | Vastgehouden | Vrijgave |
| - | - | - | - |
| 1 maart | \$1.000 | \$100 | 30 mei |
| 15 maart | \$500 | \$50 | 13 juni |
| 1 april | \$2.000 | \$200 | 30 juni |

Verkoop 1 mrt

\$100 vastgehouden → vrij op 30 mei

Verkoop 15 mrt

\$50 vastgehouden → vrij op 13 jun

Verkoop 1 apr

\$200 vastgehouden → vrij op 30 jun

1 mrt
1 apr
1 mei
1 jun
30 jun

Je reserve-overzicht toont altijd je huidige percentage en inhoudingsperiode. Als Whop je reservepercentage verlaagt, geldt het lagere percentage voor nieuwe verkopen. Geld dat al in reserve staat, behoudt zijn oorspronkelijke vrijgavedatum. Als Whop je reserve volledig verwijdert, wordt het vastgehouden geld direct vrijgegeven naar je beschikbare saldo.

### Hoe de inhoudingsperiode wordt bepaald

Een verkoop blijft niet eeuwig een risico. Zodra je het product hebt geleverd en de gebruikelijke periode voor terugbetalingen of geschillen voorbij is, blijft er weinig over dat een reserve moet dekken. Whop stemt de inhoudingsperiode af op die levenscyclus. Die duurt lang genoeg om je leveringscyclus te dekken plus de periode na levering waarin terugbetalingen en geschillen doorgaans binnenkomen. Als je direct levert, is die periode kort. Als klanten maanden voor de levering betalen, is die langer.

## Reserve met vast bedrag

Soms houdt Whop een specifiek bedrag in dollars van je bestaande saldo vast, in plaats van een percentage van nieuwe verkopen. Dit is een reserve met vast bedrag. Die kan op zichzelf gelden of naast een doorlopende reserve, en houdt nooit meer vast dan er daadwerkelijk in je saldo staat.

Een reserve met vast bedrag is één bedrag ineens met één vrijgavedatum, weergegeven als een eigen regel in je reserve-overzicht. Op die datum wordt het volledige bedrag in één keer vrijgegeven. Het kan ook eerder vrijkomen. Als Whop het bedrag verlaagt, gaat het verschil direct terug naar je beschikbare saldo. Als Whop de reserve verwijdert, gaat het volledige bedrag direct terug.

Bijvoorbeeld: een reserve met vast bedrag van \$5.000, geplaatst op 1 juni met een inhoudingsperiode van 90 dagen, wordt op 30 augustus volledig vrijgegeven:

Inhouding 1 jun

\$5.000 vastgehouden → volledig vrij op 30 aug

1 jun
1 jul
1 aug
30 aug

## Hoe reserves worden vrijgegeven

Elke inhouding heeft een vrijgavedatum, zichtbaar in je reserve-overzicht. Wanneer die datum aanbreekt, wordt het geld automatisch naar je beschikbare saldo overgezet.

Als je een betaling volledig terugbetaalt, geeft Whop de bijbehorende reserve vrij naar je beschikbare saldo.

## Reserves voor financiering (BNPL)

Voor verkopen die via een aanbieder van 'nu kopen, later betalen' worden gefinancierd, geldt een reserve die door die aanbieder wordt vastgesteld, niet door Whop. Jij krijgt vooraf betaald terwijl de klant de aanbieder in termijnen betaalt, dus de aanbieder vereist een inhouding op een deel van elke gefinancierde verkoop totdat het betalingsplan is afgerond. Deze reserves gelden voor gefinancierde verkopen ongeacht de gezondheid van je account, en verschijnen in je reserve-overzicht als eigen regels met eigen vrijgavedatums.

De gids van elke aanbieder beschrijft de reserve in detail:

* [Splitit](https://docs.whop.com/nl/payments-and-billing/financing/splitit-guide.md): 15% van elke gefinancierde verkoop, 180 dagen vastgehouden
* [SeQura](https://docs.whop.com/nl/payments-and-billing/financing/sequra-guide.md): 12% van elke gefinancierde verkoop, met een inhoudingsperiode van ongeveer 12 maanden

## Je reserves bekijken

De pagina [Balances](https://whop.com/dashboard/balance/) toont je volledige reserve-overzicht: het totaal vastgehouden bedrag, elk type reserve met het huidige percentage en de inhoudingsperiode, en de exacte datums waarop geld vrijkomt.

Je kunt hetzelfde overzicht ook programmatisch opvragen via de API, met `GET /accounts/{account_id}/reserves`.

## Volgende stappen

> [card] [Geschillenpercentages beheren](https://docs.whop.com/nl/trust-and-safety/account-health/managing-dispute-rates.md)
>
> Geschillen laag houden is de snelste manier om een reserve te verkleinen,
> en om er nooit een te krijgen.

> [card] [Betalingsgezondheid](https://docs.whop.com/nl/trust-and-safety/account-health/payment-health.md)
>
> Lees je Payment health-dashboard en de beperkingen op je account.


## Related topics

- [Splitit-gids](https://docs.whop.com/nl/payments-and-billing/financing/splitit-guide.md)
- [SeQura-gids](https://docs.whop.com/nl/payments-and-billing/financing/sequra-guide.md)
- [Geschillen beheren](https://docs.whop.com/nl/manage-your-business/manage-payments/manage-disputes.md)
