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

> Henvis virksomheder til Whop, og tjen på deres aktivitet med et henvisningslink og indtjening, du kan læse fra API'et.

Du tjener, så længe henvisningen varer, på fire separate indtægtskilder. Ét kald tilmelder dig og returnerer dit link. Alt andet rapporterer, hvad du har henvist, og hvad du har tjent.

## Hvad du kan bygge

* **Et henvisningsprogram, du selv driver**, hvor du deler dit eget link med dit eget publikum.
* **Rapportering om det, du har henvist**: hvilke virksomheder og brugere der stadig er aktive, og hvad hver enkelt genererer.
* **Indtjeningsopgørelser** specificeret ned til transaktionen og satsen bag hver linje.
* **En offentlig stillingsside** fra partner-leaderboardet.

## Kerneobjekter

Partner, henvist virksomhed, partnerindtjening. Hver enkelt er defineret i [Kernebegreber](https://docs.whop.com/da/developer/concepts.md).

## Tilmelding

[`POST /partners`](https://docs.whop.com/da/api-reference/partners/enroll-as-a-whop-partner) tilmelder den kaldende bruger og gør vedkommendes partnervirksomheder berettiget til indtjening. Det returnerer `referral_link`, den URL, du deler for at blive krediteret, og `whop_partner_enabled_at`. En ny tilmelding bevarer det oprindelige tilmeldingstidspunkt i stedet for at nulstille det, og det er derfor, kaldet er sikkert at gentage.

Kræver tilladelsen `partner:create`. Læsning af henvisninger og indtjening kræver `partner:basic:read`, og visning af henviste virksomheder accepterer også `referral:basic:read`. Se [Tilladelser](https://docs.whop.com/da/developer/guides/permissions.md).

## Hvad du tjener på

`payout_percentages` på en henvist virksomhed angiver din sats pr. indtægtskilde som en brøk, så `0.3` betyder 30 %. Tre af de fire er en andel af Whops bruttofortjeneste. Annonceforbrug er undtagelsen, og det er en andel af selve forbruget.

| `income_source` | Din andel er af |
| - | - |
| `sales` | Whops fortjeneste på virksomhedens produktsalg |
| `ad_spend` | Virksomhedens forbrug på Whop Ads |
| `transfer` | Whops fortjeneste på overførsler af platformsaldo |
| `card_interchange` | Whops fortjeneste på kortinterchange |

For en virksomhed, der er lukket for en partnervirksomhed, tilhører satsen teamet. [`GET /partners/businesses/:id`](https://docs.whop.com/da/api-reference/partners/retrieve-a-referred-business) returnerer også `my_payout_percentages`, din egen andel af hver sats. Det er hele satsen, når du selv har henvist virksomheden. Ved en partnervirksomheds aftale er det din teamandel af satsen. En manager tjener sin andel minus andelen for personen under sig, og en aftaledeltager tjener sin andel. Den er `null`, når du ikke tjener noget på virksomheden.

[`GET /partners/businesses`](https://docs.whop.com/da/api-reference/partners/list-referred-businesses) viser alt, hvad du har henvist, nyeste først. Hver partnervirksomhed har et `coma_`-ID, en `status` på `active` eller `removed` samt `referral_started_at` og `referral_expires_at`.

`earnings_usd` og `volume_usd` er objekter frem for enkelte tal. `earnings_usd` opdeles i `completed`, `pending` og `total`. `volume_usd` opdeles i `attributed`, `awaiting_settlement` og `settled`.

## Læsning af indtjening

[`GET /partners/businesses/{id}/earnings`](https://docs.whop.com/da/api-reference/partners/list-referred-business-earnings) specificerer, hvad Whop betaler dig for én virksomhed. Hver indtjening angiver sin `income_source`, det `transaction_amount_usd`, den stammer fra, og din `payout_percentage`.

Indtjening afregnes, før den udbetales. Både `commission_amount_usd` og `payout_percentage` er `null`, indtil det sker.

| `status` | Betydning |
| - | - |
| `awaiting_settlement` | Den underliggende transaktion er endnu ikke afregnet |
| `pending` | Afregnet, endnu ikke udbetalt |
| `completed` | Udbetalt |
| `canceled` | Annulleret før udbetaling, med `cancelation_reason` |
| `reversed` | Tilbageført efterfølgende, med `cancelation_reason` |

Hvor dataene findes, opdeler `financial_activity` de indtægts- og omkostningslinjer, der ligger bag kommissionen. Den er `null` for indtjening, der blev afregnet, før Whop registrerede den detalje.

## Leaderboardet

[`GET /partners/leaderboard`](https://docs.whop.com/da/api-reference/partners/retrieve-the-leaderboard) rangerer henvisere efter partnerindtjening. Parameteren `period` tager `day`, `month`, `year`, `last_30_days` eller `all_time` og er som standard `all_time`.

Godkendelse er valgfri. Anonyme kaldere får placeringerne i `leaders`, og godkendte kaldere får også deres egen placering i `me`, som er `null`, når du endnu ikke har nogen henvisningsindtjening.

## Hvor du skal hen nu

> [card] [Tilmeld dig som partner](https://docs.whop.com/da/api-reference/partners/enroll-as-a-whop-partner.md)
>
> Ét kald for at blive medlem og få dit henvisningslink.

> [card] [Vis dine henvisninger](https://docs.whop.com/da/api-reference/partners/list-referred-businesses.md)
>
> Alle virksomheder, du har bragt ind, med indtjening.

> [card] [Affiliates](https://docs.whop.com/da/developer/guides/affiliates.md)
>
> Sporing af henvisninger i dine egne produkter.

> [card] [Partner-reference](https://docs.whop.com/da/api-reference/partners/partner)
>
> Alle partner-endpoints med en playground.


## Related topics

- [Partners API](https://docs.whop.com/da/api-reference/partners/partner.md)
- [Enroll as a Whop Partner](https://docs.whop.com/da/api-reference/partners/enroll-as-a-whop-partner.md)
- [Whop API-oversigt](https://docs.whop.com/da/api-reference/overview.md)
