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

# Wallet

> Stuurt de geldoppervlakken van een account aan. `actions` toont de bedieningselementen Deposit, Accept, Send en Convert: Deposit, Send en Convert openen hun Wallet-overlays, terwijl Accept de checkoutlink-maker van Whop opent voor een zakelijk account of het aanmaken van een bedrijf voor een persoonlijk account. `deposit` retourneert live financieringskanalen; `convert` wisselt USD met Gold, Bitcoin of een aandelentoken en stelt FX-valuta's beschikbaar wanneer de host `fxEnabled` inschakelt; `send` verplaatst geld naar een ontvanger of maakt een openbare claimlink aan; `withdraw` toont uitbetalingsmethoden en maakt de uitbetaling aan wanneer de host die API niet al zelf aanstuurt; `balances` bevat twee weergaven — de lijst met tegoeden en het saldoblok dat de waarde over een venster tekent; `cards` is de compacte lijst met uitgegeven kaarten; `cardsTable` toont het volledige sorteerbare kaartenoverzicht; `cardsChart` plot kaartuitgaven; `whopCard` toont één onthulbare kaart; `activity` toont grootboekbewegingen; `activityDetail` toont een vooraf opgehaalde beweging, of haalt er een op via activiteit-ID of kaarttransactie-ID, in een losse drawer. De balk met openstaande acties en de identiteitsherinnering staan op de `dashboard`-controller. Elk oppervlak met gegevens kan de sessie van de kijker gebruiken wanneer er geen token is opgegeven.

> [!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, Wallet } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

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

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

## Opties

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

**currency** `string`

ISO 4217-valutacode van drie letters voor bedragvelden. Een onbekende code valt terug op `usd`. Standaard `"usd"`.

**accessToken** `string`

Optioneel scoped token dat wordt doorgegeven aan wallet-onderdelen met gegevens. Zonder token gebruiken leesacties de sessie van de kijker.

**openHoldingOnSelect** `boolean`

Toon de saldopagina van een tegoed in plaats van de saldografiek en -lijst wanneer op een rij wordt geklikt. Standaard uitgeschakeld, zodat een host die op `balanceSelected` routeert niet wordt bedekt door een tweede scherm. Standaard `false`.

**accountId** `string` *required*

Account- of gebruikers-ID waarvan deze oppervlakken het geld lezen. Account-ID's hebben het voorvoegsel `biz_`; gebruikers-ID's hebben het voorvoegsel `user_` en kunnen alleen het eigen saldo van de kijker lezen.

**appearance** `Appearance`

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

**locale** `WhopElementsLocale`

Locale voor de UI-tekst van de elementen in deze groep. Stel deze in op een van de ingebouwde locales van de app om de globale configuratie te overschrijven. Elke andere waarde valt terug op de standaardlocale.

## Events

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

### `onIdentityVerificationRequested`

Een storting vereist identiteitsverificatie. Handel deze callback af om je instellingen of verificatieflow te openen; Wallet navigeert niet.

**payload** `object`

**eigenschappen**

**accountId** `string` *required*

### `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 Wallet-handle van `whop.wallet.create({ … })` of `useWallet()`.

### `update`

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

**Parameters**

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

### `destroy`

Vernietigt elk element en elke sub-controller die deze handle heeft aangemaakt, verwijdert het controllerframe en geeft de abonnementen vrij. Je kunt het meerdere keren aanroepen, maar een vernietigde 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 element heeft een eigen pagina:

> [card] [ActionsElement](https://docs.whop.com/nl/elements/latest/wallet/actions.md)
>
> De rij met accountacties uit het saldodashboard van Whop. Deposit, Send, Withdraw en Convert openen de ingebouwde overlays van de Wallet-controller. Accept opent de checkoutlink-maker van Whop voor een zakelijk account of het aanmaken van een bedrijf voor een persoonlijk account. Elke knop zendt ook het bijbehorende requested-event uit, zodat de insluitende pagina de actie kan volgen.

> [card] [Balances](https://docs.whop.com/nl/elements/latest/wallet/balances)
>
> Drie weergaven van het geld van een account. De saldoweergave toont het totaal, een grafiek van hoe het is veranderd en een kiezer voor het tijdsbereik. De lijstweergave toont de tegoeden waaruit dat totaal bestaat, gewaardeerd in dollars. De uitsplitsingsweergave splitst één valuta op in beschikbare, lopende, gereserveerde en negatieve bedragen, zonder bedieningselementen voor geldbewegingen. Wanneer `openHoldingOnSelect` aan staat, vervangt een lijstrij het canvas van deze eenheid — de grafiek en de lijst — door de saldopagina van dat tegoed, in plaats van alleen de klik te melden. *(sub-controller, 4 elementen)*

> [card] [Reports](https://docs.whop.com/nl/elements/latest/wallet/reports)
>
> Saldogeschiedenis en de financiële activiteit erachter, inclusief CSV-exports. Accountafschriften zijn beschikbaar in het Whop-dashboard. *(sub-controller, 2 elementen)*

> [card] [ActivityElement](https://docs.whop.com/nl/elements/latest/wallet/activity.md)
>
> De grootboekactiviteit van een account: elke beweging van geld in of uit, de nieuwste eerst. De lijst laadt meer pagina's terwijl de kijker scrolt, en rijen melden op welke is getikt in plaats van te navigeren, zodat je je eigen detailscherm kunt openen.

> [card] [ActivityDetailElement](https://docs.whop.com/nl/elements/latest/wallet/activityDetail.md)
>
> Een losse detaildrawer voor één beweging. Wijs hem naar een vooraf opgehaalde rij met financiële activiteit, een grootboekactiviteit-ID of een kaarttransactie-ID — een vooraf opgehaalde rij heeft voorrang, anders haalt het element het record zelf op. Een kaarttransactie opent het kaartbewijs: verkoper, bedrag, status, de kaart waarop het is afgeschreven, de kaarthouder bij een bedrijfsaccount, de afwikkelingsdatum, categorie, valutaconversie en cashback.

> [card] [DepositElement](https://docs.whop.com/nl/elements/latest/wallet/deposit.md)
>
> Financiert een Whop-account. Toont een bedragveld en de live financieringskanalen van het account — crypto (een stortingsadres per netwerk met bijbehorende QR-code) en bankoverschrijving (de overschrijvingsgegevens voor elke afwikkelingsvaluta). De kanalen van een zakelijk account worden zonder credentials opgehaald, dus ze werken op elke pagina; een persoonlijk (`user_`) account toont zijn kanalen alleen aan zichzelf, dus geef er `accessToken` voor mee — zonder token dekt de eigen same-origin-sessie van de kijker het. Kaarten en platformsaldo zijn opt-in: geef `savedCards`, `allowNewCard` of `showPlatformBalance` mee en het element verzamelt het bedrag en de keuze, zendt daarna `cardDepositRequested` / `addCardRequested` / `platformBalanceSelected` uit en wacht tot je `showStep({ step: 'amount' })` aanroept wanneer je eigen scherm klaar is.

> [card] [ConvertElement](https://docs.whop.com/nl/elements/latest/wallet/convert.md)
>
> Zet het USD-saldo van een account om naar Gold, Coinbase Wrapped Bitcoin of een aandelentoken, en terug, via de openbare swaps-API van Whop. Een cross-origin mount vereist een `accessToken` met de scope `company:balance:read` plus `crypto_wallet:swap` of `crypto_wallet:manage`.

> [card] [WithdrawElement](https://docs.whop.com/nl/elements/latest/wallet/withdraw.md)
>
> Verzamelt een uitbetalingsbedrag en een opgeslagen uitbetalingsmethode, groepeert standaard- en directe leveringsopties met live kosten en geschatte aankomsttijden, en verzamelt indien nodig een nieuwe uitbetalingsmethode. Wanneer de host de flow niet aanstuurt, toont het element de methoden en maakt het de uitbetaling zelf aan — geef `accessToken` mee (of vertrouw op de same-origin-sessie van de kijker). Een host die al met de payouts-API communiceert, kan nog steeds methoden, limieten en laadvlaggen aanleveren; bevestigen zendt dan `withdrawalRequested` uit, zodat die host de uitbetaling aanmaakt.

> [card] [SendElement](https://docs.whop.com/nl/elements/latest/wallet/send.md)
>
> Verstuurt geld van een account naar een ontvanger — een gebruiker, een ander account of een openbare claimlink die iedereen kan inwisselen. Directe overboekingen gebruiken het geconfigureerde fiat- of cryptokanaal van het bronaccount. Toont een eigen zoekfunctie voor ontvangers die vanuit het account-ID wordt opgehaald, zonder andere credentials dan het eigen token van het account. Vereist een `accessToken` met de scope `payout:transfer_funds` voor directe overboekingen en `payout:withdraw_funds` voor ontvangerslijsten; zoeken naar ontvangers voor een account vereist daarnaast `company:authorized_user:read` en `member:basic:read`, en claimlinks voor een account vereisen `airdrop_link:manage` — een host zonder een van die scopes moet de bijbehorende prop uitschakelen in plaats van een rij te laten staan die een 403 oplevert.

> [card] [CardDetailsElement](https://docs.whop.com/nl/elements/latest/wallet/cardDetails)
>
> Eén kaart en wat ermee is uitgegeven: de kaart zelf, wat er ten opzichte van de limiet is uitgegeven en de laatste transacties. Opent als drawer. De kaartvoorkant, het onthullen en het vergrendelen komen van het `whopCard`-element dat erin is opgenomen, zodat een host één oppervlak krijgt in plaats van er drie samen te stellen. Op een transactie drukken, of om de volledige lijst vragen, meldt het verzoek — de drawer navigeert nooit.

> [card] [Cards](https://docs.whop.com/nl/elements/latest/wallet/cards)
>
> De kaartoppervlakken van een account, gemount vanaf één plek: de compacte lijst met uitgegeven kaarten, het volledige sorteerbare overzicht, de uitgavengrafiek en één onthulbare kaart. Mount de weergaven die de pagina nodig heeft — ze delen het account en de credential waarmee deze eenheid is aangemaakt, zodat een pagina met een grafiek boven een overzicht ze maar één keer hoeft te koppelen. *(sub-controller, 5 elementen)*


## Related topics

- [Open een wallet-sheet vanuit je eigen knop](https://docs.whop.com/nl/developer/guides/payment-request.md)
- [ActivityElement](https://docs.whop.com/nl/elements/latest/wallet/activity.md)
- [ListElement](https://docs.whop.com/nl/elements/latest/wallet/balances-list.md)
