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

# Promosyon Kodları API'si

> Promosyon Kodu, alıcının ödeme sırasında girdiği, yüzde veya sabit tutarlı bir indirimdir.

Bir hesaba aittir, tek bir ürünle sınırlandırılabilir ve kimin, kaç kez, ne zamana kadar kullanabileceğini ve indirimin kaç faturalandırma dönemi boyunca süreceğini kontrol eder.

Promosyon Kodları API'sini bir hesap için kod oluşturmak, kodları listelemek ve almak, kullanımları duraklatmak için bir kodu devre dışı bırakmak veya yeniden etkinleştirmek ve artık sunmadığınız kodları arşivlemek için kullanın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Promosyon Kodlarını Listele](https://docs.whop.com/tr/api-reference/promo-codes/list-promo-codes.md) | GET `/promo_codes` |
| [Promosyon Kodunu Al](https://docs.whop.com/tr/api-reference/promo-codes/retrieve-promo-code.md) | GET `/promo_codes/{id}` |
| [Promosyon Kodu Oluştur](https://docs.whop.com/tr/api-reference/promo-codes/create-promo-code.md) | POST `/promo_codes` |
| [Promosyon Kodunu Etkinleştir](https://docs.whop.com/tr/api-reference/promo-codes/activate-promo-code.md) | POST `/promo_codes/{id}/activate` |
| [Promosyon Kodunu Devre Dışı Bırak](https://docs.whop.com/tr/api-reference/promo-codes/deactivate-promo-code.md) | POST `/promo_codes/{id}/deactivate` |
| [Promosyon Kodunu Sil](https://docs.whop.com/tr/api-reference/promo-codes/delete-promo-code.md) | DELETE `/promo_codes/{id}` |

## Öznitelikler

**id** `string` *required*

`promo_` önekli promosyon kodu kimliği.

**account** `object` *required*

Promosyon kodunun sahibi olan hesap.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `biz_` önekli hesap kimliği.
>
> **title** `string` *required*
>
> Hesabın görünen adı.

**affiliate** `object | null` *required*

Promosyon kodunu kullanan yönlendirmelerin atfedildiği satış ortağı veya bağlı bir satış ortağı yoksa `null`.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `aff_` önekli satış ortağı kimliği.
>
> **user** `object` *required*
>
> Satış ortağı olan kullanıcı.
>
> > [accordion] Özellikler
> >
> > **id** `string` *required*
> >
> > `user_` önekli satış ortağı kullanıcı kimliği.
> >
> > **name** `string | null` *required*
> >
> > Satış ortağının görünen adı.
> >
> > **profile\_pic** `string` *required*
> >
> > Avatar ayarlanmamışsa oluşturulan yedek görsel dahil, satış ortağının avatar URL'si.
> >
> > **username** `string | null` *required*
> >
> > Satış ortağının herkese açık kullanıcı adı.

**amount\_off** `number` *required*

İndirim tutarı. Yüzde indirimleri ondalık kesir olarak gösterilir.

**churned\_users\_only** `boolean` *required*

Promosyon kodunun ayrılmış müşterilerle sınırlı olup olmadığı.

**code** `string | null` *required*

Ödeme sırasında girilen kod.

**created\_at** `string` *required*

Promosyon kodunun oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

**currency** `string` *required*

Sabit tutarlı indirim için kullanılan para birimi.

Kullanılabilir seçenekler: `usd`, `sgd`, `inr`, `aud`, `brl`, `cad`, `dkk`, `eur`, `nok`, `gbp`, `sek`, `chf`, `hkd`, `huf`, `jpy`, `mxn`, `myr`, `pln`, `czk`, `nzd`, `aed`, `eth`, `ape`, `cop`, `ron`, `thb`, `bgn`, `idr`, `dop`, `php`, `try`, `krw`, `twd`, `vnd`, `pkr`, `clp`, `uyu`, `ars`, `zar`, `dzd`, `tnd`, `mad`, `kes`, `kwd`, `jod`, `all`, `xcd`, `amd`, `bsd`, `bhd`, `bob`, `bam`, `khr`, `crc`, `xof`, `egp`, `etb`, `gmd`, `ghs`, `gtq`, `gyd`, `ils`, `jmd`, `mop`, `mga`, `mur`, `mdl`, `mnt`, `nad`, `ngn`, `mkd`, `omr`, `pyg`, `pen`, `qar`, `rwf`, `sar`, `rsd`, `lkr`, `tzs`, `ttd`, `uzs`, `rub`, `btc`, `cny`, `usdt`, `kzt`, `awg`, `whop_usd`, `xau`, `hnl`

**duration** `string` *required*

İndirimin ne kadar süre uygulanacağı.

Kullanılabilir seçenekler: `forever`, `once`, `repeating`

**existing\_memberships\_only** `boolean` *required*

Promosyon kodunun yalnızca mevcut üyeliklere uygulanıp uygulanmadığı.

**expires\_at** `string | null` *required*

Promosyon kodunun sona erdiği zaman, ISO 8601 zaman damgası olarak.

**metadata** `object` *required*

Promosyon kodunda saklanan özel anahtar-değer meta verileri.

**new\_users\_only** `boolean` *required*

Promosyon kodunun yeni müşterilerle sınırlı olup olmadığı.

**one\_per\_customer** `boolean` *required*

Her müşterinin promosyon kodunu yalnızca bir kez kullanıp kullanamayacağı.

**product** `object | null` *required*

Promosyon kodunun sınırlı olduğu ürün veya ürün kapsamlı değilse `null`.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `prod_` önekli ürün kimliği.
>
> **title** `string` *required*
>
> Ürünün görünen adı.

**promo\_duration\_months** `integer | null` *required*

İndirimin uygulandığı faturalandırma aralıkları.

**promo\_type** `string` *required*

İndirimin yüzde tabanlı mı yoksa sabit tutarlı mı olduğu.

Kullanılabilir seçenekler: `percentage`, `flat_amount`

**status** `string` *required*

Promosyon kodunun yaşam döngüsü durumu.

Kullanılabilir seçenekler: `active`, `inactive`, `archived`

**stock** `integer` *required*

Stok sınırlı olduğunda maksimum kullanım sayısı.

**unlimited\_stock** `boolean` *required*

Promosyon kodunun kullanım sınırı olmayıp olmadığı.

**updated\_at** `string` *required*

Promosyon kodunun güncellendiği zaman, ISO 8601 zaman damgası olarak.

**uses** `integer` *required*

Promosyon kodunu kullanan üyelikler.

```json PromoCode theme={null}
{
	"id": "promo_xxxxxxxxxxxxxx",
	"code": "SUMMER25",
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Shine Time Auto Detailing"
	},
	"product": {
		"id": "prod_xxxxxxxxxxxxxx",
		"title": "Ceramic Coating Package"
	},
	"affiliate": {
		"id": "aff_xxxxxxxxxxxxxx",
		"user": {
			"id": "user_xxxxxxxxxxxxxx",
			"username": "danawhitfield",
			"name": "Dana Whitfield",
			"profile_pic": "https://ui-avatars.com/api/?name=Dana+Whitfield"
		}
	},
	"status": "active",
	"promo_type": "percentage",
	"amount_off": 0.25,
	"currency": "usd",
	"duration": "repeating",
	"promo_duration_months": 3,
	"new_users_only": true,
	"churned_users_only": false,
	"existing_memberships_only": false,
	"one_per_customer": true,
	"unlimited_stock": false,
	"stock": 200,
	"uses": 37,
	"expires_at": "2026-12-31T23:59:59.000Z",
	"metadata": {},
	"created_at": "2026-09-01T12:00:00.000Z",
	"updated_at": "2026-09-01T12:00:00.000Z"
}
```


## Related topics

- [Arama API'si](https://docs.whop.com/tr/api-reference/search/search.md)
- [Promosyon Kodu](https://docs.whop.com/tr/api-reference/legacy/promo-codes/promo-code.md)
- [API sürümleri](https://docs.whop.com/tr/developer/api/versioning.md)
