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

> Ödeme yapılandırması; plan, satış ortağı ve özel meta veriler dahil, bir ödeme sayfası için yeniden kullanılabilir bir yapılandırmadır. Bir ödeme oturumundan oluşturulan ödemeler ve üyelikler onun meta verilerini devralır.

> [!NOTE]
>
> Bu kaynağın, yeni entegrasyonların üzerine inşa edilmesi gereken sürümlü API olan [Whop API](https://docs.whop.com/tr/api-reference/legacy/checkout-configurations/checkout-configuration.md) içinde bir halefi vardır. Bu sayfa tam olarak desteklenmeye devam eder.

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

Ödeme yapılandırması için kullanılacak hesabın kimliği

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

Ödeme yapılandırması için kullanılacak satış ortağı kodu

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

Ödeme yapılandırması için kullanılacak hesabın kimliği

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

'setup' modundayken yapılandırma için kullanılacak para birimi. Bu, hangi para birimine özgü ödeme yöntemlerinin kullanılabilir olduğunu hedeflemek için kullanılır. Sağlanmazsa setup modunda varsayılan olarak 'usd' olur.

Kullanılabilir seçenekler: `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*

Ödeme oturumunun benzersiz tanımlayıcısı.

Örnek: `ch_xxxxxxxxxxxxxxx`

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

Ödeme yapılandırması için kullanılacak meta veriler

**mode** `CheckoutModes` *required*

Ödeme oturumunun modu.

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

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

Varsa, oturum için açık ödeme yöntemi yapılandırması. Bu şu anda yalnızca 'setup' modunda çalışır. Ödeme yöntemi için planın payment\_method\_configuration alanını kullanın.

**alt öznitelikler**

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

Açıkça devre dışı bırakılan ödeme yöntemi tanımlayıcılarından oluşan bir dizi. Yalnızca include\_platform\_defaults true ise geçerlidir.

Kullanılabilir seçenekler: `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*

Açıkça etkinleştirilen ödeme yöntemi tanımlayıcılarından oluşan bir dizi. Bu, bu ödeme yöntemlerinin ödeme sayfasında gösterileceği anlamına gelir. Örnek kullanım durumu, yalnızca cashapp gibi belirli bir ödeme yöntemini etkinleştirmek veya platform varsayılanlarını ek yöntemlerle genişletmektir.

Kullanılabilir seçenekler: `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*

Whop'un platform varsayılanı ödeme yöntemi etkinleştirme ayarlarının bu yapılandırmaya dahil edilip edilmediği. Varsayılan ödeme yöntemlerinin tam listesi docs.whop.com/payments adresindeki dokümantasyonda bulunabilir.

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

Ödeme yapılandırması için kullanılacak plan

**alt öznitelikler**

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

İçerik üreticisinin bu plan için uyarlanabilir fiyatlandırmayı açıp açmadığı. Ham ayar — işlemci uyumluluğunu veya özellik bayraklarını kontrol etmez.

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

Yinelenen tahsilatlar arasındaki gün sayısı; örneğin aylık için 30, yıllık için 365. Tek seferlik planlar için `null`.

Örnek: `42`

**currency** `Currencies` *required*

Bu plandaki tüm fiyatlar için kullanılan para birimi (ör. 'usd', 'eur'). Plandaki tüm parasal tutarlar bu para birimindedir.

Kullanılabilir seçenekler: `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*

Süre sonu tabanlı planlar için gün cinsinden erişim süresi; örneğin bir yıllık geçiş için 365.

Örnek: `42`

**id** `string` *required*

Planın benzersiz tanımlayıcısı.

Örnek: `plan_xxxxxxxxxxxxx`

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

Planın base\_currency biriminde ilk satın alma fiyatı (ör. \$49.99 için 49.99). Tek seferlik planlarda bu, tam fiyattır. Yenilemeli planlarda bu, ilk renewal\_price üzerine ek olarak tahsil edilir.

Örnek: `6.9`

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

Bu planın faturalandırma modeli: yinelenen abonelikler için 'renewal' veya tek seferlik ödemeler için 'one\_time'.

Kullanılabilir seçenekler: `renewal`, `one_time`

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

Bu planın satış yöntemi: anında satın alma için `buy_now` veya bekleme listesi tabanlı erişim için `waitlist`.

Kullanılabilir seçenekler: `buy_now`, `waitlist`

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

Planın base\_currency biriminde her billing\_period için tahsil edilen yinelenen fiyat (ör. dönem başına \$9.99 için 9.99). Tek seferlik planlar için sıfır.

Örnek: `6.9`

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

Bu plan için 3D Secure davranışı. Null, planın hesap varsayılanını devraldığı anlamına gelir.

Kullanılabilir seçenekler: `mandate_challenge`, `frictionless`

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

İlk yenileme tahsilatından önceki ücretsiz deneme günleri. Deneme yapılandırılmadıysa veya kullanıcı bu plan için zaten bir deneme kullandıysa `null`.

Örnek: `42`

**visibility** `Visibility` *required*

Planın müşterilere görünür olup olmadığını kontrol eder. 'hidden' olarak ayarlandığında plana yalnızca doğrudan bağlantıyla erişilebilir.

Kullanılabilir seçenekler: `visible`, `hidden`, `archived`, `quick_link`

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

Bir ödemeyi tamamlamaları için müşterilere gönderebileceğiniz bir URL. `/checkout/ch_xxxx/` şeklinde görünür

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

Ödeme yapılandırması oluşturulduktan sonra kullanıcının yönlendirileceği URL


## Related topics

- [Ödeme Yapılandırmaları API'si](https://docs.whop.com/tr/api-reference/checkout-configurations/checkout-configuration.md)
- [Ödeme Yöntemlerini Kaydetme](https://docs.whop.com/tr/developer/guides/save-payment-methods.md)
- [Alt Hesaplar İçin Ödeme Tahsil Edin](https://docs.whop.com/tr/developer/platforms/collect-payments-for-subaccounts.md)
