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

# Üyelikler

> API ile üyelikleri okuyun ve faturalandırmalarını değiştirin; örneğin bir aboneliği duraklatın veya ücretsiz gün ekleyin.

Üyelik, bir kullanıcı ile bir ürün arasındaki aktif ilişkidir. Erişimi, faturalandırma durumunu ve yenileme takvimini izler. Üyelikleri doğrudan oluşturmazsınız, çünkü bunu ödeme sayfası sizin için yapar. Bir üyelik oluştuktan sonra onu okuyabilir, faturalandırmayı duraklatabilir veya iptal edebilir, ücretsiz süre tanımlayabilir ya da meta verileri güncelleyebilirsiniz.

> [!TIP]
>
> Çoğu uygulamanın üyelikleri yönetmesine hiç gerek yoktur. Bu yöntemlere; yönetici araçları, müşteri destek akışları veya kullanıcıların duraklatma ya da iptal yapmasına olanak tanıyan self-servis panolar oluştururken başvurun.

## Yaşam döngüsüne genel bakış

| İşlem | Yöntem | Ne yapar |
| - | - | - |
| Faturalandırmayı duraklat | [`memberships.pause`](https://docs.whop.com/tr/api-reference/memberships/pause-membership) | Devam ettirilene kadar gelecekteki yenilemeleri durdurur. Mevcut erişim korunur. |
| Faturalandırmayı devam ettir | [`memberships.resume`](https://docs.whop.com/tr/api-reference/memberships/resume-membership) | Bir duraklatmayı geri alır. |
| İptal et | [`memberships.cancel`](https://docs.whop.com/tr/api-reference/memberships/cancel-membership) | Dönem sonunda veya hemen (varsayılan). |
| İptali geri al | [`memberships.update`](https://docs.whop.com/tr/api-reference/memberships/update-membership) | Bekleyen bir iptali geri almak için `cancel_at_period_end: false` gönderin. |
| Ücretsiz süre tanımla | [`memberships.extend`](https://docs.whop.com/tr/api-reference/memberships/extend-membership) | Bir sonraki yenileme tarihini N gün uzatır. |
| Faturalandırma gününü değiştir | [`memberships.update`](https://docs.whop.com/tr/api-reference/memberships/update-membership) | Bir sonraki yenilemeyi taşımak için `current_period_end` gönderin. Her 30, 60, 90 … 360 veya 365 günde bir faturalandırılan üyelikler ayın o gününde yenilenmeye devam eder. |
| Meta verileri güncelle | [`memberships.update`](https://docs.whop.com/tr/api-reference/memberships/update-membership) | Meta verileri veya diğer yazılabilir alanları kısmi olarak günceller. |

## Getirme ve listeleme

```typescript TypeScript theme={null}
const membership = await client.memberships.retrieve({ id: "mem_xxxxxxxxxxxxx" });

// List with auto-pagination
const memberships = await client.memberships.list({
  account_id: "biz_xxxxxxxxxxxxx",
});

for await (const item of memberships) {
  console.log(item);
}
```

```python Python theme={null}
membership = client.memberships.retrieve("mem_xxxxxxxxxxxxx")

for item in client.memberships.list(account_id="biz_xxxxxxxxxxxxx"):
    print(item)
```

```ruby Ruby theme={null}
membership = client.memberships.retrieve(id: "mem_xxxxxxxxxxxxx")

# list returns an Enumerable that pages for you and yields one membership at a time
client.memberships.list(account_id: "biz_xxxxxxxxxxxxx").each do |item|
  puts item
end
```

```rust Rust theme={null}
let membership = client
    .memberships
    .retrieve(&"mem_xxxxxxxxxxxxx".to_string(), None)
    .await?;

// List one page of memberships for an account
let memberships = client
    .memberships
    .list(
        &MembershipsListQueryRequest {
            account_id: Some("biz_xxxxxxxxxxxxx".to_string()),
            ..Default::default()
        },
        None,
    )
    .await?;

for item in memberships.data {
    println!("{item:?}");
}
```

```go Go theme={null}
membership, err := client.Memberships.Retrieve(context.TODO(), &whopsdk.RetrieveMembershipsRequest{
    ID: "mem_xxxxxxxxxxxxx",
})
if err != nil {
    log.Fatal(err)
}
fmt.Println(membership)

// List with auto-pagination
page, err := client.Memberships.List(context.TODO(), &whopsdk.ListMembershipsRequest{
    AccountID: whopsdk.String("biz_xxxxxxxxxxxxx"),
})
if err != nil {
    log.Fatal(err)
}

iter := page.Iterator()
for iter.Next(context.TODO()) {
    fmt.Println(iter.Current())
}
if err := iter.Err(); err != nil {
    log.Fatal(err)
}
```

## Duraklatma ve devam ettirme

Duraklatma bir sonraki faturalandırma döngüsünü durdurur. Kullanıcı mevcut dönem bitene kadar mevcut erişimini korur, ancak yenileme gerçekleşmez. Otomatik devam ettirme planlamak için `until` iletin.

```typescript TypeScript theme={null}
await client.memberships.pause({
  id: "mem_xxxxxxxxxxxxx",
  until: "2026-09-01T00:00:00Z", // optional, resumes automatically
});

// Later
await client.memberships.resume({ id: "mem_xxxxxxxxxxxxx" });
```

```python Python theme={null}
client.memberships.pause(
    "mem_xxxxxxxxxxxxx",
    until="2026-09-01T00:00:00Z",  # optional, resumes automatically
)

client.memberships.resume("mem_xxxxxxxxxxxxx")
```

```ruby Ruby theme={null}
client.memberships.pause(
  id: "mem_xxxxxxxxxxxxx",
  until: "2026-09-01T00:00:00Z", # optional, resumes automatically
)

# Later
client.memberships.resume(id: "mem_xxxxxxxxxxxxx")
```

```rust Rust theme={null}
client
    .memberships
    .pause(
        &"mem_xxxxxxxxxxxxx".to_string(),
        &PauseMembershipsRequest {
            until: Some("2026-09-01T00:00:00Z".to_string()), // optional, resumes automatically
        },
        None,
    )
    .await?;

// Later
client.memberships.resume(&"mem_xxxxxxxxxxxxx".to_string(), None).await?;
```

```go Go theme={null}
_, err := client.Memberships.Pause(context.TODO(), &whopsdk.PauseMembershipsRequest{
    ID:    "mem_xxxxxxxxxxxxx",
    Until: whopsdk.String("2026-09-01T00:00:00Z"), // optional, resumes automatically
})
if err != nil {
    log.Fatal(err)
}

// Later
if _, err := client.Memberships.Resume(context.TODO(), &whopsdk.ResumeMembershipsRequest{
    ID: "mem_xxxxxxxxxxxxx",
}); err != nil {
    log.Fatal(err)
}
```

## İptal

İki iptal modu vardır. `cancel_at_period_end: true` erişimi mevcut yenileme tarihine kadar korur ve ardından devre dışı bırakır. Erişimi hemen iptal etmek için bunu atlayın (veya `false` iletin).

```typescript TypeScript theme={null}
// Cancel at the end of the current billing period
await client.memberships.cancel({
  id: "mem_xxxxxxxxxxxxx",
  cancel_at_period_end: true,
});

// Cancel immediately. Access ends now.
await client.memberships.cancel({
  id: "mem_xxxxxxxxxxxxx",
  cancel_at_period_end: false,
  reason: "Requested by customer",
});
```

```python Python theme={null}
# Cancel at the end of the current billing period
client.memberships.cancel(
    "mem_xxxxxxxxxxxxx",
    cancel_at_period_end=True,
)

# Cancel immediately. Access ends now.
client.memberships.cancel(
    "mem_xxxxxxxxxxxxx",
    cancel_at_period_end=False,
    reason="Requested by customer",
)
```

```ruby Ruby theme={null}
# Cancel at the end of the current billing period
client.memberships.cancel(
  id: "mem_xxxxxxxxxxxxx",
  cancel_at_period_end: true,
)

# Cancel immediately. Access ends now.
client.memberships.cancel(
  id: "mem_xxxxxxxxxxxxx",
  cancel_at_period_end: false,
  reason: "Requested by customer",
)
```

```rust Rust theme={null}
// Cancel at the end of the current billing period
client
    .memberships
    .cancel(
        &"mem_xxxxxxxxxxxxx".to_string(),
        &CancelMembershipsRequest {
            cancel_at_period_end: Some(true),
            ..Default::default()
        },
        None,
    )
    .await?;

// Cancel immediately. Access ends now.
client
    .memberships
    .cancel(
        &"mem_xxxxxxxxxxxxx".to_string(),
        &CancelMembershipsRequest {
            cancel_at_period_end: Some(false),
            reason: Some("Requested by customer".to_string()),
        },
        None,
    )
    .await?;
```

```go Go theme={null}
// Cancel at the end of the current billing period
_, err := client.Memberships.Cancel(context.TODO(), &whopsdk.CancelMembershipsRequest{
    ID:                "mem_xxxxxxxxxxxxx",
    CancelAtPeriodEnd: whopsdk.Bool(true),
})
if err != nil {
    log.Fatal(err)
}

// Cancel immediately. Access ends now.
_, err = client.Memberships.Cancel(context.TODO(), &whopsdk.CancelMembershipsRequest{
    ID:                "mem_xxxxxxxxxxxxx",
    CancelAtPeriodEnd: whopsdk.Bool(false),
    Reason:            whopsdk.String("Requested by customer"),
})
if err != nil {
    log.Fatal(err)
}
```

> [!NOTE]
>
> `cancel_at_period_end: true`, üyelikteki `cancel_at_period_end` değerini `true` yapar. Kullanıcı yenilemeye kadar erişimini korur, ardından üyelik devre dışı kalır ve `previous_attributes.status` ayrıldığı duruma ayarlanmış şekilde `membership.updated` tetiklenir. Alanın atlanması erişimi hemen iptal eder; bu nedenle dönem sonunda iptal etmek istediğiniz her durumda bu alanı açıkça gönderin.

## Bir iptali geri alma

Kullanıcı dönem bitmeden fikrini değiştirirse, bekleyen dönem sonu iptalini bir güncellemeyle temizleyin. Üyelik iptal için planlanmamışsa hiçbir etkisi olmaz.

```typescript TypeScript theme={null}
await client.memberships.update({
  id: "mem_xxxxxxxxxxxxx",
  cancel_at_period_end: false,
});
```

```python Python theme={null}
client.memberships.update("mem_xxxxxxxxxxxxx", cancel_at_period_end=False)
```

```ruby Ruby theme={null}
client.memberships.update(id: "mem_xxxxxxxxxxxxx", cancel_at_period_end: false)
```

```rust Rust theme={null}
client
    .memberships
    .update(
        &"mem_xxxxxxxxxxxxx".to_string(),
        &UpdateMembershipsRequest {
            cancel_at_period_end: Some(false),
            ..Default::default()
        },
        None,
    )
    .await?;
```

```go Go theme={null}
if _, err := client.Memberships.Update(context.TODO(), &whopsdk.UpdateMembershipsRequest{
    ID:                "mem_xxxxxxxxxxxxx",
    CancelAtPeriodEnd: whopsdk.Bool(false),
}); err != nil {
    log.Fatal(err)
}
```

## Ücretsiz gün ekleme

Kullanıcıya mevcut döneminde ek süre tanımlayın. Bir sonraki yenileme tarihi `days` kadar ileri kayar. Hizmet kesintileri, destek jestleri veya yönlendirme ödülleri için kullanışlıdır.

```typescript TypeScript theme={null}
await client.memberships.extend({
  id: "mem_xxxxxxxxxxxxx",
  days: 7,
});
```

```python Python theme={null}
client.memberships.extend("mem_xxxxxxxxxxxxx", days=7)
```

```ruby Ruby theme={null}
client.memberships.extend(id: "mem_xxxxxxxxxxxxx", days: 7)
```

```rust Rust theme={null}
client
    .memberships
    .extend(
        &"mem_xxxxxxxxxxxxx".to_string(),
        &ExtendMembershipsRequest { days: 7 },
        None,
    )
    .await?;
```

```go Go theme={null}
if _, err := client.Memberships.Extend(context.TODO(), &whopsdk.ExtendMembershipsRequest{
    ID:   "mem_xxxxxxxxxxxxx",
    Days: 7,
}); err != nil {
    log.Fatal(err)
}
```

`days` 1 ile 1095 (3 yıl) arasında değer kabul eder.

## Meta verileri güncelleme

Üyelikteki rastgele meta verileri veya diğer yazılabilir alanları kısmi olarak güncelleyin.

```typescript TypeScript theme={null}
await client.memberships.update({
  id: "mem_xxxxxxxxxxxxx",
  metadata: { internal_user_id: "user_12345", tier: "gold" },
});
```

```python Python theme={null}
client.memberships.update(
    "mem_xxxxxxxxxxxxx",
    metadata={"internal_user_id": "user_12345", "tier": "gold"},
)
```

```ruby Ruby theme={null}
client.memberships.update(
  id: "mem_xxxxxxxxxxxxx",
  metadata: { internal_user_id: "user_12345", tier: "gold" },
)
```

```rust Rust theme={null}
client
    .memberships
    .update(
        &"mem_xxxxxxxxxxxxx".to_string(),
        &UpdateMembershipsRequest {
            metadata: Some(HashMap::from([
                ("internal_user_id".to_string(), json!("user_12345")),
                ("tier".to_string(), json!("gold")),
            ])),
            ..Default::default()
        },
        None,
    )
    .await?;
```

```go Go theme={null}
if _, err := client.Memberships.Update(context.TODO(), &whopsdk.UpdateMembershipsRequest{
    ID: "mem_xxxxxxxxxxxxx",
    Metadata: map[string]any{
        "internal_user_id": "user_12345",
        "tier":             "gold",
    },
}); err != nil {
    log.Fatal(err)
}
```

## Yaşam döngüsü olaylarını dinleme

[Webhook'lar](https://docs.whop.com/tr/developer/guides/webhooks.md) aracılığıyla abone olun. Yaşam döngüsü boyunca tetiklenen olaylar şunlardır:

| Olay | Ne zaman tetiklenir |
| - | - |
| [`membership.activated`](https://docs.whop.com/tr/api-reference/memberships/membership-activated) | Üyelik geçerli hale gelir (ilk satın alma veya yenileme ödemesi başarılı olur). |
| [`membership.updated`](https://docs.whop.com/tr/api-reference/memberships/membership-updated) | Üyelikte bir şey değişti. Üyelik geçersiz hale geldi (başarısız ödeme, anında iptal, dönem sonu iptalinin gerçekleşmesi veya kullanıcının ayrılması). Kullanıcı iptali açtı veya kapattı. Satıcı faturalandırma dönemini, fiyatı veya yenileme tarihini düzenledi. `previous_attributes` değişiklikten önceki değerleri taşır. Etkinleştirmeler de `membership.updated` olarak iletilir. |

`pause` / `resume` / `extend` için üyelik durumu değişmez, bu nedenle hiçbir etkinleştirme/devre dışı bırakma olayı tetiklenmez. Değişikliğin başarılı olduğunu doğrulamanız gerekiyorsa çağrıdan sonra üyeliği getirin veya kendi takviminize göre yoklama yapın.

## Sonraki adımlar

> [card] [Ödeme kabul edin](https://docs.whop.com/tr/developer/guides/accept-payments.md)
>
> Üyeliklerin kaynağı. Tek seferlik ve yinelenen ödeme sayfaları.

> [card] [Ödeme yöntemlerini kaydedin](https://docs.whop.com/tr/developer/guides/save-payment-methods.md)
>
> Gelecekteki yenilemeler ve oturum dışı faturalandırma için kayıtlı kartlar.

> [card] [Webhook'ları dinleyin](https://docs.whop.com/tr/developer/guides/webhooks.md)
>
> Etkinleştirme, devre dışı bırakma ve iptal değişikliklerine tepki verin.

> [card] [Memberships API referansı](https://docs.whop.com/tr/api-reference/memberships/membership)
>
> Kaynağın tamamı: alanlar, durumlar ve her uç nokta.


## Related topics

- [Önceki sürümlerden geçiş yapın](https://docs.whop.com/tr/developer/api/migrate-from-previous-versions.md)
- [Yetkileri kontrol edin](https://docs.whop.com/tr/developer/guides/ios/check-entitlements.md)
- [Üyelik](https://docs.whop.com/tr/api-reference/legacy/memberships/membership.md)
