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

# App-installationer

> Få besked, når en konto installerer eller fjerner din app, og knyt hver installation til den post, den hører til i dit eget system.

En app-installation er én installation af din app på én Whop-konto. Din app modtager `app_installation.created`, når en konto installerer den, og `app_installation.deleted`, når en konto fjerner den. Hver installation gemmer også to værdier, som kun din app kan ændre. `external_id` knytter installationen til en post i dit system, og `metadata` indeholder små værdier som f.eks. en synkroniseringsmarkør.

## En webshop, der modtager betalinger via Whop

Denne guide følger en opdigtet app. Market Lane er et værktøj til at bygge onlinebutikker, og dets Whop-app lader en virksomhed modtage betalinger i sin Market Lane-butik via Whop. Hver butik har et handle, f.eks. `river-coffee`, og hver checkout på Market Lane starter med det handle.

Market Lane skal vide tre ting:

1. Hvornår en virksomhed installerer appen, så den kan forbinde virksomhedens butik.
2. Hvilken Whop-konto der modtager betalingen, når en checkout starter i en butik.
3. Hvornår en virksomhed fjerner appen, så dens butik holder op med at tilbyde Whop ved checkout.

**1. Anmod om de tilladelser, din app har brug for**

I din apps [tilladelser](https://docs.whop.com/da/developer/guides/permissions.md) skal du anmode om `checkout_configuration:create` for at oprette checkouts på kontoen og `webhook_receive:payments` for at få besked, når de er betalt. Virksomheden godkender begge, når den installerer appen.

**2. Abonner med din apps webhook**

Opret én webhook, der tilhører din app, ikke din konto: Sæt `resource_id` til din apps ID. Den modtager installationshændelserne for hver konto, der installerer din app, plus de betalingshændelser, som disse konti har givet adgang til.

```bash theme={null}
curl -X POST "https://api.whop.com/api/v1/webhooks" \
  -H "Authorization: Bearer $WHOP_DEVELOPER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://marketlane.example/webhooks/whop",
    "resource_id": "app_XXXXXXXX",
    "events": ["app_installation.created", "app_installation.deleted", "payment.succeeded"]
  }'
```

Nøglen skal have `developer:manage_webhook` på den konto, der ejer appen. Gem `webhook_secret` fra svaret, og verificer hver levering som beskrevet i [Webhooks](https://docs.whop.com/da/developer/guides/webhooks.md).

Kun din apps egne webhooks modtager installationshændelser. En kontos webhooks gør det aldrig, heller ikke for de apps, der er installeret på kontoen.

**3. Forbind butikken, når en virksomhed installerer appen**

`app_installation.created` indeholder installationen i `data`. Konvoluttens `account_id` er den virksomhed, der installerede appen:

```json theme={null}
{
  "type": "app_installation.created",
  "account_id": "biz_J8n2R5p9T1w4Kx",
  "data": {
    "id": "aag_T4k8M2p6W9r3Qx",
    "app": { "id": "app_XXXXXXXX", "name": "Market Lane" },
    "account": { "id": "biz_J8n2R5p9T1w4Kx", "title": "River Coffee" },
    "external_id": null,
    "metadata": {},
    "requesting_reauthorization": false
  }
}
```

Market Lane spørger virksomheden, hvilken butik der skal forbindes. Når den vælger `river-coffee`, gemmer Market Lane handlet på installationen som `external_id`:

```bash theme={null}
curl -X PATCH "https://api.whop.com/api/v1/app_installations/aag_T4k8M2p6W9r3Qx" \
  -H "Authorization: Bearer $WHOP_APP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "river-coffee",
    "metadata": { "connected_at": "2026-10-26T00:00:00Z" }
  }'
```

**4. Find kontoen, når en checkout starter**

En kunde gennemfører checkout på `river-coffee`. Forespørgslen indeholder kun butikkens handle, så Market Lane slår installationen op via `external_id`:

```bash theme={null}
curl "https://api.whop.com/api/v1/app_installations?external_id=river-coffee" \
  -H "Authorization: Bearer $WHOP_APP_API_KEY"
```

Resultatet indeholder højst én installation, og dens `account.id` er den konto, der modtager betalingen. Market Lane opretter en checkout på den konto med `POST /checkout_configurations`, lægger sit eget ordre-ID i `metadata` og sender kunden til `purchase_url`. Market Lane har ingen tabel over butikshandles og Whop-konti, fordi installationen er koblingen.

**5. Marker ordren som betalt**

`payment.succeeded` ankommer på samme webhook. Dens `account_id` er butikkens virksomhed, og betalingen indeholder `metadata` fra checkouten, så Market Lane finder ordren via dens ID og markerer den som betalt.

**6. Slå Whop-betalinger fra, når virksomheden fjerner appen**

`app_installation.deleted` ankommer, så snart en virksomhed fjerner din app. Market Lane holder straks op med at tilbyde Whop ved checkout på `river-coffee`, så ingen kunde når frem til en checkout, der ville mislykkes. Installationen vises ikke længere i `GET /app_installations`, og din app kan ikke længere handle på den konto.

**7. Genforbind ved geninstallation**

Hvis virksomheden installerer appen igen, får du endnu en `app_installation.created`. Det er den samme installation: `id`, `created_at`, `external_id` og `metadata` kommer alle tilbage. Market Lane ser `external_id: "river-coffee"` i payloaden og slår Whop-betalinger til igen for den butik uden at bede virksomheden om at forbinde den igen.

## Gem dit eget ID på en installation

* **`external_id` er unikt på tværs af din apps installationer.** Hvis du sætter en værdi, som en anden installation allerede har, returneres en `409`, så to virksomheder aldrig kan gøre krav på den samme butik. Der skelnes mellem store og små bogstaver: `River-Coffee` og `river-coffee` er forskellige.
* **`metadata` flettes.** De nøgler, du sender, sættes, en nøgle sat til `null` fjernes, nøgler, du udelader, ændres ikke, og `{}` rydder alle nøgler. Værdier er strenge.
* **En fjernet installation beholder sit `external_id`.** Så længe en virksomhed har fjernet din app, kan ingen anden installation af din app tage den værdi. Hvis virksomheden installerer appen igen, kommer værdien med tilbage.
* **Gem ikke hemmeligheder.** Din udviklerkonto kan læse `metadata` og `external_id`.

## Håndter gentagne hændelser

* **Forvent gentagelser.** En virksomhed kan installere, fjerne og installere din app igen. Behandl `app_installation.created` for en installation, du allerede kender, som en geninstallation.
* **Ignorer dubletter via `webhook-id`.** Whop forsøger leveringer igen, der ikke får et `2xx`-svar, og et genforsøg beholder samme `webhook-id`.

## Hvem kan læse installationer

| Kalder | Adgang |
| - | - |
| Din apps API-nøgle | Lister, henter og opdaterer din apps installationer, inklusive `metadata` og `external_id`. Nøglen skal have `developer:app_installation:read` for at læse og `developer:app_installation:update` for at opdatere. |
| Din udviklerkonto | Lister alle installationer af din app med `GET /app_installations?app_id=app_XXXXXXXX`. Kræver `developer:basic:read`. |
| Den konto, appen er installeret på | Lister de apps, der er installeret på den. Den ser altid `metadata` og `external_id` som `null`. |

## Næste trin

> [card] [Webhooks](https://docs.whop.com/da/developer/guides/webhooks.md)
>
> Verificer signaturer, håndter genforsøg, og se alle hændelser.

> [card] [API-reference for App Installations](https://docs.whop.com/da/api-reference/app-installations/app-installation)
>
> Alle felter og endpoints for app-installationer.

> [card] [Modtag betalinger](https://docs.whop.com/da/developer/guides/accept-payments.md)
>
> Opret checkouts, og lever ordrer ud fra `payment.succeeded`.

> [card] [Tilladelser](https://docs.whop.com/da/developer/guides/permissions.md)
>
> Angiv de tilladelser, din app anmoder om ved installation.


## Related topics

- [Planlagte kørsler](https://docs.whop.com/da/developer/guides/scheduled-runs.md)
- [Webhooks](https://docs.whop.com/da/developer/guides/webhooks.md)
- [List App Installations](https://docs.whop.com/da/api-reference/app-installations/list-app-installations.md)
