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

# Fejlfinding af Whop-integrationer

> Diagnosticér og ret almindelige fejl i en Whop-integration, fra mislykkede API-anmodninger til manglende webhooks.

Når noget går i stykker, så find ud af, hvad der fejler, tjek, at du rammer det rigtige miljø, og se på fejlsvaret. De fleste problemer skyldes: forkerte legitimationsoplysninger, uoverensstemmelse mellem sandkasse og produktion, manglende tilladelse eller en webhook-handler, der ikke svarer korrekt.

## Hurtig triage

| Symptom | Tjek først | Gå i dybden |
| - | - | - |
| API-kald returnerer `4xx` eller `5xx` | Tjek statuskoden, svar-body'en, endpointet og miljøet. | [API-anmodningsfejl](#api-request-errors) |
| API-kald returnerer `401` | Bekræft, at API-nøglen findes på serveren og hører til samme miljø som API-base-URL'en. | [API-godkendelse](#api-authentication) |
| API-kald returnerer `403` | Tjek, at appen, brugeren eller kontoen har den nødvendige tilladelse til ressourcen. | [Tilladelser og scopes](#permissions-and-scopes) |
| OAuth omdirigerer tilbage med `error` | Læs `error` og `error_description` fra callback-URL'en. | [OAuth-fejl](#oauth-errors) |
| Checkout-elementet indlæses ikke, eller betalingen mislykkes | Tilknyt `onError`, undersøg den variant eller checkout-konfiguration, du sendte med, og lad køberen prøve igen inde i elementet. | [Checkout-fejl](#checkout-errors) |
| Webhooks ankommer ikke eller bliver ved med at blive forsøgt igen | Verificér, at endpointet er offentligt, returnerer `2xx` hurtigt før langvarigt arbejde og bruger den rå request-body til signaturverificering. | [Webhook-levering](#webhook-delivery) |
| Et Whop Element rapporterer `onError` | Log `message` og `code`, og bekræft derefter adgangstokenet og de indstillinger, du sendte. | [Element-fejl](#element-errors) |

## API-anmodningsfejl

Whop returnerer standard-HTTP-statuskoder. Når en anmodning fejler, fortæller svar-body'en dig hvorfor.

De fleste fejl indeholder en kode og en besked:

```json theme={null}
{
	"error": {
		"code": "invalid_request",
		"message": "Missing required parameter: account_id"
	}
}
```

Nogle OAuth-endpoints returnerer i stedet OAuth-standardfelterne `error` og `error_description`. Se [OAuth-fejl](#oauth-errors) for disse tilfælde.

| Status | Betydning | Hvad du skal gøre |
| - | - | - |
| `400` | Anmodningen har en ugyldig form eller mangler et påkrævet felt. | Tjek påkrævede parametre, enum-værdier, ID'er og formen på indlejrede objekter. |
| `401` | Anmodningen mangler gyldig godkendelse. | Bekræft, at API-nøglen eller adgangstokenet er til stede, gyldigt og sendt fra din server. |
| `403` | Legitimationsoplysningerne er gyldige, men kan ikke udføre handlingen. | Tjek app-tilladelser, OAuth-scopes, kontoejerskab og underkontokontekst. |
| `404` | Ressourcen eller endpointet blev ikke fundet. | Bekræft ruten, API-versionen og Whop-tag-ID'et, såsom `biz_`, `plan_`, `mem_` eller `user_`. |
| `409` | Anmodningen er i konflikt med ressourcens aktuelle tilstand. | Hent ressourcens seneste tilstand, og prøv kun igen, hvis handlingen stadig er relevant. |
| `422` | Anmodningen er gyldig JSON, men fejler valideringen. | Vis valideringsbeskeden til brugeren, så vedkommende kan rette sit input. |
| `429` | Klienten sendte for mange anmodninger inden for et kort tidsrum. | For `/api/v1`-anmodninger begrænser Whop autentificerede API-kald til 600 anmodninger pr. minut pr. operation og API-legitimationsoplysning. Vent, indtil genforsøgsvinduet i fejlbeskeden er overstået. |
| `5xx` | Whop kunne ikke fuldføre anmodningen. | Prøv igen med backoff for idempotente operationer, og kontakt derefter support, hvis det fortsætter. |

### Hastighedsbegrænsninger

For `/api/v1`-anmodninger sporer Whop anmodningsmængden pr. API-operation og API-legitimationsoplysning. Standardgrænsen er 600 anmodninger pr. minut.

Når du overskrider grænsen, returnerer API'et `429` med:

```json theme={null}
{
	"error": {
		"type": "rate_limit_exceeded",
		"message": "Try again in 12 seconds."
	}
}
```

Vent den forsinkelse, der står i beskeden, før du prøver igen. For idempotente anmodninger skal du prøve igen med eksponentiel backoff. Prøv ikke validerings-, godkendelses- eller tilladelsesfejl igen uden at ændre anmodningen.

## API-godkendelse

Brug de legitimationsoplysninger, der passer til, hvor koden kører.

| Legitimationsoplysning | Brug den, når | Almindelig fejl |
| - | - | - |
| Account API-nøgle | Din server handler på vegne af din egen konto. | At lægge nøglen i browser-, mobil- eller offentlig klientkode. |
| App API-nøgle | Din app-server handler på vegne af konti, der har installeret din app. | At kalde endpoints for en konto, der ikke har installeret eller autoriseret appen. |
| Kontoafgrænset brugertoken | Dit produkts egne brugere tilgår Whop uden et Whop-login. | At udelade `scoped_actions`, så tokenet arver alle tilladelser fra den API-nøgle, der udstedte det. |
| Kontoadgangstoken | En klient har brug for kortvarig adgang til din konto uden en tilknyttet bruger. | At kalde endpoints, der handler som en bruger, hvilket afviser det. |
| OAuth-adgangstoken | En logget ind bruger giver din app adgang til sin konto. | At behandle et brugerafgrænset token som en kontodækkende API-nøgle. |
| iframe-brugertoken | En Whop-app verificerer brugeren inde i en iframe-anmodning. | At springe signaturverificering over eller videresende tokenet til uvedkommende klienter. |

Hvis en API-anmodning fejler:

1. Bekræft, at miljøet matcher nøglen: SDK'ets `Production`-miljø (standarden) for produktionsnøgler og `Sandbox` for sandbox-nøgler, eller `https://api.whop.com/api/v1` og `https://sandbox-api.whop.com/api/v1`, når du kalder API'et direkte.
2. Bekræft, at ID'er bruger Whop-tag-præfikser som `biz_`, `user_`, `mem_`, `plan_`, `prod_`, `app_`, `pay_` eller `ch_`, ikke interne numeriske ID'er.
3. Log HTTP-status, svar-body, endpoint og request-ID, hvis Whop returnerer et.
4. Prøv kun igen, når fejlen er forbigående eller skyldes hastighedsbegrænsning. Prøv ikke `401`, `403` eller valideringsfejl igen uden at ændre anmodningen.

> [!WARNING]
>
> Eksponér aldrig Account API-nøgler eller App API-nøgler i kode på klientsiden. Browser-, mobil- og iframe-kode skal kalde din server, og din server skal kalde Whop.

## Tilladelser og scopes

`403`- og `insufficient_scope`-fejl betyder normalt, at legitimationsoplysningerne er gyldige, men ikke kan udføre den handling.

* For Whop-apps skal du bekræfte, at appen anmoder om de nødvendige tilladelser i [Tilladelser](https://docs.whop.com/da/developer/guides/permissions.md), og derefter gemme app-indstillingerne og geninstallere eller genautorisere, når det er nødvendigt.
* For OAuth skal du kun anmode om de scopes, din funktion har brug for, og derefter sikre dig, at brugeren gennemførte OAuth-forløbet, efter du tilføjede disse scopes.
* For API-nøgler oprettet i dashboardet skal du bekræfte, at nøglen hører til den konto, hvis ID du sender som `account_id`.
* For underkonti skal du afklare, om forældre- eller underkontoen skal eje handlingen, før du vælger den konto, du sender.

## OAuth-fejl

OAuth-fejl returnerer en standard-payload eller en omdirigerings-forespørgselsstreng med `error` og `error_description`.

```json theme={null}
{
	"error": "invalid_grant",
	"error_description": "Authorization code has expired"
}
```

| Fejl | Betydning | Løsning |
| - | - | - |
| `invalid_request` | En påkrævet parameter mangler eller er forkert udformet. | Tjek `client_id`, `redirect_uri`, `response_type`, `code_challenge` og `code_challenge_method`. |
| `invalid_grant` | Autorisationskoden, refresh-tokenet eller adgangstokenet er udløbet, allerede brugt, eller Whop har tilbagekaldt det. | Genstart OAuth-forløbet, eller bed brugeren om at logge ind igen. Autorisationskoder kan kun bruges én gang. |
| `invalid_client` | Whop genkender ikke app-klienten. | Bekræft, at du bruger den rigtige app og det rigtige miljø. |
| `invalid_scope` | Det anmodede scope er ugyldigt eller ukendt. | Tjek tilgængelige scopes i dine app-indstillinger, og fjern eventuelle stavefejl. |
| `insufficient_scope` | Tokenet indeholder ikke det scope, endpointet kræver. | Tilføj scopet i dine app-indstillinger, og kør OAuth-samtykket igen. |
| `access_denied` | Brugeren eller kontoen afviste autorisationsanmodningen. | Brugeren valgte ikke at give adgang, eller kontoen begrænser denne app. |
| `unsupported_response_type` | Parameteren `response_type` understøttes ikke. | Brug `response_type=code` til autorisationskode-forløbet. |
| `unsupported_grant_type` | Parameteren `grant_type` understøttes ikke. | Brug `authorization_code` eller `refresh_token`. |
| `rate_limit_exceeded` | OAuth-autorisations-, token- eller introspektionsanmodninger ramte en korttidsgrænse. | Vent, og respektér `Retry-After`-headeren, hvis den findes. |

> [!TIP]
>
> Omdirigerings-URI'er skal matche præcist. Hvis du har konfigureret `https://example.com/oauth/callback`, er `https://example.com/oauth/callback/` en anden URI.

## Checkout-fejl

Checkout-elementet og iOS-checkout kan fejle af forskellige årsager. Fejlsøg dem på samme måde: tjek varianten eller checkout-konfigurationen, undersøg fejl-callbacket, og bekræft leveringen på din server.

### Checkout-element

* Tilknyt `onError`. Den kører, når elementet ikke kan indlæses eller går ned, med en `message` og en `code` til programmatisk håndtering.
* Hvis du sender kompatibilitetsegenskaben `plan`, skal du bekræfte, at varianten findes, er aktiv og hører til den konto, du forventer.
* Hvis du sender `checkoutConfiguration`, skal du bekræfte, at din server har oprettet den, og at du har sendt dens `ch_`-ID.
* Alle indstillinger sættes ved oprettelsen. For at ændre ordren skal du montere en ny checkout i stedet for at kalde `update()`.
* En mislykket betaling genåbner den samme checkout med årsagen vist, så køberen kan betale igen uden genmontering.
* Angiv en `returnUrl` på en rute, der kan vise succes- og genforsøgstilstande. Et trin uden for siden, såsom 3DS eller en bankside, sender køberen tilbage dertil.
* Brug webhooks til levering. Omdirigeringen er nyttig til UI, men din server bør stole på `payment.succeeded`.

### `iOS`-checkout

Håndtér forventede og uventede fejl med forskellige forløb:

```swift theme={null}
do {
    let result = try await checkout.purchase(planId)
    print("Receipt ID: \(result.receiptId)")
} catch WhopCheckoutError.notConfigured {
    // SDK was not set up. Call WhopCheckout.configure() first.
} catch WhopCheckoutError.cancelled {
    // The user dismissed checkout. This is not a payment failure.
} catch WhopCheckoutError.paymentFailed(let message) {
    showError(message)
} catch {
    showError("Something went wrong. Please try again.")
}
```

## Webhook-levering

Almindelige webhook-problemer:

* **Ingen hændelse modtaget**: bekræft, at webhook-URL'en er offentligt tilgængelig, bruger `https` og hører til den rigtige konto og det rigtige miljø.
* **Signaturverificering fejler**: send den rå request-body til `unwrapWebhook`. Parse ikke JSON før verificering.
* **Genforsøg bliver ved**: returnér hurtigt et `2xx`-svar efter verificering, før du starter langvarigt arbejde i et baggrundsjob.
* **Dobbelt levering**: Whop leverer webhooks mindst én gang. Gem `webhook-id` eller en anden hændelsesidentifikator, og gør handleren idempotent.
* **Uventet rækkefølge**: antag ikke, at hændelser ankommer i kronologisk rækkefølge. Hent ressourcens aktuelle tilstand, når rækkefølgen betyder noget.

Til lokal udvikling skal du videresende en offentlig URL til din maskine med en tunnel og bruge den URL i dashboardets webhook-indstillinger.

## Element-fejl

Hvert [Whop Element](https://docs.whop.com/da/elements/latest/getting-started.md) accepterer et `onError`-callback. Det kører, når elementet ikke kan indlæses eller går ned, og værdien indeholder en `message`, en valgfri `code` til programmatisk håndtering og en `sourceKey`, når en host-state-kilde fejlede.

Tilknyt det altid under udvikling:

```tsx theme={null}
<CheckoutElement
	onError={(error) => {
		console.error("CheckoutElement failed", error.code, error.message);
	}}
/>
```

Hvis et element ikke kan indlæses:

1. Bekræft, at adgangstokenet blev udstedt til den konto, du forventer, og har de scopes, som elementets referenceside angiver.
2. På dit eget domæne skal du altid sende et `accessToken`. Seerens session virker kun på whop.com.
3. Bekræft, at containeren findes, før du kalder `mount`. React-komponenter monterer sig selv.
4. Lyt efter `onReady`, så du ved, om elementet blev initialiseret.
5. Hvis elementet ender i en tilstand, det ikke kan komme sig fra, så kald `destroy()` og opret et nyt.

[Elements-fejlfindingstabellen](https://docs.whop.com/da/elements/latest/getting-started.md#troubleshooting) viser de almindelige symptomer og deres årsager.

## Sandkasse og produktion

Sandbox-data og produktionsdata er adskilte.

| Miljø | Dashboard | API |
| - | - | - |
| Sandkasse | `https://sandbox.whop.com` | `https://sandbox-api.whop.com/api/v1` |
| Produktion | `https://whop.com` | `https://api.whop.com/api/v1` |

Når du skifter fra sandkasse til produktion:

* Opret nye produktions-API-nøgler.
* Skift SDK-miljøet fra `Sandbox` til `Production`, eller fjern en 1.x-sandbox-tilsidesættelse af `baseUrl` / `base_url` / `WithBaseURL`.
* Genskab produkter, checkout-links, webhooks og underkontoposter, der kun findes i sandkassen, i produktion.
* Bekræft, at webhook-URL'er peger på produktionsinfrastruktur, ikke en lokal tunnel.

## Hvad du skal inkludere, når du beder om hjælp

Inkludér så meget af følgende, som du kan:

* Endpointet, SDK-metoden eller elementnavnet, der fejlede.
* Miljøet: sandkasse eller produktion.
* Statuskoden, fejl-body'en, OAuth-`error_description` eller elementets `onError`-værdi.
* De involverede Whop-ID'er, med hemmeligheder fjernet.
* Webhook-hændelses-ID'et eller `webhook-id`-headeren ved webhook-problemer.
* Et kort kodestykke, der viser, hvordan du opretter klienten, checkouten, OAuth-URL'en, webhook-handleren eller elementet.

> [card] [OAuth](https://docs.whop.com/da/developer/guides/oauth.md)
>
> Byg OAuth 2.1 + PKCE-forløbet, og håndtér fornyelse af tokens.

> [card] [Webhooks](https://docs.whop.com/da/developer/guides/webhooks.md)
>
> Verificér signaturer, før du behandler hændelser, og håndtér genforsøg.

> [card] [Tilladelser](https://docs.whop.com/da/developer/guides/permissions.md)
>
> Vælg app-tilladelser, og forklar dem for skabere.

> [card] [Test i sandkassen](https://docs.whop.com/da/developer/guides/sandbox.md)
>
> Test API-kald og checkout-forløb uden at røre produktion.


## Related topics

- [GoHighLevel](https://docs.whop.com/da/third-party-integrations/gohighlevel.md)
- [QuickBooks](https://docs.whop.com/da/third-party-integrations/quickbooks.md)
- [Zapier](https://docs.whop.com/da/third-party-integrations/zapier.md)
