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

# Checkoutconfiguratie

> Een checkoutconfiguratie is een herbruikbare configuratie voor een checkout, inclusief het plan, de affiliate en aangepaste metadata. Betalingen en lidmaatschappen die vanuit een checkoutsessie worden aangemaakt, nemen de metadata ervan over.

> [!NOTE]
>
> Deze resource heeft een opvolger in de [Whop API](https://docs.whop.com/nl/api-reference/legacy/checkout-configurations/checkout-configuration.md), de API met versies waarop nieuwe integraties moeten bouwen. Deze pagina blijft volledig ondersteund.

```json Example theme={null}
{
	"account_id": "<string>",
	"affiliate_code": "<string>",
	"company_id": "<string>",
	"currency": "usd",
	"id": "ch_xxxxxxxxxxxxxxx",
	"metadata": {},
	"mode": "payment",
	"payment_method_configuration": {
		"disabled": ["acss_debit"],
		"enabled": ["acss_debit"],
		"include_platform_defaults": true
	},
	"plan": {
		"adaptive_pricing_enabled": true,
		"billing_period": 42,
		"currency": "usd",
		"expiration_days": 42,
		"id": "plan_xxxxxxxxxxxxx",
		"initial_price": 6.9,
		"plan_type": "renewal",
		"release_method": "buy_now",
		"renewal_price": 6.9,
		"three_ds_level": "mandate_challenge",
		"trial_period_days": 42,
		"visibility": "visible"
	},
	"purchase_url": "<string>",
	"redirect_url": "<string>"
}
```

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

De ID van het account dat voor de checkoutconfiguratie moet worden gebruikt

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

De affiliatecode die voor de checkoutconfiguratie moet worden gebruikt

**company\_id** `string` *required*

De ID van het account dat voor de checkoutconfiguratie moet worden gebruikt

**currency** `Currencies | null` *required*

De valuta die voor de configuratie moet worden gebruikt in de modus 'setup'. Hiermee wordt bepaald welke valutaspecifieke betaalmethoden beschikbaar zijn. Indien niet opgegeven, wordt in de setupmodus standaard 'usd' gebruikt.

Beschikbare opties: `usd`, `sgd`, `inr`, `aud`, `brl`, `cad`, `dkk`, `eur`, `nok`, `gbp`, `sek`, `chf`, `hkd`, `huf`, `jpy`, `mxn`, `myr`, `pln`, `czk`, `nzd`, `aed`, `eth`, `ape`, `cop`, `ron`, `thb`, `bgn`, `idr`, `dop`, `php`, `try`, `krw`, `twd`, `vnd`, `pkr`, `clp`, `uyu`, `ars`, `zar`, `dzd`, `tnd`, `mad`, `kes`, `kwd`, `jod`, `all`, `xcd`, `amd`, `bsd`, `bhd`, `bob`, `bam`, `khr`, `crc`, `xof`, `egp`, `etb`, `gmd`, `ghs`, `gtq`, `gyd`, `ils`, `jmd`, `mop`, `mga`, `mur`, `mdl`, `mnt`, `nad`, `ngn`, `mkd`, `omr`, `pyg`, `pen`, `qar`, `rwf`, `sar`, `rsd`, `lkr`, `tzs`, `ttd`, `uzs`, `rub`, `btc`, `cny`, `usdt`, `kzt`, `awg`, `whop_usd`, `xau`, `hnl`

**id** `string` *required*

De unieke identificatie van de checkoutsessie.

Voorbeeld: `ch_xxxxxxxxxxxxxxx`

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

De metadata die voor de checkoutconfiguratie moeten worden gebruikt

**mode** `CheckoutModes` *required*

De modus van de checkoutsessie.

Beschikbare opties: `payment`, `setup`

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

De expliciete configuratie van betaalmethoden voor de sessie, indien aanwezig. Dit werkt momenteel alleen in de modus 'setup'. Gebruik de payment\_method\_configuration van het plan voor de betaalmethode.

**onderliggende attributen**

**disabled** `array\<PaymentMethodTypes\>` *required*

Een array met identificaties van betaalmethoden die expliciet zijn uitgeschakeld. Alleen van toepassing als include\_platform\_defaults true is.

Beschikbare opties: `acss_debit`, `addi`, `affirm`, `afterpay_clearpay`, `alipay`, `alipayhk`, `alma`, `amazon_pay`, `apple`, `apple_pay`, `au_bank_transfer`, `au_becs_debit`, `bacs_debit`, `bancolombia`, `bancontact`, `bank_wire`, `billie`, `blik`, `boleto`, `bre_b`, `ca_bank_transfer`, `capchase_pay`, `card`, `card_present`, `card_installments_three`, `card_installments_six`, `card_installments_twelve`, `cashapp`, `claritypay`, `coinbase`, `crypto`, `crypto_subscription`, `custom`, `customer_balance`, `demo_pay`, `duitnow_qr`, `efecty`, `eps`, `eu_bank_transfer`, `fpx`, `flex_pay`, `gb_bank_transfer`, `gcash`, `giropay`, `google_pay`, `gopay`, `grabpay`, `id_bank_transfer`, `ideal`, `interac`, `international_bank_wire`, `kakao_pay`, `klarna`, `klarna_pay_now`, `konbini`, `kr_card`, `kr_market`, `kriya`, `kueski`, `link`, `mb_way`, `m_pesa`, `mercado_pago`, `mercado_pago_ar`, `mercado_pago_mx`, `mobilepay`, `modo`, `mondu`, `multibanco`, `naver_pay`, `nequi`, `netbanking`, `ng_bank`, `ng_bank_transfer`, `ng_card`, `ng_market`, `ng_ussd`, `ng_wallet`, `nupay`, `nz_bank_account`, `oney`, `oney_3x`, `oney_4x`, `opay`, `oxxo`, `p24`, `pago_efectivo`, `pse`, `pay_by_bank`, `payco`, `paynow`, `paypal`, `paypal_express`, `paypay`, `payto`, `payto_email`, `payto_phone`, `payto_bank_account`, `pix`, `pix_automatico`, `platform_balance`, `promptpay`, `qris`, `rapipago`, `rechnung`, `revolut_pay`, `samsung_pay`, `satispay`, `scalapay`, `sencillito`, `sepa_debit`, `sequra`, `servipag`, `sezzle`, `shop_pay`, `shopeepay`, `sofort`, `south_korea_market`, `spei`, `splitit`, `sunbit`, `swish`, `tabby`, `tamara`, `touch_n_go`, `twint`, `upi`, `us_bank_account`, `us_bank_transfer`, `venmo`, `verve`, `vipps`, `webpay`, `wechat_pay`, `whop_pay`, `yape`, `zip`, `coinflow`, `unknown`

**enabled** `array\<PaymentMethodTypes\>` *required*

Een array met identificaties van betaalmethoden die expliciet zijn ingeschakeld. Dit betekent dat deze betaalmethoden bij de checkout worden getoond. Een voorbeeld is het inschakelen van slechts één specifieke betaalmethode zoals cashapp, of het uitbreiden van de platformstandaarden met extra methoden.

Beschikbare opties: `acss_debit`, `addi`, `affirm`, `afterpay_clearpay`, `alipay`, `alipayhk`, `alma`, `amazon_pay`, `apple`, `apple_pay`, `au_bank_transfer`, `au_becs_debit`, `bacs_debit`, `bancolombia`, `bancontact`, `bank_wire`, `billie`, `blik`, `boleto`, `bre_b`, `ca_bank_transfer`, `capchase_pay`, `card`, `card_present`, `card_installments_three`, `card_installments_six`, `card_installments_twelve`, `cashapp`, `claritypay`, `coinbase`, `crypto`, `crypto_subscription`, `custom`, `customer_balance`, `demo_pay`, `duitnow_qr`, `efecty`, `eps`, `eu_bank_transfer`, `fpx`, `flex_pay`, `gb_bank_transfer`, `gcash`, `giropay`, `google_pay`, `gopay`, `grabpay`, `id_bank_transfer`, `ideal`, `interac`, `international_bank_wire`, `kakao_pay`, `klarna`, `klarna_pay_now`, `konbini`, `kr_card`, `kr_market`, `kriya`, `kueski`, `link`, `mb_way`, `m_pesa`, `mercado_pago`, `mercado_pago_ar`, `mercado_pago_mx`, `mobilepay`, `modo`, `mondu`, `multibanco`, `naver_pay`, `nequi`, `netbanking`, `ng_bank`, `ng_bank_transfer`, `ng_card`, `ng_market`, `ng_ussd`, `ng_wallet`, `nupay`, `nz_bank_account`, `oney`, `oney_3x`, `oney_4x`, `opay`, `oxxo`, `p24`, `pago_efectivo`, `pse`, `pay_by_bank`, `payco`, `paynow`, `paypal`, `paypal_express`, `paypay`, `payto`, `payto_email`, `payto_phone`, `payto_bank_account`, `pix`, `pix_automatico`, `platform_balance`, `promptpay`, `qris`, `rapipago`, `rechnung`, `revolut_pay`, `samsung_pay`, `satispay`, `scalapay`, `sencillito`, `sepa_debit`, `sequra`, `servipag`, `sezzle`, `shop_pay`, `shopeepay`, `sofort`, `south_korea_market`, `spei`, `splitit`, `sunbit`, `swish`, `tabby`, `tamara`, `touch_n_go`, `twint`, `upi`, `us_bank_account`, `us_bank_transfer`, `venmo`, `verve`, `vipps`, `webpay`, `wechat_pay`, `whop_pay`, `yape`, `zip`, `coinflow`, `unknown`

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

Of de standaardinstellingen van het Whop-platform voor het inschakelen van betaalmethoden in deze configuratie zijn opgenomen. De volledige lijst met standaardbetaalmethoden staat in de documentatie op docs.whop.com/payments.

**plan** `object | null` *required*

Het plan dat voor de checkoutconfiguratie moet worden gebruikt

**onderliggende attributen**

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

Of de creator adaptieve prijzen voor dit plan heeft ingeschakeld. Onbewerkte instelling — controleert geen compatibiliteit met processors of feature flags.

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

Aantal dagen tussen terugkerende afschrijvingen, zoals 30 voor maandelijks of 365 voor jaarlijks. `null` voor eenmalige plannen.

Voorbeeld: `42`

**currency** `Currencies` *required*

De valuta die voor alle prijzen in dit plan wordt gebruikt (bijv. 'usd', 'eur'). Alle geldbedragen in het plan zijn in deze valuta uitgedrukt.

Beschikbare opties: `usd`, `sgd`, `inr`, `aud`, `brl`, `cad`, `dkk`, `eur`, `nok`, `gbp`, `sek`, `chf`, `hkd`, `huf`, `jpy`, `mxn`, `myr`, `pln`, `czk`, `nzd`, `aed`, `eth`, `ape`, `cop`, `ron`, `thb`, `bgn`, `idr`, `dop`, `php`, `try`, `krw`, `twd`, `vnd`, `pkr`, `clp`, `uyu`, `ars`, `zar`, `dzd`, `tnd`, `mad`, `kes`, `kwd`, `jod`, `all`, `xcd`, `amd`, `bsd`, `bhd`, `bob`, `bam`, `khr`, `crc`, `xof`, `egp`, `etb`, `gmd`, `ghs`, `gtq`, `gyd`, `ils`, `jmd`, `mop`, `mga`, `mur`, `mdl`, `mnt`, `nad`, `ngn`, `mkd`, `omr`, `pyg`, `pen`, `qar`, `rwf`, `sar`, `rsd`, `lkr`, `tzs`, `ttd`, `uzs`, `rub`, `btc`, `cny`, `usdt`, `kzt`, `awg`, `whop_usd`, `xau`, `hnl`

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

Toegangsduur in dagen voor plannen op basis van een vervaldatum, zoals 365 voor een pas van één jaar.

Voorbeeld: `42`

**id** `string` *required*

De unieke identificatie van het plan.

Voorbeeld: `plan_xxxxxxxxxxxxx`

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

De initiële aankoopprijs in de base\_currency van het plan (bijv. 49.99 voor \$49.99). Voor eenmalige plannen is dit de volledige prijs. Voor verlengingsplannen wordt dit bovenop de eerste renewal\_price in rekening gebracht.

Voorbeeld: `6.9`

**plan\_type** `PlanTypes` *required*

Het factureringsmodel voor dit plan: 'renewal' voor terugkerende abonnementen of 'one\_time' voor eenmalige betalingen.

Beschikbare opties: `renewal`, `one_time`

**release\_method** `ReleaseMethod` *required*

Verkoopmethode voor dit plan: `buy_now` voor directe aankoop of `waitlist` voor toegang via een wachtlijst.

Beschikbare opties: `buy_now`, `waitlist`

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

De terugkerende prijs die elke billing\_period in rekening wordt gebracht in de base\_currency van het plan (bijv. 9.99 voor \$9.99/periode). Nul voor eenmalige plannen.

Voorbeeld: `6.9`

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

Het 3D Secure-gedrag voor dit plan. Null betekent dat het plan de standaardinstelling van het account overneemt.

Beschikbare opties: `mandate_challenge`, `frictionless`

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

Gratis proefdagen vóór de eerste verlengingsafschrijving. `null` als er geen proefperiode is geconfigureerd of de gebruiker al een proefperiode voor dit plan heeft gebruikt.

Voorbeeld: `42`

**visibility** `Visibility` *required*

Bepaalt of het plan zichtbaar is voor klanten. Bij 'hidden' is het plan alleen toegankelijk via een directe link.

Beschikbare opties: `visible`, `hidden`, `archived`, `quick_link`

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

Een URL die je naar klanten kunt sturen om een checkout te voltooien. Deze ziet eruit als `/checkout/ch_xxxx/`

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

De URL waarnaar de gebruiker wordt doorgestuurd nadat de checkoutconfiguratie is aangemaakt


## Related topics

- [Checkout Configurations API](https://docs.whop.com/nl/api-reference/checkout-configurations/checkout-configuration.md)
- [Overzicht van betalingen](https://docs.whop.com/nl/developer/payments/overview.md)
- [Betalingen innen voor subaccounts](https://docs.whop.com/nl/developer/platforms/collect-payments-for-subaccounts.md)
