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

# Bir ödül görevi programı yürütün

> API üzerinden ücretli ödül görevleri yayınlayın, emaneti bir hesap bakiyesinden fonlayın, tekrarları planlayın, gönderimleri alıp inceleyin ve ödül görevlerini iptal edin.

Kendi ürününüzden ücretli görevler yayınlayın, bunları bir hesabın bakiyesinden fonlayın ve gönderim kuyruğunu kendi arayüzünüze çekin. Bu kılavuz tüm döngüyü kapsar: bir ödül görevi oluşturma, iş alma, inceleme ve iptal etme.

> [!NOTE]
>
> Bir ödül görevi yayınlamak para hareketi gerektirdiğinden `bounty:create` ve `payout:transfer_funds` izinlerine sahip bir API anahtarına ihtiyacınız vardır. Gönderimleri okumak için `bounty:basic:read` gerekir.

## Bir ödül görevi yayınlayın

[`POST /bounties`](https://docs.whop.com/tr/api-reference/bounties/create-bounty) bir `title`, bir çalışanın izleyeceği talimatları içeren bir `description` ve bir `gross_reward_amount` gerektirir.

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

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

const bounty = await client.bounties.create({
	title: "Clip our launch stream",
	description: "Cut a 30 to 60 second vertical clip and post it to TikTok. Include the product name in the caption.",
	gross_reward_amount: 25,
	accepted_submissions_limit: 4,
	business_goal_type: "clipping",
	account_id: "biz_XXXXXXXX",
	allowed_country_codes: ["US", "CA"],
});

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

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

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

bounty = client.bounties.create(
    title="Clip our launch stream",
    description="Cut a 30 to 60 second vertical clip and post it to TikTok. Include the product name in the caption.",
    gross_reward_amount=25,
    accepted_submissions_limit=4,
    business_goal_type="clipping",
    account_id="biz_XXXXXXXX",
    allowed_country_codes=["US", "CA"],
)

print(bounty.id)
```

### Ödülün size maliyeti

`gross_reward_amount`, ödül görevi başına değil, **kabul edilen gönderim başına** tam ABD doları cinsindendir. `accepted_submissions_limit` kaç gönderimin kazanabileceğini belirler ve varsayılan değeri `1`'dir. Whop bu ikisinin çarpımını emanete alır ve bu toplam en az 5 $olmalıdır. Yukarıdaki örnek 100$ emanete alır.

Platform ücretleri ve satış ortağı payları üzerine eklenmek yerine brüt tutardan düşülür, bu nedenle 25 $'lık bir ödül fonlayana 25 $'a mal olur.

### Paranın kaynağı

Havuz varsayılan olarak çağıranın kişisel bakiyesinden çekilir. Bunun yerine bir hesabın bakiyesinden fonlamak için `account_id` geçirin; bu, o hesabın fonlarını hareket ettirme izni gerektirir.

### Ödül görevinin bulunduğu yer

`experience_id`, bir ödül görevini belirli bir deneyime yerleştirir: açık bir ödül görevi için herkese açık, davetli bir ödül görevi için özel; ve **`account_id` ayarlamadığınız sürece zorunludur**. `account_id` ayarlayıp deneyimi atladığınızda, ödül görevi o hesabın herkese açık forumuna bağlanır.

### Hedefi belirtme

`business_goal_type`, işin neyi başarmayı amaçladığını belirtir ve bunu ödül görevini oluştururken bir kez belirtirsiniz. `clipping`, `post_engagement`, `owned_account_growth`, `ugc_content`, `local_activation`, `data_capture` veya `other` değerlerini alır.

`capture_spec` yalnızca hedef `data_capture` olduğunda kabul edilir. Başka bir hedefle gönderilmesi başarısız olur.

## Planlayın ve tekrarlayın

Bir ödül görevi, `publish_at` ayarlamadığınız sürece oluşturduğunuz anda yayınlanır. Whop onu gizli bir taslak olarak oluşturur, ardından belirttiğiniz zamanda fonlar ve yayınlar. `publish_at` ayarlandığında `publish_at_timezone` zorunludur.

`frequency`, planlanmış bir ödül görevini yinelenen bir göreve dönüştürür. Varsayılan değeri `once`'dır, `hourly`, `daily`, `weekly` veya `monthly` değerlerini alır ve **yalnızca `publish_at` ile birlikte uygulanır**. Her tekrar, kendi gönderimleri ve kendi emaneti olan ayrı bir ödül görevidir.

```typescript TypeScript theme={null}
const weekly = await client.bounties.create({
	title: "Weekly product clip",
	description: "One vertical clip per week featuring a different product from the catalog.",
	gross_reward_amount: 50,
	account_id: "biz_XXXXXXXX",
	business_goal_type: "clipping",
	publish_at: "2026-09-01T15:00:00Z",
	publish_at_timezone: "America/New_York",
	frequency: "weekly",
});
```

```python Python theme={null}
weekly = client.bounties.create(
    title="Weekly product clip",
    description="One vertical clip per week featuring a different product from the catalog.",
    gross_reward_amount=50,
    account_id="biz_XXXXXXXX",
    business_goal_type="clipping",
    publish_at="2026-09-01T15:00:00Z",
    publish_at_timezone="America/New_York",
    frequency="weekly",
)
```

## Bir ödül görevini düzenleyin

[`PATCH /bounties/{id}`](https://docs.whop.com/tr/api-reference/bounties/update-bounty) uç noktasının neyi kabul ettiği, ödül görevinin yayınlanıp yayınlanmadığına bağlıdır. **Planlanmış bir taslak** her şeyi kabul eder: ödülü, kazanan yuvalarını, planı ve içerik alanlarını.

**Yayınlanmış bir ödül görevi** yalnızca içeriği, yani `title`, `description`, `allowed_country_codes` ve `business_goal_type` değerlerini kabul eder. Ödül görevi girişim kabul etmeyi bıraktığında veya herhangi bir gönderim `submitted` ya da `approved` durumuna ulaştığında bunlar bile reddedilir. Bir ödül görevi yayınlandığında ödül, kazanan yuvaları ve plan sabitlenir.

`accepted_submissions_per_user_limit`, bir çalışanın kaç yuva kazanabileceğini sınırlar. Varsayılan değeri `1`'dir, `accepted_submissions_limit` değerini aşamaz ve bir çalışan aynı anda bir girişim yürütür.

## Gönderimleri alın

[`POST /bounty_submissions`](https://docs.whop.com/tr/api-reference/bounty-submissions/create-bounty-submission), `bounty_id` ve bir `deliverable` alır. `urls`, `file_ids` ve bir `caption` değerini **en az bir bağlantı veya bir dosya** olacak şekilde birleştirin. Whop boş bir teslimatı reddeder. Standart bir ödül görevinde bu tek çağrı çalışanın tüm akışıdır ve gönderim doğrudan incelemeye gider. Gönderimler bir kullanıcı kimlik bilgisi gerektirir, bu nedenle bir Account API anahtarı gönderim oluşturamaz.

```typescript TypeScript theme={null}
const submission = await client.bountySubmissions.create({
	bounty_id: "bnty_XXXXXXXX",
	deliverable: {
		urls: ["https://www.tiktok.com/@creator/video/1234567890"],
		file_ids: ["file_XXXXXXXX"],
		caption: "Vertical cut, 42 seconds.",
	},
});
```

```python Python theme={null}
submission = client.bounty_submissions.create(
    bounty_id="bnty_XXXXXXXX",
    deliverable={
        "urls": ["https://www.tiktok.com/@creator/video/1234567890"],
        "file_ids": ["file_XXXXXXXX"],
        "caption": "Vertical cut, 42 seconds.",
    },
)
```

`allowed_country_codes`, bir ödül görevinde kimlerin çalışabileceğini kısıtlar. ISO 3166 alpha-2 kodlarını alır. Boş bir liste dünya genelinde anlamına gelir.

Bir çalışan kendi girişimini [`DELETE /bounty_submissions/{id}`](https://docs.whop.com/tr/api-reference/bounty-submissions/cancel-bounty-submission) ile geri çekebilir. Bunu yalnızca girişimi başlatan çalışan yapabilir ve bir Account API anahtarı bunu onun adına yapamaz.

### Entegrasyonunuzun tamamlayamayacağı hedefler

İki hedef türü kanıtlarını API dışında biriktirir. Bir `data_capture` ödül görevinde gönderimi bir teslimat **olmadan** oluşturun: bu, kliplerinin sunucu tarafında biriktiği talep edilmiş bir girişim başlatır. Bir canlı yayın ödül görevinin kanıtı, herkese açık API'nin sunmadığı bir yüzey üzerinden ilerler. Entegrasyonunuz bu ödül görevlerini yayınlayabilir ve kuyruklarını okuyabilir, ancak çalışan girişimi Whop'ta tamamlar.

## Kuyruğu inceleyin

Gönderimleri `bounty_id` ve isteğe bağlı olarak `status` ile filtrelenmiş şekilde [`GET /bounty_submissions`](https://docs.whop.com/tr/api-reference/bounty-submissions/list-bounty-submissions) ile okuyun.

```typescript TypeScript theme={null}
const queue = await client.bountySubmissions.list({
	bounty_id: "bnty_XXXXXXXX",
	status: "submitted",
});

for (const submission of queue.data) {
	console.log(submission.id, submission.status);
}
```

```python Python theme={null}
queue = client.bounty_submissions.list(
    bounty_id="bnty_XXXXXXXX",
    status="submitted",
)

for submission in queue.data:
    print(submission.id, submission.status)
```

Bir gönderim dört durumdan geçer:

| `status` | Anlamı |
| - | - |
| `in_progress` | Henüz kanıt göndermemiş etkin bir girişim |
| `submitted` | Bir karar bekliyor |
| `approved` | Kabul edildi ve emanetteki ödül ödenir |
| `denied` | Reddedildi. Sunulabilir bir neden varsa `denial_reason` bu nedeni taşır, yoksa `null` olur |

> [!WARNING]
>
> Onaylama ve reddetme Whop kontrol panelinde gerçekleşir. API'de onaylama veya reddetme işlemi yoktur; bu nedenle ürününüz kuyruğu ve sonuçlarını gösterebilir, ancak kararı Whop'ta bir kişi verir.

Ödül görevleri webhook yaymaz. Sonuçları kendi ürününüze yansıtmak için ödül görevine göre filtrelenmiş `GET /bounty_submissions` uç noktasını yoklayın. Bir kişinin incelediği bir kuyruk için dakikada bir uygundur. Bir ödül görevinde yakın zamanda etkinlik yoksa birkaç dakikada bire düşürün.

## Bir ödül görevini iptal edin

[`POST /bounties/{id}/cancel`](https://docs.whop.com/tr/api-reference/bounties/cancel), işlemde olan bir iş yoksa fonlayana hemen iade yapar. İncelemede bir iş varsa yeni gönderimleri durdurur ve o iş sonuçlanıp ödendikten sonra iptal eder.

İsteği tekrarlamak hiçbir şey yapmaz. Tüm yuvaları zaten ödenmiş bir ödül görevi `400` döndürür.

## Doğrulamayı geçip yine de başarısız olan istekler

İstek şemasının ifade edemediği dört kural. Gövde doğru biçimlendirilmiş olsa bile her biri bir hata döndürür:

* `account_id` ayarlanmamışken `experience_id` atlanması.
* `frequency` değerinin `publish_at` olmadan gönderilmesi.
* `business_goal_type` değeri `data_capture` dışında bir şeyken `capture_spec` gönderilmesi.
* Ne bağlantı ne de dosya içeren bir `deliverable`.

## Sonraki adımlar

> [card] [Ödül görevlerine genel bakış](https://docs.whop.com/tr/developer/bounties/overview.md)
>
> Nesneler ve birbirleriyle nasıl uyum sağladıkları.

> [card] [Dosya yükleyin](https://docs.whop.com/tr/developer/guides/upload-files.md)
>
> Bir teslimatın başvurduğu dosya kimliklerini alın.

> [card] [Ödül görevleri referansı](https://docs.whop.com/tr/api-reference/bounties/bounty)
>
> Her uç nokta için istek ve yanıt yapıları.

> [card] [Ödül görevi gönderimleri referansı](https://docs.whop.com/tr/api-reference/bounty-submissions/retrieve-bounty-submission.md)
>
> Gönderim nesnesi ve filtreleri.


## Related topics

- [Ödül görevleri](https://docs.whop.com/tr/developer/bounties/overview.md)
- [Ödül Görevi Gönderimleri API'si](https://docs.whop.com/tr/api-reference/bounty-submissions/bounty-submission.md)
- [Ödül Görevleri API'si](https://docs.whop.com/tr/api-reference/bounties/bounty.md)
