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

> Styrer en kontos pengeflader. `actions` viser kontrollerne Deposit, Accept, Send og Convert: Deposit, Send og Convert åbner deres Wallet-overlays, mens Accept åbner Whops værktøj til oprettelse af checkout-links for en virksomhedskonto eller oprettelse af en virksomhed for en personlig konto. `deposit` returnerer aktive indbetalingskanaler; `convert` bytter USD med guld, Bitcoin eller et aktietoken og viser FX-valutaer, når værten aktiverer `fxEnabled`; `send` flytter penge til en modtager eller opretter et offentligt indløsningslink; `withdraw` viser udbetalingsmetoder og opretter udbetalingen, når værten ikke allerede styrer det API; `balances` har to flader – listen over beholdninger og saldoblokken, der tegner værdien over et tidsvindue; `cards` er den kompakte liste over udstedte kort; `cardsTable` viser den fulde sorterbare kortoversigt; `cardsChart` plotter kortforbrug; `whopCard` viser ét kort, hvis oplysninger kan vises; `activity` viser bevægelser i hovedbogen; `activityDetail` viser en forudhentet bevægelse eller henter en efter aktivitets-ID eller korttransaktions-ID i en selvstændig skuffe. Bjælken med udestående handlinger og påmindelsen om identitetsverifikation ligger på `dashboard`-controlleren. Alle datadrevne flader kan bruge seerens session, når der ikke angives et token.

> [!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 hændelser blive udløst live:

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

## Indstillinger

Send disse til `whop.wallet.create({ … })`, eller som props på `<Wallet>` i React.

**currency** `string`

Trebogstavs ISO 4217-valutakode for beløbsfelter. En ukendt kode falder tilbage til `usd`. Standard er `"usd"`.

**accessToken** `string`

Valgfrit afgrænset token, der videregives til datadrevne wallet-underelementer. Uden det bruger læsninger seerens session.

**openHoldingOnSelect** `boolean`

Vis en beholdnings saldoside i stedet for saldodiagrammet og -listen, når der klikkes på en række. Slået fra som standard, så en vært, der router på `balanceSelected`, ikke bliver dækket af en ekstra skærm. Standard er `false`.

**accountId** `string` *required*

Konto- eller bruger-ID, hvis penge disse flader læser. Konto-ID'er har præfikset `biz_`; bruger-ID'er har præfikset `user_` og kan kun læse seerens egen saldo.

**appearance** `Appearance`

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

**locale** `WhopElementsLocale`

Sprogindstilling for UI-teksten i denne gruppes elementer. Sæt den til en af appens indbyggede sprogindstillinger for at tilsidesætte den globale konfiguration. Enhver anden værdi falder tilbage til standardsprogindstillingen.

## Hændelser

Send callbacks i create-indstillingerne eller React-props.

### `onIdentityVerificationRequested`

En indbetaling kræver identitetsverifikation. Håndtér denne callback for at åbne dine indstillinger eller dit verifikationsflow; Wallet navigerer ikke.

**payload** `object`

**egenskaber**

**accountId** `string` *required*

### `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å Wallet-handlet fra `whop.wallet.create({ … })` eller `useWallet()`.

### `update`

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

**Parametre**

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

### `destroy`

Ødelægger alle elementer og sub-controllere, som dette handle har oprettet, fjerner controller-frame'en og frigiver dens abonnementer. Du kan kalde det 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, denne gruppe monterer. Hvert har sin egen side:

> [card] [ActionsElement](https://docs.whop.com/da/elements/latest/wallet/actions.md)
>
> Kontoens handlingsrække fra Whops saldodashboard. Deposit, Send, Withdraw og Convert åbner Wallet-controllerens indbyggede overlays. Accept åbner Whops værktøj til oprettelse af checkout-links for en virksomhedskonto eller oprettelse af en virksomhed for en personlig konto. Hver knap udsender også sin anmodningshændelse, så den indlejrende side kan observere handlingen.

> [card] [Saldi](https://docs.whop.com/da/elements/latest/wallet/balances)
>
> Tre visninger af en kontos penge. Saldovisningen viser totalen, et diagram over, hvordan den har ændret sig, og en vælger til tidsintervallet. Listevisningen viser de beholdninger, der udgør totalen, værdiansat i dollars. Opdelingsvisningen deler én valuta op i tilgængelige, afventende, reserverede og negative beløb uden kontroller til pengebevægelser. Når `openHoldingOnSelect` er slået til, erstatter en listerække denne enheds lærred – diagrammet og listen – med den pågældende beholdnings saldoside i stedet for kun at rapportere klikket. *(sub-controller, 4 elementer)*

> [card] [Rapporter](https://docs.whop.com/da/elements/latest/wallet/reports)
>
> Saldohistorik og den økonomiske aktivitet bag den, inklusive CSV-eksporter. Kontoudtog er tilgængelige i Whop-dashboardet. *(sub-controller, 2 elementer)*

> [card] [ActivityElement](https://docs.whop.com/da/elements/latest/wallet/activity.md)
>
> En kontos aktivitet i hovedbogen: hver bevægelse af penge ind eller ud, nyeste først. Listen indlæser flere sider, efterhånden som seeren scroller, og rækkerne rapporterer, hvilken der blev trykket på, i stedet for at navigere, så du kan åbne din egen detaljeskærm.

> [card] [ActivityDetailElement](https://docs.whop.com/da/elements/latest/wallet/activityDetail.md)
>
> En selvstændig detaljeskuffe for én bevægelse. Peg den på en forudhentet række med økonomisk aktivitet, et aktivitets-ID fra hovedbogen eller et korttransaktions-ID – en forudhentet række har forrang, ellers henter elementet selv posten. En korttransaktion åbner kortkvitteringen: forhandler, beløb, status, det kort, den blev trukket på, kortholderen på en virksomhedskonto, afregningsdatoen, kategori, valutaomregning og cashback.

> [card] [DepositElement](https://docs.whop.com/da/elements/latest/wallet/deposit.md)
>
> Indbetaler penge på en Whop-konto. Viser et beløbsfelt og kontoens aktive indbetalingskanaler – krypto (en indbetalingsadresse pr. netværk med tilhørende QR-kode) og bankoverførsel (overførselsfelterne for hver afregningsvaluta). En virksomhedskontos kanaler opløses uden legitimation, så de virker på enhver side; en personlig (`user_`) konto viser kun sine kanaler for sig selv, så send `accessToken` for den – hvis det udelades, dækker seerens egen session på samme origin det. Kort og platformssaldo er valgfrie: send `savedCards`, `allowNewCard` eller `showPlatformBalance`, så indsamler elementet beløbet og valget, udsender derefter `cardDepositRequested` / `addCardRequested` / `platformBalanceSelected` og venter på, at du kalder `showStep({ step: 'amount' })`, når din egen skærm er færdig.

> [card] [ConvertElement](https://docs.whop.com/da/elements/latest/wallet/convert.md)
>
> Konverterer en kontos USD-saldo til guld, Coinbase Wrapped Bitcoin eller et aktietoken og tilbage via Whops offentlige swaps-API. En montering på tværs af origins kræver et `accessToken` med scopet `company:balance:read` plus `crypto_wallet:swap` eller `crypto_wallet:manage`.

> [card] [WithdrawElement](https://docs.whop.com/da/elements/latest/wallet/withdraw.md)
>
> Indsamler et udbetalingsbeløb og en gemt udbetalingsmetode, grupperer valg mellem standard- og øjeblikkelig levering med aktuelle gebyrer og estimerede ankomsttider og indsamler en ny udbetalingsmetode, når det er nødvendigt. Når værten ikke styrer flowet, viser elementet metoderne og opretter selv udbetalingen – send `accessToken` (eller benyt seerens session på samme origin). En vært, der allerede taler med udbetalings-API'et, kan stadig levere metoder, grænser og indlæsningsflag; en bekræftelse udsender så `withdrawalRequested`, så værten kan oprette udbetalingen.

> [card] [SendElement](https://docs.whop.com/da/elements/latest/wallet/send.md)
>
> Sender penge fra en konto til en modtager – en bruger, en anden konto eller et offentligt indløsningslink, som alle kan indløse. Direkte overførsler bruger kildekontoens konfigurerede fiat- eller kryptokanal. Viser sin egen modtagersøgning, der opløses ud fra konto-ID'et uden anden legitimation end kontoens eget token. Kræver et `accessToken` med scopet `payout:transfer_funds` for direkte overførsler og `payout:withdraw_funds` for modtagerlister; søgning efter modtagere for en konto kræver desuden `company:authorized_user:read` og `member:basic:read`, og indløsningslinks for en konto kræver `airdrop_link:manage` – en vært uden et af disse scopes bør slå den tilsvarende prop fra i stedet for at efterlade en række, der vil give 403.

> [card] [CardDetailsElement](https://docs.whop.com/da/elements/latest/wallet/cardDetails)
>
> Ét kort og det, der er brugt på det: selve kortet, hvad det har brugt i forhold til sin grænse, og dets seneste transaktioner. Åbner som en skuffe. Kortets forside, visningen af kortoplysninger og låsen kommer fra `whopCard`-elementet, der er sammensat indeni, så en vært får én flade i stedet for at samle tre. Et tryk på en transaktion eller en anmodning om den fulde liste rapporterer anmodningen – skuffen navigerer aldrig.

> [card] [Kort](https://docs.whop.com/da/elements/latest/wallet/cards)
>
> En kontos kortflader, monteret fra ét sted: den kompakte liste over udstedte kort, den fulde sorterbare oversigt, forbrugsdiagrammet og et enkelt kort, hvis oplysninger kan vises. Montér de flader, siden har brug for – de deler kontoen og den legitimation, denne enhed er udstedt med, så en side, der viser et diagram over en oversigt, kun skal forbinde dem én gang. *(sub-controller, 5 elementer)*


## Related topics

- [Åbn et wallet-ark fra din egen knap](https://docs.whop.com/da/developer/guides/payment-request.md)
- [Tilføj Express Checkout](https://docs.whop.com/da/developer/guides/express-checkout.md)
- [ActivityElement](https://docs.whop.com/da/elements/latest/wallet/activity.md)
