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

# CheckoutSession

> Lavniveau, headless checkout-session til en side, der tegner sin egen PayPal-knap. `load()` opretter checkout-sessionen ud fra `lineItems`; `show("paypal", { termsAccepted: true })` sender køberen til PayPal — et pop op-vindue på desktop, hele fanen på telefoner — og resolver med betalingen, når køberen godkender. Med `paymentMethodOptions.paypal.requestShipping` beder PayPal køberen om en leveringsadresse, og kontoens webhook, der abonnerer på `shipping_address.changed`, prissætter hver adresse på din server, mens køberen er på PayPal; betalingen oprettes først, når køberen godkender, til den pris. Efter en helsidesomdirigering bliver promiset aldrig afgjort; aflæs i stedet udfaldet fra query-parametrene `payment` og `status` på `redirectUrl`.

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

*Siden `v1.10.0`.*

Opret denne [`Checkout`](https://docs.whop.com/da/elements/latest/checkout/overview)-ressource uden at montere et element: `whop.checkout.checkoutSession.create({ … })` i vanilla eller `useWhop().checkout.checkoutSession.create({ … })` i React.

## Indstillinger

Angiv disse til `whop.checkout.checkoutSession.create({ … })`.

**accountId** `string` *required*

Konto-ID med præfikset `biz_`, der sælger linjeposterne.

**lineItems** `CheckoutSessionLineItem[]` *required*

Det, køberen køber: hver post angiver en variant (`plan_…`) og en valgfri `quantity` (standard 1). Flere poster udgør en kurv.

**egenskaber**

**variant** `string` *required*

**quantity** `number`

**redirectUrl** `string` *required*

Hvor køberen lander efter PayPal, når fanen blev omdirigeret, med `payment` og `status` tilføjet: `succeeded`, `canceled`, `failed` eller `processing`, mens Whop stadig er ved at gennemføre opkrævningen (læs betalingen fra din server for at se den blive afgjort). På desktop lukkes pop op-vinduet i stedet, og `show()` bliver afgjort.

**metadata** `Record\<string, string\>`

Dine egne strengnøgler og -værdier, op til 40, som gemmes på checkout-sessionen og kopieres over på den betaling, den opretter, så de kommer tilbage på betalingen og dens webhooks, for eksempel til annonce- og affiliate-attribution. De angives fra køberens browser, så stol aldrig på dem til priser eller levering.

**setupFutureUsage** `"off_session"`

Sæt til `off_session` for at gemme køberens PayPal-konto, så din server senere kan opkræve den uden køberen, for eksempel til et upsell med ét klik. PayPal beder køberen om at acceptere fremtidige betalinger, mens de godkender. Angiv det kun, efter at du har fortalt køberen, at deres PayPal-konto bliver gemt.

**email** `string`

Køberens e-mail, som betalingen og medlemskabet tilhører. Udelad den for at bruge e-mailen fra den PayPal-konto, der godkender.

**paymentMethodOptions** `CheckoutSessionPaymentMethodOptions`

Indstillinger for én betalingsmetode. `paypal.requestShipping` får PayPal til at bede køberen om en leveringsadresse. Når kontoen har et aktiveret `https`-webhook, der abonnerer på `shipping_address.changed`, kalder Whop det for hver adresse og opkræver de totaler, det svarer med. Standard er `false`.

**egenskaber**

**paypal** `CheckoutSessionPayPalOptions`

**egenskaber**

**requestShipping** `boolean`

## Metoder

Kald disse på ressourcen.

> [!WARNING]
>
> Kald `show` synkront under brugeraktivering. Afvent forudsætninger først.

### `load`

Opret checkout-sessionen ud fra `lineItems`. Kalder du den igen, returneres den samme session. `show()` indlæser den først, hvis den ikke er indlæst. `terms` er det, køberen accepterer ved at betale: vis dens `links` (sælgerens offentliggjorte politikker og Whops købervilkår) ved siden af din knap, og når `terms.required` er `true`, skal køberen aktivt acceptere dem, for eksempel med et afkrydsningsfelt. `requirements` angiver, hvad sessionen skal bruge, før den kan betales: alt andet end `email`, `terms` og, med `paypal.requestShipping`, `shipping_address` kan ikke indsamles her, så `show()` afviser det.

**Returnerer** `Promise<CheckoutSessionLoaded>`

**id** `string` *required*

**status** `string` *required*

**requirements** `string[]` *required*

**terms** `CheckoutSessionTerms` *required*

**egenskaber**

**required** `boolean` *required*

**links** `CheckoutSessionTermsLink[]` *required*

**egenskaber**

**kind** `string` *required*

En af `"terms_of_service"`, `"privacy_policy"`, `"return_policy"`, `"eula"`, `"whop_buyer_terms"` eller `"whop_privacy_policy"`.

**url** `string` *required*

### `show`

Kald den synkront i din PayPal-knaps klik-handler: på desktop åbner den pop op-vinduet der, og et pop op-vindue, der åbnes senere, bliver blokeret. Angiv kun `termsAccepted: true`, når `load()`'s `terms.links` blev vist ved siden af knappen for dette tryk, og, når `terms.required` er `true`, køberen aktivt har accepteret dem. Resolver med `{ payment }`, når køberen godkender, og Whop opkræver. Afviser med en fejl, hvis `code` er `attestation_required` uden `termsAccepted`, `requirements_unsupported`, når sessionen kræver noget, PayPal ikke kan indsamle (se `requirements` fra `load()`), `payment_request_cancelled`, når køberen annullerer eller lukker PayPal, `seller_pricing_unavailable`, når kontoen ikke kan prissætte denne betaling via sit webhook (den håndterer ikke selv sin moms, eller kurven har en rabatkode, et køber-gebyr, en marketplace-deling eller en plan, der fornyes), eller ellers `payment_failed`. På telefoner går fanen til PayPal, og promiset bliver aldrig afgjort. Kald synkront under brugeraktivering. Afvent forudsætninger først, fordi browsere tilbagekalder aktiveringen på tværs af asynkrone trin.

**Parametre**

**paymentMethod** `"paypal"` *required*

**options** `CheckoutSessionShowOptions`

**egenskaber**

**termsAccepted** `boolean`

**Returnerer** `Promise<CheckoutSessionConfirmResult>`

**payment** `CheckoutSessionPayment` *required*

**egenskaber**

**id** `string` *required*

**status** `string` *required*
