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

# Setup Intents API

> En Setup Intent gemmer en købers betalingsmetode til senere uden at opkræve penge nu.

Opret en ud fra et bekræftelsestoken, som betalingselementerne indsamlede i setup-tilstand, eller ud fra en allerede gemt betalingsmetode for at genverificere den. Den kører det samme indsamlingsflow som en betaling, så køberen kan stadig mangle et trin: 3D Secure på et kort, en hostet tilmelding eller tilknytning af en bankkonto.

Oprettelsessvaret er setup intent'en, som den blev oprettet, ikke dens resultat. Giv dens `client_secret` til elementernes `handleNextAction`, eller poll [Hent status](https://docs.whop.com/da/api-reference/setup-intents/retrieve-setup-status.md) for at se, hvor langt opsætningen er nået, og hvad der mangler. Når den når `succeeded`, angiver `payment_method_id` den gemte metode, og Create Payment opkræver den.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [Vis Setup Intents](https://docs.whop.com/da/api-reference/setup-intents/list-setup-intents.md) | GET `/setup_intents` |
| [Hent Setup Intent](https://docs.whop.com/da/api-reference/setup-intents/retrieve-setup-intent.md) | GET `/setup_intents/{id}` |
| [Hent setup-status](https://docs.whop.com/da/api-reference/setup-intents/retrieve-setup-status.md) | GET `/setup_intents/{setup_intent_id}/status` |
| [Opret Setup Intent](https://docs.whop.com/da/api-reference/setup-intents/create-setup-intent.md) | POST `/setup_intents` |
| [Opdater setup-retur-URL](https://docs.whop.com/da/api-reference/setup-intents/update-setup-return-url.md) | PATCH `/setup_intents/{setup_intent_id}/return_url` |

## Attributter

**id** `string` *required*

Setup intent-id med præfikset `sint_`.

**account\_id** `string | null` *required*

Den konto, betalingsmetoden gemmes for, med præfikset `biz_`.

**checkout\_configuration\_id** `string | null` *required*

Den checkout-konfiguration, denne opsætning blev oprettet via, med præfikset `ch_`.
Null for en opsætning oprettet via dette API i stedet for en hostet checkout.

**client\_secret** `string | null` *required*

Den legitimation, som en købers overflade præsenterer for at polle denne opsætning og angive dens
retur-URL — giv den til elementernes `handleNextAction`. Kun på opsætninger
oprettet via dette API, og altid null i listesvar — hent
setup intent'en for at få den.

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

Hvornår setup intent'en blev oprettet, som et ISO 8601-tidsstempel.

**last\_setup\_error** `object | null` *required*

Hvorfor opsætningen endte, hvor den gjorde, eller `null`, når intet er mislykkedes. Til stede ved `canceled` — en køber, der opgav, har ingen kode, en afvist af udbyderen har. Fjernes, når opsætningen lykkes.

> [accordion] Egenskaber
>
> **code** `string | null` *required*
>
> En maskinlæsbar klassificering af fejlen, f.eks. `enrollment_declined`.
> Fraværende, når køberen blot opgav opsætningen.
>
> **message** `string | null` *required*
>
> En menneskelæsbar forklaring på fejlen.

**member\_id** `string | null` *required*

Køberens medlemspost på kontoen med præfikset `mber_`. Null uden
tilladelsen member:basic:read, medmindre kalderen er køberen.

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

Dine egne nøgle-værdi-data, vedhæftet da setup intent'en blev oprettet.

**payment\_instrument** `object | null` *required*

Metoden bag denne opsætning, formet til visning: et navn til køberen, standardikonsættet samt kortets mærke, sidste fire cifre, udstederidentifikationsnummer, udløb og netværkstransaktions-id, når det var et kort. Null, indtil en metode er indsamlet.

> [accordion] Egenskaber
>
> **card** `object | null` *required*
>
> Kun kort-, Apple Pay- og Google Pay-betalinger: kortets netværk, sidste fire cifre, udstederidentifikationsnummer, udløb og netværkstransaktions-id.
>
> > [accordion] Egenskaber
> >
> > **brand** `string | null` *required*
> >
> > Netværksidentifikatoren (`visa`, `amex`, …), der svarer til `card.networks`-poster
> > og gemte kortbetalingsmetoder. Null, når vaulten ikke registrerede
> > netværket.
> >
> > **exp\_month** `number | null` *required*
> >
> > Kortets udløbsmåned, 1 til 12. Null, når vaulten ikke registrerede den.
> >
> > **exp\_year** `number | null` *required*
> >
> > Kortets firecifrede udløbsår. Null, når vaulten ikke registrerede det.
> >
> > **issuer\_identification\_number** `string | null` *required*
> >
> > Udstederidentifikationsnummeret, også kaldet BIN: kortets første seks
> > eller otte cifre, som identificerer den udstedende bank. Null, når processoren ikke
> > rapporterede det.
> >
> > **last4** `string | null` *required*
> >
> > Kortets sidste fire cifre, når de er registreret.
> >
> > **network\_transaction\_id** `string | null` *required*
> >
> > Det netværkstransaktions-id, denne konto bruger for kortet. Det er kontoens eget id fra dens første opkrævning eller verifikation med kunden til stede på kortet, når Whop har et. Ellers er det et tidligere netværkstransaktions-id for dette kort, som kan stamme fra en anden kontos transaktion eller være medbragt med kortet. Angiv det som den forudgående transaktion ved en senere forhandlerinitieret opkrævning af dette kort hos denne konto. Null, indtil der findes et. En webhook sendt, når en betaling første gang registreres, kan indeholde `null`, så hent betalingen for at læse det.
>
> **display\_name** `string` *required*
>
> Instrumentnavn til køberen — "Visa •••• 4242", når kortet blev vist, ellers
> metodens eget navn ("Klarna").
>
> **icons** `object` *required*
>
> Standardikonsættet: kvadratiske og kortformede ikoner, hver i lyse og mørke farvevarianter.
>
> > [accordion] Egenskaber
> >
> > **card** `object` *required*
> >
> > Flisen med kreditkortproportioner (48x30).
> >
> > > [accordion] Egenskaber
> > >
> > > **dark** `object` *required*
> > >
> > > Farvevarianten til mørke flader.
> > >
> > > > [accordion] Egenskaber
> > > >
> > > > **png\_1x** `string` *required*
> > > >
> > > > Rasterfallback i formens oprindelige størrelse.
> > > >
> > > > **png\_2x** `string` *required*
> > > >
> > > > Rasterfallback ved dobbelt tæthed.
> > > >
> > > > **png\_4x** `string` *required*
> > > >
> > > > Rasterfallback ved firedobbelt tæthed.
> > > >
> > > > **svg** `string` *required*
> > > >
> > > > Vektorfilen. Foretræk denne overalt, hvor SVG kan gengives.
> > >
> > > **light** `object` *required*
> > >
> > > Farvevarianten til lyse flader.
> > >
> > > > [accordion] Egenskaber
> > > >
> > > > **png\_1x** `string` *required*
> > > >
> > > > Rasterfallback i formens oprindelige størrelse.
> > > >
> > > > **png\_2x** `string` *required*
> > > >
> > > > Rasterfallback ved dobbelt tæthed.
> > > >
> > > > **png\_4x** `string` *required*
> > > >
> > > > Rasterfallback ved firedobbelt tæthed.
> > > >
> > > > **svg** `string` *required*
> > > >
> > > > Vektorfilen. Foretræk denne overalt, hvor SVG kan gengives.
> >
> > **square** `object` *required*
> >
> > Den kvadratiske flise (32x32).
> >
> > > [accordion] Egenskaber
> > >
> > > **dark** `object` *required*
> > >
> > > Farvevarianten til mørke flader.
> > >
> > > > [accordion] Egenskaber
> > > >
> > > > **png\_1x** `string` *required*
> > > >
> > > > Rasterfallback i formens oprindelige størrelse.
> > > >
> > > > **png\_2x** `string` *required*
> > > >
> > > > Rasterfallback ved dobbelt tæthed.
> > > >
> > > > **png\_4x** `string` *required*
> > > >
> > > > Rasterfallback ved firedobbelt tæthed.
> > > >
> > > > **svg** `string` *required*
> > > >
> > > > Vektorfilen. Foretræk denne overalt, hvor SVG kan gengives.
> > >
> > > **light** `object` *required*
> > >
> > > Farvevarianten til lyse flader.
> > >
> > > > [accordion] Egenskaber
> > > >
> > > > **png\_1x** `string` *required*
> > > >
> > > > Rasterfallback i formens oprindelige størrelse.
> > > >
> > > > **png\_2x** `string` *required*
> > > >
> > > > Rasterfallback ved dobbelt tæthed.
> > > >
> > > > **png\_4x** `string` *required*
> > > >
> > > > Rasterfallback ved firedobbelt tæthed.
> > > >
> > > > **svg** `string` *required*
> > > >
> > > > Vektorfilen. Foretræk denne overalt, hvor SVG kan gengives.
>
> **installment\_count** `number | null` *required*
>
> Kun afdragsmetoder: hvor mange betalinger opkrævningen deles op i. Data, ikke
> tekst — sammensæt og oversæt etiketten på klientsiden.
>
> **payment\_method\_type** `string` *required*
>
> Identifikatoren for betalingsmetodetypen, f.eks. `card`, `klarna`, `apple_pay`.

**payment\_method\_id** `string | null` *required*

Den gemte betalingsmetode med præfikset `payt_`, klar til at blive opkrævet med Create
Payment. Null, indtil opsætningen har `succeeded`.

**payment\_method\_type** `string | null` *required*

Den type instrument, der gemmes, for eksempel `card` eller `us_bank_account`.

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

Hvor køberen lander efter at have gennemført et eksternt trin, eller `null` for at lade
dem blive, hvor de er.

**status** `string` *required*

Hvor langt opsætningen er nået. **En 201 eller 200 betyder, at vi svarede, ikke at metoden blev gemt — forgren altid på dette.** `requires_action` — køberen har et udestående trin; giv `client_secret` til elementerne, eller poll Retrieve setup status. `processing` — processoren træffer afgørelse. `succeeded` — metoden er gemt, og kun denne betyder gemt. `canceled` — opgivet eller afvist; se `last_setup_error`.

Tilgængelige muligheder: `processing`, `succeeded`, `canceled`, `requires_action`

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

3D Secure-adfærd for understøttede on-session-kortbetalinger. `mandate_challenge` kræver en 3DS-challenge før betalingsbehandling; `mandate_if_required` kræver kun en challenge, 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 godkendelsesgendannelse kan tilsidesætte præferencen. Den indstilling, der er anmodet om for denne opsætning, eller `null`, når den ikke er angivet.

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

**three\_ds\_verified** `boolean` *required*

True, når køberen gennemførte 3D Secure under lagringen af denne betalingsmetode.

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

Hvornår setup intent'en sidst blev opdateret, som et ISO 8601-tidsstempel.

**user** `object | null` *required*

Den bruger, der gemmer betalingsmetoden. Null, når køberen er en konto frem for en bruger.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Bruger-id med præfikset `user_`.
>
> **name** `string | null` *required*
>
> Visningsnavn.
>
> **profile\_picture** `object` *required*
>
> Avatar-wrapper. Dens `url` er altid til stede og er en genereret pladsholder, når brugeren ikke har angivet et billede.
>
> > [accordion] Egenskaber
> >
> > **url** `string` *required*
> >
> > URL til avatarbillede. Altid til stede. Det er en genereret pladsholder, når brugeren ikke har angivet et billede.
>
> **username** `string` *required*
>
> Offentligt brugernavn.

```json SetupIntent theme={null}
{
	"id": "sint_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"checkout_configuration_id": null,
	"client_secret": null,
	"created_at": "2026-09-22T12:00:00.000Z",
	"last_setup_error": null,
	"member_id": "mber_xxxxxxxxxxxxxx",
	"metadata": {
		"customer_id": "cus_4417"
	},
	"payment_method_id": "payt_xxxxxxxxxxxxxx",
	"payment_method_type": "card",
	"return_url": "https://shinetime.example/billing/saved",
	"status": "succeeded",
	"three_ds_verified": false,
	"three_ds_level": "mandate_challenge",
	"updated_at": "2026-09-22T12:00:00.000Z",
	"user": {
		"id": "user_xxxxxxxxxxxxxx",
		"name": "Dana Whitfield",
		"profile_picture": {
			"url": "https://ui-avatars.com/api/"
		},
		"username": "danawhitfield"
	},
	"payment_instrument": {
		"card": {
			"brand": "visa",
			"issuer_identification_number": "41111111",
			"last4": "4242",
			"exp_month": 11,
			"exp_year": 2030,
			"network_transaction_id": "016153570198200"
		},
		"display_name": "Visa •••• 4242",
		"icons": {
			"card": {
				"dark": {
					"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
					"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
					"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
					"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
				},
				"light": {
					"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
					"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
					"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
					"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
				}
			},
			"square": {
				"dark": {
					"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
					"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
					"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
					"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
				},
				"light": {
					"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
					"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
					"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
					"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
				}
			}
		},
		"installment_count": null,
		"payment_method_type": "card"
	}
}
```


## Related topics

- [Byg en checkout med Payment Elements](https://docs.whop.com/da/developer/guides/payment-elements.md)
- [Setup Intent](https://docs.whop.com/da/api-reference/legacy/setup-intents/setup-intent.md)
- [List setup intents](https://docs.whop.com/da/api-reference/legacy/setup-intents/list-setup-intents.md)
