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

# API de Checkout Configurations

> Una Checkout Configuration es un enlace de pago reutilizable propiedad de una cuenta.

En el modo `payment` vende una variante específica; en el modo `setup` recopila y guarda los datos de pago sin cobrar. Cada configuración también puede sobrescribir qué métodos de pago se aceptan y cómo se aplica 3D Secure para ese checkout.

Usa la API de Checkout Configurations para crear enlaces de pago para una variante existente o definida en línea, listar las configuraciones de una cuenta, recuperar la configuración detrás de una URL de checkout y eliminar los enlaces que ya no deban usarse.

> [!NOTE]
>
> Reemplaza el recurso Legacy [Checkout configurations](https://docs.whop.com/es/api-reference/checkout-configurations/checkout-configuration). Las integraciones Legacy existentes siguen funcionando; consulta [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md) para conocer el contrato de estabilidad.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar checkout configurations](https://docs.whop.com/es/api-reference/checkout-configurations/list-checkout-configurations.md) | GET `/checkout_configurations` |
| [Recuperar una checkout configuration](https://docs.whop.com/es/api-reference/checkout-configurations/retrieve-a-checkout-configuration.md) | GET `/checkout_configurations/{id}` |
| [Crear una checkout configuration](https://docs.whop.com/es/api-reference/checkout-configurations/create-a-checkout-configuration.md) | POST `/checkout_configurations` |
| [Eliminar una checkout configuration](https://docs.whop.com/es/api-reference/checkout-configurations/delete-a-checkout-configuration.md) | DELETE `/checkout_configurations/{id}` |

## Atributos

**id** `string` *required*

ID de la checkout configuration, con el prefijo `ch_`.

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

ID de la cuenta, con el prefijo `biz_`.

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

Código de afiliado aplicado en el checkout, o `null` cuando no hay ninguno.

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

Cuándo se creó la checkout configuration, como marca de tiempo ISO 8601.

**currency** `string | null`

Moneda usada para la disponibilidad de métodos de pago en modo setup; el valor predeterminado es `usd` si se omite.

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

La configuración que rige un checkout montado a partir de esta configuración, resuelta a través de todas las capas (sus propias sobrescrituras, las de la variante y las de la cuenta): la forma que lleva el `payment_method_configuration` de una sesión. Aplícala sobre el catálogo de tipos de métodos de pago para obtener el conjunto ofrecible. `null` significa los valores predeterminados de la plataforma; `payment_method_configuration` sigue siendo la sobrescritura editable propia de esta configuración.

> [accordion] Propiedades
>
> **disabled** `string[]`
>
> Métodos de pago deshabilitados explícitamente.
>
> **enabled** `string[]`
>
> Métodos de pago habilitados explícitamente.
>
> **include\_platform\_defaults** `boolean`
>
> Si se incluyen los métodos de pago predeterminados de la plataforma.

**metadata** `object | null`

Metadatos personalizados de clave-valor copiados a pagos y membresías. `null` sin el scope `checkout_configuration:basic:read`.

**mode** `string` *required*

Controla si el checkout cobra al comprador de inmediato o guarda los datos de pago para más adelante.

Opciones disponibles: `payment`, `setup`

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

Sobrescrituras de métodos de pago para este checkout. `null` cuando usa los valores predeterminados de la variante o de la plataforma.

> [accordion] Propiedades
>
> **disabled** `string[]`
>
> Métodos de pago deshabilitados explícitamente para el checkout.
>
> **enabled** `string[]`
>
> Métodos de pago habilitados explícitamente para el checkout.
>
> **include\_platform\_defaults** `boolean`
>
> Si se incluyen los métodos de pago predeterminados de la plataforma.

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

URL de checkout que puedes enviar a los clientes.

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

URL a la que se envía a los clientes después del checkout, o `null` cuando no hay redirección configurada.

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

Comportamiento de 3D Secure para pagos con tarjeta compatibles en sesión. `mandate_challenge` exige un desafío 3DS antes de procesar el pago; `mandate_if_required` exige un desafío solo cuando el procesador de pagos lo requiere; `frictionless_if_required` usa el flujo 3DS sin fricción habitual. Los pagos de \$1,000 o más usan `mandate_if_required` a menos que se seleccione `mandate_challenge`. Los requisitos de riesgo y de recuperación de autenticación pueden anular la preferencia. Se aplica en modo setup; `null` usa 3DS sin fricción. El modo payment usa la política de la variante.

Opciones disponibles: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`

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

Cuándo se actualizó la checkout configuration por última vez, como marca de tiempo ISO 8601.

**variant** `object | null`

Variante usada para el checkout de pago. `null` en modo setup.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la variante, con el prefijo `plan_`.
>
> **adaptive\_pricing\_enabled** `boolean` *required*
>
> Si esta variante acepta pagos en moneda local mediante precios adaptativos.
>
> **billing\_period** `integer | null` *required*
>
> Intervalo de facturación recurrente en días, como 30 para mensual o 365 para anual. `null` para variantes de pago único.
>
> **billing\_type** `string` *required*
>
> Modelo de facturación de la variante.
>
> Opciones disponibles: `renewal`, `one_time`
>
> **currency** `string` *required*
>
> Código de moneda ISO de tres letras para los precios de la variante.
>
> **expiration\_days** `integer | null` *required*
>
> Duración del acceso en días para variantes basadas en vencimiento.
>
> **initial\_price** `number` *required*
>
> Precio de compra inicial en la moneda de la variante.
>
> **release\_method** `string` *required*
>
> Método de venta de la variante.
>
> Opciones disponibles: `buy_now`, `waitlist`
>
> **renewal\_price** `number` *required*
>
> Precio recurrente cobrado en cada periodo de facturación.
>
> **three\_ds\_level** `string | null` *required*
>
> Comportamiento de 3D Secure para pagos con tarjeta compatibles en sesión. `mandate_challenge` exige un desafío 3DS antes de procesar el pago; `mandate_if_required` exige un desafío solo cuando el procesador de pagos lo requiere; `frictionless_if_required` usa el flujo 3DS sin fricción habitual. Los pagos de \$1,000 o más usan `mandate_if_required` a menos que se seleccione `mandate_challenge`. Los requisitos de riesgo y de recuperación de autenticación pueden anular la preferencia. `null` hereda el valor predeterminado de la cuenta.
>
> Opciones disponibles: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`
>
> **trial\_period\_days** `integer | null` *required*
>
> Días de prueba gratuita antes del primer cobro de renovación.
>
> **visibility** `string` *required*
>
> Si la variante es visible para los clientes u oculta a la vista pública.
>
> Opciones disponibles: `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"
}
```
