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

# Memberships API

> Üyelik (Membership), bir müşterinin bir varyantı satın almasıdır: ona bir ürüne erişim sağlayan abonelik veya tek seferlik erişim izni.

Faturalama durumunu (`active`, `trialing`, `past_due` vb.), mevcut dönemi, bekleyen iptalleri, özel meta verileri ve ürün lisanslama içeriyorsa yazılım lisans anahtarını takip eder.

Bir hesabın üyeliklerini veya kendi üyeliklerinizi listelemek, birini kimliğe veya lisans anahtarına göre almak, bir alıcıyı ücretsiz bir varyant üzerinden katılmaya davet etmek ve yaşam döngüsünü yönetmek için Memberships API'sini kullanın: hemen veya dönem sonunda iptal etme, planlanmış bir iptali geri alma, ödeme tahsilatını duraklatma ve sürdürme, erişimi uzatma veya yeniden etkinleştirme, promosyon kodu veya satış ortağı uygulama, yenileme sıklığını değiştirme, erişimi yeniden eşitleme, transfer bağlantısı oluşturma ve meta verileri güncelleme.

> [!NOTE]
>
> Legacy [Memberships](https://docs.whop.com/tr/api-reference/memberships/membership) 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 |
| - | - |
| [List Memberships](https://docs.whop.com/tr/api-reference/memberships/list-memberships.md) | GET `/memberships` |
| [Retrieve Membership](https://docs.whop.com/tr/api-reference/memberships/retrieve-membership.md) | GET `/memberships/{id}` |
| [Apply Promo Code to Membership](https://docs.whop.com/tr/api-reference/memberships/apply-promo-code-to-membership.md) | POST `/memberships/{id}/apply_promo_code` |
| [Assign Affiliate to Membership](https://docs.whop.com/tr/api-reference/memberships/assign-affiliate-to-membership.md) | POST `/memberships/{id}/assign_affiliate` |
| [Cancel Membership](https://docs.whop.com/tr/api-reference/memberships/cancel-membership.md) | POST `/memberships/{id}/cancel` |
| [Extend Membership](https://docs.whop.com/tr/api-reference/memberships/extend-membership.md) | POST `/memberships/{id}/extend` |
| [Pause Membership](https://docs.whop.com/tr/api-reference/memberships/pause-membership.md) | POST `/memberships/{id}/pause` |
| [Reactivate Membership](https://docs.whop.com/tr/api-reference/memberships/reactivate-membership.md) | POST `/memberships/{id}/reactivate` |
| [Resume Membership](https://docs.whop.com/tr/api-reference/memberships/resume-membership.md) | POST `/memberships/{id}/resume` |
| [Resync Membership Access](https://docs.whop.com/tr/api-reference/memberships/resync-membership-access.md) | POST `/memberships/{id}/resync_access` |
| [Transfer Membership](https://docs.whop.com/tr/api-reference/memberships/transfer-membership.md) | POST `/memberships/{id}/transfer` |
| [Invite to a Membership](https://docs.whop.com/tr/api-reference/memberships/invite-to-a-membership.md) | POST `/memberships/invite` |
| [Update Membership](https://docs.whop.com/tr/api-reference/memberships/update-membership.md) | PATCH `/memberships/{id}` |

## Öznitelikler

**id** `string` *required*

`mem_` önekli üyelik kimliği.

**account** `object` *required*

Bu üyeliğin ait olduğu hesap (satıcı).

> [accordion] Properties
>
> **id** `string` *required*
>
> `biz_` önekli hesap kimliği.
>
> **logo\_url** `string | null` *required*
>
> Hesap logosu görseli URL'si. Hesap bir logo belirlemediyse `null` olur.
>
> **route** `string` *required*
>
> `whop.com/\{route}` vitrin yolunda kullanılan, hesabın herkese açık rota tanımlayıcısı.
>
> **title** `string` *required*
>
> Hesabın görünen adı.

**affiliate** `object | null` *required*

Üyeliğin satış ortaklığı komisyonu. Satış ortağı yoksa, hesapta `affiliate:basic:read` izni yoksa ve webhook'larda her zaman `null` olur.

> [accordion] Properties
>
> **id** `string` *required*
>
> `aff_` önekli satış ortağı kimliği.
>
> **applies\_to\_payments** `string` *required*
>
> Komisyonun yalnızca üyeliğin ilk ödemesinde mi yoksa tüm ödemelerinde mi ödendiği.
>
> Kullanılabilir seçenekler: `first_payment`, `all_payments`
>
> **commission\_amount** `object | null` *required*
>
> Üyelik para birimindeki sabit ücretli komisyon veya yüzde için `null`.
>
> > [accordion] Properties
> >
> > **amount** `string` *required*
> >
> > Ana birim cinsinden, tam ondalık dize olarak tutar. Örneğin `"10.00"` on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için dize olarak verilir.
> >
> > **currency** `string` *required*
> >
> > Küçük harfli, üç harfli ISO 4217 para birimi kodu.
> >
> > **decimals** `integer` *required*
> >
> > Tutarın kaç ondalık basamak taşıdığı. Bu, tahsilatın kendisinin çalıştığı hassasiyettir.
> >
> > **display\_decimals** `integer` *required*
> >
> > Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` değerine eşittir, ancak bilinçli olarak her zaman değil: COP sentavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu yüzden değerler `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.
>
> **commission\_percentage** `number | null` *required*
>
> Yüzde puanı cinsinden yüzde komisyonu (yani `20`, %20 anlamına gelir) veya sabit ücret için `null`.
>
> **commission\_source** `string` *required*
>
> Komisyon oranının nasıl belirlendiği: bu satış ortağı için belirlenen bir oran için `custom`, planın veya ürünün üye satış ortaklığı oranı için `member`, ürünün genel satış ortaklığı oranı için `global` veya bir Whop pazar yeri yönlendirmesi için `marketplace`.
>
> Kullanılabilir seçenekler: `custom`, `member`, `marketplace`, `global`
>
> **commission\_type** `string` *required*
>
> Komisyonun yüzde mi yoksa sabit ücret mi olduğu.
>
> Kullanılabilir seçenekler: `flat_fee`, `percentage`
>
> **enabled** `boolean` *required*
>
> Bu üyeliğin satış ortaklığı komisyonu ödeyip ödemediği. `false`, satış ortağının üyelikte tutulduğu ancak artık ödeme almadığı anlamına gelir.
>
> **user\_id** `string` *required*
>
> Satış ortağının `user_` önekli kullanıcı kimliği.

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

Yinelenen tahsilatlar arasındaki gün sayısı. Yenilenmeyen üyelikler veya birden fazla yenileme takvimine sahip üyelikler için `null` olur.

**cancel\_at\_period\_end** `boolean` *required*

Üyeliğin mevcut faturalama dönemi sona erdiğinde iptal edilecek şekilde ayarlanıp ayarlanmadığı. Yalnızca yinelenen varyantlar için anlamlıdır.

**cancel\_option** `string | null` *required*

Üyenin iptal nedeni olarak seçtiği kategori. Kategori seçilmediyse `null` olur.

Kullanılabilir seçenekler: `too_expensive`, `switching`, `missing_features`, `technical_issues`, `bad_experience`, `unused`, `other`, `testing`

**canceled\_at** `string | null` *required*

İptalin talep edildiği zaman veya talep zamanı kaydedilmemişse üyeliğin iptal edildiği zaman, ISO 8601 zaman damgası olarak. Hiçbiri kaydedilmemişse `null` olur.

**cancellation\_reason** `string | null` *required*

İptal sırasında sağlanan serbest metin açıklaması. Neden belirtilmediyse `null` olur.

**collection\_method** `string | null` *required*

Yenilemelerin nasıl tahsil edildiği. `charge_automatically` her dönem kayıtlı ödeme yönteminden tahsilat yapar; `send_invoice` her dönem alıcıya e-postayla bir fatura gönderir. Ayarlanmamışsa `null` olur.

Kullanılabilir seçenekler: `charge_automatically`, `send_invoice`

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

Üyeliğin oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

**current\_period\_end** `string | null` *required*

Mevcut faturalama döneminin yenilendiği zaman veya yenilenmeyen bir üyeliğin sona erdiği zaman, ISO 8601 zaman damgası olarak. Son kullanma tarihi olmayan tek seferlik satın alımlar için `null` olur.

**current\_period\_start** `string | null` *required*

Mevcut faturalama döneminin başladığı zaman, ISO 8601 zaman damgası olarak. Faturalama dönemi kaydedilmemişse `null` olur.

**expires\_at** `string | null` *required*

Sabit bir bitiş tarihine sahip bir üyelik için erişimin sona erdiği zaman, ISO 8601 zaman damgası olarak. Üyeliğin bitiş tarihi olmadığında (ör. yenilenen bir üyelik) `null` olur.

**external\_accounts** `object[] | null` *required*

Üyenin Discord ve Telegram gibi harici platformlardaki hesapları. Üyenin bağlı hesabı yoksa boştur. Webhook'larda `null` olur.

> [accordion] Properties
>
> **external\_id** `string` *required*
>
> Üyenin platformdaki kullanıcı kimliği, örneğin bir Discord kullanıcı kimliği. Platform önekiyle (`discord_\<external_id>`) birlikte, List Memberships'in filtrelediği `external_account` değeridir.
>
> **platform** `string` *required*
>
> Üyenin hesabının bulunduğu platform.
>
> Kullanılabilir seçenekler: `discord`, `telegram`
>
> **username** `string | null` *required*
>
> Üyenin platformdaki kullanıcı adı. Whop bunu bilmediğinde (ör. yalnızca bir Discord kimliğiyle içe aktarılan bir üyelik için) `null` olur.

**feedback\_option** `object | null` *required*

Üyenin seçtiği, hesabın kendi iptal nedeni; üyenin gördüğü haliyle. Üye varsayılan bir kategori seçtiyse veya neden belirtmediyse `null` olur.

> [accordion] Properties
>
> **label** `string` *required*
>
> Üye seçtiğinde seçeneğin etiketi. Seçeneğin daha sonra yeniden adlandırılması bunu değiştirmez.

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

Varyantın, varyantın para birimindeki mevcut peşin fiyatı. Bu bir liste fiyatıdır; alıcının ödediği tutar olmayabilir. İlk tahsilat ücretsiz olduğunda `amount` değeri `"0.00"` olur.

> [accordion] Properties
>
> **amount** `string` *required*
>
> Ana birim cinsinden, tam ondalık dize olarak tutar. Örneğin `"10.00"` on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için dize olarak verilir.
>
> **currency** `string` *required*
>
> Küçük harfli, üç harfli ISO 4217 para birimi kodu.
>
> **decimals** `integer` *required*
>
> Tutarın kaç ondalık basamak taşıdığı. Bu, tahsilatın kendisinin çalıştığı hassasiyettir.
>
> **display\_decimals** `integer` *required*
>
> Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` değerine eşittir, ancak bilinçli olarak her zaman değil: COP sentavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu yüzden değerler `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.

**license\_key** `string | null` *required*

Bu üyeliğin yazılım lisans anahtarı. Yalnızca ürün bir yazılım lisanslama deneyimi içerdiğinde bulunur.

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

Alıcının faturalamayı yönetmek için oturum açabileceği URL. Üye kaydı yoksa veya çağıran alıcı değilse ya da hesapta `member:manage` iznine sahip değilse `null` olur.

**member** `object | null` *required*

Çağıranın hesaptaki üye satırı. Yalnızca üyelik çağırana ait olduğunda bulunur; satıcı tarafı okumalarda `null` olur.

> [accordion] Properties
>
> **access\_level** `string` *required*
>
> Üyenin hesapta neye erişebildiği: ödeme yapan üyeler için `customer`, ekip üyeleri için `admin`, tüm erişim izinlerinin süresi dolduğunda `no_access`.
>
> Kullanılabilir seçenekler: `no_access`, `admin`, `customer`
>
> **last\_accessed\_at** `string | null` *required*
>
> Üyenin hesabın içeriğini en son açtığı zaman, ISO 8601 zaman damgası olarak. Hiç açmadıysa `null` olur.
>
> **position** `number | null` *required*
>
> Üyenin, alıcının kendi hesap listesindeki sıralama konumu. Alıcı düzenleyene kadar `null` olur.

**member\_id** `string | null` *required*

Alıcının hesaptaki `mber_` önekli üye kaydı. Üyeliğin üye kaydı olmadığında (ör. talep edilmemiş bir üyelik) `null` olur.

**metadata** `object` *required*

Üyelik üzerinde saklanan, genellikle yazılım lisanslama için kullanılan özel anahtar-değer çiftleri.

**most\_recent\_action** `string | null` *required*

Üyeliğin en son yaşam döngüsü olayı; örneğin `renewing_on` veya `canceled_on`. Bunu `most_recent_action_at` ile birlikte kullanın. Hiçbiri kaydedilmemişse `null` olur.

Kullanılabilir seçenekler: `canceled_on`, `finished_split_pay_at`, `canceling_on`, `ending_on`, `renewing_on`, `past_due`, `next_payment_attempt`, `paused_at`, `trial_ends_at`, `unresolved_at`, `trial_canceling_on`

**most\_recent\_action\_at** `string | null` *required*

`most_recent_action` olayının gerçekleştiği veya gerçekleşmesinin planlandığı zaman, ISO 8601 zaman damgası olarak. `renewing_on` gibi yaklaşan olaylar için gelecekteki bir zamandır. Eylem kaydedilmemişse `null` olur.

**phone\_number** `string | null` *required*

Alıcının bu üyelik için kaydedilmiş telefon numarası veya `null`. Satıcının telefon toplama özelliği açıksa ödeme sırasında toplanan (veya doğrulanan) numaradır; alıcı bu satıcıyla paylaştıysa hesap numarasına geri döner.

**product** `object` *required*

Bu üyeliğin erişim sağladığı ürün.

> [accordion] Properties
>
> **id** `string` *required*
>
> `prod_` önekli ürün kimliği.
>
> **logo\_url** `string | null` *required*
>
> Ürün logosu görseli URL'si. Ürünün logosu yoksa `null` olur.
>
> **title** `string` *required*
>
> Ürünün görünen adı.

**product\_id** `string` *required*

Bu üyeliğin erişim sağladığı, `prod_` önekli ürün.

**promo\_code\_id** `string | null` *required*

Bu üyeliğe indirim uygulayan `promo_` önekli promosyon kodu. Hiçbiri uygulanmadıysa `null` olur. Ödeme sırasında veya Apply Promo Code to Membership ile ayarlanır.

**renewal\_price** `object | null` *required*

Hâlâ geçerli olan herhangi bir promosyon kodundan sonra, varyantın para birimindeki yenileme fiyatı. Alıcının yerel para biriminde faturalandırılan bir üyelikten, her faturalama tarihinde bu fiyatın o tarihteki döviz kuruyla dönüştürülmüş hali tahsil edilir. Yenilenmeyen üyelikler için `null` olur.

> [accordion] Properties
>
> **amount** `string` *required*
>
> Ana birim cinsinden, tam ondalık dize olarak tutar. Örneğin `"10.00"` on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için dize olarak verilir.
>
> **currency** `string` *required*
>
> Küçük harfli, üç harfli ISO 4217 para birimi kodu.
>
> **decimals** `integer` *required*
>
> Tutarın kaç ondalık basamak taşıdığı. Bu, tahsilatın kendisinin çalıştığı hassasiyettir.
>
> **display\_decimals** `integer` *required*
>
> Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` değerine eşittir, ancak bilinçli olarak her zaman değil: COP sentavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu yüzden değerler `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.

**split\_pay\_current\_payments** `integer | null` *required*

Bölünmüş ödemeli bir üyelikte şu ana kadar sayılan ödenmiş taksitler. Üyelik bölünmüş ödemede değilse veya ilk taksiti sayılmadan önce `null` olur.

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

Üyeliğin faturalamayı durdurmasından önce gereken taksit ödemeleri. Üyelik bölünmüş ödemede değilse `null` olur.

**status** `string` *required*

Üyeliğin faturalama durumu. `active`/`trialing` üyelikler erişim sağlar; `past_due`, başarısız bir ödemeden sonraki ek süredir; `completed` tek seferlik satın alımlar erişimi korur; `canceled`/`expired` üyelikler erişim sağlamaz.

Kullanılabilir seçenekler: `trialing`, `active`, `past_due`, `completed`, `canceled`, `expired`, `unresolved`

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

Üyeliğin en son değiştirildiği zaman, ISO 8601 zaman damgası olarak. Üyeliğin kendisindeki en son değişikliği yansıtır; böylece webhook yeniden denemeleri, yeniden oynatmalar ve geriye dönük doldurmalarla mutabakat yapabilirsiniz.

**user\_id** `string | null` *required*

`user_` önekli alıcı. Alıcı başka bir işletme olduğunda veya üyelik talep edilmemişse `null` olur.

**variant\_id** `string` *required*

Alıcının satın aldığı `plan_` önekli varyant.

```json Membership theme={null}
{
	"id": "mem_xxxxxxxxxxxxxx",
	"affiliate": null,
	"status": "active",
	"collection_method": "charge_automatically",
	"most_recent_action": "renewing_on",
	"most_recent_action_at": "2026-08-01T00:00:00.000Z",
	"user_id": "user_xxxxxxxxxxxxx",
	"product_id": "prod_xxxxxxxxxxxxx",
	"variant_id": "plan_xxxxxxxxxxxxx",
	"member_id": "mber_xxxxxxxxxxxxx",
	"product": {
		"id": "prod_xxxxxxxxxxxxx",
		"title": "Pickaxe Pro",
		"logo_url": "https://cdn.whop.com/product.png"
	},
	"initial_price": {
		"currency": "usd",
		"amount": "0.00",
		"decimals": 2,
		"display_decimals": 2
	},
	"renewal_price": {
		"currency": "usd",
		"amount": "50.00",
		"decimals": 2,
		"display_decimals": 2
	},
	"split_pay_current_payments": null,
	"split_pay_required_payments": null,
	"expires_at": null,
	"promo_code_id": null,
	"billing_period_days": 30,
	"license_key": "A1B2C3-D4E5F6-G7H8I9",
	"phone_number": "+12025550123",
	"cancel_at_period_end": false,
	"current_period_start": "2026-07-01T00:00:00.000Z",
	"current_period_end": "2026-08-01T00:00:00.000Z",
	"canceled_at": null,
	"cancel_option": null,
	"cancellation_reason": null,
	"feedback_option": null,
	"external_accounts": [
		{
			"platform": "discord",
			"external_id": "123456789012345678",
			"username": "jane"
		}
	],
	"manage_url": "https://whop.com/billing/manage/mber_xxxxxxxxxxxxx",
	"metadata": {
		"external_customer_id": "cus_123"
	},
	"created_at": "2026-07-01T00:00:00.000Z",
	"updated_at": "2026-07-15T00:00:00.000Z",
	"member": {
		"access_level": "customer",
		"last_accessed_at": "2026-07-20T15:30:00.000Z",
		"position": 1
	},
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Pickaxe",
		"route": "pickaxe",
		"logo_url": "https://cdn.whop.com/account.png"
	}
}
```


## Related topics

- [Cancel membership](https://docs.whop.com/tr/api-reference/legacy/memberships/cancel-membership.md)
- [List memberships](https://docs.whop.com/tr/api-reference/legacy/memberships/list-memberships.md)
- [Retrieve membership](https://docs.whop.com/tr/api-reference/legacy/memberships/retrieve-membership.md)
