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

# Ödeme Yapılandırmaları API'si

> Ödeme Yapılandırması, bir hesaba ait yeniden kullanılabilir bir ödeme bağlantısıdır.

`payment` modunda belirli bir varyantı satar; `setup` modunda ücret almadan ödeme bilgilerini toplar ve kaydeder. Her yapılandırma ayrıca o ödeme işlemi için hangi ödeme yöntemlerinin kabul edileceğini ve 3D Secure'un nasıl uygulanacağını geçersiz kılabilir.

Ödeme Yapılandırmaları API'sini mevcut veya satır içi bir varyant için ödeme bağlantıları oluşturmak, bir hesabın yapılandırmalarını listelemek, bir ödeme URL'sinin arkasındaki yapılandırmayı almak ve artık kullanılmaması gereken bağlantıları silmek için kullanın.

> [!NOTE]
>
> Eski (Legacy) [Ödeme yapılandırmaları](https://docs.whop.com/tr/api-reference/checkout-configurations/checkout-configuration) kaynağının yerini alır. Mevcut Legacy entegrasyonları çalışmaya devam eder; kararlılık sözleşmesi için [API sürümleri](https://docs.whop.com/tr/developer/api/versioning.md) sayfasına bakın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Ödeme yapılandırmalarını listele](https://docs.whop.com/tr/api-reference/checkout-configurations/list-checkout-configurations.md) | GET `/checkout_configurations` |
| [Bir ödeme yapılandırmasını al](https://docs.whop.com/tr/api-reference/checkout-configurations/retrieve-a-checkout-configuration.md) | GET `/checkout_configurations/{id}` |
| [Bir ödeme yapılandırması oluştur](https://docs.whop.com/tr/api-reference/checkout-configurations/create-a-checkout-configuration.md) | POST `/checkout_configurations` |
| [Bir ödeme yapılandırmasını sil](https://docs.whop.com/tr/api-reference/checkout-configurations/delete-a-checkout-configuration.md) | DELETE `/checkout_configurations/{id}` |

## Öznitelikler

**id** `string` *required*

`ch_` önekli ödeme yapılandırması kimliği.

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

`biz_` önekli hesap kimliği.

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

Ödeme sırasında uygulanan satış ortaklığı kodu veya ayarlanmamışsa `null`.

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

Ödeme yapılandırmasının oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

**currency** `string | null`

Kurulum modunda ödeme yöntemi kullanılabilirliği için kullanılan para birimi; belirtilmezse varsayılan `usd` olur.

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

Bu yapılandırmadan oluşturulan bir ödeme işlemini yöneten, tüm katmanlar (kendi geçersiz kılmaları, varyantınki ve hesabınki) üzerinden çözümlenmiş yapılandırma — bir oturumun `payment_method_configuration` alanının taşıdığı biçim. Sunulabilir kümeyi elde etmek için bunu ödeme yöntemi türleri kataloğuna uygulayın. `null` platform varsayılanları anlamına gelir; `payment_method_configuration` bu yapılandırmanın kendi düzenlenebilir geçersiz kılması olarak kalır.

> [accordion] Özellikler
>
> **disabled** `string[]`
>
> Açıkça devre dışı bırakılan ödeme yöntemleri.
>
> **enabled** `string[]`
>
> Açıkça etkinleştirilen ödeme yöntemleri.
>
> **include\_platform\_defaults** `boolean`
>
> Platform varsayılan ödeme yöntemlerinin dahil edilip edilmediği.

**metadata** `object | null`

Ödemelere ve üyeliklere kopyalanan özel anahtar-değer meta verileri. `checkout_configuration:basic:read` kapsamı olmadan `null`.

**mode** `string` *required*

Ödeme işleminin alıcıdan hemen ücret alıp almayacağını veya ödeme bilgilerini daha sonra kullanmak üzere kaydedip kaydetmeyeceğini kontrol eder.

Kullanılabilir seçenekler: `payment`, `setup`

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

Bu ödeme işlemi için ödeme yöntemi geçersiz kılmaları. Varyant veya platform varsayılanlarını kullandığında `null`.

> [accordion] Özellikler
>
> **disabled** `string[]`
>
> Ödeme işlemi için açıkça devre dışı bırakılan ödeme yöntemleri.
>
> **enabled** `string[]`
>
> Ödeme işlemi için açıkça etkinleştirilen ödeme yöntemleri.
>
> **include\_platform\_defaults** `boolean`
>
> Platform varsayılan ödeme yöntemlerinin dahil edilip edilmediği.

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

Müşterilere gönderebileceğiniz ödeme URL'si.

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

Müşterilerin ödemeden sonra yönlendirildiği URL veya yönlendirme yapılandırılmamışsa `null`.

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

Desteklenen oturum içi kart ödemeleri için 3D Secure davranışı. `mandate_challenge`, ödeme işlenmeden önce bir 3DS doğrulaması gerektirir; `mandate_if_required`, yalnızca ödeme işlemcisi gerektirdiğinde doğrulamayı zorunlu kılar; `frictionless_if_required`, normal sürtünmesiz 3DS akışını kullanır. `mandate_challenge` seçilmedikçe 1.000 \$ veya üzeri ödemeler `mandate_if_required` kullanır. Risk ve kimlik doğrulama kurtarma gereksinimleri tercihi geçersiz kılabilir. Kurulum modunda uygulanır; `null` sürtünmesiz 3DS kullanır. Ödeme modu varyant politikasını kullanır.

Kullanılabilir seçenekler: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`

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

Ödeme yapılandırmasının son güncellendiği zaman, ISO 8601 zaman damgası olarak.

**variant** `object | null`

Ödeme işlemi için kullanılan varyant. Kurulum modunda `null`.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `plan_` önekli varyant kimliği.
>
> **adaptive\_pricing\_enabled** `boolean` *required*
>
> Bu varyantın uyarlanabilir fiyatlandırma aracılığıyla yerel para birimiyle ödeme kabul edip etmediği.
>
> **billing\_period** `integer | null` *required*
>
> Gün cinsinden yinelenen faturalandırma aralığı; örneğin aylık için 30 veya yıllık için 365. Tek seferlik varyantlar için `null`.
>
> **billing\_type** `string` *required*
>
> Varyantın faturalandırma modeli.
>
> Kullanılabilir seçenekler: `renewal`, `one_time`
>
> **currency** `string` *required*
>
> Varyantın fiyatları için üç harfli ISO para birimi kodu.
>
> **expiration\_days** `integer | null` *required*
>
> Süre sonu tabanlı varyantlar için gün cinsinden erişim süresi.
>
> **initial\_price** `number` *required*
>
> Varyant para birimi cinsinden ilk satın alma fiyatı.
>
> **release\_method** `string` *required*
>
> Varyantın satış yöntemi.
>
> Kullanılabilir seçenekler: `buy_now`, `waitlist`
>
> **renewal\_price** `number` *required*
>
> Her faturalandırma döneminde alınan yinelenen fiyat.
>
> **three\_ds\_level** `string | null` *required*
>
> Desteklenen oturum içi kart ödemeleri için 3D Secure davranışı. `mandate_challenge`, ödeme işlenmeden önce bir 3DS doğrulaması gerektirir; `mandate_if_required`, yalnızca ödeme işlemcisi gerektirdiğinde doğrulamayı zorunlu kılar; `frictionless_if_required`, normal sürtünmesiz 3DS akışını kullanır. `mandate_challenge` seçilmedikçe 1.000 \$ veya üzeri ödemeler `mandate_if_required` kullanır. Risk ve kimlik doğrulama kurtarma gereksinimleri tercihi geçersiz kılabilir. `null` hesap varsayılanını devralır.
>
> Kullanılabilir seçenekler: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`
>
> **trial\_period\_days** `integer | null` *required*
>
> İlk yenileme ücretinden önceki ücretsiz deneme günleri.
>
> **visibility** `string` *required*
>
> Varyantın müşterilere görünür mü yoksa herkese açık görünümden gizli mi olduğu.
>
> Kullanılabilir seçenekler: `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

- [Kartlar API'si](https://docs.whop.com/tr/api-reference/cards/card.md)
- [İtirazlar API'si](https://docs.whop.com/tr/api-reference/disputes/dispute.md)
- [API sürümleri](https://docs.whop.com/tr/developer/api/versioning.md)
