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

> Trois vues de l'argent d'un compte. La vue du solde affiche le total, un graphique de son évolution et un sélecteur de période. La vue de liste affiche les avoirs qui composent ce total, valorisés en dollars. La vue de répartition divise une devise en montants disponibles, en attente, en réserve et négatifs, sans contrôles de mouvement d'argent. Lorsque `openHoldingOnSelect` est activé, une ligne de la liste remplace le canevas de cette unité — le graphique et la liste — par la page de solde de cet avoir, au lieu de simplement signaler le clic.

> [!NOTE]
>
> Cette page documente `@whop/elements@1.10.0` et `@whop/elements-react@1.10.0`.

*Depuis `v1.0.0`.*

Se monte à l'intérieur de [`Wallet`](https://docs.whop.com/fr/elements/latest/wallet/overview). Créez-le pour obtenir un handle, puis montez ses éléments sur ce handle. Appelez `destroy()` pour supprimer le sous-contrôleur. Créez-le à nouveau pour obtenir un nouveau handle.

## Aperçu

Une démo interactive en direct de la disposition par défaut de ce sous-contrôleur, avec des données d'exemple :

Se monte n'importe où dans votre hiérarchie de vues. [`BalanceElement`](https://docs.whop.com/fr/elements/latest/wallet/balances-balance#swift) et [`ListElement`](https://docs.whop.com/fr/elements/latest/wallet/balances-list#swift) sont indépendants : utilisez-en un seul, ou les deux sur un même écran. Chacun prend un `accountId` et charge ses propres données.

## Aperçu

Exécuté sur un iPhone, dans l'application d'exemple :

[BalanceElement exécuté sur un simulateur iPhone](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()
        }
    }
}
```

## Options

Transmettez-les à `wallet.create('balances', { … })`, ou comme props sur `<Balances>` avec React. Les props injectées par le parent n'apparaissent jamais ici.

**accessToken** `string`

Un jeton à portée limitée pour les lectures de répartition et de règlement du solde. Un compte nécessite `company:balance:read`. S'il est omis, la session same-origin du visiteur est utilisée.

**openHoldingOnSelect** `boolean`

Affiche la page de solde de l'avoir de cette unité à la place du graphique et de la liste lorsqu'une ligne est cliquée. Désactivé par défaut afin qu'un hôte qui effectue son routage sur `balanceSelected` ne soit pas recouvert par un second écran. Par défaut : `false`.

## Méthodes

Appelez-les sur le sous-handle obtenu via `wallet.create('balances', { … })`.

### `update`

Fusionne de nouvelles props et de nouveaux callbacks dans le sous-contrôleur.

**Paramètres**

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

### `destroy`

Détruit le sous-contrôleur et ses éléments, puis libère son emplacement exclusif. Un `create("balances")` ultérieur repart de zéro.

## Paramètres

**accountId** `String` *required*

Le compte dont la vue lit l'argent. Utilisez un ID de compte préfixé par `biz_`. Un ID d'utilisateur préfixé par `user_` lit le propre solde du visiteur et nécessite une authentification du visiteur (`WhopSDK.configureWithOAuth`), et non un jeton de compte.

## États

Chaque vue gère ses propres états, de sorte qu'aucune n'empêche l'autre de s'afficher.

## Bon à savoir

* Elles ne partagent aucun état et se chargent indépendamment : vous pouvez donc en utiliser une seule, ou les deux comme ci-dessus.
* Consultez le détail sur [`BalanceElement`](https://docs.whop.com/fr/elements/latest/wallet/balances-balance#swift) et [`ListElement`](https://docs.whop.com/fr/elements/latest/wallet/balances-list#swift) ; [`ActivityElement`](https://docs.whop.com/fr/elements/latest/wallet/activity#swift) liste les mouvements qui les sous-tendent.

> [!NOTE]
>
> Appelez `WhopSDK.configure(tokenProvider:)` une seule fois au lancement. Les vues attendent le jeton. Consultez [Premiers pas](https://docs.whop.com/fr/elements/latest/getting-started.md). Appliquez un thème avec `.whopTheme(_:)`.

## Éléments

Les éléments que ce sous-contrôleur monte. Chacun a sa propre page :

> [card] [BalanceElement](https://docs.whop.com/fr/elements/latest/wallet/balances-balance.md)
>
> Le solde d'un compte et un graphique de son évolution. Le total et sa variation se trouvent en haut, le graphique en dessous et les boutons de période en bas. Le visiteur peut lire des points individuels du graphique et changer lui-même de période.

> [card] [BreakdownElement](https://docs.whop.com/fr/elements/latest/wallet/balances-breakdown.md)
>
> Le total d'une devise réparti en soldes disponible, en attente, en réserve et négatif. Les lignes à zéro disparaissent, et la surface ne contient délibérément aucun bouton de mouvement d'argent afin que l'hôte reste maître de ces actions.

> [card] [SettlementElement](https://docs.whop.com/fr/elements/latest/wallet/balances-settlement.md)
>
> Les détails du solde du compte tels qu'affichés par le tableau de bord de Whop : fonds disponibles, dates de règlement en attente, conditions de réserve et éventuel solde négatif. Il s'ouvre dans une modale de 550px et utilise le compte, la devise et l'identifiant du handle balances.

> [card] [ListElement](https://docs.whop.com/fr/elements/latest/wallet/balances-list.md)
>
> Les avoirs derrière le solde d'un compte. Chaque devise et chaque jeton a sa propre ligne, avec son nom et sa valeur en dollars, du plus grand au plus petit. Les lignes peuvent signaler celle que le visiteur a touchée, afin que vous puissiez ouvrir votre propre écran pour celle-ci. Lorsque `openHoldingOnSelect` est activé, un clic sur une ligne affiche la page de solde de cet avoir à la place du graphique et de la liste de cette unité.


## Related topics

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