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

# Voorkeursvaluta voor verrekening

> Zet elke nieuwe verkoop om naar USD, EUR, GBP, CAD of AUD. Bekijk welke verkopen worden omgezet en hoe terugbetalingen, geschillen en platformkosten worden verrekend.

Stel een voorkeursvaluta voor verrekening in om alle nieuwe omzet in één saldo te zetten. Whop zet elke nieuwe verkoop om naar die valuta wanneer de koper betaalt, zodat je vóór een uitbetaling geen kleine saldi hoeft om te wisselen.

| | Oorspronkelijke valuta (standaard) | Voorkeursvaluta voor verrekening |
| - | - | - |
| **Waar een verkoop wordt verrekend** | Een saldo in de valuta van het plan | Een saldo in de valuta die je kiest |
| **Te beheren saldi** | Eén per planvaluta | Eén |
| **Extra kosten** | Geen | 0,5% op elke omgezette verkoop |

## Een valuta kiezen

> [tab] Dashboard
>
> 1. Selecteer in je dashboardinstellingen **Payments**.
> 2. Selecteer onder **Preferred settlement currency** een valuta bij **Settle every new sale in**.
> 3. Selecteer **Save changes**.

> [tab] API
>
> Stuur een valutacode in kleine letters naar [Update Account Preferences](https://docs.whop.com/nl/api-reference/accounts/update-account-preferences.md). Stuur `null` om de instelling uit te schakelen.
>
> ```typescript TypeScript theme={null}
> import { WhopClient } from "@whop/sdk";
>
> const client = new WhopClient({ token: process.env.WHOP_API_KEY });
>
> const preferences = await client.accounts.preferences.update({
> 	account_id: "biz_xxxxxxxxxxxxx",
> 	preferred_settlement_currency: "usd",
> });
>
> console.log(preferences.preferred_settlement_currency_changeable_at);
> ```
>
> ```python Python theme={null}
> import os
>
> from whop_sdk import Whop
>
> client = Whop(token=os.environ["WHOP_API_KEY"])
>
> preferences = client.accounts.preferences.update(
>     account_id="biz_xxxxxxxxxxxxx",
>     preferred_settlement_currency="usd",
> )
>
> print(preferences.preferred_settlement_currency_changeable_at)
> ```
>
> ```ruby Ruby theme={null}
> require "whop_sdk"
>
> client = Whop_sdk::Client.new(token: ENV.fetch("WHOP_API_KEY"))
>
> preferences = client.accounts.preferences.update(
>   account_id: "biz_xxxxxxxxxxxxx",
>   preferred_settlement_currency: "usd"
> )
>
> puts preferences.preferred_settlement_currency_changeable_at
> ```
>
> ```bash cURL theme={null}
> curl -X PATCH "https://api.whop.com/api/v1/accounts/biz_xxxxxxxxxxxxx/preferences" \
>   -H "Authorization: Bearer $WHOP_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "preferred_settlement_currency": "usd" }'
> ```
>
> Het antwoord geeft de voorkeuren van het account terug:
>
> ```json theme={null}
> {
> 	"preferred_settlement_currency": "usd",
> 	"preferred_settlement_currency_changeable_at": "2026-10-22T14:03:11.000Z"
> }
> ```

Een wijziging geldt alleen voor nieuwe verkopen. Geld dat al in je saldi staat, blijft in zijn valuta.

## Weten welke verkopen worden omgezet

Een verkoop wordt omgezet wanneer de valuta van het plan niet je voorkeursvaluta is. De valuta waarin de koper betaalt, verandert daar niets aan.

Deze verkopen worden nooit omgezet:

* Verkopen op plannen die al in je voorkeursvaluta staan.
* App Store-aankopen. Apple betaalt deze in USD uit.
* Verkopen die buiten je Whop-saldo worden verrekend, zoals verkopen via een Stripe-account dat je hebt gekoppeld.

Whop legt de wisselkoers vast wanneer de koper betaalt en slaat deze op bij de betaling. De instelling heeft geen effect op de koper. De koper betaalt de prijs die bij de checkout wordt getoond, en het ontvangstbewijs toont dat bedrag.

## Kostenstructuur

Voor elke omgezette verkoop geldt een vergoeding van 0,5%. Je gebruikelijke kosten gelden ook. De betaling toont de 0,5% op de regel **Currency conversion**.

Whop rekent de 0,5% niet aan wanneer de koper betaalt in een andere valuta dan die van het plan. [Adaptieve prijzen](https://docs.whop.com/nl/payments-and-billing/fees/adaptive-pricing.md) rekent al kosten aan voor die omzetting bij de checkout.

Deze voorbeelden gebruiken USD als voorkeursvaluta:

| Planvaluta | Koper betaalt in | Verrekend in | 0,5% kosten |
| - | - | - | - |
| USD | USD of EUR | USD | Nee. Het plan staat al in USD. |
| GBP | GBP | USD | Ja |
| GBP | EUR of USD | USD | Nee. De koper heeft in een andere valuta betaald. |
| MXN | MXN | USD | Ja |
| GBP, App Store | GBP | USD | Nee. Apple betaalt in USD uit. |

## Terugbetalingen en geschillen

Een terugbetaling of geschil wordt afgeschreven van het saldo waarin de verkoop is verrekend.

* **Terugbetalingen** gebruiken de wisselkoers die bij de betaling is opgeslagen. Een koerswijziging na de verkoop verandert het bedrag niet.
* **Geschillen** gebruiken de wisselkoers op de dag dat het geschil wordt geopend. Het bedrag kan afwijken van de omgezette verkoop.

## Platforms en subaccounts

De instelling geldt alleen voor het account dat deze instelt. Een subaccount neemt de instelling van zijn platform niet over, en een platform neemt de instellingen van zijn subaccounts niet over.

Je applicatiekosten volgen jouw instelling. Whop zet elke vergoeding om naar jouw valuta tegen de wisselkoers op de dag van de verkoop. Het aandeel van het subaccount volgt de instelling van het subaccount.

Whop rekent je 0,5% aan op omgezette applicatiekosten. Whop rekent de 0,5% niet aan wanneer het plan van de verkoop al in jouw valuta staat.

## Bedragen op een betaling uitlezen

Een [betaling](https://docs.whop.com/nl/api-reference/payments/payment) geeft bedragen in twee valuta's. Elk bedrag bevat een eigen `currency`.

| Velden | Valuta | Te gebruiken voor |
| - | - | - |
| `total`, `subtotal`, `tax_amount`, `refunded_amount`, `amount_after_fees` | De verrekeningsvaluta | Saldi, uitbetalingen en reconciliatie van het grootboek |
| `presentment_total`, `presentment_tax_amount`, `presentment_refunded_amount` | De valuta waarin de koper heeft betaald | Ordertotalen, ontvangstbewijzen en e-mails aan klanten |

Vergelijk `presentment_total` om een betaling aan een order in je systeem te koppelen. De instelling verandert die waarde niet. `presentment_total` bevat geen kosten voor de koper. [Betalingswebhooks](https://docs.whop.com/nl/developer/guides/webhooks.md) versturen dezelfde velden.

## Volgende stappen

> [card] [Referentie voor accountvoorkeuren](https://docs.whop.com/nl/api-reference/accounts/update-account-preferences.md)
>
> Elk voorkeursveld en de scope die elk veld nodig heeft.

> [card] [Adaptieve prijzen](https://docs.whop.com/nl/payments-and-billing/fees/adaptive-pricing.md)
>
> Toon kopers bij de checkout prijzen in hun lokale valuta.
