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

# Checkout Configurations API

> Een Checkout Configuration is een herbruikbare checkoutlink die eigendom is van een account.

In de modus `payment` verkoopt ze een specifieke variant; in de modus `setup` verzamelt en bewaart ze betaalgegevens zonder kosten in rekening te brengen. Elke configuratie kan ook overschrijven welke betaalmethoden worden geaccepteerd en hoe 3D Secure voor die checkout wordt afgedwongen.

Gebruik de Checkout Configurations API om checkoutlinks aan te maken voor een bestaande of inline variant, configuraties voor een account weer te geven, de configuratie achter een checkout-URL op te halen, en links te verwijderen die niet meer gebruikt mogen worden.

> [!NOTE]
>
> Vervangt de Legacy-resource [Checkout
> configurations](https://docs.whop.com/nl/api-reference/checkout-configurations/checkout-configuration).
> Bestaande Legacy-integraties blijven werken; zie [API-versies](https://docs.whop.com/nl/developer/api/versioning.md)
> voor het stabiliteitscontract.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Checkoutconfiguraties weergeven](https://docs.whop.com/nl/api-reference/checkout-configurations/list-checkout-configurations.md) | GET `/checkout_configurations` |
| [Een checkoutconfiguratie ophalen](https://docs.whop.com/nl/api-reference/checkout-configurations/retrieve-a-checkout-configuration.md) | GET `/checkout_configurations/{id}` |
| [Een checkoutconfiguratie aanmaken](https://docs.whop.com/nl/api-reference/checkout-configurations/create-a-checkout-configuration.md) | POST `/checkout_configurations` |
| [Een checkoutconfiguratie verwijderen](https://docs.whop.com/nl/api-reference/checkout-configurations/delete-a-checkout-configuration.md) | DELETE `/checkout_configurations/{id}` |

## Attributen

**id** `string` *required*

Checkoutconfiguratie-ID, met prefix `ch_`.

**account\_id** `string` *required*

Account-ID, met prefix `biz_`.

**affiliate\_code** `string | null`

Affiliatecode die bij de checkout wordt toegepast, of `null` wanneer er geen
is ingesteld.

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

Wanneer de checkoutconfiguratie is aangemaakt, als ISO 8601-tijdstempel.

**currency** `string | null`

Valuta die wordt gebruikt voor de beschikbaarheid van betaalmethoden in de
setup-modus; standaard `usd` wanneer weggelaten.

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

De configuratie die geldt voor een checkout die vanuit deze configuratie wordt geladen, bepaald via elke laag (de eigen overschrijvingen, die van de variant en die van het account) — de vorm die de `payment_method_configuration` van een sessie heeft. Pas deze toe op de catalogus van betaalmethodetypen om de aan te bieden set te krijgen. `null` betekent platformstandaarden; `payment_method_configuration` blijft de eigen bewerkbare overschrijving van deze configuratie.

> [accordion] Eigenschappen
>
> **disabled** `string[]`
>
> Expliciet uitgeschakelde betaalmethoden.
>
> **enabled** `string[]`
>
> Expliciet ingeschakelde betaalmethoden.
>
> **include\_platform\_defaults** `boolean`
>
> Of standaardbetaalmethoden van het platform worden meegenomen.

**metadata** `object | null`

Aangepaste key-value-metadata die naar betalingen en lidmaatschappen wordt
gekopieerd. `null` zonder de scope `checkout_configuration:basic:read`.

**mode** `string` *required*

Bepaalt of de checkout de koper direct belast of betaalgegevens bewaart voor later.

Beschikbare opties: `payment`, `setup`

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

Overschrijvingen van betaalmethoden voor deze checkout. `null` wanneer de standaarden van de variant of het platform worden gebruikt.

> [accordion] Eigenschappen
>
> **disabled** `string[]`
>
> Betaalmethoden die expliciet zijn uitgeschakeld voor de checkout.
>
> **enabled** `string[]`
>
> Betaalmethoden die expliciet zijn ingeschakeld voor de checkout.
>
> **include\_platform\_defaults** `boolean`
>
> Of standaardbetaalmethoden van het platform worden meegenomen.

**purchase\_url** `string | null`

Checkout-URL die je naar klanten kunt sturen.

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

URL waarnaar klanten na de checkout worden gestuurd, of `null` wanneer er geen
doorverwijzing is ingesteld.

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

3D Secure-gedrag voor ondersteunde on-session kaartbetalingen. `mandate_challenge` vereist een 3DS-challenge vóór de verwerking van de betaling; `mandate_if_required` verplicht een challenge alleen wanneer de betalingsverwerker dat vereist; `frictionless_if_required` gebruikt de gewone frictionless 3DS-flow. Betalingen van \$1,000 of meer gebruiken `mandate_if_required`, tenzij `mandate_challenge` is geselecteerd. Vereisten voor risico en herstel van authenticatie kunnen de voorkeur overschrijven. Geldt in de setup-modus; `null` gebruikt frictionless 3DS. De payment-modus gebruikt het beleid van de variant.

Beschikbare opties: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`

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

Wanneer de checkoutconfiguratie voor het laatst is bijgewerkt, als ISO
8601-tijdstempel.

**variant** `object | null`

Variant die wordt gebruikt voor de betaalcheckout. `null` in de setup-modus.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Variant-ID, met prefix `plan_`.
>
> **adaptive\_pricing\_enabled** `boolean` *required*
>
> Of deze variant betalingen in lokale valuta accepteert via adaptive pricing.
>
> **billing\_period** `integer | null` *required*
>
> Terugkerend factureringsinterval in dagen, zoals 30 voor maandelijks of 365
> voor jaarlijks. `null` voor eenmalige varianten.
>
> **billing\_type** `string` *required*
>
> Factureringsmodel voor de variant.
>
> Beschikbare opties: `renewal`, `one_time`
>
> **currency** `string` *required*
>
> ISO-valutacode van drie letters voor de prijzen van de variant.
>
> **expiration\_days** `integer | null` *required*
>
> Toegangsduur in dagen voor varianten op basis van een vervaldatum.
>
> **initial\_price** `number` *required*
>
> Initiële aankoopprijs in de valuta van de variant.
>
> **release\_method** `string` *required*
>
> Verkoopmethode voor de variant.
>
> Beschikbare opties: `buy_now`, `waitlist`
>
> **renewal\_price** `number` *required*
>
> Terugkerende prijs die elke factureringsperiode in rekening wordt gebracht.
>
> **three\_ds\_level** `string | null` *required*
>
> 3D Secure-gedrag voor ondersteunde on-session kaartbetalingen. `mandate_challenge` vereist een 3DS-challenge vóór de verwerking van de betaling; `mandate_if_required` verplicht een challenge alleen wanneer de betalingsverwerker dat vereist; `frictionless_if_required` gebruikt de gewone frictionless 3DS-flow. Betalingen van \$1,000 of meer gebruiken `mandate_if_required`, tenzij `mandate_challenge` is geselecteerd. Vereisten voor risico en herstel van authenticatie kunnen de voorkeur overschrijven. `null` neemt de standaardinstelling van het account over.
>
> Beschikbare opties: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`
>
> **trial\_period\_days** `integer | null` *required*
>
> Aantal gratis proefdagen vóór de eerste verlengingsbetaling.
>
> **visibility** `string` *required*
>
> Of de variant zichtbaar is voor klanten of verborgen is voor het publiek.
>
> Beschikbare opties: `visible`, `hidden`, `archived`, `quick_link`

```json CheckoutConfiguration theme={null}
{
	"id": "ch_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"affiliate_code": "pickaxe-partner",
	"created_at": "2026-07-01T12:00:00Z",
	"currency": "usd",
	"metadata": {
		"campaign": "summer-launch"
	},
	"mode": "payment",
	"payment_method_configuration": {
		"enabled": ["card", "apple_pay"],
		"disabled": ["crypto"],
		"include_platform_defaults": true
	},
	"effective_payment_method_configuration": {
		"enabled": ["card", "apple_pay"],
		"disabled": ["crypto"],
		"include_platform_defaults": true
	},
	"variant": {
		"id": "plan_xxxxxxxxxxxxx",
		"visibility": "visible",
		"billing_type": "renewal",
		"release_method": "buy_now",
		"currency": "usd",
		"billing_period": 30,
		"expiration_days": null,
		"initial_price": 29,
		"renewal_price": 29,
		"trial_period_days": 7,
		"three_ds_level": "frictionless_if_required",
		"adaptive_pricing_enabled": true
	},
	"purchase_url": "https://whop.com/checkout/plan_xxxxxxxxxxxxx/?session=ch_xxxxxxxxxxxxxx",
	"redirect_url": "https://pickaxe.example/welcome",
	"three_ds_level": "frictionless_if_required",
	"updated_at": "2026-07-02T12:00:00Z"
}
```


## Related topics

- [Create checkout configuration](https://docs.whop.com/nl/api-reference/legacy/checkout-configurations/create-checkout-configuration.md)
- [Retrieve checkout configuration](https://docs.whop.com/nl/api-reference/legacy/checkout-configurations/retrieve-checkout-configuration.md)
- [List checkout configurations](https://docs.whop.com/nl/api-reference/legacy/checkout-configurations/list-checkout-configurations.md)
