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

# Variants API

> Variant, bir ürünün satın alınabilir tek bir yapılandırmasıdır.

Fiyatı, faturalandırma sıklığını, stoku, SKU'yu, öznitelikleri, vergi davranışını, ödeme alanlarını ve satın alma görünürlüğünü kontrol eder. Variant kimlikleri `plan_` önekli olmaya devam eder.

Variants API'yi ürünler için varyantlar oluşturmak, mevcut varyantları listelemek, varyant yapılandırmasını getirmek veya güncellemek, ödeme için vergi hesaplamak ve artık sunulmaması gereken varyantları silmek için kullanın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Varyantları Listele](https://docs.whop.com/tr/api-reference/variants/list-variants.md) | GET `/variants` |
| [Varyantı Getir](https://docs.whop.com/tr/api-reference/variants/retrieve-variant.md) | GET `/variants/{id}` |
| [Varyant Oluştur](https://docs.whop.com/tr/api-reference/variants/create-variant.md) | POST `/variants` |
| [Varyantı Güncelle](https://docs.whop.com/tr/api-reference/variants/update-variant.md) | PATCH `/variants/{id}` |
| [Varyantı Sil](https://docs.whop.com/tr/api-reference/variants/delete-variant.md) | DELETE `/variants/{id}` |

## Öznitelikler

**id** `string` *required*

Varyant kimliği, `plan_` önekli.

**account** `object | null` *required*

Bu varyantı satan hesap; bağımsız fatura varyantları için `null`.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Hesap kimliği, `biz_` önekli.
>
> **title** `string` *required*
>
> Hesabın görünen adı.

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

Bu varyant için uyarlanabilir fiyatlandırmanın etkin olup olmadığı. Ham ayardır — işlemci uyumluluğunu veya özellik bayraklarını kontrol etmez.

**allow\_multiple\_quantity** `boolean` *required*

Bir siparişte birden fazla birimin satın alınıp alınamayacağı. Yenilenen varyantlar bunu etkinleştiremez. `false` olduğunda ödemeler, sepetler ve faturalar 1'in üzerindeki miktarları reddeder.

**attributes** `object | null` *required*

Bu varyantı ürünü içinde ayırt eden öznitelik değerleri; öznitelik adından değere bir eşleme olarak, örneğin `\{"color": "Blue", "size": "Large"}`. Adlar snake\_case tanımlayıcılarıdır ve alfabetik sırayla döner. Bir üründeki öznitelikli her varyant aynı öznitelik adlarını ve farklı bir değer kümesini taşır; ürün tüm seçenek kümesini `variant_attributes` olarak listeler. Varyantın özniteliği olmadığında `null`.

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

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

**billing\_type** `string` *required*

Bu varyantın faturalandırma modeli.

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

**cancel\_discount\_intervals** `number | null` *required*

İptal indiriminin ne kadar süreceği: süresiz için `0`, yalnızca sonraki ödeme için `1` veya müşterinin kabul ettiği andan itibaren takvim ayı sayısı. Hiçbiri sunulmadığında veya aktör `plan:basic:read` kapsamına sahip olmadığında `null`.

**cancel\_discount\_percentage** `number | null` *required*

Tam sayı yüzde olarak iptal indirimi. Hiçbiri sunulmadığında veya aktör `plan:basic:read` kapsamına sahip olmadığında `null`.

**checkout\_styling** `object | null` *required*

Varyant düzeyinde ödeme sayfası stili (`background_color`, `button_color`, `font_family`, `border_style`); `null` hesap varsayılanını devralır.

**collect\_tax** `boolean` *required*

Hesabın vergi yapılandırmasına göre bu varyantın satın alımlarında vergi tahsil edilip edilmediği.

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

Varyantın oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

**currency** `string` *required*

Bu varyanttaki her fiyatın belirtildiği para biriminin üç harfli ISO 4217 kodu, küçük harfli: varyantın kendi para birimi veya varyant ona dönüştürülebildiğinde okuma isteğinin talep ettiği `presentment_currency`.

**custom\_fields** `object[]` *required*

Ödeme formunda toplanan özel giriş alanları.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Özel alan kimliği, `field_` önekli.
>
> **field\_type** `string` *required*
>
> Özel alan giriş türü.
>
> Kullanılabilir seçenekler: `text`
>
> **name** `string` *required*
>
> Ödeme sırasında müşteriye gösterilen alan etiketi.
>
> **order** `number` *required*
>
> Ödeme formundaki alan konumu.
>
> **placeholder** `string | null` *required*
>
> Boş alanda gösterilen yer tutucu metin. Hiçbiri ayarlanmadıysa `null`.
>
> **required** `boolean` *required*
>
> Müşterinin ödeme yapmak için bu alanı doldurması gerekip gerekmediği.

**deletable** `boolean | null` *required*

Varyantın silinip silinemeyeceği (üyeliği veya bekleme listesi girişi yoksa). Aktör varyantın hesabında `plan:basic:read` kapsamına sahip olmadığı sürece `null`.

**description** `string | null` *required*

Müşteriye görünen varyant açıklaması. En fazla 1000 karakter. Açıklama ayarlanmadıysa `null`.

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

Bu varyant için bir ödemeyi yöneten, her katman (varyantın kendisi ve hesabınki) üzerinden çözümlenmiş yapılandırma — bir oturumun `payment_method_configuration` alanının taşıdığı yapı. Sunulabilir kümeyi elde etmek için bunu ödeme yöntemi türleri kataloğu üzerine uygulayın. `null` platform varsayılanları anlamına gelir; `payment_method_configuration` varyantın kendi düzenlenebilir geçersiz kılması olarak kalır.

> [accordion] Özellikler
>
> **disabled** `string[]` *required*
>
> Varsayılanlar sunacak olsa bile bu ödemenin sunmadığı ödeme yöntemleri.
>
> **enabled** `string[]` *required*
>
> Bu ödemenin, varsayılanların sağladıklarına ek olarak sunduğu ödeme yöntemleri.
>
> **include\_platform\_defaults** `boolean` *required*
>
> Başlangıç noktasının Whop'un varsayılan kümesi olup olmadığı. `false` olduğunda yalnızca `enabled` sunulur.

**expiration\_days** `number | null` *required*

Süre sonu tabanlı varyantlar için gün cinsinden erişim süresi, örneğin bir yıllık geçiş için 365. Süre sonu olmayan varyantlar için `null`.

**formatted\_price** `string` *required*

Gösterim için `currency` cinsinden insan tarafından okunabilir fiyat (para birimi + aralık), örneğin "\$10 / month".

**image** `object | null` *required*

Ürün sayfasında gösterilen fiyatlandırma katmanı görseli (`url`, `blurhash`); görsel ayarlanmadığında `null`.

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

`currency` cinsinden ilk satın alma fiyatı.

**initial\_price\_due** `object` *required*

Promosyon kodları ve vergiden önce bir birim için ödeme sırasında tahsil edilen toplam: yinelenen varyantlar için `initial_price` artı ilk `renewal_price` veya ücretsiz deneme geçerliyken yalnızca `initial_price`. Görüntüleyen kullanıcı bu varyant için zaten bir deneme kullandıysa deneme geçerli olmaz. `currency` cinsinden belirtilir.

> [accordion] Özellikler
>
> **amount** `string` *required*
>
> Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin `"10.00"` on dolardır. Aktarım sırasında hiçbir kayan nokta sayısı onu yuvarlamasın diye bir dizedir.
>
> **currency** `string` *required*
>
> Üç harfli ISO 4217 para birimi kodu, küçük harfli.
>
> **decimals** `integer` *required*
>
> Tutarın taşıdığı ondalık basamak sayısı. Bu, ücretin kendisinin işlendiği hassasiyettir.
>
> **display\_decimals** `integer` *required*
>
> GÖSTERİLECEK ondalık basamak sayısı. Genellikle `decimals` ile aynıdır, ancak kasıtlı olarak her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu yüzden `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.

**internal\_notes** `string | null` *required*

Müşterilere gösterilmeyen özel notlar. Aktör varyantın hesabında `plan:basic:read` kapsamına sahip olmadığı sürece `null`.

**invoice** `object | null` *required*

Bu varyantın oluşturulduğu fatura; bir fatura için oluşturulmadıysa `null`.

**member\_count** `number | null` *required*

Bu varyant üzerinden etkin üyelikler. Aktör varyantın hesabında `plan:basic:read` kapsamına sahip olmadığı sürece `null`.

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

Varyantta saklanan özel anahtar-değer çiftleri. Ödeme ve üyelik olaylarının webhook yüklerine dahil edilir. En fazla 50 anahtar, anahtar başına 100 karakter, değer başına 500 karakter. Ayrılmış `custom_cta` ve `custom_cta_url` anahtarları ayarlandığında, bu varyant için ürünün ödeme harekete geçirici mesajını geçersiz kılar.

**offer\_cancel\_discount** `boolean | null` *required*

İptal indirimi sunulup sunulmadığı. Aktör varyantın hesabında `plan:basic:read` kapsamına sahip olmadığı sürece `null`.

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

Ödeme yöntemi yapılandırması (`enabled`, `disabled`, `include_platform_defaults`); varyant varsayılan ayarları kullandığında `null`.

**product** `object | null` *required*

Bu varyantın ait olduğu ürün; bağımsız varyantlar için `null`.

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

Müşterilerin bu varyantı doğrudan satın alabileceği URL.

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

Müşterinin bu varyant için ödeme yaptıktan sonra yönlendirildiği yer. Hiçbiri ayarlanmadığında veya aktör varyantın hesabında `plan:basic:read` kapsamına sahip olmadığı sürece `null`.

**release\_method** `string` *required*

Bu varyantın satış yöntemi.

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

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

Her faturalandırma döneminde tahsil edilen yinelenen fiyat, `currency` cinsinden.

**sku** `string | null` *required*

Stok tutma birimi, satıcı tarafından ayarlanan serbest metin (örneğin `TSHIRT-LARGE-BLUE`). Benzersizliği zorunlu değildir. Ayarlanmadığında `null`.

**split\_pay\_required\_payments** `number | null` *required*

Abonelik duraklatılmadan önce gereken taksit ödemeleri. 1'den büyük olmalıdır. Bölünmüş ödeme yapılandırılmadıysa `null`.

**stock** `number | null` *required*

Satın alınabilir birimler. Aktör varyantın hesabında `plan:basic:read` kapsamına sahip olmadığı sürece `null`.

**strike\_through\_initial\_price** `number | null` *required*

Üstü çizili olarak gösterilen orijinal ilk fiyat, `currency` cinsinden. Üstü çizili fiyat ayarlanmadığında `null`.

**strike\_through\_renewal\_price** `number | null` *required*

Üstü çizili olarak gösterilen orijinal yenileme fiyatı, `currency` cinsinden. Üstü çizili fiyat ayarlanmadığında `null`.

**tax\_type** `string` *required*

Bu varyant için verginin nasıl işlendiği; verginin fiyata dahil mi, ödeme sırasında mı eklendiği yoksa yapılandırılmamış mı olduğu dahil.

Kullanılabilir seçenekler: `inclusive`, `exclusive`, `unspecified`

**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çilmediği sürece 1.000 \$ veya üzeri ödemeler `mandate_if_required` kullanır. Risk ve kimlik doğrulama kurtarma gereksinimleri bu tercihi geçersiz kılabilir. `null` hesap varsayılanını devralır.

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

**title** `string | null` *required*

Müşterilere gösterilen varyant görünen adı. En fazla 30 karakter. Ad olmadan oluşturulan bir varyant varsayılan olarak `/` ile birleştirilmiş öznitelik değerlerini kullanır. Başlık ayarlanmadıysa `null`.

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

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

**unlimited\_stock** `boolean` *required*

Varyantın sınırsız stoğa sahip olup olmadığı. `true` olduğunda `stock` alanı yok sayılır; bekleme listesi varyantları her zaman `true` bildirir.

**unpaid\_invoice\_count** `integer | null` *required*

Bu varyant için düzenlenmiş, ödenmemiş veya geçersiz kılınmamış fatura sayısı. `0`'ın üzerinde olduğu sürece varyantın fiyatlarını, faturalandırma dönemini, denemesini, ödeme sayısını, para birimini veya faturalandırma türünü değiştiremezsiniz. Aktör varyantın hesabında `plan:basic:read` kapsamına sahip olmadığı sürece `null`.

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

Varyantın son güncellendiği zaman, ISO 8601 zaman damgası olarak.

**visibility** `string` *required*

Bu varyantın nerede görülebileceğini kontrol eder. `hidden` olduğunda varyanta yalnızca doğrudan bağlantısıyla erişilebilir.

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

```json Variant theme={null}
{
	"id": "plan_xxxxxxxxxxxxx",
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Pickaxe"
	},
	"adaptive_pricing_enabled": true,
	"allow_multiple_quantity": false,
	"attributes": {
		"seats": "5",
		"tier": "Pro"
	},
	"billing_period": 30,
	"cancel_discount_intervals": null,
	"cancel_discount_percentage": null,
	"checkout_styling": null,
	"collect_tax": true,
	"created_at": "2023-12-01T05:00:00.401Z",
	"currency": "usd",
	"custom_fields": [
		{
			"id": "cusf_xxxxxxxxxxxx",
			"field_type": "text",
			"name": "Discord username",
			"order": 0,
			"placeholder": "e.g. pickaxe_user",
			"required": true
		}
	],
	"deletable": false,
	"description": "Monthly access to Pickaxe Analytics.",
	"expiration_days": null,
	"formatted_price": "$29.00 / month",
	"image": null,
	"initial_price": 29,
	"internal_notes": "Standard monthly variant",
	"redirect_url": null,
	"invoice": null,
	"member_count": 42,
	"metadata": {
		"external_plan_id": "monthly",
		"custom_cta": "subscribe",
		"custom_cta_url": "https://example.com/wash-club"
	},
	"offer_cancel_discount": false,
	"payment_method_configuration": {
		"enabled": ["card"],
		"disabled": [],
		"include_platform_defaults": true
	},
	"effective_payment_method_configuration": {
		"enabled": ["card"],
		"disabled": [],
		"include_platform_defaults": true
	},
	"billing_type": "renewal",
	"product": {
		"id": "prod_xxxxxxxxxxxxx",
		"title": "Pickaxe Analytics"
	},
	"purchase_url": "https://whop.com/pickaxe-analytics/checkout/plan_xxxxxxxxxxxxx",
	"release_method": "buy_now",
	"renewal_price": 29,
	"initial_price_due": {
		"currency": "usd",
		"amount": "29.00",
		"decimals": 2,
		"display_decimals": 2
	},
	"sku": "PICKAXE-PRO-5-MONTHLY",
	"split_pay_required_payments": null,
	"stock": null,
	"strike_through_initial_price": null,
	"strike_through_renewal_price": null,
	"tax_type": "exclusive",
	"three_ds_level": "frictionless_if_required",
	"title": "Pro / 5 seats",
	"trial_period_days": 7,
	"unlimited_stock": true,
	"unpaid_invoice_count": 0,
	"updated_at": "2023-12-01T05:00:00.401Z",
	"visibility": "visible"
}
```


## Related topics

- [Varyantlar](https://docs.whop.com/tr/api-reference/legacy/variants/variant.md)
- [API sürümleri](https://docs.whop.com/tr/developer/api/versioning.md)
- [Delete Variant](https://docs.whop.com/tr/api-reference/variants/delete-variant.md)
