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

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

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

*Sinds `v1.0.0`.*

Wordt gemount binnen [`Wallet`](https://docs.whop.com/nl/elements/latest/wallet/overview). Maak het aan om een handle te krijgen en mount daarna de elementen ervan op die handle. Roep `destroy()` aan om de sub-controller te verwijderen. Maak het opnieuw aan om een nieuwe handle te krijgen.

## Voorbeeld

Een live, interactieve demo van de standaardindeling van deze sub-controller met voorbeeldgegevens:

Kan overal in je view-hiërarchie worden gemount. [`BalanceElement`](https://docs.whop.com/nl/elements/latest/wallet/balances-balance#swift) en [`ListElement`](https://docs.whop.com/nl/elements/latest/wallet/balances-list#swift) zijn onafhankelijk, dus gebruik er één los of beide op één scherm. Elk neemt een `accountId` en laadt zijn eigen gegevens.

## Voorbeeld

Draaiend op een iPhone, in de voorbeeldapp:

[BalanceElement draaiend op een iPhone-simulator](https://app.revyl.ai/embed/c1954726-8f9b-483d-9f50-247fa7bfb007?controls=0)

```tsx React theme={null}
import { WhopElements, Wallet, Balances, BalanceElement, BreakdownElement, ListElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <Balances>
          <BalanceElement />
          <BreakdownElement />
          <ListElement />
        </Balances>
      </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 */ });
  const balances = wallet.create('balances', { /* options */ });
  balances.create('balance').mount('#wallet-balances-balance');
  balances.create('breakdown').mount('#wallet-balances-breakdown');
  balances.create('list').mount('#wallet-balances-list');
</script>
```

```swift Swift theme={null}
import SwiftUI
import WhopElements

// WhopSDK.configure(tokenProvider:) runs once at app launch. See Getting started.
struct WalletScreen: View {
    let account = "biz_xxxx"

    var body: some View {
        ScrollView {
            VStack(spacing: 24) {
                BalanceElement(accountId: account)
                ListElement(accountId: account)
            }
            .padding()
        }
    }
}
```

## Opties

Geef deze mee aan `wallet.create('balances', { … })`, of als props op `<Balances>` in React. Props die door de parent worden geïnjecteerd, verschijnen hier nooit.

**accessToken** `string`

Een scoped token voor het lezen van saldo-uitsplitsingen en afwikkelingen. Een account heeft `company:balance:read` nodig. Wordt het weggelaten, dan wordt de same-origin-sessie van de kijker gebruikt.

**openHoldingOnSelect** `boolean`

Toon de saldopagina van een tegoed van deze eenheid in plaats van de grafiek 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`.

## Methoden

Roep deze aan op de sub-handle van `wallet.create('balances', { … })`.

### `update`

Voegt nieuwe props en callbacks samen in de sub-controller.

**Parameters**

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

### `destroy`

Vernietigt de sub-controller en de elementen ervan, en geeft daarna het exclusieve slot vrij. Een latere `create("balances")` begint opnieuw.

## Parameters

**accountId** `String` *required*

Het account waarvan de view het geld leest. Gebruik een account-ID met het voorvoegsel `biz_`. Een gebruikers-ID met het voorvoegsel `user_` leest het eigen saldo van de kijker en vereist kijkerauthenticatie (`WhopSDK.configureWithOAuth`), geen accounttoken.

## Statussen

Elke view beheert zijn eigen statussen, dus geen van beide blokkeert de weergave van de ander.

## Goed om te weten

* Ze delen geen status en laden onafhankelijk, dus je kunt er één los gebruiken of beide zoals hieronder.
* Lees de details op [`BalanceElement`](https://docs.whop.com/nl/elements/latest/wallet/balances-balance#swift) en [`ListElement`](https://docs.whop.com/nl/elements/latest/wallet/balances-list#swift); [`ActivityElement`](https://docs.whop.com/nl/elements/latest/wallet/activity#swift) toont de bewegingen erachter.

> [!NOTE]
>
> Roep `WhopSDK.configure(tokenProvider:)` eenmaal aan bij het opstarten. Views wachten op het token. Zie [Aan de slag](https://docs.whop.com/nl/elements/latest/getting-started.md). Pas een thema toe met `.whopTheme(_:)`.

## Elementen

De elementen die deze sub-controller mount. Elk element heeft een eigen pagina:

> [card] [BalanceElement](https://docs.whop.com/nl/elements/latest/wallet/balances-balance.md)
>
> Het saldo van een account en een grafiek van hoe het is veranderd. Het totaal en de verandering staan bovenaan, de grafiek daaronder en de knoppen voor het tijdsbereik onderaan. De kijker kan afzonderlijke punten in de grafiek aflezen en zelf het tijdsbereik wijzigen.

> [card] [BreakdownElement](https://docs.whop.com/nl/elements/latest/wallet/balances-breakdown.md)
>
> Het totaal van één valuta, opgesplitst in beschikbare, lopende, gereserveerde en negatieve saldi. Rijen met een waarde van nul verdwijnen, en het oppervlak bevat bewust geen knoppen voor geldbewegingen, zodat de host die acties beheert.

> [card] [SettlementElement](https://docs.whop.com/nl/elements/latest/wallet/balances-settlement.md)
>
> De saldodetails van het account zoals het dashboard van Whop ze toont: beschikbare middelen, data van lopende afwikkelingen, reservevoorwaarden en eventuele negatieve saldi. Het opent als modal van 550px en gebruikt het account, de valuta en de credential van de balances-handle.

> [card] [ListElement](https://docs.whop.com/nl/elements/latest/wallet/balances-list.md)
>
> De tegoeden achter het saldo van een account. Elke valuta en token krijgt een eigen rij met de naam en de waarde in dollars, de grootste eerst. Rijen kunnen melden op welke de kijker heeft getikt, zodat je er je eigen scherm voor kunt openen. Wanneer `openHoldingOnSelect` aan staat, toont een klik op een rij de saldopagina van dat tegoed in plaats van de grafiek en lijst van deze eenheid.


## Related topics

- [BalanceElement](https://docs.whop.com/nl/elements/latest/wallet/balances-balance.md)
- [BalanceReportElement](https://docs.whop.com/nl/elements/latest/wallet/reports-balanceReport.md)
- [ListElement](https://docs.whop.com/nl/elements/latest/wallet/balances-list.md)
