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

> 체크아웃 구성(Checkout Configuration)은 계정이 소유한 재사용 가능한 체크아웃 링크입니다.

`payment` 모드에서는 특정 변형을 판매하고, `setup` 모드에서는 청구 없이 결제 정보를 수집하여 저장합니다. 각 구성은 해당 체크아웃에서 허용되는 결제 수단과 3D Secure 적용 방식을 재정의할 수도 있습니다.

Checkout Configurations API를 사용하여 기존 또는 인라인 변형에 대한 체크아웃 링크를 생성하고, 계정의 구성을 조회하고, 체크아웃 URL에 연결된 구성을 조회하고, 더 이상 사용하지 않을 링크를 삭제할 수 있습니다.

> [!NOTE]
>
> 레거시 [Checkout configurations](https://docs.whop.com/ko/api-reference/checkout-configurations/checkout-configuration) 리소스를 대체합니다. 기존 레거시 통합은 계속 작동합니다. 안정성 보장에 대해서는 [API 버전](https://docs.whop.com/ko/developer/api/versioning.md)을 참고하세요.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [체크아웃 구성 목록 조회](https://docs.whop.com/ko/api-reference/checkout-configurations/list-checkout-configurations.md) | GET `/checkout_configurations` |
| [체크아웃 구성 조회](https://docs.whop.com/ko/api-reference/checkout-configurations/retrieve-a-checkout-configuration.md) | GET `/checkout_configurations/{id}` |
| [체크아웃 구성 생성](https://docs.whop.com/ko/api-reference/checkout-configurations/create-a-checkout-configuration.md) | POST `/checkout_configurations` |
| [체크아웃 구성 삭제](https://docs.whop.com/ko/api-reference/checkout-configurations/delete-a-checkout-configuration.md) | DELETE `/checkout_configurations/{id}` |

## 속성

**id** `string` *required*

체크아웃 구성 ID이며, 접두사는 `ch_`입니다.

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

계정 ID이며, 접두사는 `biz_`입니다.

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

체크아웃 시 적용되는 제휴 코드이며, 설정되지 않은 경우 `null`입니다.

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

체크아웃 구성이 생성된 시점으로, ISO 8601 타임스탬프입니다.

**currency** `string | null`

setup 모드에서 결제 수단 사용 가능 여부에 사용되는 통화입니다. 생략하면 기본값은 `usd`입니다.

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

이 구성으로 마운트된 체크아웃을 제어하는 구성으로, 모든 계층(자체 재정의, 변형의 재정의, 계정의 재정의)을 거쳐 결정됩니다. 세션의 `payment_method_configuration`과 같은 형태입니다. 결제 수단 유형 카탈로그에 적용하여 제공 가능한 집합을 구하세요. `null`은 플랫폼 기본값을 의미하며, `payment_method_configuration`은 이 구성 자체의 편집 가능한 재정의로 유지됩니다.

> [accordion] 속성
>
> **disabled** `string[]`
>
> 명시적으로 비활성화된 결제 수단입니다.
>
> **enabled** `string[]`
>
> 명시적으로 활성화된 결제 수단입니다.
>
> **include\_platform\_defaults** `boolean`
>
> 플랫폼 기본 결제 수단 포함 여부입니다.

**metadata** `object | null`

결제와 멤버십에 복사되는 사용자 지정 키-값 메타데이터입니다. `checkout_configuration:basic:read` 범위가 없으면 `null`입니다.

**mode** `string` *required*

체크아웃 시 구매자에게 즉시 청구할지, 나중을 위해 결제 정보를 저장할지를 제어합니다.

사용 가능한 옵션: `payment`, `setup`

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

이 체크아웃의 결제 수단 재정의입니다. 변형 또는 플랫폼 기본값을 사용하는 경우 `null`입니다.

> [accordion] 속성
>
> **disabled** `string[]`
>
> 체크아웃에서 명시적으로 비활성화된 결제 수단입니다.
>
> **enabled** `string[]`
>
> 체크아웃에서 명시적으로 활성화된 결제 수단입니다.
>
> **include\_platform\_defaults** `boolean`
>
> 플랫폼 기본 결제 수단 포함 여부입니다.

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

고객에게 보낼 수 있는 체크아웃 URL입니다.

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

체크아웃 후 고객이 이동하는 URL이며, 리디렉션이 구성되지 않은 경우 `null`입니다.

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

지원되는 온세션 카드 결제에 대한 3D Secure 동작입니다. `mandate_challenge`는 결제 처리 전에 3DS 챌린지를 요구하고, `mandate_if_required`는 결제 처리업체가 요구할 때에만 챌린지를 의무화하며, `frictionless_if_required`는 일반적인 프릭션리스 3DS 흐름을 사용합니다. \$1,000 이상의 결제는 `mandate_challenge`를 선택하지 않는 한 `mandate_if_required`를 사용합니다. 위험 및 인증 복구 요구 사항이 이 설정보다 우선할 수 있습니다. setup 모드에 적용되며, `null`이면 프릭션리스 3DS를 사용합니다. payment 모드는 변형의 정책을 사용합니다.

사용 가능한 옵션: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`

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

체크아웃 구성이 마지막으로 업데이트된 시점으로, ISO 8601 타임스탬프입니다.

**variant** `object | null`

결제 체크아웃에 사용되는 변형입니다. setup 모드에서는 `null`입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 변형 ID이며, 접두사는 `plan_`입니다.
>
> **adaptive\_pricing\_enabled** `boolean` *required*
>
> 이 변형이 적응형 가격 책정을 통해 현지 통화 결제를 허용하는지 여부입니다.
>
> **billing\_period** `integer | null` *required*
>
> 반복 청구 간격(일)으로, 월간은 30, 연간은 365 등입니다. 일회성 변형은 `null`입니다.
>
> **billing\_type** `string` *required*
>
> 변형의 청구 모델입니다.
>
> 사용 가능한 옵션: `renewal`, `one_time`
>
> **currency** `string` *required*
>
> 변형 가격의 세 글자 ISO 통화 코드입니다.
>
> **expiration\_days** `integer | null` *required*
>
> 만료 기반 변형의 접근 기간(일)입니다.
>
> **initial\_price** `number` *required*
>
> 변형 통화 기준의 최초 구매 가격입니다.
>
> **release\_method** `string` *required*
>
> 변형의 판매 방식입니다.
>
> 사용 가능한 옵션: `buy_now`, `waitlist`
>
> **renewal\_price** `number` *required*
>
> 각 청구 기간마다 청구되는 반복 가격입니다.
>
> **three\_ds\_level** `string | null` *required*
>
> 지원되는 온세션 카드 결제에 대한 3D Secure 동작입니다. `mandate_challenge`는 결제 처리 전에 3DS 챌린지를 요구하고, `mandate_if_required`는 결제 처리업체가 요구할 때에만 챌린지를 의무화하며, `frictionless_if_required`는 일반적인 프릭션리스 3DS 흐름을 사용합니다. \$1,000 이상의 결제는 `mandate_challenge`를 선택하지 않는 한 `mandate_if_required`를 사용합니다. 위험 및 인증 복구 요구 사항이 이 설정보다 우선할 수 있습니다. `null`이면 계정 기본값을 상속합니다.
>
> 사용 가능한 옵션: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`
>
> **trial\_period\_days** `integer | null` *required*
>
> 첫 갱신 청구 전 무료 체험 일수입니다.
>
> **visibility** `string` *required*
>
> 변형이 고객에게 표시되는지 또는 공개 보기에서 숨겨지는지 여부입니다.
>
> 사용 가능한 옵션: `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

- [Checkout Configuration](https://docs.whop.com/ko/api-reference/legacy/checkout-configurations/checkout-configuration.md)
- [Create checkout configuration](https://docs.whop.com/ko/api-reference/legacy/checkout-configurations/create-checkout-configuration.md)
- [Retrieve checkout configuration](https://docs.whop.com/ko/api-reference/legacy/checkout-configurations/retrieve-checkout-configuration.md)
