> ## 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 Partners API

> İşletmeleri Whop'a yönlendirin ve onların etkinliklerinden kazanç elde edin; bir yönlendirme bağlantısı ve API'den okuyabileceğiniz kazançlarla.

Yönlendirme sürdüğü müddetçe dört ayrı gelir kaynağından kazanç elde edersiniz. Tek bir çağrı sizi kaydeder ve bağlantınızı döndürür. Geri kalan her şey neleri yönlendirdiğinizi ve ne kazandığınızı raporlar.

## Neler oluşturabilirsiniz

* Kendi bağlantınızı kendi kitlenizle paylaştığınız, **kendi yürüttüğünüz bir yönlendirme programı**.
* **Yönlendirdiklerinize dair raporlama**: hangi işletmelerin ve kullanıcıların hâlâ aktif olduğu ve her birinin ne ürettiği.
* Her satırın arkasındaki işleme ve orana kadar ayrıntılandırılmış **kazanç dökümleri**.
* Partner liderlik tablosundan **herkese açık bir sıralama sayfası**.

## Temel nesneler

Partner, yönlendirilen işletme, partner kazancı. Her biri [Temel Kavramlar](https://docs.whop.com/tr/developer/concepts.md) sayfasında tanımlanmıştır.

## Kayıt olma

[`POST /partners`](https://docs.whop.com/tr/api-reference/partners/enroll-as-a-whop-partner), çağrıyı yapan kullanıcıyı kaydeder ve partner işletmelerini kazanç için uygun hâle getirir. Kredilendirilmek için paylaştığınız URL olan `referral_link` değerini ve `whop_partner_enabled_at` değerini döndürür. Tekrar kayıt olmak, orijinal kayıt zamanını sıfırlamak yerine korur; çağrıyı tekrarlamayı güvenli kılan da budur.

`partner:create` iznini gerektirir. Yönlendirmeleri ve kazançları okumak `partner:basic:read` gerektirir; yönlendirilen işletmeleri listelemek ise `referral:basic:read` iznini de kabul eder. Bkz. [İzinler](https://docs.whop.com/tr/developer/guides/permissions.md).

## Neyden kazanırsınız

Yönlendirilen bir işletmedeki `payout_percentages`, gelir kaynağı başına oranınızı kesir olarak verir; yani `0.3` %30 anlamına gelir. Dört kaynaktan üçü Whop'un brüt kârından bir paydır. Reklam harcaması istisnadır ve harcamanın kendisinden bir paydır.

| `income_source` | Payınız şunun üzerindendir |
| - | - |
| `sales` | Whop'un işletmenin ürün satışlarından elde ettiği kâr |
| `ad_spend` | İşletmenin Whop Ads harcaması |
| `transfer` | Whop'un platform bakiye transferlerinden elde ettiği kâr |
| `card_interchange` | Whop'un kart interchange ücretlerinden elde ettiği kâr |

Bir partner işletmesi için kapatılmış bir işletmede bu oran ekibe aittir. [`GET /partners/businesses/:id`](https://docs.whop.com/tr/api-reference/partners/retrieve-a-referred-business) ayrıca her orandan kendi payınız olan `my_payout_percentages` değerini de döndürür. İşletmeyi kendiniz yönlendirdiyseniz bu, oranın tamamıdır. Bir partner işletmesinin anlaşmasında ise oranın ekip payınızdır. Bir yönetici, kendi payından altındaki kişinin payı düşülmüş tutarı kazanır; bir anlaşma katılımcısı ise kendi payını kazanır. İşletmeden hiçbir şey kazanmıyorsanız değer `null` olur.

[`GET /partners/businesses`](https://docs.whop.com/tr/api-reference/partners/list-referred-businesses), yönlendirdiğiniz her şeyi en yeniden başlayarak listeler. Her partner işletmesi bir `coma_` kimliği, `active` veya `removed` değerinde bir `status` ile `referral_started_at` ve `referral_expires_at` alanlarını taşır.

`earnings_usd` ve `volume_usd` tek sayılar değil nesnelerdir. `earnings_usd`; `completed`, `pending` ve `total` olarak ayrılır. `volume_usd` ise `attributed`, `awaiting_settlement` ve `settled` olarak ayrılır.

## Kazançları okuma

[`GET /partners/businesses/{id}/earnings`](https://docs.whop.com/tr/api-reference/partners/list-referred-business-earnings), Whop'un tek bir işletme için size ne ödediğini kalem kalem listeler. Her kazanç kendi `income_source` değerini, kaynaklandığı `transaction_amount_usd` tutarını ve `payout_percentage` oranınızı belirtir.

Kazançlar ödenmeden önce mutabakata girer. Bu gerçekleşene kadar hem `commission_amount_usd` hem de `payout_percentage` `null` olur.

| `status` | Anlamı |
| - | - |
| `awaiting_settlement` | Temel işlemin mutabakatı henüz yapılmadı |
| `pending` | Mutabakatı yapıldı, henüz ödenmedi |
| `completed` | Ödendi |
| `canceled` | Ödemeden önce iptal edildi, `cancelation_reason` ile birlikte |
| `reversed` | Sonradan geri alındı, `cancelation_reason` ile birlikte |

Verinin mevcut olduğu durumlarda `financial_activity`, komisyonun arkasındaki gelir ve maliyet satırlarını ayrıntılı gösterir. Whop bu ayrıntıyı kaydetmeye başlamadan önce mutabakatı yapılan kazançlar için `null` olur.

## Liderlik tablosu

[`GET /partners/leaderboard`](https://docs.whop.com/tr/api-reference/partners/retrieve-the-leaderboard), yönlendirenleri partner kazançlarına göre sıralar. `period` parametresi `day`, `month`, `year`, `last_30_days` veya `all_time` değerlerini alır ve varsayılan olarak `all_time` kullanılır.

Kimlik doğrulama isteğe bağlıdır. Anonim çağıranlar sıralamaları `leaders` içinde alır; kimliği doğrulanmış çağıranlar ise kendi sıralamalarını da `me` içinde alır. Henüz yönlendirme kazancınız yoksa bu değer `null` olur.

## Sonraki adımlar

> [card] [Partner olarak kaydolun](https://docs.whop.com/tr/api-reference/partners/enroll-as-a-whop-partner.md)
>
> Katılmak ve yönlendirme bağlantınızı almak için tek bir çağrı.

> [card] [Yönlendirmelerinizi listeleyin](https://docs.whop.com/tr/api-reference/partners/list-referred-businesses.md)
>
> Getirdiğiniz her işletme, kazançlarıyla birlikte.

> [card] [Satış ortakları](https://docs.whop.com/tr/developer/guides/affiliates.md)
>
> Kendi ürünlerinizin içinde yönlendirme takibi.

> [card] [Partners referansı](https://docs.whop.com/tr/api-reference/partners/partner)
>
> Her partner uç noktası, bir deneme alanıyla birlikte.


## Related topics

- [Partners API](https://docs.whop.com/tr/api-reference/partners/partner.md)
- [Enroll as a Whop Partner](https://docs.whop.com/tr/api-reference/partners/enroll-as-a-whop-partner.md)
- [Whop API'ye Genel Bakış](https://docs.whop.com/tr/api-reference/overview.md)
