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

# Kostenopslagen & subsidies

> Configureer opslagen op platformkosten en uitbetalingssubsidies voor subaccounts, met voorbeelden, ondersteunde limieten en vereisten voor het beschikbare saldo.

Met kostenopslagen kan je platform aanpassen wat subaccounts bovenop de kosten van Whop betalen. Positieve opslagen leveren je platform omzet op. Negatieve uitbetalingsopslagen subsidiëren de opnamekosten van een subaccount vanuit het saldo van je platform. Whop ontvangt nog steeds zijn volledige vergoeding.

## Opslagen configureren

Gebruik de API-sleutel van je platform met de permissie `company:update_child_fees`. Gebruik [Retrieve account fees](https://docs.whop.com/nl/api-reference/accounts/retrieve-account-fees.md) om de effectieve tarieven, standaardwaarden en de aanpasbaarheid van elke opslag te bekijken.

Gebruik [Update account fees](https://docs.whop.com/nl/api-reference/accounts/update-account-fees.md) met `PATCH /api/v1/accounts/{account_id}/fees`:

| Geldt voor | Account-ID in de URL | Sectie van het verzoek |
| - | - | - |
| Subaccounts zonder aangepast tarief | Je platform | `child_markups` |
| Eén subaccount | Dat subaccount | `markups` |

Elke opslag heeft een `percentage` en een vast bedrag (`fixed`). `percentage: 1` betekent 1%. Stel `fixed` in in Amerikaanse dollars. Uitbetalingsopslagen worden bij het in rekening brengen omgerekend naar de valuta van de opname.

Dit voorbeeld stelt voor één subaccount een opslag voor uitbetalingen per bankoverschrijving (wire) in van 1% min \$ 0,60:

```bash theme={null}
curl --request PATCH \
  --url https://api.whop.com/api/v1/accounts/biz_SUBACCOUNT_ID/fees \
  --header "Authorization: Bearer $WHOP_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "markups": {
      "payouts": {
        "bank_wire": { "percentage": 1, "fixed": -0.60 }
      }
    }
  }'
```

Stuur voor een standaardwaarde op platformniveau hetzelfde `payouts`-object onder `child_markups` naar het account-ID van je platform. Stel een tarief in voor elke uitbetalingsmethode met de keys die het fees-endpoint teruggeeft.

## Betalingsopslagen per betaalmethode

`payments` is de opslag op elke betaling die een subaccount ontvangt zonder applicatievergoeding bij de checkout. Stel een betaalmethode in onder `payment_methods` om die anders te belasten:

| Key | Betaalmethoden |
| - | - |
| `card` | Kaarten, inclusief Apple Pay en Google Pay |
| `ach` | Betalingen via Amerikaanse bankrekeningen en Amerikaanse bankoverschrijvingen |
| `wire` | Bankoverschrijvingen (wires), binnenlands en internationaal |

Elke andere betaalmethode gebruikt de opslag `payments`.

```json theme={null}
{
  "child_markups": {
    "payments": { "percentage": 2, "fixed": 0.30 },
    "payment_methods": {
      "card": { "percentage": 3, "fixed": 0.30 },
      "ach": { "percentage": 1, "fixed": 0 }
    }
  }
}
```

### Kaartopslagen per regio

Het eigen kaarttarief van Whop hangt af van de regio van de acquirer die de betaling verwerkt. Stel `card_regions` in om kaarten in elke regio anders te prijzen. Een kaartbetaling uit een regio zonder eigen opslag gebruikt `payment_methods.card`.

| Key | Kaartbetalingen verwerkt door een acquirer in |
| - | - |
| `usa` | De Verenigde Staten |
| `eu` | Europa |
| `uk` | Het Verenigd Koninkrijk |
| `ca` | Canada |
| `au` | Australië |

```json theme={null}
{
  "child_markups": {
    "card_regions": {
      "usa": { "percentage": 0.55, "fixed": 0.30 },
      "uk": { "percentage": 0.5, "fixed": 0.20 }
    }
  }
}
```

Een betaling gebruikt de eerste opslag die ze vindt, in deze volgorde:

1. De opslag van het subaccount voor de regio van de kaartbetaling.
2. De opslag van het subaccount voor de betaalmethode.
3. De `payments`-opslag van het subaccount.
4. De platformstandaard voor de regio van de kaartbetaling.
5. De platformstandaard voor de betaalmethode.
6. De `payments`-standaard van het platform.

Stap 1 en 4 gelden alleen voor kaartbetalingen. Een tarief dat voor één subaccount is ingesteld, gaat altijd voor op een platformstandaard.

## Een opslag wijzigen of wissen

* Weggelaten velden behouden hun effectieve waarden. Stel voor een opslag met alleen een percentage expliciet `fixed: 0` in.
* Stel zowel `percentage: 0` als `fixed: 0` in om een opslag voor dat account uit te schakelen. Het subaccount betaalt nog steeds de vergoeding van Whop.
* Stuur `null` voor het hele tarief, zoals `markups: { payouts: { bank_wire: null } }`, om een override voor een subaccount te verwijderen en de platformstandaard te herstellen, of nul als die er niet is.

## Hoe uitbetalingssubsidies werken

De opslag combineert het percentage van het opnamebedrag met het vaste bedrag. Als het resultaat negatief is, betaalt je platform dat bedrag aan de vergoeding van Whop. De subsidie stopt wanneer de totale kosten van het subaccount nul bereiken. De uitbetaling wordt nooit hoger dan het opnamebedrag.

Deze voorbeelden gebruiken een opname van $10 en een Whop-vergoeding van$ 0,60. De \$ 0,60 is een voorbeeldtarief, geen standaardprijs voor elke uitbetalingsmethode.

| Percentage | Vast | Kosten subaccount | Netto-uitbetaling | Whop ontvangt | Wijziging platformsaldo |
| - | - | - | - | - | - |
| 0.4% | \$2.00 | \$2.64 | \$7.36 | \$0.60 | +\$2.04 |
| 1% | −\$0.60 | \$0.10 | \$9.90 | \$0.60 | −\$0.50 |
| −5% | \$0.00 | \$0.10 | \$9.90 | \$0.60 | −\$0.50 |
| 0% | −\$100.00 | \$0.00 | \$10.00 | \$0.60 | −\$0.60 |

## Limieten en financiering

| Regel | Gedrag |
| - | - |
| Limieten voor uitbetalingsopslagen | Elk onderdeel kan negatief zijn: −100% tot 100%, en −$100 tot$ 100 vast. De werkelijke subsidie kan de vergoeding van Whop niet overschrijden. |
| Limieten voor andere opslagen | 0% tot 100%, en $0 tot$ 100 vast. Negatieve waarden worden geweigerd voor opslagen die geen uitbetalingsopslagen zijn. |
| Platformsaldo | Houd voldoende beschikbaar saldo aan in de opnamevaluta om de subsidie te dekken. De saldocontrole en de afschrijving gebeuren tegelijk. |
| Onvoldoende saldo | De uitbetaling blijft in behandeling terwijl Whop het opnieuw probeert. Financier het platform vóór de aanmaakdeadline, ongeveer 10 minuten. Anders mislukt de uitbetaling zonder dat er geld wordt verplaatst. |
| Volledige kostendekking | Wanneer `covered_payout_fees` de uitbetalingsmethode dekt, betaalt het platform de volledige vergoeding van Whop en wordt de opslag genegeerd. |

Voor een opname uit een EUR-saldo heeft je platform EUR nodig om de subsidie te financieren. Een USD-saldo dekt dit niet automatisch.

Bekijk een [uitbetalingsofferte](https://docs.whop.com/nl/api-reference/payouts/create-payout-quote.md) voordat je de uitbetaling aanmaakt. Een offerte toont de kosten, maar reserveert geen platformgeld. Het saldo van het platform wordt gecontroleerd wanneer de uitbetaling wordt afgeschreven. De werkelijke kosten hangen af van de uitbetalingsmethode en de prijsafspraken van je account.


## Related topics

- [Vergoedingsopslag](https://docs.whop.com/nl/api-reference/legacy/fee-markups/fee-markup.md)
- [Create fee markup](https://docs.whop.com/nl/api-reference/legacy/fee-markups/create-fee-markup.md)
- [Delete fee markup](https://docs.whop.com/nl/api-reference/legacy/fee-markups/delete-fee-markup.md)
