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

# Whop Partners API

> Verwijs bedrijven door naar Whop en verdien aan hun activiteit, met een referrallink en verdiensten die je via de API kunt uitlezen.

Je verdient zolang de referral duurt, op vier afzonderlijke inkomstenbronnen. Eén aanroep schrijft je in en geeft je link terug. Al het andere rapporteert wat je hebt doorverwezen en wat je hebt verdiend.

## Wat je kunt bouwen

* **Een referralprogramma dat je zelf runt**, waarbij je je eigen link deelt met je eigen publiek.
* **Rapportage over wat je hebt doorverwezen**: welke bedrijven en gebruikers nog actief zijn en wat elk ervan oplevert.
* **Overzichten van verdiensten**, uitgesplitst tot op de transactie en het tarief achter elke regel.
* **Een openbare ranglijstpagina** op basis van het partnerleaderboard.

## Kernobjecten

Partner, doorverwezen bedrijf, partnerverdienste. Elk object wordt gedefinieerd in [Kernconcepten](https://docs.whop.com/nl/developer/concepts.md).

## Inschrijven

[`POST /partners`](https://docs.whop.com/nl/api-reference/partners/enroll-as-a-whop-partner) schrijft de aanroepende gebruiker in en maakt diens partnerbedrijven in aanmerking voor verdiensten. De aanroep geeft `referral_link` terug, de URL die je deelt om erkend te worden, en `whop_partner_enabled_at`. Opnieuw inschrijven behoudt het oorspronkelijke inschrijvingsmoment in plaats van het te resetten, waardoor de aanroep veilig herhaald kan worden.

Vereist de permissie `partner:create`. Voor het uitlezen van referrals en verdiensten is `partner:basic:read` nodig, en voor het weergeven van doorverwezen bedrijven wordt ook `referral:basic:read` geaccepteerd. Zie [Permissies](https://docs.whop.com/nl/developer/guides/permissions.md).

## Waaraan je verdient

`payout_percentages` op een doorverwezen bedrijf geeft je tarief per inkomstenbron als fractie, dus `0.3` betekent 30%. Drie van de vier zijn een aandeel in de brutowinst van Whop. Advertentie-uitgaven vormen de uitzondering: dat is een aandeel in de uitgaven zelf.

| `income_source` | Jouw aandeel is van |
| - | - |
| `sales` | De winst van Whop op de productverkopen van het bedrijf |
| `ad_spend` | De Whop Ads-uitgaven van het bedrijf |
| `transfer` | De winst van Whop op overboekingen van platformsaldo |
| `card_interchange` | De winst van Whop op kaart-interchange |

Bij een bedrijf dat voor een partnerbedrijf is binnengehaald, behoort dat tarief toe aan het team. [`GET /partners/businesses/:id`](https://docs.whop.com/nl/api-reference/partners/retrieve-a-referred-business) geeft ook `my_payout_percentages` terug, jouw eigen deel van elk tarief. Dat is het volledige tarief wanneer je het bedrijf zelf hebt doorverwezen. Bij een deal van een partnerbedrijf is het jouw teamaandeel in het tarief. Een manager verdient zijn aandeel minus het aandeel van de persoon onder hem, en een deelnemer aan een deal verdient zijn deel. Het is `null` wanneer je niets aan het bedrijf verdient.

[`GET /partners/businesses`](https://docs.whop.com/nl/api-reference/partners/list-referred-businesses) geeft alles weer wat je hebt doorverwezen, nieuwste eerst. Elk partnerbedrijf heeft een `coma_`-ID, een `status` van `active` of `removed`, en `referral_started_at` en `referral_expires_at`.

`earnings_usd` en `volume_usd` zijn objecten in plaats van losse getallen. `earnings_usd` splitst zich op in `completed`, `pending` en `total`. `volume_usd` splitst zich op in `attributed`, `awaiting_settlement` en `settled`.

## Verdiensten uitlezen

[`GET /partners/businesses/{id}/earnings`](https://docs.whop.com/nl/api-reference/partners/list-referred-business-earnings) specificeert wat Whop je voor één bedrijf betaalt. Elke verdienste vermeldt de `income_source`, het `transaction_amount_usd` waaruit ze voortkomt en je `payout_percentage`.

Verdiensten worden eerst verrekend voordat ze worden uitbetaald. Zowel `commission_amount_usd` als `payout_percentage` zijn `null` totdat dat gebeurt.

| `status` | Betekenis |
| - | - |
| `awaiting_settlement` | De onderliggende transactie is nog niet verrekend |
| `pending` | Verrekend, nog niet uitbetaald |
| `completed` | Uitbetaald |
| `canceled` | Vóór uitbetaling ongeldig gemaakt, met `cancelation_reason` |
| `reversed` | Achteraf teruggevorderd, met `cancelation_reason` |

Waar de gegevens bestaan, splitst `financial_activity` de inkomsten- en kostenregels achter de commissie uit. Het is `null` voor verdiensten die zijn verrekend voordat Whop dat detail vastlegde.

## Het leaderboard

[`GET /partners/leaderboard`](https://docs.whop.com/nl/api-reference/partners/retrieve-the-leaderboard) rangschikt doorverwijzers op partnerverdiensten. De parameter `period` accepteert `day`, `month`, `year`, `last_30_days` of `all_time`, en staat standaard op `all_time`.

Authenticatie is optioneel. Anonieme aanroepers krijgen de ranglijst in `leaders`, en geauthenticeerde aanroepers krijgen ook hun eigen positie in `me`, dat `null` is wanneer je nog geen referralverdiensten hebt.

## Volgende stappen

> [card] [Inschrijven als partner](https://docs.whop.com/nl/api-reference/partners/enroll-as-a-whop-partner.md)
>
> Eén aanroep om deel te nemen en je referrallink te krijgen.

> [card] [Je referrals weergeven](https://docs.whop.com/nl/api-reference/partners/list-referred-businesses.md)
>
> Elk bedrijf dat je hebt binnengehaald, met verdiensten.

> [card] [Affiliates](https://docs.whop.com/nl/developer/guides/affiliates.md)
>
> Referraltracking binnen je eigen producten.

> [card] [Partners-referentie](https://docs.whop.com/nl/api-reference/partners/partner)
>
> Elk partner-endpoint, met een playground.
