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

# Payments

> Indsaml en betaling ud fra et `plan_`-ID eller en inline valuta og et beløb, eller gem en betalingsmetode uden opkrævning med `mode: "setup"`. Montér PaymentElement, CardElement eller CardFields, og kald derefter `payments.createConfirmationToken` med faktureringsoplysninger. Valg af wallet åbner automatisk wallettens ark. Når kontoen tilbyder banktilknytning på siden (`bank_debit.bank_connection` på dens betalingsmetodetype for bankkonto), åbner et valg af bankkonto også Plaid Link på siden. Hvis køberen lukker en af dem, afvises kaldet med `payment_request_cancelled`, som din betalingshandler bør behandle som en annullering. Bekræft tokenet på serveren, og send derefter betalingens eller setup intentens `client_secret` til `handleNextAction` for eventuelle udestående trin.

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

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

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

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

## Indstillinger

Angiv disse til `whop.payments.create({ … })` eller som props på `<Payments>` i React.

> [!NOTE]
>
> Angiv præcis én af disse kombinationer:
>
> * `accountId` og `plan`
> * `accountId`, `currency` og `amount`
> * `accountId`, `mode: "setup"` og `currency`
> * ingen af `plan`, `currency`, `amount` eller `mode`

**accountId** `string`

Konto-ID med præfikset `biz_`. Udelad kun, når du kalder statiske metoder uden en kontoflade.

**mode** `"payment" | "setup"`

Monteringstilstand, `payment` som standard. `setup` gemmer en betalingsmetode og opkræver intet, hverken nu eller senere: kun metoder, der kan gemmes, tilbydes, og beløbsgrænser gælder ikke. Bekræft med `createConfirmationToken()`, og opret derefter setup intenten på serveren.

**plan** `string`

Plan-ID med præfikset `plan_`. Det resolveres på klientsiden til valuta, beløb og metodekonfiguration. Angiv en plan eller en inline valuta og et beløb, aldrig begge.

**offerAmounts** `object`

Totaler for `feeInclusive` og `feeFree` i mindste enhed, der bruges til at afgrænse metoder, når checkout genprissætter `amount` for en gebyrfri metode såsom BNPL. Hver metode kontrolleres mod sin tilsvarende total, så den valgte gebyrfri metode ikke forsvinder. Når de udelades, afgrænser `amount` alle metoder.

**egenskaber**

**feeInclusive** `number` *required*

**feeFree** `number` *required*

**returnUrl** `string`

Retur-URL til bank- eller 3DS-trin uden for siden. Standard er den side, der monterer. Køberen lander der uanset udfaldet, med `payment` (eller `setup`), `status` (`succeeded`, `failed`, `canceled` eller en stadig afventende status såsom `processing`) og `client_secret` tilføjet, så forgren på `status`, før du viser en successide.

**setupFutureUsage** `"off_session" | "on_session"`

En setup gemmer betalingsmetoden til `off_session`-brug, den eneste anvendelse, en setup accepterer.

**previewWalletAvailability** `WalletAvailability`

Tilsidesættelse af wallet-tilgængelighed til deterministiske forhåndsvisninger. Live checkouts undersøger værten.

**egenskaber**

**applePay** `boolean` *required*

**googlePay** `boolean` *required*

**payPal** `boolean`

**order** `("apple_pay" | "google_pay" | "paypal_express")[]`

Wallets rangeret efter, hvilket ark der er native i denne browser — Apple Pay først på WebKit, Google Pay først alle andre steder, PayPal sidst — så express-knapper kan stables med den bedste først. Fraværende ved tilgængelighed angivet af forbrugeren (forhåndsvisninger) og på wire-formater, der er ældre end feltet. En inline union, ikke payment-requests WalletSheetType: det modul importerer allerede dette.

**wallets** `object`

Hver tilgængelig wallets detaljer med wallet-typen som nøgle. Fraværende ved tilgængelighed angivet af forbrugeren (forhåndsvisninger).

**egenskaber**

**apple\_pay** `WalletDetails`

**egenskaber**

**button** `WalletButtonArt`

Wallettens officielle knapgrafik. Fraværende, når der ikke er publiceret nogen.

**egenskaber**

**light** `object` *required*

Til lyse sider.

**egenskaber**

**color** `string` *required*

**image** `string` *required*

**dark** `object` *required*

Til mørke sider.

**egenskaber**

**color** `string` *required*

**image** `string` *required*

**google\_pay** `WalletDetails`

**egenskaber**

**button** `WalletButtonArt`

Wallettens officielle knapgrafik. Fraværende, når der ikke er publiceret nogen.

**egenskaber**

**light** `object` *required*

Til lyse sider.

**egenskaber**

**color** `string` *required*

**image** `string` *required*

**dark** `object` *required*

Til mørke sider.

**egenskaber**

**color** `string` *required*

**image** `string` *required*

**paypal\_express** `WalletDetails`

**egenskaber**

**button** `WalletButtonArt`

Wallettens officielle knapgrafik. Fraværende, når der ikke er publiceret nogen.

**egenskaber**

**light** `object` *required*

Til lyse sider.

**egenskaber**

**color** `string` *required*

**image** `string` *required*

**dark** `object` *required*

Til mørke sider.

**egenskaber**

**color** `string` *required*

**image** `string` *required*

**currency** `string`

Tre-bogstavs ISO 4217-valutakode med små bogstaver. Den filtrerer betalingsmetodematrixen.

**amount** `number`

Betalingsbeløb i mindste enhed. Metoder, hvis grænser udelukker det, tilbydes ikke.

**paymentMethodConfiguration** `object`

Kontoens betalingsmetodefiltre i API'ets format med `enabled`, `disabled` og `include_platform_defaults`. `disabled` fjerner typer, `enabled` gendanner tilbudte typer, og `include_platform_defaults: false` efterlader kun aktiverede typer. Planer leverer deres egen konfiguration.

**egenskaber**

**enabled** `string[]`

**disabled** `string[]`

**include\_platform\_defaults** `boolean`

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

## Events

Angiv callbacks i create-indstillingerne eller som React-props.

### `onLoadingChange`

Kører, når den grupperede indlæsningstilstand ændres. Værdien er `true`, så længe et monteret element stadig indlæses.

**loading** `boolean`

## Metoder

Kald disse på Payments-handlet fra `whop.payments.create({ … })` eller `usePayments()`.

### `createConfirmationToken`

Opretter et bekræftelsestoken for den valgte metode fra din betalingsknap. Angiv checkoutens faktureringsoplysninger. De skal indeholde `email`. Angiv `phone` for metoder, der kræver det, når indsamling af faktureringsoplysninger er slået fra. Kort kræver også `name` og en adresse, der indeholder `line1` og `country`. Valg af wallet åbner wallettens ark under interaktionen med betalingsknappen. Når kontoen tilbyder banktilknytning på siden (`bank_debit.bank_connection` på dens betalingsmetodetype for bankkonto), åbner et valg af bankkonto også Plaid Link undervejs, og kaldet resolveres, når køberen har tilknyttet en konto. Det kræver en whop.com-side eller et domæne, der er klar til Apple Pay via [Domains API](https://docs.whop.com/da/api-reference/beta/domains/domain), og en Content Security Policy, der tillader de Plaid-værter, som `contentSecurityPolicy()` returnerer. Ellers tilknytter køberen i stedet kontoen efter indsendelsen. Hvis køberen lukker arket eller Link, afvises kaldet med `payment_request_cancelled`: behandl det som en annullering, ikke en betalingsfejl, og lad køberen betale igen. Bekræft det returnerede `confirmationToken` på serveren, og kald derefter `WhopElements.payments.handleNextAction(…)`. Kører på din side (på værtssiden), ikke i controllerens iframe.

**Parametre**

**input** `object` *required*

**egenskaber**

**billingDetails** `object`

**egenskaber**

**email** `string`

**name** `string`

**phone** `string`

**address** `object`

**egenskaber**

**country** `string`

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**Returnerer** `Promise<object>`

**confirmationToken** `string` *required*

**type** `string` *required*

### `update`

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

**Parametre**

**options** `Partial\<PaymentsOptions\>` *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 den 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.

## Statiske metoder

Kald disse uden at montere: `whop.payments.<method>(…)` i vanilla eller `useWhop().payments.<method>(…)` i React.

### `handleNextAction`

Fuldfører en bekræftet betalings udestående trin uden at montere et element. `clientSecret` identificerer betalingen. Du behøver ikke et betalings-ID. Inline-trin åbner i en dialog og resolveres med `redirected: false`. Hvis dialogen lukkes, returneres betalingens aktuelle status, som kan forblive afventende. Helsidestrin omdirigerer med `redirected: true` til `return_url` eller til en hostet kvittering, når betalingen ikke har en retur-URL. Inde i en iframe navigerer de fanen på øverste niveau. Hvis den indlejrende side afviser den navigation, afvises de med koden `TAB_NAVIGATION_BLOCKED`, og betalingen forbliver afventende. Sæt `returnUrl` for at opdatere destinationen før visning. En mislykket opdatering afvises, før noget trin kører. Inline-trin navigerer aldrig til den URL. En betaling, hvis opkrævning stadig er ved at blive afgjort, polles, indtil et trin dukker op, eller den afsluttes; en afgjort betaling uden trin resolveres med det samme.

**Parametre**

**input** `object` *required*

**egenskaber**

**clientSecret** `string` *required*

**returnUrl** `string`

**pollIntervalMs** `number`

**Returnerer** `Promise<object>`

**status** `string` *required*

**redirected** `boolean` *required*

**lastPaymentError** `object | null` *required*

**egenskaber**

**code** `string | null`

**decline\_code** `string | null`

**message** `string | null`

## Ressourcer

Opret disse SDK-objekter uden at montere et element. Hvert har sin egen side:

> [card] [PaymentRequest](https://docs.whop.com/da/elements/latest/payments/paymentRequest.md)
>
> Lavniveau-ark til Apple Pay, Google Pay eller PayPal til brugerdefinerede knapper, express checkout og forsendelses-callbacks. Wallet-felter automatiserer dette flow via `payments.createConfirmationToken`. Afvent `canMakePayment()` for at kontrollere tilgængelighed og forberede wallet'en, og kald derefter `show(type)` synkront i handleren for brugerinteraktionen. Det resolverede `ctok` er et bekræftelsestoken med præfikset `ctok_`. Bekræft det på serveren som et token oprettet af et element. Et PayPal-token opkræver højst den total, PayPal viste køberen.

## Content Security Policy

Noget af denne gruppes arbejde kører på din side, ikke i en frame. En side med en Content Security Policy har brug for disse kilder. `contentSecurityPolicy()` fra `@whop/elements` returnerer alle kilder i denne tabel. Sandbox-kilden gælder med `environment: "sandbox"`.

| Krav | Direktiv | Produktionskilde | Sandbox-kilde |
| - | - | - | - |
| Plaid Links script | `script-src` | `https://cdn.plaid.com` | Samme |
| ↳ Plaid Links frame, som Plaids script åbner | `frame-src` | `https://cdn.plaid.com` | Samme |
| ↳ Plaids API, som Plaids script kalder | `connect-src` | `https://production.plaid.com` | `https://sandbox.plaid.com` |

## Elementer

De elementer, som denne gruppe monterer. Hvert har sin egen side:

> [card] [AddressElement](https://docs.whop.com/da/elements/latest/payments/address.md)
>
> Indsamler en fakturerings- eller leveringsadresse. Felter, rækkefølge og validering følger det valgte land. Indeholder autocomplete for gadeadresse (fuld skærm på telefoner) og metoder til at læse eller validere adressen.

> [card] [EmailElement](https://docs.whop.com/da/elements/latest/payments/email.md)
>
> Indsamler køberens e-mail og sender den til `payments.createConfirmationToken()`, så længe elementet er monteret. En eksplicit `billingDetails.email` har forrang. En matchende Whop-konto viser valgfri indlogning med kodeverificering eller med kontoens passkey, hvis den har en. En vellykket indlogning låser op for gemte betalingsmetoder i betalingselementet. Købere kan fortsætte som gæster.

> [card] [TaxIdElement](https://docs.whop.com/da/elements/latest/payments/taxId.md)
>
> Indsamler en virksomheds skatteregistrering, som API'et accepterer. Etiketterne bruger navne rettet mod køberen. Pladsholderen matcher det valgte format. `country` forudvælger en type. `onChange` udsender bekræftede par. Værten leverer API'ets valideringsfejl.

> [card] [BrandingElement](https://docs.whop.com/da/elements/latest/payments/branding.md)
>
> **Påkrævet — de øvrige elementer undtagen `AddressElement`, `EmailElement` og `TaxIdElement` venter på det.** Whops merchant-of-record-meddelelse: køberens accept af Whops servicevilkår for købere og privatlivspolitik, med Whop-ordmærket. Påkrævet — betalings-, kort- og kortfeltelementerne forbliver i deres indlæsningstilstand, indtil det er monteret, og betalinger kan ikke bekræftes uden det.

**Alternativer.** Montér ét ad gangen. Ødelæg det, før du monterer et andet:

> [card] [PaymentElement](https://docs.whop.com/da/elements/latest/payments/payment.md)
>
> Viser tilgængelige betalingsmetoder og indsamler den valgte metodes påkrævede felter og oplysninger. Brug `change` til at aktivere din betalingsknap. Kald `payments.createConfirmationToken()` i dens aktiveringshandler. Bekræft tokenet på serveren, og send derefter eventuelle udestående trin til `payments.handleNextAction(…)`. Brug `addressChange` til adresseafhængige opdateringer.

> [card] [CardElement](https://docs.whop.com/da/elements/latest/payments/card.md)
>
> Færdigarrangerede felter til kortnummer, udløbsdato og sikkerhedskode. Opret med `payments.create("card")`, aktivér din betalingsknap ud fra `onChange`, og bekræft med `payments.createConfirmationToken()`. Kortnumre forbliver i PCI-isolerede hostede felter. `layout` understøtter `stacked` (standard) og `compact`.

> [card] [CardFields](https://docs.whop.com/da/elements/latest/payments/cardFields)
>
> Tre separat monterbare, PCI-isolerede kortfelter til brugerdefinerede layouts: nummer, udløbsdato og sikkerhedskode. Opret med `payments.create("cardFields")`, placér hvert felt, aktivér din betalingsknap ud fra `onChange`, og bekræft med `payments.createConfirmationToken()`. Kortnumre forbliver i hostede felter. *(sub-controller, 3 elementer)*


## Related topics

- [Payments API](https://docs.whop.com/da/api-reference/payments/payment.md)
- [Retrieve Payment](https://docs.whop.com/da/api-reference/payments/retrieve-payment.md)
- [Retry Payment](https://docs.whop.com/da/api-reference/payments/retry-payment.md)
