> ## 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 temel kavramları

> Whop API'sinin oluştuğu nesneler: her birinin ne olduğu, nasıl adlandırıldığı ve nasıl bağlandıkları.

Whop'un API'si, öngörülebilir şekillerde birbirine bağlanan az sayıda nesneden oluşur. Bu sayfa her birini tanımlar ve bir nesnenin birden fazla adla anıldığı yerlerde bunu açıkça belirtir.

```mermaid theme={null}
graph LR
  A[hesap<br/>biz_] --> P[ürün<br/>prod_]
  A --> K[API anahtarları]
  P --> L[varyant<br/>plan_]
  P --> E[deneyim<br/>exp_]
  U[kullanıcı<br/>user_] --> M[üyelik<br/>mem_]
  M --> P
  PAY[ödeme<br/>pay_] --> LG[defter<br/>ldgr_]
  LG --> PO[para çekme]
  LG --> T[transfer]
```

## Hesaplar ve kimlik

**account** `biz_`

Whop'taki bir işletme. API anahtarlarına, ürünlere, webhook'lara ve paraya sahiptir. Bkz. [Hesaplar](https://docs.whop.com/tr/api-reference/accounts/account).

**user** `user_`

Whop girişi olan bir kişi. Bir kullanıcı birçok hesaptan satın alabilir ve bir hesabın yönetimine de yardım edebilir. Bkz. [Kullanıcılar](https://docs.whop.com/tr/api-reference/users/user).

**team member**

Bir hesabı işletme erişimi verilmiş bir kullanıcı. Rolü neler yapabileceğini belirler. Bkz. [Ekip üyeleri](https://docs.whop.com/tr/api-reference/team-members/team-member).

**member**

Müşteri olarak görülen bir kullanıcı: hesabın sattığı bir şeye üyeliği olan veya bir zamanlar üyeliği olmuş biri. Bkz. [Üyeler](https://docs.whop.com/tr/api-reference/members/member).

### Alt hesap

Bir pazar yeri yürüttüğünüzde kaydettiğiniz ve adına işlem yaptığınız bir hesap. Onun adına ödemeleri tahsil eder ve ona ödeme yaparsınız. Platform kılavuzları bunu bazen alt satıcı (sub-merchant) olarak adlandırır. İki kelime aynı nesneyi ifade eder. [Platform hızlı başlangıcı](https://docs.whop.com/tr/developer/platforms/quickstart.md) tüm akışı adım adım anlatır.

**verification**

Bir hesabın ödeme alabilmesi için geçmesi gereken kimlik kontrolü. Bireyler Know Your Customer (KYC) kontrollerini, işletmeler ise Know Your Business (KYB) kontrollerini tamamlar. Bkz. [Doğrulamalar](https://docs.whop.com/tr/api-reference/verifications/verification).

**identity profile** `idpf_`

Bir doğrulamanın ürettiği doğrulanmış kimlik verilerinin kaydı.

## Sattıklarınız

Bir hesap ürün satar. Bir ürün, fiyatı belirleyen bir veya daha fazla varyant taşır ve bir alıcının gerçekte aldığı deneyimlere bağlanır.

**product** `prod_`

Bir hesabın sattığı şey. Açıklamayı, medyayı ve bir alıcının seçebileceği varyantları barındırır. Bkz. [Ürünler](https://docs.whop.com/tr/api-reference/products/product).

**variant** `plan_`

Bir ürünün kendi fiyatı, faturalandırma yapısı, stoğu, SKU'su ve özellikleri olan satın alınabilir bir yapılandırması. Varyant kimlikleri `plan_` önekini korur. Bkz. [Varyantlar](https://docs.whop.com/tr/api-reference/variants/variant).

**membership** `mem_`

Bir alıcının ödeme yaptığında aldığı şey. Bir kullanıcıyı bir varyanta bağlar ve erişimin şu anda geçerli olup olmadığını söyleyen bir durum taşır. Bkz. [Üyelikler](https://docs.whop.com/tr/api-reference/memberships/membership).

### Deneyim

Bir hesabın sattığı şeyin içindeki bir içerik veya işlevsellik birimi. Bir ürün bir veya daha fazla deneyime bağlanır ve o ürüne sahip bir üyelik, bunlara erişim sağlayan şeydir.

Bu, Whop'un platforma en özgü terimidir ve adından tahmin edemeyeceğiniz terimdir. Whop içinde çalışan bir uygulama geliştiriyorsanız, deneyim uygulamanızın içine render edildiği şeydir. Bkz. [Uygulama görünümleri](https://docs.whop.com/tr/developer/guides/app-views.md).

### Hak (entitlement)

Bir kullanıcının belirli bir şeyi şu anda kullanabileceğini söyleyen kayıt. Erişim sorudur, hak ise saklanan yanıttır. Bunu bir hesaba, bir ürüne veya bir deneyime karşı kontrol edin. Bkz. [Kimlik doğrulama](https://docs.whop.com/tr/developer/guides/authentication.md).

## Para nasıl hareket eder

Para gelir, bir yerde durur, sonra çıkar. Aşağıdaki her nesne bu yoldaki bir adımdır ve gerçekleştikleri sırayla listelenmiştir.

**checkout configuration** `ch_`

Bir satın almanın yeniden kullanılabilir tanımı: hangi varyant, hangi fiyatla, hangi yönlendirmeyle. Canlı bir ödeme sayfası üretir. Bkz. [Ödeme yapılandırmaları](https://docs.whop.com/tr/api-reference/checkout-configurations/checkout-configuration).

**payment** `pay_`

Bir alıcıdan bir hesaba para aktarmaya yönelik tek bir girişim; başarılı olup olmadığını söyleyen bir durum taşır.

**charge**

Aynı olayın kart ağı tarafından tanımlanması. Dokümantasyon her iki kelimeyi de kullanır. API nesnesi payment'tır.

### Defter (ledger)

Bir hesabın parası üzerindeki her alacak ve borç kaydının güncel kaydı. Bir hesabın neye sahip olduğu ve ona ne borçlu olunduğu konusunda doğruluk kaynağıdır. Para başka bir yere gitmeden önce bir deftere düşer. Bkz. [Defter etkinliği](https://docs.whop.com/tr/api-reference/ledgers/ledger-activity).

**balance**

Bir defterde şu anda bulunan, harcayabileceğiniz veya çekebileceğiniz tutar.

**reserve**

Whop'un gelecekteki iadelere ve itirazlara karşı tuttuğu bakiye dilimi. Bir programa göre serbest bırakılır.

**fee**

Para bir bakiyeye ulaşmadan önce alınan, Whop'un bir ödemeden aldığı pay.

**deposit**

Whop dışından bir bakiyeye eklenen para. Bkz. [Yatırmalar](https://docs.whop.com/tr/api-reference/deposits/deposit).

**payout**

Bir bakiyeden Whop dışındaki bir banka hesabına veya cüzdana çıkan para. Bkz. [Para çekmeler](https://docs.whop.com/tr/api-reference/payouts/payout).

**transfer**

Dış dünyaya dokunmadan Whop içindeki iki hesap arasında hareket eden para. Bkz. [Transferler](https://docs.whop.com/tr/api-reference/transfers/transfer).

**swap**

Bir bakiyenin desteklenen token'lar, zincirler veya cüzdan hedefleri arasında dönüştürülmesi. Bkz. [Takaslar](https://docs.whop.com/tr/api-reference/swaps/swap).

**card** `icrd_`

Bir hesap veya kullanıcı bakiyesinden harcama yapan, Whop tarafından verilen sanal kart. Bkz. [Kartlar](https://docs.whop.com/tr/api-reference/cards/card).

**refund**

Sizin başlattığınız, alıcıya iade edilen tamamlanmış bir ödeme.

**dispute**

Alıcının bankası tarafından alıcı adına geri çevrilen bir ödeme. Buna itiraz edebilirsiniz. Bkz. [İtirazlar](https://docs.whop.com/tr/api-reference/disputes/dispute).

## Whop üzerinde geliştirme

> [!NOTE]
>
> **Platform**, bu dokümantasyonda iki anlama gelir. Platform olarak Whop, entegre olduğunuz üründür. Pazar yeri anlamında bir platform ise, alt hesapları kaydedip onların satışlarından pay aldığınız andan itibaren *sizsiniz*. Hangisinin kastedildiğini çevreleyen cümle söyler.

**app** `app_`

Whop içinde çalışan ve pazar yeri aracılığıyla bir kitleye ulaşan yazılım. Bkz. [Uygulamalar](https://docs.whop.com/tr/api-reference/apps/app).

**app view**

Bir uygulamanın Whop içinde render ettiği tek bir ekran: müşteriye yönelik deneyim görünümü veya içerik üreticisine yönelik kontrol paneli görünümü. Bkz. [Uygulama görünümleri](https://docs.whop.com/tr/developer/guides/app-views.md).

**iframe**

Whop'un uygulamanızın sayfalarını kendi arayüzüne nasıl gömdüğü. Uygulamanız sizin sunucularınızda çalışır ve Whop'un çerçevesi içinde render edilir. Bkz. [iframe](https://docs.whop.com/tr/developer/guides/iframe.md).

**permission**

Bir API anahtarının kullanmasına izin verilen tek bir yetenek. Bkz. [İzinler](https://docs.whop.com/tr/developer/guides/permissions.md).

### Kapsam (scope)

İzinle aynı fikir, ancak bir OAuth token'ı üzerinde: bir kullanıcının uygulamanızın kendi adına yapabileceğini kabul ettiği şeyler kümesi. İzin, anahtarınızın yapabildiği şeydir. Kapsam, bir kullanıcının yapmanıza izin verdiği şeydir. Bkz. [OAuth kılavuzu](https://docs.whop.com/tr/developer/guides/oauth.md).

**OAuth grant**

Bir kullanıcının uygulamanızı bir kapsam kümesi için onayladığının kaydı.

**element**

Arayüzü kendiniz oluşturmamanız için Whop'un sunduğu ve kendi ürününüze yerleştirdiğiniz hazır bir kullanıcı arayüzü bileşeni.

**event**

Bir hesapta gerçekleşen bir şey, örneğin bir ödemenin başarılı olması.

**webhook**

Whop'un bir olayın gerçekleştiğini bildirmek için sunucunuza gönderdiği HTTP isteği. Bkz. [Webhook'lar](https://docs.whop.com/tr/developer/guides/webhooks.md).

## Topluluk

**chat channel**

Üyelerin birbirlerine mesaj gönderdiği bir oda. Bkz. [Sohbet](https://docs.whop.com/tr/developer/guides/chat/quickstart.md).

**message**

Bir sohbet kanalındaki veya bir doğrudan mesajdaki tek bir gönderi.

**forum**

Canlı sohbetten ayrı, daha uzun gönderiler için konu tabanlı bir alan. Bkz. [Forumlar](https://docs.whop.com/tr/developer/guides/forums.md).

**forum post**

Bir forumdaki yanıtları ve tepkileriyle birlikte tek bir konu.

**notification**

Whop içinde bir kullanıcıya gönderilen bir mesaj. Her gönderim tek bir deneyime veya tek bir kullanıcıya yönelik olur. Bkz. [Bildirimler](https://docs.whop.com/tr/developer/guides/notifications.md).

## Reklamcılık

**ad campaign** `adcamp_`

Bir reklam ağındaki ücretli reklamlar için üst düzey kapsayıcı. Platformu, hedefi ve bütçe stratejisini belirler. Bkz. [Reklam kampanyaları](https://docs.whop.com/tr/api-reference/ad-campaigns/ad-campaign).

**ad group** `adgrp_`

Bir kampanyanın içinde yer alır ve yayını kontrol eder: hedefleme, optimizasyon hedefi ve zaman planı. Bkz. [Reklam grupları](https://docs.whop.com/tr/api-reference/ad-groups/ad-group).

**ad** `ad_`

Bir reklam grubunun yayınladığı kreatif birim: metin, varlıklar ve hedef URL. Bkz. [Reklamlar](https://docs.whop.com/tr/api-reference/ads/ad).

**audience**

Whop'a yüklenen ve bir reklam grubunda kişileri hedeflemek veya hariç tutmak için kullanılan bir müşteri listesi. Bkz. [Kitleler](https://docs.whop.com/tr/api-reference/audiences/audience).

## Yönlendirmeler ve ödüller

**affiliate** `aff_`

Bir ürüne alıcı göndererek komisyon kazanan kişi. Bkz. [Satış ortakları](https://docs.whop.com/tr/developer/guides/affiliates.md).

**partner**

Whop'un ortaklık programına kayıtlı olan ve Whop'a yönlendirdiği işletmelerden kazanç elde eden bir kullanıcı. Bkz. [Ortaklar](https://docs.whop.com/tr/developer/partners/overview.md).

**referred business** `coma_`

Bir ortağın Whop'a getirdiği, kendisine uygulanan komisyon oranlarını ve yönlendirme süresini taşıyan bir işletme.

**partner earning**

Yönlendirilen bir işletme için, geldiği gelir kaynağını ve durumunu belirten tek bir komisyon satırı.

**bounty** `bnty_`

Ödülü yayınlandığı andan itibaren emanette tutulan ücretli bir görev. Bkz. [Ödül görevleri](https://docs.whop.com/tr/developer/bounties/overview.md).

**bounty submission** `btys_`

Bir çalışanın bir ödül görevindeki girişimi; girişimden incelemeye ve ödemeye kadar.

## Ortamlar ve anahtarlar

Whop iki ortam çalıştırır. Hiçbir şeyi paylaşmazlar.

| | Sandbox | Üretim |
| - | - | - |
| Para | Asla hareket etmez | Gerçek |
| Kontrol paneli | Ayrı | Ayrı |
| Anahtarlar | Kendi kümesi | Kendi kümesi |
| Veriler | Test verileri | Canlı veriler |

Nasıl geçiş yapılacağı için [Sandbox'ta test edin](https://docs.whop.com/tr/developer/guides/sandbox.md) sayfasına bakın.

> [!WARNING]
>
> Sandbox ve üretim anahtarları birbirinin aynısı görünür. Anahtar dizesindeki hiçbir şey hangi ortama ait olduğunu söylemez; bu nedenle bunları farklı adlar altında saklayın ve para hareket ettiren herhangi bir şeyi çalıştırmadan önce kontrol edin.

API'ye beş kimlik bilgisi türü ulaşır. Kimin verilerine ihtiyacınız olduğuna göre seçin.

| Kimlik bilgisi | Kimin adına hareket eder | Ne zaman kullanılır |
| - | - | - |
| API anahtarı | Hesabınız veya uygulamanız | Sunucunuz kendi işletmeniz veya uygulamanızı kuran her hesap üzerinde çalışıyorsa |
| Hesap kapsamlı kullanıcı token'ı | Tek bir hesap içindeki tek bir kullanıcı | Ürününüzün kendi kullanıcıları varsa ve bunlar Whop'a Whop oturumu açmadan ulaşıyorsa |
| Hesap erişim token'ı | Daraltılmış izinlerle hesabınız | Bir istemcinin API anahtarınızı tutmadan hesabınıza kısa süreli erişime ihtiyacı varsa |
| iframe kullanıcı token'ı | Uygulamanızı görüntüleyen kullanıcı | Uygulamanız Whop içinde render ediliyorsa ve ona kimin baktığını bilmeniz gerekiyorsa |
| OAuth token'ı | Whop'ta oturum açmış bir kullanıcı | Bir kullanıcı oturum açıp uygulamanızı onayladıysa |

Her birinin nasıl seçileceği ve kapsamlandırılacağı için [Kimlik doğrulama ve API anahtarları](https://docs.whop.com/tr/developer/guides/auth-scoping.md) sayfasına bakın.

**Api-Version-Date**

Sonraki değişikliklerin üzerine geliştirme yaptığınız yanıtları değiştirmemesi için entegrasyonunuzu API'nin tarihli bir sürümüne sabitleyen başlık. Bkz. [API sürümleme](https://docs.whop.com/tr/developer/api/versioning.md).

**idempotency key**

Bir `POST` isteğine eklediğiniz bir değer; böylece isteği yeniden denemek işi iki kez yapmak yerine orijinal yanıtı yeniden oynatır. Bkz. [Idempotent istekler](https://docs.whop.com/tr/developer/api/idempotency.md).

## Kimlik referansı

Her nesne önekli bir kimlik taşır. Bir yüke bakarken, bu tablo elinizde ne olduğunu söyler.

| Önek | Nesne | Bkz. |
| - | - | - |
| `biz_` | Hesap | [Hesaplar](https://docs.whop.com/tr/api-reference/accounts/account) |
| `user_` | Kullanıcı | [Kullanıcılar](https://docs.whop.com/tr/api-reference/users/user) |
| `prod_` | Ürün | [Ürünler](https://docs.whop.com/tr/api-reference/products/product) |
| `plan_` | Varyant | [Varyantlar](https://docs.whop.com/tr/api-reference/variants/variant) |
| `mem_` | Üyelik | [Üyelikler](https://docs.whop.com/tr/api-reference/memberships/membership) |
| `exp_` | Deneyim | [Uygulama görünümleri](https://docs.whop.com/tr/developer/guides/app-views.md) |
| `app_` | Uygulama | [Uygulamalar](https://docs.whop.com/tr/api-reference/apps/app) |
| `pay_` | Ödeme | [Genel bakış](https://docs.whop.com/tr/api-reference/overview.md) |
| `ch_` | Ödeme yapılandırması | [Ödeme yapılandırmaları](https://docs.whop.com/tr/api-reference/checkout-configurations/checkout-configuration) |
| `ldgr_` | Defter hesabı | [Defter etkinliği](https://docs.whop.com/tr/api-reference/ledgers/ledger-activity) |
| `idpf_` | Kimlik profili | [Doğrulamalar](https://docs.whop.com/tr/api-reference/verifications/verification) |
| `sacc_` | Harici hesap | [Harici hesaplar](https://docs.whop.com/tr/api-reference/external-accounts/external-account) |
| `aff_` | Satış ortağı | [Satış ortakları](https://docs.whop.com/tr/developer/guides/affiliates.md) |
| `adcamp_` | Reklam kampanyası | [Reklam kampanyaları](https://docs.whop.com/tr/api-reference/ad-campaigns/ad-campaign) |
| `adgrp_` | Reklam grubu | [Reklam grupları](https://docs.whop.com/tr/api-reference/ad-groups/ad-group) |
| `ad_` | Reklam | [Reklamlar](https://docs.whop.com/tr/api-reference/ads/ad) |
| `bnty_` | Ödül görevi | [Ödül görevleri](https://docs.whop.com/tr/developer/bounties/overview.md) |
| `btys_` | Ödül görevi gönderimi | [Ödül görevleri](https://docs.whop.com/tr/developer/bounties/overview.md) |
| `coma_` | Yönlendirilen işletme | [Ortaklar](https://docs.whop.com/tr/developer/partners/overview.md) |
| `icrd_` | Kart | [Kartlar](https://docs.whop.com/tr/api-reference/cards/card) |
| `course_` | Kurs | [Genel bakış](https://docs.whop.com/tr/api-reference/overview.md) |
| `file_` | Dosya | [Genel bakış](https://docs.whop.com/tr/api-reference/overview.md) |

## Sonraki adımlar

> [card] [Hızlı başlangıç](https://docs.whop.com/tr/developer/quickstart.md)
>
> Birkaç dakika içinde ilk API çağrınızı yapın.

> [card] [Sandbox'ta test edin](https://docs.whop.com/tr/developer/guides/sandbox.md)
>
> Canlıya geçmeden önce her şeyi test verileriyle deneyin.

> [card] [API genel bakışı](https://docs.whop.com/tr/api-reference/overview.md)
>
> İsteklerin, sürümlemenin ve sayfalamanın nasıl çalıştığı.

> [card] [Neler oluşturabilirsiniz](https://docs.whop.com/tr/developer/start.md)
>
> Tam yetenek haritası ve oluşturduğunuz şey için kılavuz.
