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

# Dashboard

> En kontos egne dashboard-flader, indlejret på dit website. Afgræns det til en konto med `accountId`, og montér derefter `paymentsTable` for kontoens betalinger, `paymentDetail` for én betaling, `required-actions` for de bannere med udestående handlinger, som Whops eget dashboard viser over saldoen — identitetsverificering, indbetalinger, skat og resten — og `verification` for påmindelsen, der kun gælder identitet. Alle flader læser med de samme legitimationsoplysninger, så to ved siden af hinanden altid viser den samme konto. Bannerne renderer intet, når kontoen ikke har noget udestående, så de kan stå permanent i et layout, og de rapporterer de tryk, de ikke selv kan besvare — Add money og Verify — så hosten monterer sit eget indbetalings- eller verificeringsflow, såsom `wallet`-controllerens `deposit`-element eller `verifications`-controllerens `kyc`-element.

> [!NOTE]
>
> Denne side dokumenterer `@whop/elements@1.10.0` og `@whop/elements-react@1.10.0`.

*Siden `v1.0.0`.*

## Playground

Sæt elementerne sammen med eksempeldata. Betjen kontrollerne, tilføj og arrangér elementer, og se events blive udløst live:

```tsx React theme={null}
import { WhopElements, Dashboard } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Dashboard /* options */>
        {/* mount elements here */}
      </Dashboard>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const dashboard = window.WhopElements().dashboard.create({ /* options */ });
</script>
```

## Indstillinger

Angiv disse til `whop.dashboard.create({ … })` eller som props på `<Dashboard>` i React.

**accessToken** `string`

Et afgrænset token, som alle flader under dette handle læser med. Udsted ét token til hele handlet på din server med `POST /api/v1/access_tokens`, og sæt et nyt med `update({ accessToken })`, før det udløber. Læsning af betalinger kræver `payment:basic:read`; køber-e-mails kræver desuden `member:email:read`, kunderejsen `member:basic:read`, sporingskolonnen `shipment:basic:read`, og produkt- og plannavnene på en betaling `access_pass:basic:read` og `plan:basic:read`. Bannerne kræver `payout:account:read`, og start af verificering fra handlingslinjen `identity:write`. Udelades det, bærer læsningerne seerens egen session, som kun svarer ved samme origin.

**accountId** `string` *required*

Konto- eller bruger-ID, hvis poster disse flader læser. Konto-ID'er har præfikset `biz_`; bruger-ID'er har præfikset `user_`, kan kun læse seerens egne udestående handlinger og har ingen betalinger.

**appearance** `Appearance`

Visuel tilpasning af denne gruppes elementer. Tilsidesætter den globale `WhopElements({ appearance })`. Ændr den live med `update({ appearance })`.

**locale** `WhopElementsLocale`

Sprog for UI-teksten i denne gruppes elementer. Sæt den til et af appens indbyggede sprog for at tilsidesætte den globale konfiguration. Enhver anden værdi falder tilbage til standardsproget.

## Events

Angiv callbacks i create-indstillingerne eller som React-props.

### `onLoadingChange`

Kører, når den samlede indlæsningstilstand ændres. Værdien er `true`, så længe et monteret element stadig indlæses.

**loading** `boolean`

## Metoder

Kald disse på Dashboard-handlet fra `whop.dashboard.create({ … })` eller `useDashboard()`.

### `update`

Fletter nye handle-indstillinger ind i alle monterede elementer. I React ændrer du i stedet namespace-props.

**Parametre**

**options** `Partial\<DashboardOptions\>` *required*

### `destroy`

Ødelægger alle elementer og sub-controllere, som dette handle har oprettet, fjerner controller-framen og frigiver dens abonnementer. Du kan kalde den mere end én gang, men et ødelagt handle afviser alle andre kald — opret et nyt handle for at starte forfra. React fjerner gruppen automatisk, når provideren afmonteres.

## Elementer

De elementer, som denne gruppe monterer. Hvert element har sin egen side:

> [card] [RequiredActionsElement](https://docs.whop.com/da/elements/latest/dashboard/required-actions.md)
>
> Bannerne med udestående handlinger fra Whops saldo-dashboard — identitetsverificering, indbetalinger, skat og resten — i samme rækkefølge, som API'et returnerer dem. En konto uden noget udestående renderer slet intet, så elementet kan stå permanent i et layout. Teksterne kommer fra API'et. Et tryk på Verify starter en hostet identitetssession og navigerer dertil; Add money rapporterer `depositRequested` og bliver, hvor den er, så hosten monterer sit eget indbetalingsflow — for eksempel `wallet`-controllerens `deposit`-element; alle andre knapper følger handlingens eget link. Læser med Dashboard-handlets `accessToken`, som kræver `payout:account:read` plus `identity:write` for at starte verificering. En mislykket læsning renderer intet frem for en fejl — et banner bør aldrig blive det mest larmende på en andens side.

> [card] [VerificationElement](https://docs.whop.com/da/elements/latest/dashboard/verification.md)
>
> Et banner, der beder kontohaveren om at verificere sin identitet, og som kun vises, mens verificeringen er udestående — en konto, der allerede er verificeret, renderer slet intet, så elementet kan stå permanent i et layout. Overskriften og statusbeskederne kommer fra API'et, med en kortere beskrivelse, når kontohaveren inviteres til at starte verificering, så de følger kontoens faktiske tilstand: en konto, der ikke er startet, inviteres til at låse op for kort og udbetalinger, en konto under gennemgang vises som afventende, og en mislykket eller markeret konto siger det. Et tryk på knappen rapporterer `verificationRequested` og bliver, hvor den er, så hosten monterer sin egen verificering — for eksempel `verifications`-controllerens `kyc`-element. Læser med Dashboard-handlets `accessToken`, som kræver `payout:account:read`. En mislykket læsning renderer intet frem for en fejl — en påmindelse bør aldrig blive det mest larmende på siden.

> [card] [PaymentsTableElement](https://docs.whop.com/da/elements/latest/dashboard/paymentsTable.md)
>
> Dashboardets betalingstabel med statuskort, søgning, filtre, sortering, rækkevalg, CSV-eksport, kolonneindstillinger og paginering. Læser alle betalingssider for at beregne fuldstændige antal og filtrere lokalt; beregnet til konti med beskedne betalingshistorikker. Kundedetaljer og refusioner overdrages til din applikation via events.

> [card] [PaymentDetailElement](https://docs.whop.com/da/elements/latest/dashboard/paymentDetail.md)
>
> En betalingsdetaljeside med dashboardets opdeling, aktivitet, kunde, detaljer og kunderejse. Hver sektion kan skjules. Læser payment:basic:read; kundens e-mail kræver member:email:read, og kunderejsen kræver member:basic:read. Handlings-events lader din applikation bekræfte og godkende ændringer; dette element refunderer, genforsøger eller annullerer aldrig selv en betaling.
