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

# SaaS

> Yazılımınızı Whop'ta satın. Bir web uygulamasını her kullanıcının erişimini kontrol ederek, indirilebilir yazılımları ise lisans anahtarlarıyla koruyun.

Whop, yazılımınız için ödeme, faturalandırma ve abonelik yönetimini yürütür. Uygulamanız birini içeri almadan önce, müşterinin şu anda erişimi olup olmadığını Whop ile kontrol eder. Bu sayfa, bu kontrolü yapmanın iki yolunu gösterir.

## Entegrasyonunuzu seçin

| | Erişim kontrolü | Lisans anahtarları |
| - | - | - |
| **En uygun olduğu durum** | Kullanıcıların sitenizde oturum açtığı bir web uygulaması | Kullanıcıların indirdiği masaüstü uygulamaları, betikler ve araçlar |
| **Müşteriyi tanımlayan şey** | Kullanıcı kaydınızda saklanan Whop kullanıcı kimliği | Whop'un her satın alımla verdiği bir lisans anahtarı |
| **Sunucunuzun çağırdığı şey** | `users.checkAccess` | `memberships.retrieve` ve `memberships.update` |
| **Tek bir makineyle sınırlama** | Hayır | Evet, üyelik meta verilerindeki bir donanım kimliğiyle |

Her iki yol da aynı kurulumu paylaşır.

## Kurulum

### 1. Whop'unuzu ve bir ürün oluşturun

Whop'unuza bir ad vermek ve URL'sini seçmek için [whop.com/sell](https://whop.com/dashboard/start/) adresinden başlayın. Ardından kontrol panelinizde **Products** bölümüne gidin ve müşterilerinizin ödeyeceği fiyatla bir ürün ekleyin. Ürün kimliğini (`prod_`) ve plan kimliğini (`plan_`) kopyalayın. Aşağıda ikisine de ihtiyacınız olacak.

### 2. Bir API anahtarı oluşturun

Kontrol panelinizde **Developer → API keys** bölümüne gidin ve bir hesap API anahtarı oluşturun. Anahtar işletmeniz adına işlem yapar, bu yüzden onu sunucunuzda tutun ve asla istemci kodunda veya indirilebilir bir uygulamada yayınlamayın. `WHOP_API_KEY` olarak saklayın.

### 3. SDK'yı kurun

```bash npm theme={null}
npm install @whop/sdk
```

```bash pip theme={null}
pip install whop-sdk
```

Bir istemci oluşturun ve yeniden kullanın. Bu sayfadaki örnekler ona `client` adını verir.

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

export const client = new WhopClient({ token: process.env.WHOP_API_KEY });
```

```python Python theme={null}
import os

from whop_sdk import Whop

client = Whop(token=os.environ["WHOP_API_KEY"])
```

## E-posta ile giriş entegrasyonu

Müşteriler kendi web uygulamanızda oturum açtığında bu yolu kullanın. Her müşterinin Whop kullanıcı kimliğini kullanıcı kaydınızda saklayın, ardından ücretli özellikleri sunmadan önce bu kimlikle erişimi kontrol edin.

### 1. Kullanıcı tablonuza Whop sütunları ekleyin

| Sütun | Tür | Açıklama |
| - | - | - |
| `whop_user_id` | string | Müşterinin `user_` önekli Whop kullanıcı kimliği. |
| `whop_username` | string | İsteğe bağlı. Müşterinin Whop kullanıcı adı. Arayüzünüzde ve günlüklerinizde gösterin. |

### 2. Oturum açmış kullanıcıları ödeme sayfasına gönderin

Sunucunuzdan bir ödeme yapılandırması oluşturun ve kendi kullanıcı kimliğinizi `metadata` içine koyun. Whop bu meta verileri üyeliğe kopyalar; bir sonraki adım satın alımı kullanıcınıza bu şekilde bağlar. Ardından kullanıcıyı `purchase_url` adresine yönlendirin.

```typescript TypeScript theme={null}
export async function startCheckout(userId: string) {
  const checkout = await client.checkoutConfigurations.create({
    variant_id: process.env.WHOP_VARIANT_ID!,
    metadata: { customer_id: userId },
    redirect_url: "https://yourapp.com/billing/return",
  });

  return checkout.purchase_url;
}
```

```python Python theme={null}
def start_checkout(user_id: str) -> str:
    checkout = client.checkout_configurations.create(
        variant_id=os.environ["WHOP_VARIANT_ID"],
        metadata={"customer_id": user_id},
        redirect_url="https://yourapp.com/billing/return",
    )

    return checkout.purchase_url
```

Bunun yerine alıcıları kendi sayfanızda tutmak için [Checkout öğesini gömün](https://docs.whop.com/tr/developer/guides/embed-checkout.md) ve aynı `metadata` değerini onun tutamacında geçirin. [Ödeme kabul etme](https://docs.whop.com/tr/developer/guides/accept-payments.md) sayfası tüm ödeme seçeneklerini karşılaştırır.

### 3. Whop kullanıcı kimliğini webhook'tan kaydedin

[Kontrol panelinizin Developer sekmesini](https://whop.com/dashboard/developer) açın, **Create webhook** seçeneğini seçin, `membership.activated` olayına abone olun ve imzalama gizli anahtarını `WHOP_WEBHOOK_SECRET` olarak saklayın. Olayın `data` değeri, alıcının `user_id` değerini ve ödeme sırasında ayarladığınız `metadata` değerini içeren üyeliktir.

```typescript TypeScript theme={null}
// app/api/webhooks/whop/route.ts
import { unwrapWebhook } from "@whop/sdk/helpers";
import type { NextRequest } from "next/server";

export async function POST(request: NextRequest) {
  // Verify the raw body. Parsing it first changes the bytes and the signature check fails.
  const event = unwrapWebhook(await request.text(), {
    headers: Object.fromEntries(request.headers),
    key: process.env.WHOP_WEBHOOK_SECRET!,
  });

  if (event.type === "membership.activated") {
    const customerId = event.data.metadata?.customer_id;
    if (customerId && event.data.user_id) {
      await db.users.update(customerId, { whop_user_id: event.data.user_id });
    }
  }

  return new Response("OK", { status: 200 });
}
```

```python Python theme={null}
import os

from fastapi import FastAPI, Request, Response
from whop_sdk.lib.verify_webhook import unwrap

app = FastAPI()


@app.post("/api/webhooks/whop")
async def whop_webhook(request: Request):
    # Verify the raw body. Parsing it first changes the bytes and the signature check fails.
    event = unwrap(await request.body(), dict(request.headers), os.environ["WHOP_WEBHOOK_SECRET"])

    if event["type"] == "membership.activated":
        membership = event["data"]
        customer_id = (membership.get("metadata") or {}).get("customer_id")
        if customer_id and membership.get("user_id"):
            db.users.update(customer_id, whop_user_id=membership["user_id"])

    return Response(status_code=200)
```

`membership.activated` yenilemelerde de tetiklenir, bu yüzden yazma işlemini tekrarlanmaya karşı güvenli hale getirin. [Webhook'lar](https://docs.whop.com/tr/developer/guides/webhooks.md) sayfası yeniden denemeleri ve testleri ele alır.

### 4. Ücretli özellikleri sunmadan önce erişimi kontrol edin

Kullanıcının ürününüze erişimi olup olmadığını Whop'a sorun. Yanıt yenilemeleri, iptalleri ve iadeleri izler, böylece faturalandırma durumunu kendiniz takip etmeniz gerekmez.

```typescript TypeScript theme={null}
export async function hasAccess(whopUserId: string) {
  const access = await client.users.checkAccess({
    id: whopUserId,
    resource_id: process.env.WHOP_PRODUCT_ID!,
  });

  return access.has_access;
}
```

```python Python theme={null}
def has_access(whop_user_id: str) -> bool:
    access = client.users.check_access(
        resource_id=os.environ["WHOP_PRODUCT_ID"],
        id=whop_user_id,
    )

    return access.has_access
```

Aynı yanıttaki `access_level` değeri `customer`, `admin` veya `no_access` olur.

### 5. Müşterilerin faturalandırmayı yönetmesine izin verin

Ödeme yöntemlerini güncellemeleri veya iptal etmeleri için müşterileri [Whop siparişlerine](https://whop.com/@me/settings/orders) yönlendirin. Satın alırken kullandıkları e-postayla oturum açarlar.

## Lisans anahtarı entegrasyonu

Müşterinin makinesinde çalışan yazılımlar için bu yolu kullanın. Her satın alım benzersiz bir lisans anahtarıyla gelir. Yazılımınız anahtarı ister ve sunucunuz onu Whop ile kontrol eder.

### 1. Ürününüze Software uygulamasını ekleyin

Whop'unuza [Software uygulamasını yükleyin](https://whop.com/apps/app_jHH5YT7jHYQANi/install/), açın ve yazılımınızın adını ve indirme bağlantısını ekleyin. Alıcılar daha sonra lisans anahtarlarını ve indirmeyi siparişlerinde görür. API, bir üyeliğin `license_key` değerini yalnızca ürünü bu uygulamayı içerdiğinde döndürür.

### 2. Anahtarları sunucunuzdan doğrulayın

Anahtarları asla yayınladığınız yazılımdan değil, kendi sunucunuzdan kontrol edin. API anahtarınız işletmenizdeki her üyeliği okuyabilir ve değiştirebilir, bu yüzden onu asla kullanıcıların indirdiği bir masaüstü uygulamasına veya betiğe gömmeyin. Yazılımınız lisans anahtarını ve bir makine tanımlayıcısını sunucunuza gönderir, sunucunuz da bunu Whop ile kontrol eder.

Her anahtarı tek bir makineyle sınırlamak için, biri anahtarı ilk kez kullandığında üyeliğin meta verilerinde bir donanım kimliği saklayın, ardından sonraki her kontrolde bunu karşılaştırın:

* **Anahtar henüz bağlanmamış** (meta verilerinde `hwid` yok): makinenin `hwid` değerini kaydedin ve erişim verin.
* **Saklanan `hwid` eşleşiyor:** erişim verin.
* **Saklanan `hwid` farklı:** erişimi reddedin. Müşteri sıfırlayana kadar anahtar başka bir makinede kullanımdadır.

```typescript TypeScript theme={null}
// Add "past_due" if you let customers keep access while Whop retries a failed renewal.
const VALID_STATUSES = ["active", "trialing", "completed"];

export async function validateLicense(licenseKey: string, hwid: string) {
  // Retrieve accepts a license key in place of a membership ID. An unknown key throws a 404 error.
  const membership = await client.memberships.retrieve({ id: licenseKey });

  if (!VALID_STATUSES.includes(membership.status)) {
    return { valid: false, reason: "membership_inactive" };
  }

  const boundHwid = membership.metadata?.hwid;

  if (!boundHwid) {
    // Update merges these keys into the existing metadata.
    await client.memberships.update({ id: membership.id, metadata: { hwid } });
    return { valid: true };
  }

  if (boundHwid !== hwid) {
    return { valid: false, reason: "bound_to_another_machine" };
  }

  return { valid: true };
}
```

```python Python theme={null}
# Add "past_due" if you let customers keep access while Whop retries a failed renewal.
VALID_STATUSES = {"active", "trialing", "completed"}


def validate_license(license_key: str, hwid: str) -> dict:
    # Retrieve accepts a license key in place of a membership ID. An unknown key raises a 404 error.
    membership = client.memberships.retrieve(license_key)

    if membership.status not in VALID_STATUSES:
        return {"valid": False, "reason": "membership_inactive"}

    bound_hwid = (membership.metadata or {}).get("hwid")

    if not bound_hwid:
        # Update merges these keys into the existing metadata.
        client.memberships.update(membership.id, metadata={"hwid": hwid})
        return {"valid": True}

    if bound_hwid != hwid:
        return {"valid": False, "reason": "bound_to_another_machine"}

    return {"valid": True}
```

### 3. Bir lisans anahtarını sıfırlayın

Müşteriler anahtarlarını siparişlerinden sıfırlayabilir. Sunucunuzdan sıfırlamak için [üyeliği](https://docs.whop.com/tr/api-reference/memberships/update-membership.md) boş bir meta veri nesnesiyle (`metadata: {}`) güncelleyin. Herhangi bir makineden yapılan bir sonraki kontrol anahtarı yeniden bağlar.

## Mağaza sayfanızı tasarlayın

Mağaza sayfanız, insanların satın almadan önce yazılımınız hakkında bilgi edindiği yerdir. Sol üstteki whop adınızı seçin, ardından düzenleyiciyi açmak için **Design store page** seçeneğini seçin. Özelleştirmek için **Edit details** seçeneğini seçin:

* **Ad ve başlık:** yazılımın ne yaptığını ve kimin için olduğunu söyleyin.
* **Açıklama:** çözdüğü soruna ve alıcıların güncellemeler, destek veya bir topluluk gibi neler elde ettiğine odaklanın.
* **Logo:** temiz, sade bir logo ekleyin.
* **Galeri görselleri veya video:** yazılımı kullanımda gösterin. Kısa bir demo videosu alıcıların karar vermesine yardımcı olur.
* **Kategori:** insanların Whop'a göz atarken yazılımınızı bulmasına yardımcı olacak kategoriyi seçin.

## Sonraki adımlar

> [card] [Ödeme kabul edin](https://docs.whop.com/tr/developer/guides/accept-payments.md)
>
> Ödeme bağlantılarını, Checkout öğesini ve ödeme öğelerini karşılaştırın.

> [card] [Webhook'lar](https://docs.whop.com/tr/developer/guides/webhooks.md)
>
> İmzaları doğrulayın, yeniden denemeleri işleyin ve olayları test edin.

> [card] [Üyelikleri yönetin](https://docs.whop.com/tr/developer/guides/memberships.md)
>
> Üyelikleri sunucunuzdan iptal edin, duraklatın, uzatın ve güncelleyin.

> [card] [Whop ile oturum açın](https://docs.whop.com/tr/developer/guides/oauth.md)
>
> Müşterilerin parola yerine Whop hesaplarıyla oturum açmasına izin verin.


## Related topics

- [Whop ile Başlayın](https://docs.whop.com/tr/get-started.md)
- [Whop Uygulamaları Nedir](https://docs.whop.com/tr/whop-apps/what-are-whop-apps.md)
