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

# Whop API Hızlı Başlangıç

> İlk Whop API çağrınızı yapın, bir ödeme sayfası oluşturun, bir test kartıyla ödeyin ve webhook'u alın; hepsi sandbox'ta. Ardından production ortamına geçin.

Bu hızlı başlangıç, paranın hiçbir zaman hareket etmediği ayrı bir Whop ortamı olan sandbox'ta çalışır. Bir sandbox API anahtarı alacak, ilk çağrınızı yapacak, bir ödeme sayfası oluşturacak, bunu bir test kartıyla ödeyecek ve `payment.succeeded` webhook'unu sunucunuzda alacaksınız. Canlıya geçmek son adımdır ve büyük ölçüde anahtarları değiştirmekten ibarettir.

> [!TIP]
>
> Bir kodlama ajanı kullanıyorsanız, ona bu sayfayı Markdown olarak (`https://docs.whop.com/developer/quickstart.md`) verin veya [Genel bakış](https://docs.whop.com/tr/developer/start.md#build-with-your-coding-agent) sayfasındaki istemi yapıştırın.

## Sandbox ve production

Whop, hiçbir şey paylaşmayan iki ortam çalıştırır: ne hesaplar, ne anahtarlar, ne ürünler, ne de webhook'lar. Sandbox'ta geliştirir, production'da yayına alırsınız. Aşağıdaki her değer bu iki ortam arasında değişir.

| | Sandbox: geliştirme ve test | Production: yayına alma |
| - | - | - |
| Para | Asla hareket etmez | Gerçek |
| Kontrol paneli | [sandbox.whop.com](https://sandbox.whop.com) | [whop.com](https://whop.com) |
| API anahtarları ve webhook'lar | [sandbox.whop.com/dashboard/developer](https://sandbox.whop.com/dashboard/developer) | [whop.com/dashboard/developer](https://whop.com/dashboard/developer) |
| API temel URL'si | `https://sandbox-api.whop.com/api/v1` | `https://api.whop.com/api/v1` |
| SDK ortamı | `Sandbox` | `Production`, SDK varsayılanı |
| Ödeme sayfaları | `sandbox.whop.com/checkout/...` | `whop.com/checkout/...` |
| `WHOP_ENVIRONMENT` | `sandbox` | `production` |

> [!WARNING]
>
> Sandbox ve production API anahtarları birebir aynı görünür; bu nedenle bir anahtardaki hiçbir şey hangi ortama ait olduğunu söylemez. Bu sayfadaki kod parçacıkları ortamı sabit kodlamak yerine bir `WHOP_ENVIRONMENT` değişkeninden seçer, böylece aynı kod her iki ortamda da çalışır. [Whop MCP sunucusu](https://docs.whop.com/tr/developer/ai/overview.md#mcp-server) yalnızca production verileri üzerinde işlem yapar.

## Bir sandbox API anahtarı alın

**1. Sandbox'a kaydolun**

[sandbox.whop.com](https://sandbox.whop.com) adresine gidin ve bir hesap oluşturun. Bu hesap, whop.com'daki herhangi bir hesabınızdan ayrıdır. Kayıt akışı ilk işletmenizi oluşturur; bu, API anahtarlarına, ürünlere, webhook'lara ve ödemelere sahip olan Hesaptır.

**2. Bir Hesap API anahtarı oluşturun**

[sandbox.whop.com/dashboard/developer](https://sandbox.whop.com/dashboard/developer) adresini açın. **Account API Keys** bölümünde **Create** seçeneğini seçin ve anahtara `Local development` gibi bir ad verin.

Bu hızlı başlangıç için Admin rolünü kullanın. Production'a geçmeden önce yalnızca çağırdığınız uç noktaları kapsayan özel bir izin setine geçin.

**3. Anahtarı sunucunuzda saklayın**

Whop anahtarı gösterdiğinde kopyalayın ve ait olduğu ortamla birlikte yerel `.env` dosyanıza koyun:

```bash theme={null}
WHOP_ENVIRONMENT=sandbox
WHOP_API_KEY=your_sandbox_key
```

![Bir anahtar adı, maskelenmiş değer ve Create düğmesini gösteren Whop kontrol paneli Account API Keys bölümü](https://mintcdn.com/whop/xuW6TKFlagvnbmV0/images/developer-api-key-field.png?fit=max\&auto=format\&n=xuW6TKFlagvnbmV0\&q=85\&s=699bf36af18f7a12dfd855eb0684b38e)

> [!NOTE]
>
> `WHOP_API_KEY` değerini sunucunuzda tutun. API anahtarlarını tarayıcı koduna, mobil uygulamalara veya herkese açık depolara koymayın. Sandbox ve production anahtarları birebir aynı göründüğünden, onları birbirinden ayırt edebileceğiniz şekilde adlandırın.

Sunucunuz kendi işletmeniz adına işlem yaptığında doğru seçim bir Hesap API anahtarıdır. Diğer işletmelerin yüklediği bir uygulama geliştirmek veya kullanıcıların Whop ile oturum açmasını sağlamak için [Kimlik doğrulama ve API anahtarları](https://docs.whop.com/tr/developer/guides/auth-scoping.md) sayfasına bakın.

## SDK'yı yükleyin

```bash TypeScript theme={null}
pnpm add @whop/sdk
```

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

```bash Ruby theme={null}
gem install whop_sdk
```

> [!NOTE]
>
> Bu sayfa SDK 2.7.0 veya üzerini gerektirir. Önceki sürümler ödeme yapılandırmalarında satır içi `variant` değerini kabul etmez.

## İlk çağrınızı yapın

İstemciyi `WHOP_ENVIRONMENT` içinde belirtilen ortama yönlendirin ve anahtarınızın arkasındaki hesabı getirin. Bu, anahtarın çalıştığını doğrular ve `biz_` ile başlayan hesap kimliğinizi yazdırır.

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

const apiKey = process.env.WHOP_API_KEY;

if (!apiKey) {
  throw new Error("Set WHOP_API_KEY");
}

const client = new WhopClient({
  token: apiKey,
  environment: process.env.WHOP_ENVIRONMENT === "production" ? WhopEnvironment.Production : WhopEnvironment.Sandbox,
});

const account = await client.accounts.me();

console.log(account.id);
```

```python Python theme={null}
import os
from whop_sdk import Whop, WhopEnvironment

client = Whop(
    token=os.environ["WHOP_API_KEY"],
    environment=WhopEnvironment.PRODUCTION if os.environ.get("WHOP_ENVIRONMENT") == "production" else WhopEnvironment.SANDBOX,
)

account = client.accounts.me()

print(account.id)
```

```ruby Ruby theme={null}
require "whop_sdk"

whop = Whop_sdk::Client.new(
  token: ENV.fetch("WHOP_API_KEY"),
  environment: ENV["WHOP_ENVIRONMENT"] == "production" ? Whop_sdk::Environment::PRODUCTION : Whop_sdk::Environment::SANDBOX,
)

account = whop.accounts.me

puts account.id
```

```bash curl (sandbox) theme={null}
curl https://sandbox-api.whop.com/api/v1/accounts/me \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-11-04-1"
```

```json Response (trimmed) theme={null}
{
	"id": "biz_XXXXXXXX",
	"title": "Acme Studio",
	"route": "acme-studio",
	"status": "active"
}
```

> [!TIP]
>
> Bu sizin sandbox hesabınız. Anahtar çalışıyor.

## Bir ödeme sayfası oluşturun

Tek bir çağrı bir varyant oluşturur ve `sandbox.whop.com` üzerinde barındırılan bir ödeme sayfası olan `purchase_url` değerini döndürür.

```typescript TypeScript theme={null}
const checkout = await client.checkoutConfigurations.create({
	variant: {
		title: "Starter",
		billing_type: "one_time",
		initial_price: 10.0,
		currency: "usd",
	},
});

console.log(checkout.purchase_url);
```

```python Python theme={null}
checkout = client.checkout_configurations.create(
    variant={
        "title": "Starter",
        "billing_type": "one_time",
        "initial_price": 10.0,
        "currency": "usd",
    },
)

print(checkout.purchase_url)
```

```ruby Ruby theme={null}
checkout = whop.checkout_configurations.create(
  variant: {
    title: "Starter",
    billing_type: "one_time",
    initial_price: 10.0,
    currency: "usd",
  },
)

puts checkout.purchase_url
```

Bu URL'yi ödeme adımında açacaksınız. Zaten bir varyantınız varsa, satır içi `variant` yerine kimliğini `variant_id` olarak iletin. İkisini birden gönderemezsiniz. [Create Checkout Configuration](https://docs.whop.com/tr/api-reference/checkout-configurations/create-a-checkout-configuration.md), yinelenen fiyatlandırma, deneme süreleri ve yönlendirme URL'leri dahil tüm seçenekleri listeler.

## Webhook'u dinleyin

`payment.succeeded` olayının ulaşacağı bir yer olması için ödeme yapmadan önce uç noktanızı kurun.

**1. Bir uç nokta ekleyin**

İmzayı doğrulayan ve olayı günlüğe kaydeden bir `POST` rotası ekleyin. Doğrulama ham istek gövdesini gerektirir, bu yüzden herhangi bir JSON ayrıştırmasından önce onu okuyun.

```typescript TypeScript + Next.js theme={null}
import { unwrapWebhook } from "@whop/sdk/helpers";
import type { NextRequest } from "next/server";

export async function POST(request: NextRequest): Promise<Response> {
  const event = unwrapWebhook<{ type: string; data: { id: string } }>(await request.text(), {
    headers: Object.fromEntries(request.headers),
    key: process.env.WHOP_WEBHOOK_SECRET!,
  });

  console.log(event.type, event.data.id);

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

```python Python + FastAPI 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):
    event = unwrap(await request.body(), headers=dict(request.headers), key=os.environ["WHOP_WEBHOOK_SECRET"])

    print(event["type"], event["data"]["id"])

    return Response(status_code=200)
```

```ruby Ruby on Rails theme={null}
class Api::WebhooksController < ApplicationController
  skip_before_action :verify_authenticity_token

  def whop
    event = WhopSDK::Helpers::VerifyWebhook.unwrap(
      request.raw_post,
      headers: {
        "webhook-id" => request.headers["webhook-id"],
        "webhook-timestamp" => request.headers["webhook-timestamp"],
        "webhook-signature" => request.headers["webhook-signature"],
      },
      key: ENV.fetch("WHOP_WEBHOOK_SECRET"),
    )

    Rails.logger.info("#{event[:type]} #{event[:data][:id]}")

    head :ok
  end
end
```

Geliştirme sırasında rotayı ngrok, Cloudflare Tunnel veya başka bir tünel ile HTTPS üzerinden erişilebilir hale getirin.

**2. Webhook'u sandbox kontrol panelinde oluşturun**

Sandbox kontrol panelinde **Developer > Webhooks** bölümünü açın, ardından **Create webhook** seçeneğini seçin. Uç noktanızın HTTPS adresini yapıştırın, API sürümünü `v1` olarak bırakın ve `payment.succeeded` olayını seçin.

![Olaylar listesinde payment\_succeeded olayının seçili olduğu webhook oluşturma formu](https://mintcdn.com/whop/RLIxcN4GVU-CLB5B/images/create-webhook-select-events.png?fit=max\&auto=format\&n=RLIxcN4GVU-CLB5B\&q=85\&s=079887392e21e4680a82415244aeaea4)

**3. İmzalama gizli anahtarını saklayın**

Gizli anahtarı webhook'un **Secret** sütunundan kopyalayın ve `ws_` öneki dahil, tam olarak gösterildiği gibi `.env` dosyasına ekleyin:

```bash theme={null}
WHOP_WEBHOOK_SECRET=ws_your_secret
```

Yeni değeri alması için sunucunuzu yeniden başlatın.

## Bir test kartıyla ödeyin

Ödeme sayfası adımındaki `purchase_url` adresini açın ve şu bilgilerle ödeyin:

| Alan | Değer |
| - | - |
| Kart numarası | `4242 4242 4242 4242` |
| Son kullanma tarihi | `12/34` gibi gelecekteki herhangi bir tarih |
| CVC | `123` gibi herhangi 3 rakam |
| Fatura adresi | Herhangi bir adres |

Birkaç saniye içinde sunucunuz `payment.succeeded` olayını ve `pay_` ile başlayan ödeme kimliğini günlüğe kaydeder.

> [!TIP]
>
> Bir ödeme aldınız ve webhook'unu uçtan uca işlediniz. Hiçbir ücret tahsil edilmedi.

Reddedilen bir kartı veya 3D Secure'u test etmek için [Test kartları](https://docs.whop.com/tr/developer/guides/sandbox.md#test-cards) bölümündeki diğer numaraları kullanın. Hiçbir şey gelmezse, kontrol panelindeki webhook'un teslimat günlüğünü ve [Webhook teslimatı](https://docs.whop.com/tr/developer/troubleshooting.md#webhook-delivery) bölümünü kontrol edin.

## Canlıya geçin

Sandbox ve production hiçbir şey paylaşmaz; bu nedenle canlıya geçmek, kurulumu whop.com üzerinde production kimlik bilgileriyle tekrarlamak anlamına gelir. Kodunuz değişmez. Yalnızca ortamınızdaki değerler değişir.

**1. Bir production anahtarı oluşturun**

[whop.com](https://whop.com/start) adresinde oturum açın, [whop.com/dashboard/developer](https://whop.com/dashboard/developer) adresini açın ve yalnızca entegrasyonunuzun kullandığı izinlere sahip bir Hesap API anahtarı oluşturun.

**2. Her değeri production karşılığıyla değiştirin**

Production ortamınızda üç değişkenin hepsini production değerlerine ayarlayın. Bir sandbox anahtarını veya gizli anahtarını asla production'da yeniden kullanmayın; tersini de yapmayın.

```bash Sandbox theme={null}
WHOP_ENVIRONMENT=sandbox
WHOP_API_KEY=your_sandbox_key
WHOP_WEBHOOK_SECRET=ws_your_sandbox_secret
```

```bash Production theme={null}
WHOP_ENVIRONMENT=production
WHOP_API_KEY=your_production_key
WHOP_WEBHOOK_SECRET=ws_your_production_secret
```

API'yi doğrudan çağırıyorsanız, temel URL'yi `https://api.whop.com/api/v1` olarak değiştirin.

**3. Sandbox'ta oluşturduklarınızı yeniden oluşturun**

Ürünler, varyantlar, ödeme yapılandırmaları ve webhook'lar aktarılmaz. Production webhook'unu production URL'nize göre oluşturun ve yeni imzalama gizli anahtarını saklayın.

**4. API sürümünüzü sabitleyin**

SDK, karşısında derlendiği sürümü gönderir. API'yi doğrudan çağırıyorsanız, sonraki değişikliklerin yanıtlarınızı değiştirmemesi için her istekte `Api-Version-Date` gönderin. Bkz. [API sürümleme](https://docs.whop.com/tr/developer/api/versioning.md).

> [!WARNING]
>
> Production ödeme bağlantıları gerçek para tahsil eder. Ücret oluşturan veya bakiye taşıyan herhangi bir şeyi çalıştırmadan önce hangi anahtarı kullandığınızı kontrol edin.

## Şimdi asıl amacınız olanı geliştirin

> [card] [Abonelik veya tek seferlik bir ürün satıyorsunuz](https://docs.whop.com/tr/developer/guides/accept-payments.md)
>
> Ödeme bağlantıları, Checkout öğesi, varyantlar ve deneme süreleri.

> [card] [Sizden başka kişilere borçlusunuz](https://docs.whop.com/tr/developer/platforms/manual-payouts.md)
>
> Ödemeler, transferler, bakiyeler ve ödeme portalı.

> [card] [Başkalarının sattıklarından pay alıyorsunuz](https://docs.whop.com/tr/developer/platforms/quickstart.md)
>
> Alt hesaplar, onlar adına tahsilat ve onlara ödeme yapma.

> [card] [Yalnızca altyapı değil, dağıtım da istiyorsunuz](https://docs.whop.com/tr/developer/guides/app-views.md)
>
> Kimlik doğrulama, görünümler ve CLI ile Whop içinde çalışan uygulamalar.

> [card] [Ürününüz insanların birbiriyle konuşmasını gerektiriyor](https://docs.whop.com/tr/developer/guides/chat/quickstart.md)
>
> Yerleştirebileceğiniz sohbet, DM'ler ve forumlar.

> [card] [Sadece referansı okumak istiyorsunuz](https://docs.whop.com/tr/api-reference/overview.md)
>
> Current API'deki her kaynak, her uç noktada bir deneme alanıyla birlikte.


## Related topics

- [Sohbet Hızlı Başlangıcı](https://docs.whop.com/tr/developer/guides/chat/quickstart.md)
- [Whop API temel kavramları](https://docs.whop.com/tr/developer/concepts.md)
- [Platform Hızlı Başlangıcı](https://docs.whop.com/tr/developer/platforms/quickstart.md)
