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

# Variants API

> En Variant er én købbar konfiguration af et produkt.

Den styrer pris, faktureringskadence, lager, SKU, attributter, momsadfærd, checkout-felter og købssynlighed. Variant-ID'er har fortsat præfikset `plan_`.

Brug Variants API'et til at oprette varianter til produkter, vise eksisterende varianter, hente eller opdatere variantkonfiguration, beregne moms til checkout og slette varianter, der ikke længere skal tilbydes.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [Vis varianter](https://docs.whop.com/da/api-reference/variants/list-variants.md) | GET `/variants` |
| [Hent variant](https://docs.whop.com/da/api-reference/variants/retrieve-variant.md) | GET `/variants/{id}` |
| [Opret variant](https://docs.whop.com/da/api-reference/variants/create-variant.md) | POST `/variants` |
| [Opdatér variant](https://docs.whop.com/da/api-reference/variants/update-variant.md) | PATCH `/variants/{id}` |
| [Slet variant](https://docs.whop.com/da/api-reference/variants/delete-variant.md) | DELETE `/variants/{id}` |

## Attributter

**id** `string` *required*

Variant-ID med præfikset `plan_`.

**account** `object | null` *required*

Konto, der sælger denne variant; `null` for selvstændige fakturavarianter.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Konto-ID med præfikset `biz_`.
>
> **title** `string` *required*
>
> Kontoens visningsnavn.

**adaptive\_pricing\_enabled** `boolean` *required*

Om adaptiv prissætning er aktiveret for denne variant. Rå indstilling — kontrollerer ikke
processorkompatibilitet eller feature flags.

**allow\_multiple\_quantity** `boolean` *required*

Om mere end én enhed kan købes i en ordre. Fornyelsesvarianter
kan ikke aktivere det. Når `false`, afviser checkouts, kurve og fakturaer en
mængde over 1.

**attributes** `object | null` *required*

Attributværdier, der adskiller denne variant inden for dens produkt, som et map fra attributnavn til værdi, f.eks. `\{"color": "Blue", "size": "Large"}`. Navne er snake\_case-identifikatorer og returneres i alfabetisk rækkefølge. Hver variant med attributter på et produkt har de samme attributnavne og et særskilt sæt værdier; produktet viser det fulde sæt af muligheder som `variant_attributes`. `null`, når varianten ikke har nogen attributter.

**billing\_period** `number | null` *required*

Antal dage mellem tilbagevendende opkrævninger, såsom 30 for månedlig eller 365 for
årlig. `null` for engangsvarianter.

**billing\_type** `string` *required*

Faktureringsmodel for denne variant.

Tilgængelige muligheder: `renewal`, `one_time`

**cancel\_discount\_intervals** `number | null` *required*

Hvor længe annulleringsrabatten varer: `0` for altid, `1` kun den næste betaling,
eller et antal kalendermåneder fra det tidspunkt, hvor kunden accepterer den. `null`
når ingen tilbydes, eller aktøren mangler `plan:basic:read`-scopet.

**cancel\_discount\_percentage** `number | null` *required*

Annulleringsrabat som en heltalsprocent. `null`, når ingen
tilbydes, eller aktøren mangler `plan:basic:read`-scopet.

**checkout\_styling** `object | null` *required*

Checkout-styling på variantniveau (`background_color`, `button_color`,
`font_family`, `border_style`); `null` arver kontoens standard.

**collect\_tax** `boolean` *required*

Om der opkræves moms ved køb af denne variant, baseret på kontoens
momskonfiguration.

**created\_at** `string` *required*

Hvornår varianten blev oprettet, som et ISO 8601-tidsstempel.

**currency** `string` *required*

Trebogstavs ISO 4217-kode for den valuta, som alle priser på denne variant er
angivet i, med små bogstaver: variantens egen valuta, eller den
`presentment_currency`, som læsningen bad om, når varianten kan omregnes
til den.

**custom\_fields** `object[]` *required*

Brugerdefinerede inputfelter, der indsamles i checkout-formularen.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> ID for brugerdefineret felt med præfikset `field_`.
>
> **field\_type** `string` *required*
>
> Inputtype for brugerdefineret felt.
>
> Tilgængelige muligheder: `text`
>
> **name** `string` *required*
>
> Feltetiket, der vises for kunden ved checkout.
>
> **order** `number` *required*
>
> Feltets position i checkout-formularen.
>
> **placeholder** `string | null` *required*
>
> Pladsholdertekst, der vises i det tomme felt. `null`, hvis ingen er angivet.
>
> **required** `boolean` *required*
>
> Om kunden skal udfylde dette felt for at gennemføre checkout.

**deletable** `boolean | null` *required*

Om varianten kan slettes (den har ingen medlemskaber eller ventelisteposter).
`null`, medmindre aktøren har `plan:basic:read`-scopet på
variantens konto.

**description** `string | null` *required*

Variantbeskrivelse, der er synlig for kunden. Maksimalt 1000 tegn. `null`, hvis ingen
beskrivelse er angivet.

**effective\_payment\_method\_configuration** `object | null` *required*

Den konfiguration, der styrer en checkout for denne variant, opløst gennem alle lag (variantens egen og kontoens) — den form, som en sessions `payment_method_configuration` har. Anvend den oven på kataloget over betalingsmetodetyper for at få det sæt, der kan tilbydes. `null` betyder platformens standarder; `payment_method_configuration` forbliver variantens egen redigerbare tilsidesættelse.

> [accordion] Egenskaber
>
> **disabled** `string[]` *required*
>
> Betalingsmetoder, som denne checkout tilbageholder, selv når standarderne ville tilbyde
> dem.
>
> **enabled** `string[]` *required*
>
> Betalingsmetoder, som denne checkout tilbyder ud over det, standarderne giver.
>
> **include\_platform\_defaults** `boolean` *required*
>
> Om Whops standardsæt er udgangspunktet. Når `false`, tilbydes kun `enabled`.

**expiration\_days** `number | null` *required*

Adgangsvarighed i dage for udløbsbaserede varianter, såsom 365 for et
etårigt pas. `null` for varianter uden udløb.

**formatted\_price** `string` *required*

Menneskelæsbar pris til visning (valuta + interval) i `currency`, f.eks.
"\$10 / month".

**image** `object | null` *required*

Billede for prisniveau (`url`, `blurhash`), der vises på produktsiden; `null`, når
intet billede er angivet.

**initial\_price** `number` *required*

Indledende købspris, i `currency`.

**initial\_price\_due** `object` *required*

Samlet beløb opkrævet ved checkout for én enhed, før rabatkoder og moms: `initial_price` plus den første `renewal_price` for tilbagevendende varianter, eller `initial_price` alene, mens en gratis prøveperiode gælder. Prøveperioden gælder ikke, når den visende bruger allerede har brugt en for denne variant. Angivet i `currency`.

> [accordion] Egenskaber
>
> **amount** `string` *required*
>
> Beløbet i hovedenheder, som en eksakt decimalstreng. For eksempel er `"10.00"`
> ti dollars. Det er en streng, så ingen float afrunder det undervejs.
>
> **currency** `string` *required*
>
> Trebogstavs ISO 4217-valutakode med små bogstaver.
>
> **decimals** `integer` *required*
>
> Hvor mange decimaler beløbet har. Dette er den præcision, som selve
> opkrævningen kører med.
>
> **display\_decimals** `integer` *required*
>
> Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, og bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen locale ved hjælp af dette.

**internal\_notes** `string | null` *required*

Private noter, der ikke vises for kunder. `null`, medmindre aktøren har
`plan:basic:read`-scopet på variantens konto.

**invoice** `object | null` *required*

Faktura, som denne variant blev genereret til; `null`, medmindre den er oprettet til en faktura.

**member\_count** `number | null` *required*

Aktive medlemskaber gennem denne variant. `null`, medmindre aktøren har
`plan:basic:read`-scopet på variantens konto.

**metadata** `object | null` *required*

Brugerdefinerede nøgle-værdi-par gemt på varianten. Inkluderet i webhook-payloads for
betalings- og medlemskabshændelser. Maksimalt 50 nøgler, 100 tegn pr. nøgle, 500
tegn pr. værdi. De reserverede nøgler `custom_cta` og `custom_cta_url`
tilsidesætter, når de er angivet, produktets checkout-call-to-action for denne variant.

**offer\_cancel\_discount** `boolean | null` *required*

Om der tilbydes en annulleringsrabat. `null`, medmindre aktøren har
`plan:basic:read`-scopet på variantens konto.

**payment\_method\_configuration** `object | null` *required*

Konfiguration af betalingsmetoder (`enabled`, `disabled`,
`include_platform_defaults`); `null`, når varianten bruger standardindstillinger.

**product** `object | null` *required*

Produkt, som denne variant hører til; `null` for selvstændige varianter.

**purchase\_url** `string` *required*

URL, hvor kunder kan købe denne variant direkte.

**redirect\_url** `string | null` *required*

Hvor kunden sendes hen efter betaling for denne variant. `null`, når intet er
angivet, eller medmindre aktøren har `plan:basic:read`-scopet på variantens
konto.

**release\_method** `string` *required*

Salgsmetode for denne variant.

Tilgængelige muligheder: `buy_now`, `waitlist`

**renewal\_price** `number` *required*

Tilbagevendende pris, der opkræves hver faktureringsperiode, i `currency`.

**sku** `string | null` *required*

Lagerenhed (SKU), fritekst angivet af sælgeren (f.eks. `TSHIRT-LARGE-BLUE`).
Håndhæves ikke som unik. `null`, når den ikke er angivet.

**split\_pay\_required\_payments** `number | null` *required*

Ratebetalinger, der kræves, før abonnementet sættes på pause. Skal være større
end 1. `null`, hvis split pay ikke er konfigureret.

**stock** `number | null` *required*

Enheder tilgængelige for køb. `null`, medmindre aktøren har
`plan:basic:read`-scopet på variantens konto.

**strike\_through\_initial\_price** `number | null` *required*

Oprindelig startpris vist med gennemstregning, i `currency`. `null`, når
ingen gennemstregning er angivet.

**strike\_through\_renewal\_price** `number | null` *required*

Oprindelig fornyelsespris vist med gennemstregning, i `currency`. `null`, når
ingen gennemstregning er angivet.

**tax\_type** `string` *required*

Hvordan moms håndteres for denne variant, herunder om moms er inkluderet i prisen, lægges til ved checkout eller ikke er konfigureret.

Tilgængelige muligheder: `inclusive`, `exclusive`, `unspecified`

**three\_ds\_level** `string | null` *required*

3D Secure-adfærd for understøttede kortbetalinger i sessionen. `mandate_challenge` kræver en 3DS-udfordring før betalingsbehandling; `mandate_if_required` kræver kun en udfordring, når betalingsprocessoren kræver det; `frictionless_if_required` bruger det almindelige friktionsfri 3DS-flow. Betalinger på \$1.000 eller mere bruger `mandate_if_required`, medmindre `mandate_challenge` er valgt. Krav til risiko og gendannelse af godkendelse kan tilsidesætte præferencen. `null` arver kontoens standard.

Tilgængelige muligheder: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`

**title** `string | null` *required*

Variantens visningsnavn, der vises for kunder. Maksimalt 30 tegn. En variant,
der oprettes uden et, får som standard sine attributværdier sammensat med `/`. `null`
hvis ingen titel er angivet.

**trial\_period\_days** `number | null` *required*

Dage med gratis prøveperiode før den første fornyelsesopkrævning. `null`, hvis ingen prøveperiode er
konfigureret, eller brugeren allerede har brugt en prøveperiode for denne variant.

**unlimited\_stock** `boolean` *required*

Om varianten har ubegrænset lager. Når `true`, ignoreres feltet `stock`;
ventelistevarianter rapporterer altid `true`.

**unpaid\_invoice\_count** `integer | null` *required*

Antal udstedte fakturaer for denne variant, der ikke er betalt eller annulleret. Mens det
er over `0`, kan du ikke ændre variantens priser, faktureringsperiode, prøveperiode,
antal betalinger, valuta eller faktureringstype. `null`, medmindre aktøren har
`plan:basic:read`-scopet på variantens konto.

**updated\_at** `string` *required*

Hvornår varianten sidst blev opdateret, som et ISO 8601-tidsstempel.

**visibility** `string` *required*

Styrer, hvor denne variant kan ses. Når `hidden`, kan varianten kun nås via dens direkte link.

Tilgængelige muligheder: `visible`, `hidden`, `archived`, `quick_link`

```json Variant theme={null}
{
	"id": "plan_xxxxxxxxxxxxx",
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Pickaxe"
	},
	"adaptive_pricing_enabled": true,
	"allow_multiple_quantity": false,
	"attributes": {
		"seats": "5",
		"tier": "Pro"
	},
	"billing_period": 30,
	"cancel_discount_intervals": null,
	"cancel_discount_percentage": null,
	"checkout_styling": null,
	"collect_tax": true,
	"created_at": "2023-12-01T05:00:00.401Z",
	"currency": "usd",
	"custom_fields": [
		{
			"id": "cusf_xxxxxxxxxxxx",
			"field_type": "text",
			"name": "Discord username",
			"order": 0,
			"placeholder": "e.g. pickaxe_user",
			"required": true
		}
	],
	"deletable": false,
	"description": "Monthly access to Pickaxe Analytics.",
	"expiration_days": null,
	"formatted_price": "$29.00 / month",
	"image": null,
	"initial_price": 29,
	"internal_notes": "Standard monthly variant",
	"redirect_url": null,
	"invoice": null,
	"member_count": 42,
	"metadata": {
		"external_plan_id": "monthly",
		"custom_cta": "subscribe",
		"custom_cta_url": "https://example.com/wash-club"
	},
	"offer_cancel_discount": false,
	"payment_method_configuration": {
		"enabled": ["card"],
		"disabled": [],
		"include_platform_defaults": true
	},
	"effective_payment_method_configuration": {
		"enabled": ["card"],
		"disabled": [],
		"include_platform_defaults": true
	},
	"billing_type": "renewal",
	"product": {
		"id": "prod_xxxxxxxxxxxxx",
		"title": "Pickaxe Analytics"
	},
	"purchase_url": "https://whop.com/pickaxe-analytics/checkout/plan_xxxxxxxxxxxxx",
	"release_method": "buy_now",
	"renewal_price": 29,
	"initial_price_due": {
		"currency": "usd",
		"amount": "29.00",
		"decimals": 2,
		"display_decimals": 2
	},
	"sku": "PICKAXE-PRO-5-MONTHLY",
	"split_pay_required_payments": null,
	"stock": null,
	"strike_through_initial_price": null,
	"strike_through_renewal_price": null,
	"tax_type": "exclusive",
	"three_ds_level": "frictionless_if_required",
	"title": "Pro / 5 seats",
	"trial_period_days": 7,
	"unlimited_stock": true,
	"unpaid_invoice_count": 0,
	"updated_at": "2023-12-01T05:00:00.401Z",
	"visibility": "visible"
}
```


## Related topics

- [Varianter](https://docs.whop.com/da/api-reference/legacy/variants/variant.md)
- [API-versioner](https://docs.whop.com/da/developer/api/versioning.md)
- [Delete Variant](https://docs.whop.com/da/api-reference/variants/delete-variant.md)
