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

> De eigen dashboardoppervlakken van een account, ingesloten op je site. Beperk het tot een account met `accountId` en mount vervolgens `paymentsTable` voor de betalingen van het account, `paymentDetail` voor één betaling, `required-actions` voor de banners met openstaande acties die het eigen dashboard van Whop boven het saldo toont — identiteitsverificatie, stortingen, belasting en de rest — en `verification` voor de herinnering die alleen over identiteit gaat. Elk oppervlak leest met dezelfde referentie, zodat twee oppervlakken naast elkaar altijd hetzelfde account tonen. De banners geven niets weer zodra het account niets meer openstaand heeft, zodat ze permanent in een lay-out kunnen staan, en ze melden de klikken die ze zelf niet kunnen afhandelen — Add money en Verify — zodat de host zijn eigen stortings- of verificatieflow mount, zoals het `deposit`-element van de `wallet`-controller of het `kyc`-element van de `verifications`-controller.

> [!NOTE]
>
> Deze pagina documenteert `@whop/elements@1.10.0` en `@whop/elements-react@1.10.0`.

*Sinds `v1.0.0`.*

## Playground

Stel de elementen samen met voorbeeldgegevens. Bedien de besturingselementen, voeg elementen toe en schik ze, en zie events live worden geactiveerd:

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

## Opties

Geef deze mee aan `whop.dashboard.create({ … })`, of als props op `<Dashboard>` in React.

**accessToken** `string`

Een token met beperkte scope waarmee elk oppervlak onder deze handle leest. Maak op je server één token aan voor de hele handle met `POST /api/v1/access_tokens`, en stel een nieuw token in met `update({ accessToken })` voordat het verloopt. Het lezen van betalingen vereist `payment:basic:read`; e-mailadressen van kopers vereisen daarnaast `member:email:read`, het klanttraject `member:basic:read`, de trackingkolom `shipment:basic:read`, en de product- en abonnementsnamen op een betaling `access_pass:basic:read` en `plan:basic:read`. De banners vereisen `payout:account:read`, en het starten van verificatie vanuit de actiebalk `identity:write`. Wanneer het wordt weggelaten, gebruiken de leesacties de eigen sessie van de kijker, die alleen same-origin antwoordt.

**accountId** `string` *required*

Account- of gebruikers-ID waarvan deze oppervlakken de gegevens lezen. Account-ID's hebben de prefix `biz_`; gebruikers-ID's hebben de prefix `user_`, kunnen alleen de eigen openstaande acties van de kijker lezen en hebben geen betalingen.

**appearance** `Appearance`

Visuele aanpassing voor de elementen van deze groep. Overschrijft de globale `WhopElements({ appearance })`. Wijzig het live met `update({ appearance })`.

**locale** `WhopElementsLocale`

Taalinstelling voor de UI-tekst van de elementen van deze groep. Stel het in op een van de ingebouwde taalinstellingen van de app om de globale configuratie te overschrijven. Elke andere waarde valt terug op de standaardtaalinstelling.

## Events

Geef callbacks mee in de create-opties of als React-props.

### `onLoadingChange`

Wordt uitgevoerd wanneer de gegroepeerde laadstatus verandert. De waarde is `true` zolang een gemount element nog laadt.

**loading** `boolean`

## Methoden

Roep deze aan op de Dashboard-handle van `whop.dashboard.create({ … })` of `useDashboard()`.

### `update`

Voegt nieuwe handle-opties samen in elk gemount element. Wijzig in React in plaats daarvan de namespace-props.

**Parameters**

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

### `destroy`

Verwijdert elk element en elke subcontroller die deze handle heeft aangemaakt, verwijdert het controllerframe en geeft de abonnementen vrij. Je kunt het meerdere keren aanroepen, maar een verwijderde handle weigert elke andere aanroep — maak een nieuwe handle aan om opnieuw te beginnen. React verwijdert de groep automatisch wanneer de provider wordt ontkoppeld.

## Elementen

De elementen die deze groep mount. Elk heeft een eigen pagina:

> [card] [RequiredActionsElement](https://docs.whop.com/nl/elements/latest/dashboard/required-actions.md)
>
> De banners met openstaande acties uit het saldodashboard van Whop — identiteitsverificatie, stortingen, belasting en de rest — in dezelfde volgorde als waarin de API ze retourneert. Een account zonder openstaande acties geeft helemaal niets weer, zodat het element permanent in een lay-out kan staan. De tekst komt uit de API. Een druk op Verify start een gehoste identiteitssessie en gaat daarheen; Add money meldt `depositRequested` en blijft staan, zodat de host zijn eigen stortingsflow mount — bijvoorbeeld het `deposit`-element van de `wallet`-controller; elke andere knop volgt de eigen link van de actie. Leest met de `accessToken` van de Dashboard-handle, die `payout:account:read` nodig heeft, plus `identity:write` om verificatie te starten. Een mislukte leesactie geeft niets weer in plaats van een fout — een banner mag nooit het meest opvallende element worden op de pagina van iemand anders.

> [card] [VerificationElement](https://docs.whop.com/nl/elements/latest/dashboard/verification.md)
>
> Een banner die de accounthouder vraagt de identiteit te verifiëren, alleen getoond zolang de verificatie openstaat — een account dat al is geverifieerd, geeft helemaal niets weer, zodat het element permanent in een lay-out kan staan. De kop en statusmeldingen komen uit de API, met een kortere beschrijving wanneer de accounthouder wordt uitgenodigd om de verificatie te starten, zodat ze de werkelijke status van het account volgen: een account dat nog niet is begonnen, wordt uitgenodigd om kaarten en uitbetalingen te ontgrendelen, een account in beoordeling wordt als in behandeling weergegeven, en een mislukt of gemarkeerd account meldt dat. Een druk op de knop meldt `verificationRequested` en blijft staan, zodat de host zijn eigen verificatie mount — bijvoorbeeld het `kyc`-element van de `verifications`-controller. Leest met de `accessToken` van de Dashboard-handle, die `payout:account:read` nodig heeft. Een mislukte leesactie geeft niets weer in plaats van een fout — een herinnering mag nooit het meest opvallende element op de pagina worden.

> [card] [PaymentsTableElement](https://docs.whop.com/nl/elements/latest/dashboard/paymentsTable.md)
>
> De betalingstabel uit het dashboard met statuskaarten, zoeken, filters, sorteren, rijselectie, CSV-export, kolominstellingen en paginering. Leest alle betalingspagina's om volledige aantallen te berekenen en lokaal te filteren; bedoeld voor accounts met een bescheiden betalingsgeschiedenis. Klantgegevens en terugbetalingen worden via events aan je applicatie doorgegeven.

> [card] [PaymentDetailElement](https://docs.whop.com/nl/elements/latest/dashboard/paymentDetail.md)
>
> Een betalingsdetailpagina met de specificatie uit het dashboard, activiteit, klant, details en klanttraject. Elke sectie kan worden verborgen. Leest payment:basic:read; het e-mailadres van de klant vereist member:email:read en het traject vereist member:basic:read. Actie-events laten je applicatie wijzigingen bevestigen en autoriseren; dit element voert zelf nooit een terugbetaling, nieuwe poging of annulering van een betaling uit.


## Related topics

- [Apple Pay en Google Pay inschakelen](https://docs.whop.com/nl/payments/apple-pay.md)
- [Betalingen accepteren](https://docs.whop.com/nl/developer/guides/accept-payments.md)
- [Webhooks](https://docs.whop.com/nl/developer/guides/webhooks.md)
