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

# DepositElement

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

> [!NOTE]
>
> Denne side dokumenterer `@whop/elements@1.10.0` og `@whop/elements-react@1.10.0`.

*Siden `v1.0.0`.*

Monteres inde i [`Wallet`](https://docs.whop.com/da/elements/latest/wallet/overview). `accountId` og `accessToken` kommer derfra. Send props og callbacks via create-indstillingerne eller React-props. Behold det oprettede handle eller React-`ref` for at kalde `showStep()` og `refresh()`.

> [!NOTE]
>
> Du kan montere dette element **inline** (`create`) eller åbne det som et **modal**-overlay (`createOverlay`).

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <DepositElement onDepositInitiated={(e) => console.log(e)} onCardDepositRequested={(e) => console.log(e)} onAddCardRequested={(e) => console.log(e)} onBankSelected={(e) => console.log(e)} onIdentityVerificationRequested={(e) => console.log(e)} onPlatformBalanceSelected={(e) => console.log(e)} onDepositConfirmed={(e) => console.log(e)} onStepChanged={(e) => console.log(e)} onDismissed={(e) => console.log(e)} />
      </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 */ });
  wallet.create('deposit', {
    onDepositInitiated: (e) => console.log(e),
    onCardDepositRequested: (e) => console.log(e),
    onAddCardRequested: (e) => console.log(e),
    onBankSelected: (e) => console.log(e),
    onIdentityVerificationRequested: (e) => console.log(e),
    onPlatformBalanceSelected: (e) => console.log(e),
    onDepositConfirmed: (e) => console.log(e),
    onStepChanged: (e) => console.log(e),
    onDismissed: (e) => console.log(e)
  }).mount('#wallet-deposit');
</script>
```

Eksempeldata. [Åbn Playground](https://docs.whop.com/da/elements/latest/wallet/overview#playground).

## Props

**accessToken** `string`

Et afgrænset token, der lader opløsningen af kanaler læse en personlig (`user_`) konto – kræver `payout:account:read` plus `payout:account:update`, for at bankkanalen kan klargøres. Udsted det på din server med `POST /api/v1/access_tokens`. Hvis det udelades, bruger kaldet seerens egen session, som kun svarer på samme origin; virksomhedskonti opløses uden nogen legitimation.

**amount** `string`

Udfyld beløbet på forhånd, og gør det skrivebeskyttet – til flows, der allerede ved, hvad der skyldes. Et beløb på eller under nul ignoreres, ligesom et beløb med mere end 12 hele cifre; resten afrundes til valutaens antal decimaler. Standard er `""`.

**showCrypto** `boolean`

Tilbyd kryptokanalen, når kontoen har en indbetalingsadresse. Standard er `true`.

**showBank** `boolean`

Tilbyd kanalen til bankoverførsel. Vises, selv før kontoen har bankoplysninger – hvis den vælges, beder den seeren om at verificere sin identitet, når det er det, kontoen stadig mangler, og rapporterer kanalen som endnu ikke tilgængelig, når det ikke er tilfældet. Standard er `true`.

**savedCards** `DepositSavedCard[]`

Kort, du allerede har gemt for denne betaler, vist som indbetalingsrækker. Valg af et kort udsender `cardDepositRequested` med beløbet – elementet opkræver aldrig selv en kortbetaling. Standard er `[]`.

**egenskaber**

**id** `string` *required*

Betalingsmetode-ID, der sendes tilbage i `cardDepositRequested`.

**label** `string` *required*

Rækkens etiket, for eksempel `Visa •••• 4242`.

**cardBrand** `string | null`

Mærkenøgle, der bruges til at vælge rækkens ikon – `visa`, `mastercard`, `amex`, `discover`, `jcb`.

**allowNewCard** `boolean`

Tilføj en "Add card"-række, der udsender `addCardRequested`, så du kan åbne dit eget flow til indsamling af kort. Standard er `false`.

**showPlatformBalance** `boolean`

Tilbyd en "Platform balance"-række, der udsender `platformBalanceSelected` med det samme uden et beløbstrin. Standard er `false`.

**cardFee** `DepositCardFee | null`

Behandlingsgebyrer, der vises som forhåndsvisning under beløbet, når en kortrække er valgt. `percentageFee` er i PROCENTPOINT (`2.9` er 2,9 %); `fixedFee` og `radarFee` er i hele valutaenheder (`0.3` er \$0.30). Standard er `null`.

**egenskaber**

**percentageFee** `number` *required*

PROCENTPOINT, ikke en brøk: `2.9` betyder 2,9 %.

**fixedFee** `number` *required*

Fast gebyr i hele valutaenheder: `0.3` betyder \$0.30.

**radarFee** `number` *required*

Gebyr for svindelscreening i hele valutaenheder.

**depositRailFees** `Partial\<Record\<"crypto" | "bank", DepositRailFee\>\>`

Tilsidesæt kontoens indbetalingsgebyrer under kanalvælgeren, med kanalen som nøgle (`bank`, `crypto`). Udeladte kanaler bruger de gebyrer, kontoen returnerer. `percentageFee` er i PROCENTPOINT (`1.5` er 1,5 %); `fixedFeeUsd` er i hele USD-enheder (`2` er \$2.00) uanset indbetalingsvalutaen. Viser satsen, før der indtastes et beløb, og det opkrævede beløb bagefter. Standard er `{}`.

**egenskaber**

**crypto** `DepositRailFee`

**egenskaber**

**percentageFee** `number` *required*

PROCENTPOINT, ikke en brøk: `1.5` betyder 1,5 %.

**fixedFeeUsd** `number` *required*

Fast gebyr i hele USD-enheder: `2` betyder \$2.00 uanset indbetalingsvalutaen.

**bank** `DepositRailFee`

**egenskaber**

**percentageFee** `number` *required*

PROCENTPOINT, ikke en brøk: `1.5` betyder 1,5 %.

**fixedFeeUsd** `number` *required*

Fast gebyr i hele USD-enheder: `2` betyder \$2.00 uanset indbetalingsvalutaen.

**preferredMethodId** `string`

Forvælg en kanal efter id (`bank`, `crypto`, `platform_balance` eller et gemt korts id). Continue forbliver deaktiveret, så længe den kanal endnu ikke tilbydes, i stedet for at indbetale via en anden. Standard er `""`.

**deferBankToHost** `boolean`

Udsend `bankSelected`, og bliv på beløbsskærmen i stedet for at vise overførselsfelterne – til værter, der kører deres eget trin, efter at kontoen allerede har en virtuel bankkonto. Standard er `false`.

**confirmCryptoDeposit** `boolean`

Vis en "I have deposited my funds"-knap på kryptoskærmen, der udsender `depositConfirmed`, så du kan begynde at holde øje med overførslen. Standard er `false`.

**initialStep** `"amount" | "crypto" | "bank"`

Åbn direkte på en kanal i stedet for vælgeren. `crypto` og `bank` kræver intet beløb; deres tilbage-knap udsender `dismissed`, fordi der ikke er nogen vælger bag dem. Standard er `"amount"`.

## Hændelser

Send callbacks i create-indstillingerne eller React-props.

### `onDepositInitiated`

Betaleren bekræftede et beløb og en kanal. Udløses for alle kanaler, før nogen instruktioner vises – hooket til analyse/funnel.

**payload** `object`

**egenskaber**

**method** `"crypto" | "bank" | "card" | "platform_balance"` *required*

**amount** `number` *required*

**currency** `string` *required*

**paymentMethodId** `string`

### `onCardDepositRequested`

Et gemt kort blev valgt. Opkræv betalingen på din side, og kald derefter `showStep({ step: "amount" })` for at sende elementet tilbage til vælgeren.

**payload** `object`

**egenskaber**

**amount** `number` *required*

**currency** `string` *required*

**paymentMethodId** `string` *required*

### `onAddCardRequested`

Rækken "Add card" blev valgt – åbn dit flow til indsamling af kort.

### `onBankSelected`

Bankkanalen blev valgt, mens `deferBankToHost` er sat – kør dit trin, og vis derefter selv felterne, eller kald `showStep({ step: "bank" })`.

### `onIdentityVerificationRequested`

Seeren valgte bankoverførsel, før denne konto har en virtuel bankkonto. Elementet bliver på beløbsskærmen og navigerer aldrig – montér din egen verifikation, f.eks. `verifications`-controlleren, som svar på dette.

**payload** `object`

**egenskaber**

**accountId** `string` *required*

### `onPlatformBalanceSelected`

Rækken med platformssaldo blev valgt. Den indeholder intet beløb – din egen skærm indsamler det.

### `onDepositConfirmed`

Betaleren oplyste at have sendt kryptoen. `since` er en nedre grænse i unix-sekunder, hvorfra indgående overførsler begynder at blive matchet (den kigger lidt tilbage i tiden, så en overførsel sendt øjeblikke før klikket stadig matcher).

**payload** `object`

**egenskaber**

**network** `string` *required*

**token** `string` *required*

**networkLabel** `string` *required*

**since** `number` *required*

### `onStepChanged`

Den synlige skærm ændrede sig.

**payload** `object`

**egenskaber**

**step** `"amount" | "crypto" | "bank"` *required*

### `onDismissed`

Betaleren gik tilbage fra en kanal, som elementet blev åbnet direkte på – luk den flade, der indeholder det.

### `onLoaderStart`

Kører, efter at indlæsningsskelettet tegnes første gang, og før `onReady`.

### `onReady`

Kører efter elementets første komplette optegning.

### `onError`

Kører, når elementet ikke kan indlæses eller går ned. Fallback-visningen forbliver synlig. Brug `code` til programmatisk håndtering. `sourceKey` identificerer en host-state-kilde, der fejlede.

**e** `object`

**egenskaber**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Metoder

Kald disse på det handle, som `create` returnerer, eller via en React-`ref`.

### `showStep`

Flyt elementet til en skærm. `{ step: "amount" }` er måden, du giver kontrollen tilbage på, efter at du har gennemført en indbetaling med kort eller platformssaldo på din side.

**Parametre**

**input** `object` *required*

**egenskaber**

**step** `"amount" | "crypto" | "bank"` *required*

**Returnerer** `Promise<void>`

### `refresh`

Opløs kontoens indbetalingskanaler igen. Kald den, når noget på din side ændrer, hvad kontoen kan tilbyde – f.eks. når bank-onboarding er fuldført – så den nye kanal vises uden at vente på, at cachen udløber.

**Returnerer** `Promise<void>`

### `mount`

Monterer elementet i `target` og begynder indlæsningen. React-komponenter monterer sig selv.

**Parametre**

**target** `string | HTMLElement` *required*

### `destroy`

Fjerner elementet og frigiver dets frame og abonnementer. Du kan kalde den mere end én gang. React fjerner elementet automatisk.

### `update`

Fletter nye props ind i det monterede element. I React ændrer du i stedet komponentens props.

**Parametre**

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

## Styling

Style disse dele via `appearance.classes`. Brug camel case eller kebab case til egenskabsnavne, og medtag enheder. Sidens stylesheets kan ikke nå elementets frame. Frameworket validerer hver deklaration, før den indsættes.

| Klasse | Rammer |
| - | - |
| `.whop-DepositSurface` | Roden af deposit-elementet – én skærm ad gangen |

```ts theme={null}
const wallet = whop.wallet.create({
  appearance: {
    classes: {
      'whop-DepositSurface': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

wallet.update({
  appearance: {
    classes: { 'whop-DepositSurface': { fontWeight: '700' } }
  }
});
```

I React sender du `appearance` til `<Wallet>`. Sæt det globalt med `WhopElements({ appearance })`.
