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

# Configuración de checkout

> Una configuración de checkout es una configuración reutilizable para un checkout, que incluye el plan, el afiliado y metadatos personalizados. Los pagos y las membresías creados a partir de una sesión de checkout heredan sus metadatos.

> [!NOTE]
>
> Este recurso tiene un sucesor en la [API de Whop](https://docs.whop.com/es/api-reference/legacy/checkout-configurations/checkout-configuration.md), la API versionada sobre la que deben construirse las nuevas integraciones. Esta página sigue teniendo soporte completo.

```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*

El ID de la cuenta que se usará para la configuración de checkout

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

El código de afiliado que se usará para la configuración de checkout

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

El ID de la cuenta que se usará para la configuración de checkout

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

La moneda que se usará para la configuración en el modo 'setup'. Se usa para determinar qué métodos de pago específicos de cada moneda están disponibles. Si no se proporciona, el valor predeterminado será 'usd' en el modo setup.

Opciones disponibles: `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*

El identificador único de la sesión de checkout.

Ejemplo: `ch_xxxxxxxxxxxxxxx`

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

Los metadatos que se usarán para la configuración de checkout

**mode** `CheckoutModes` *required*

El modo de la sesión de checkout.

Opciones disponibles: `payment`, `setup`

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

La configuración explícita de métodos de pago para la sesión, si la hay. Actualmente solo funciona en el modo 'setup'. Usa la payment\_method\_configuration del plan para el método de pago.

**atributos secundarios**

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

Un array de identificadores de métodos de pago que están deshabilitados explícitamente. Solo se aplica si include\_platform\_defaults es true.

Opciones disponibles: `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*

Un array de identificadores de métodos de pago que están habilitados explícitamente. Esto significa que estos métodos de pago se mostrarán en el checkout. Un caso de uso de ejemplo es habilitar solo un método de pago específico, como cashapp, o ampliar los valores predeterminados de la plataforma con métodos adicionales.

Opciones disponibles: `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*

Si la configuración de habilitación de métodos de pago predeterminada de la plataforma Whop se incluye en esta configuración. La lista completa de métodos de pago predeterminados se encuentra en la documentación en docs.whop.com/payments.

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

El plan que se usará para la configuración de checkout

**atributos secundarios**

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

Si el creador ha activado los precios adaptativos para este plan. Configuración sin procesar: no comprueba la compatibilidad del procesador ni los feature flags.

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

Número de días entre cargos recurrentes, como 30 para mensual o 365 para anual. `null` para planes de pago único.

Ejemplo: `42`

**currency** `Currencies` *required*

La moneda usada para todos los precios de este plan (p. ej., 'usd', 'eur'). Todos los importes monetarios del plan se expresan en esta moneda.

Opciones disponibles: `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*

Duración del acceso en días para planes basados en caducidad, como 365 para un pase de un año.

Ejemplo: `42`

**id** `string` *required*

El identificador único del plan.

Ejemplo: `plan_xxxxxxxxxxxxx`

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

El precio de compra inicial en la base\_currency del plan (p. ej., 49.99 para \$49.99). Para planes de pago único, es el precio completo. Para planes de renovación, se cobra además del primer renewal\_price.

Ejemplo: `6.9`

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

El modelo de facturación de este plan: 'renewal' para suscripciones recurrentes o 'one\_time' para pagos únicos.

Opciones disponibles: `renewal`, `one_time`

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

Método de venta de este plan: `buy_now` para compra inmediata o `waitlist` para acceso basado en lista de espera.

Opciones disponibles: `buy_now`, `waitlist`

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

El precio recurrente que se cobra en cada billing\_period en la base\_currency del plan (p. ej., 9.99 para \$9.99/periodo). Cero para planes de pago único.

Ejemplo: `6.9`

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

El comportamiento de 3D Secure para este plan. Null significa que el plan hereda el valor predeterminado de la cuenta.

Opciones disponibles: `mandate_challenge`, `frictionless`

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

Días de prueba gratuita antes del primer cargo de renovación. `null` si no hay ninguna prueba configurada o si el usuario ya ha usado una prueba para este plan.

Ejemplo: `42`

**visibility** `Visibility` *required*

Controla si el plan es visible para los clientes. Cuando se establece en 'hidden', solo se puede acceder al plan mediante un enlace directo.

Opciones disponibles: `visible`, `hidden`, `archived`, `quick_link`

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

Una URL que puedes enviar a los clientes para completar un checkout. Tiene el aspecto `/checkout/ch_xxxx/`

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

La URL a la que redirigir al usuario después de crear la configuración de checkout
