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

# API sürümleri

> API'deki değişikliklerin entegrasyonunuzu asla bozmaması için isteklerinizi tarihli bir API sürümüne sabitleyin.

Current API tarihlerle sürümlenir. Uyumluluğu bozan değişiklikler yalnızca sizin dahil olmayı seçtiğiniz yeni bir tarihli sürüm içinde yayınlanır. Bir sürüme sabitlediğinizde, üzerine geliştirme yaptığınız istek ve yanıt yapıları asla değişmez. Resmi SDK'lar, oluşturulurken kullanılan sürümü otomatik olarak gönderir.

```bash theme={null}
curl https://api.whop.com/api/v1/variants \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-07-23"
```

| Gönderdiğiniz | Aldığınız |
| - | - |
| `Api-Version-Date: 2026-07-23` | API'nin o tarihte çalıştığı hali |
| Başlık yok, API anahtarında sabitleme var | API anahtarında saklanan API sürümü |
| Başlık veya saklanan sabitleme yok | Orijinal `2025-01-01` davranışı |
| Bilinmeyen bir tarih | Desteklenen sürümleri içeren bir `400` hatası |

> [!NOTE]
>
> **Bir `Api-Version-Date` geçirmezseniz veya saklanmış bir API anahtarı sabitlemeniz yoksa, kararlı API modeli kullanılır.** İkisi de olmayan istekler sürümleme öncesi davranışla karşılanır, böylece mevcut entegrasyonlar değişmeden çalışmaya devam eder. En son API'ye dahil olmak için tarihli bir sürüme sabitleyin.

## API anahtarı sürüm sabitlemeleri

API anahtarları kendi API sürüm sabitlemelerini taşır. Bir API anahtarıyla kimliği doğrulanan istekler, `Api-Version-Date` belirtmediklerinde bu sabitlemeyi kullanır. Saklanmış bir sabitlemesi olmayan mevcut anahtarlar `2025-01-01` kullanır. Yeni oluşturulan anahtarlar yayınlanmış en son sürümü kullanır.

Açık bir `Api-Version-Date` başlığı her zaman API anahtarının sabitlemesine göre önceliklidir, böylece kaydedilmiş sürümü değiştirmeden önce bir yükseltmeyi test edebilirsiniz.

Her sürüm yeni uç noktaları ve isteğe bağlı alanları otomatik olarak alır. Uyumluluğu bozan değişiklikler, aşağıdaki değişiklik günlüğünde listelenen yeni bir tarihli sürüm oluşturur.

Yükseltirken yalnızca hedef aydaki girişleri değil, mevcut sabitlemenizden hedef sürümünüze kadar olan her girişi inceleyin. Özellikle, `2026-07-20` sürümünden Eylül'e yükseltmek, `2026-07-23` üyeler ve üyelikler geçişini kapsar.

## Değişiklik günlüğü

Aşağıda listelenen TypeScript SDK sürümleri varsayılan olarak o girişteki API sürümünü kullanır. `apiVersionDate` değerini geçersiz kılmak yanıt sürümünü değiştirir, ancak SDK türlerini değiştirmez.

**2026-11-17**

Bir seviye yalnızca kendi seviyesini ve puanlarını tutar

[Retrieve user](https://docs.whop.com/tr/api-reference/users/retrieve-user.md) ve [Retrieve account](https://docs.whop.com/tr/api-reference/accounts/retrieve-account.md) üzerindeki `level` artık `current`, `points`, `points_by_source` ve `resets_at` alanlarına, bir hesapta ise ek olarak `account_level` alanına sahiptir.

Şu alanlar `level` içinden kaldırıldı: `levels`, `points_to_next`, `monthly_qualifying_spend`, `monthly_card_spend`, `monthly_ads_spend` ve `monthly_trading_volume`. `boosted`, bir hesabın `level` alanından kaldırıldı. Bir hesabın `account_level` değeri `current` değerinin altında olduğunda hesap güçlendirilmiş (boosted) olur.

**2026-11-16-2**

Bir seviyenin `applied_level` alanı artık `current`

[Retrieve user](https://docs.whop.com/tr/api-reference/users/retrieve-user.md) ve [Retrieve account](https://docs.whop.com/tr/api-reference/accounts/retrieve-account.md) üzerinde `level.applied_level` alanının adı `level.current` olarak değiştirildi. Değer değişmedi: `0` ile `10` arasında uygulanan seviye.

**2026-11-16-1**

Yönlendirilen kullanıcılar listesi 17 Kasım'dan sonra yanıt vermeyi durdurur

`GET /partners/referred_users`, 17 Kasım 2026'dan sonra yanıt vermeyi durdurur. 18 Kasım'dan itibaren her sürüm bir `410` döndürür. O zamana kadar her yanıt `Deprecation` ve `Sunset` başlıklarını taşır. Listenin bir yerine geçeni yoktur.

**2026-11-16**

Bir kullanıcıya atıf talepleri sona erdi

Ortaklar artık bir kullanıcıya atıf talebi gönderemez. Bu yalnızca bu sürüm için değil, her API sürümü için geçerlidir.

[Create a partner referral request](https://docs.whop.com/tr/api-reference/partner-referral-requests/create-a-partner-referral-request.md), `target_user_id`, `target_username` ve `target_email` değerlerini `code` değeri `user_referral_requests_retired` olan bir `400` ile reddeder. Bir işletme için atıf talep etmek üzere `account_id` veya `account_url` gönderin. Bir kullanıcıya gönderilmiş talepler artık listelenmez veya alınmaz, [list partner referral requests](https://docs.whop.com/tr/api-reference/partner-referral-requests/list-partner-referral-requests.md) üzerindeki `target_user_id` filtresi hiçbir talep döndürmez ve bir talepteki `user` her zaman `null` olur.

**2026-11-14-1**

Bir kullanıcının seviyesi herkese açıktır

[Retrieve user](https://docs.whop.com/tr/api-reference/users/retrieve-user.md), yalnızca sizin için değil, hesapları Whop Levels içinde olan her kullanıcı için `level` döndürür. `level.applied_level`, kullanıcının `0` ile `10` arasındaki seviyesidir.

`level` içindeki `points`, `points_by_source`, `monthly_*` tutarları ve `levels` gibi diğer alanlar, kendinizi ayrılmış `me` kimliğiyle almadığınız ve bakiye okuma kapsamına sahip olmadığınız sürece `null` olur. Bunları okumadan önce `null` olup olmadıklarını kontrol edin.

**2026-11-14**

Kendi satın alımlarınızı listeleyin ve alın

Bir kullanıcı kimlik bilgisiyle, [list payments](https://docs.whop.com/tr/api-reference/payments/list-payments.md) üzerinde `user_id=me` kendi ödemelerinizi döndürür. Bu, her hesaptan yaptığınız satın alımları ve adına satış yaptığınız hesaplardaki ödemelerinizi kapsar. Yalnızca o satın alımları listelemek için satın aldığınız bir hesabın `account_id` değerini ekleyin. [Retrieve payment](https://docs.whop.com/tr/api-reference/payments/retrieve-payment.md) satın aldığınız bir ödemeyi döndürür.

Bir satın alma, alıcısı olarak görebildiklerinizi gösterir. `amount_after_fees`, `usd_total`, `holds` ve `metadata` gibi hesap tarafı alanlar bu kayıtta null veya boştur. `amount_charged`, alıcı ücretleri dahil size ne kadar ücret alındığını belirtir.

**2026-11-13-1**

Ekip üyeleri hesaplarını bir nesne olarak taşır

Ekip üyelerinin artık üst düzey bir `account_id` alanı yoktur. Hesap kimliğini `account.id` üzerinden okuyun. `account` nesnesi ayrıca hesabın `title`, `route` ve `logo_url` değerlerini de içerir.

**2026-11-13**

Leads API'si kullanımdan kaldırıldı

`/leads` uç noktaları kullanımdan kaldırıldı ve artık API referansında listelenmiyor. Bu sürümde ve sonrasında bir `410` döndürürler. Önceki sürümler, `Deprecation`, `Sunset` ve successor `Link` başlıklarıyla 20 Kasım 2026'ya kadar çalışmaya devam eder. Bu tarihten sonra her sürüm bir `410` döndürür.

Her potansiyel müşteri aynı zamanda işletmesinin bir üyesidir; potansiyel müşterinin kimliği üyenin `metadata` alanında `lead_id` olarak bulunur. Potansiyel müşterileri listelemek yerine [List members](https://docs.whop.com/tr/api-reference/members/list-members.md) kullanın. E-posta ile bir üye eklemek için [Create member](https://docs.whop.com/tr/api-reference/members/create-member.md) kullanın. Birini okumak veya güncellemek için [Retrieve member](https://docs.whop.com/tr/api-reference/members/retrieve-member.md) ve [Update member](https://docs.whop.com/tr/api-reference/members/update-member.md) kullanın.

**2026-11-12**

Yönlendirilen kullanıcılar listesi kullanımdan kaldırıldı

`GET /partners/referred_users` kullanımdan kaldırıldı ve artık API referansında listelenmiyor. Mevcut entegrasyonlar için her yanıtta bir `Deprecation` başlığıyla yanıt vermeye devam eder ve bir yerine geçeni yoktur.

**2026-11-11**

Yinelenen faturalar ön ödeme ücretini içerir

Bir fatura oluşturmak veya kalemlerini değiştirmek, ilk faturada yinelenen bir varyantın `initial_price` ile `renewal_price` toplamını tahsil eder. Yenileme faturaları yalnızca `renewal_price` tahsil eder. Diğer alanları düzenlemek, faturanın kaydedilmiş fiyatlarını korur.

İlk faturanın ödenmesi, varyantın deneme süresi olmadan hemen ücretli bir faturalandırma dönemi başlatır. Sınırlı bir ödeme sayısı o faturayı da içerir: 75 $'lık bir ön ödeme ücreti ve üç adet 40 $'lık taksit, önce 115 $, sonra 40 $, sonra 40 \$ olarak faturalandırılır.

**2026-11-10-1**

Yenilenen Economic Intelligence teklifi `3_days`

TypeScript SDK: [`@whop/sdk@2.8.0`](https://unpkg.com/@whop/sdk@2.8.0/dist/esm/BaseClient.mjs).

[Retrieve account preferences](https://docs.whop.com/tr/api-reference/accounts/retrieve-account-preferences.md) üzerindeki `economic_intelligence_offers` içindeki yenilenen teklif artık `3_days` anahtarına sahiptir. Her 3 günde bir yenilenir. Açmak için [Update account preferences](https://docs.whop.com/tr/api-reference/accounts/update-account-preferences.md) uç noktasına `economic_intelligence_duration_key: "3_days"` gönderin. `weekly` anahtarı reddedilir.

**2026-11-10**

Reklam istatistikleri artık `clicks` almıyor

`clicks` alanı [Create ad stats](https://docs.whop.com/tr/api-reference/ads/create-ad-stats.md) uç noktasından kaldırıldı. Bir saatin `clicks` değeri, reklamın Whop pikseli tarafından kaydedilen sayfa görüntülemeleridir ve herhangi bir sürümde gönderilen bir `clicks` değeri yok sayılır.

**2026-11-07**

Chat API: kanallar, üyeler ve mesajlar

Uygulamanıza sohbet ekleyin. [Kanallar](https://docs.whop.com/tr/api-reference/channels/list-channels.md) doğrudan mesajları, grup sohbetlerini, topluluk sohbetlerini ve destek sohbetlerini kapsar. [Kanal üyeleri](https://docs.whop.com/tr/api-reference/channel-members/list-channel-members.md) kişi ekler ve çıkarır. [Mesajlar](https://docs.whop.com/tr/api-reference/messages/list-messages.md) gönderilebilir, düzenlenebilir, sabitlenebilir, mesajlara tepki verilebilir ve oy verilebilir.

`/messages` bu sürümden itibaren yapı değiştirir. Bir mesaj, `user` yerine `channel_id` ve `author`, `is_edited` ve `is_pinned` yerine `edited` ve `pinned` alanlarına sahiptir. Bir güncelleme yerine `POST /messages/{id}/pin` ve `/unpin` ile sabitleyin. [Delete message](https://docs.whop.com/tr/api-reference/messages/delete-message.md) `204` döndürür. `POST /messages/{id}/react`, `/unreact` ve `/vote` ile tepki verin ve oy verin.

**2026-11-06**

`bank_transfer` defter satırı türü kullanımdan kaldırıldı

Iron banka yatırımları, `line_type` değeri `onchain_deposit` olan [defter etkinliği](https://docs.whop.com/tr/api-reference/ledgers/ledger-activity) satırlarıdır ve `source.sender_address` değerleri `iron` olur. Finansal etkinlik ve finansal raporlardaki `line_types` filtresi artık `bank_transfer` kabul etmez.

**2026-11-05-1**

Ödeme listeleri Whop Card'ı içerir

[List saved payout methods](https://docs.whop.com/tr/api-reference/payouts/list-saved-payout-methods.md), hesabın Whop Card'ını içerir. [List payouts](https://docs.whop.com/tr/api-reference/payouts/list-payouts.md), fonları ona aktaran ödemeleri içerir. Kaydedilmiş bir ödeme yöntemi ve bir [ödemenin](https://docs.whop.com/tr/api-reference/payouts/payout) `payout_method` değeri bir `type` alanına sahiptir. `external` fonları Whop dışına gönderir. `whop_card` fonları hesabın kendi Whop Card'ına aktarır. Bir kullanıcının para çekeceği yeri seçtiği bir listede `whop_card` yöntemlerini dışarıda bırakın.

**2026-11-05**

İşlemdeki bir itiraz başvurusu `generating_response` bildirir

Kanıtı ödeme işlemcisinde olan ve henüz kabul edilmemiş bir [itiraz](https://docs.whop.com/tr/api-reference/disputes/dispute), `under_review` yerine `generating_response` bildirir. İşlemci kabul ettiğinde itiraz `under_review` durumuna geçer. İşlemci reddettiğinde itiraz `needs_response` durumuna döner ve alındığında `submission_failure_reason` verir. Her iki geçiş de `dispute.updated` olarak gönderilir.

**2026-11-04-1**

Whop Levels: uygulanan seviye `applied_level`

Bir [kullanıcının](https://docs.whop.com/tr/api-reference/users/user) ve bir [hesabın](https://docs.whop.com/tr/api-reference/accounts/account) `level` alanında `current` artık `applied_level` oldu ve `processing_rate_percentage` kaldırıldı. Bir seviyenin standart kart işleme yüzdesini `levels` içindeki girişinden, bir hesabın kendi oranını ise [Retrieve account fees](https://docs.whop.com/tr/api-reference/accounts/retrieve-account-fees.md) üzerinden okuyun. Bir hesabın `level` alanı ayrıca kendi puanlarının ulaştığı seviye olan `account_level` alanını ekler.

**2026-11-04**

Reklam sertifikaları kaldırıldı

Whop artık reklam sertifikaları sunmuyor. [Retrieve account preferences](https://docs.whop.com/tr/api-reference/accounts/retrieve-account-preferences.md) ve [Update account preferences](https://docs.whop.com/tr/api-reference/accounts/update-account-preferences.md) artık `ads_certifications` döndürmez ve bir güncelleme artık bunu kabul etmez.

**2026-11-03-1**

Bağlı hesaplar artık alt hesaplar

Platform alt hesapları artık subaccount (alt hesap) olarak adlandırılıyor. [List payments](https://docs.whop.com/tr/api-reference/payments/list-payments.md) ve [List disputes](https://docs.whop.com/tr/api-reference/disputes/list-disputes.md) üzerinde ve bunların özet uç noktalarında `include_connected_accounts` artık `include_subaccounts` oldu. [Update account preferences](https://docs.whop.com/tr/api-reference/accounts/update-account-preferences.md) üzerinde, hem yanıtta hem de güncelleme gövdesinde `covers_connected_account_negative_balances` artık `covers_subaccount_negative_balances` oldu. `connected_accounts` gruplamasını kullanan finansal rapor satırları artık `subaccounts` kullanır.

**2026-11-03**

Ödeme talepleri bir teklif gerektirir

[Create a payout](https://docs.whop.com/tr/api-reference/payouts/create-payout.md) artık `quote_token` gerektirir. Önce `POST /payouts/quotes` çağırın, ardından teklifin süresi dolmadan token'ını aynı ödeme ayrıntılarıyla gönderin. Eksik veya geçersiz teklifler `invalid_payout_quote` ile `400` döndürür. Belirsiz bir ödemeyi yeniden denerken, teklifin süresi dolduktan sonra bile mevcut ödemenin kurtarılabilmesi için orijinal token'ı ve `Idempotency-Key` değerini yeniden gönderin.

**2026-11-02-1**

Taslak oluşturulduktan sonra bir faturanın müşterisi değiştirilemez

[Update invoice](https://docs.whop.com/tr/api-reference/invoices/update-invoice.md) üzerinde, taslağın mevcut müşterisinden farklı bir `member_id`, `null` dahil, bir `400` döndürür. Başka birini faturalandırmak için önce [taslağı geçersiz kılın](https://docs.whop.com/tr/api-reference/invoices/void-invoice.md). Ardından [yeni bir fatura oluşturun](https://docs.whop.com/tr/api-reference/invoices/create-invoice.md). Müşterisi olmadan kaydedilmiş bir taslağa yine de müşteri eklenebilir.

**2026-11-02**

Snapchat bağlantıları kaldırıldı

[Connect an External Account](https://docs.whop.com/tr/api-reference/external-accounts/connect-an-external-account.md) artık `advertise` kapsamını kullanan son platform olan `snapchat` değerini almaz, bu nedenle `scopes` alanı da kaldırıldı. `snapchat` veya herhangi bir `scopes` göndermek bir `400` döndürür.

**2026-10-30**

Reklam kampanyaları bid\_type alanını bırakıyor

Reklam kampanyaları artık `bid_type` almaz veya döndürmez. Her reklam ağı kendi kampanya teklif stratejisini seçer ve `desired_cost_per_result` her ağdaki hedefinizdir: reklamların nasıl teklif verdiğini asla değiştirmez. `bid_type` göndermek bir `400` döndürür.

**2026-10-29-8**

Reklam bağlantıları kaldırıldı

Reklamlar Whop'un kendi sayfaları ve profilleri altında yayınlanır, bu nedenle artık reklam için hesap bağlamazsınız. [Connect an External Account](https://docs.whop.com/tr/api-reference/external-accounts/connect-an-external-account.md) artık `meta_business` almaz ve `tiktok` artık `advertise` kapsamını almaz. Bunlardan birini göndermek bir `400` döndürür.

**2026-10-29-5**

Dönüşüm değeri kuralları kaldırıldı

Dönüşüm değeri kuralları kaldırıldı ve reklam ağları her dönüşümün orijinal değerini alır. Dönüşüm değeri kurallarını listelemek kullanımdan kaldırıldı: boş bir liste döndürür, artık belgelenmez ve yanıtları bir `Deprecation` başlığı taşır. Diğer tüm dönüşüm değeri kuralı uç noktaları bir `410` döndürür.

**2026-10-29-4**

Kitleler etkileşim kurallarını, kural hedefleri ise platformu bırakıyor

Kitleler artık sosyal etkileşimden oluşturulamaz. Mevcut etkileşim kitleleri hâlâ `source_type` değeri `engagement` olarak listelenir, ancak artık `engagement` döndürmezler. [Create audience](https://docs.whop.com/tr/api-reference/audiences/create-audience.md) uç noktasına `engagement` veya `source_type` olarak `engagement` göndermek bir `400` döndürür. Dönüşüm değeri kuralı hedefleri artık `platform` almaz veya döndürmez. Her hedef, Whop'un onu çalıştırdığı her ağı kapsar ve bir hedefte `platform` göndermek bir `400` döndürür.

**2026-10-29-3**

Harici hesap ortakları kullanımdan kaldırıldı

Ortaklık reklamları artık kullanılamıyor. Bir harici hesabın ortaklarını listelemek boş bir liste döndürür. Bir ortak eklemek veya kaldırmak bir `400` döndürür. Bu uç noktalar artık belgelenmez ve yanıtları bir `Deprecation` başlığı taşır.

**2026-10-29-2**

Kopyalar preserve\_engagement alanını bırakıyor, gönderi ve potansiyel müşteri formu listeleri kullanımdan kaldırıldı

Bir reklam kampanyasını, reklam grubunu veya reklamı kopyalamak artık `preserve_engagement` almaz. Bunu [Duplicate an Ad Campaign](https://docs.whop.com/tr/api-reference/ad-campaigns/duplicate-an-ad-campaign.md), [Duplicate an Ad Group](https://docs.whop.com/tr/api-reference/ad-groups/duplicate-an-ad-group.md) veya [Duplicate an Ad](https://docs.whop.com/tr/api-reference/ads/duplicate-an-ad.md) uç noktasına göndermek bir `400` döndürür. Bir harici hesabın gönderilerini veya potansiyel müşteri formlarını listelemek kullanımdan kaldırıldı: ikisi de boş bir liste döndürür, artık belgelenmezler ve yanıtları bir `Deprecation` başlığı taşır.

**2026-10-29-1**

Reklamlar post\_id alanını bırakıyor ve hedefleme araması kullanımdan kaldırıldı

Reklamlar artık `post_id` döndürmez. Reklam grubu hedefleme seçeneklerini aramak ve reklam grubu erişimini tahmin etmek kullanımdan kaldırıldı: ikisi de çalışmaya devam eder, ancak artık belgelenmezler ve yanıtları bir `Deprecation` başlığı taşır. Bir dönüşüm değeri kuralı hedefi, Whop'un onu çalıştırdığı her ağı kapsamak için `platform` değerini dışarıda bırakabilir.

**2026-10-29**

Reklamlar ağa özgü alanları ve bilinirlik hedefini bırakıyor

Reklam kampanyaları, reklam grupları ve reklamlar artık `platform` döndürmez ve [Create an Ad Campaign](https://docs.whop.com/tr/api-reference/ad-campaigns/create-an-ad-campaign.md) artık bunu almaz. Yeni kampanyalar `awareness` hedefini kullanamaz. Mevcut bilinirlik kampanyaları bunu hâlâ döndürür. Reklamlar artık `existing_post_id`, `post_source`, `external_accounts` veya `translations` almaz veya döndürmez ve artık `post_thumbnail_url` döndürmez. Kaldırılmış bir alanı veya hedef olarak `awareness` değerini [Create an Ad Campaign](https://docs.whop.com/tr/api-reference/ad-campaigns/create-an-ad-campaign.md), [Create ad](https://docs.whop.com/tr/api-reference/ads/create-an-ad.md) veya [Update ad](https://docs.whop.com/tr/api-reference/ads/update-an-ad.md) uç noktasına göndermek bir `400` döndürür.

**2026-10-28-1**

Reklamlar gelişmiş yayın ve kreatif alanlarını bırakıyor

Reklam kampanyaları artık `optimization_goal` döndürmez. Reklam grupları artık `optimization_goal`, `conversion_location`, `message_apps`, `minimum_daily_spend`, `dynamic_creative`, `placements`, `frequency_cap` veya `detailed_targeting` almaz veya döndürmez ve Whop yayını kampanyanın `objective` değerinden ayarlar. Reklamlar artık `messaging_config`, `multi_advertiser_ads`, `lead_form`, `lead_form_id` veya `music` almaz veya döndürmez. Bunlardan herhangi birini [Create ad group](https://docs.whop.com/tr/api-reference/ad-groups/create-an-ad-group.md), [Update ad group](https://docs.whop.com/tr/api-reference/ad-groups/update-an-ad-group.md), [Create ad](https://docs.whop.com/tr/api-reference/ads/create-an-ad.md) veya [Update ad](https://docs.whop.com/tr/api-reference/ads/update-an-ad.md) uç noktasına göndermek, alanı adlandıran bir `400` döndürür.

**2026-10-28**

Hesap varyant listeleri eski fatura varyantlarını dışarıda bırakır

`account_id` ile [List variants](https://docs.whop.com/tr/api-reference/variants/list-variants.md), faturası sonradan silinmiş olanlar dahil, eski bir fatura için oluşturulmuş varyantları dışarıda bırakır. Birini okumak için [varyantı](https://docs.whop.com/tr/api-reference/variants/retrieve-variant.md) kimliğiyle alın. Kullanımdan kaldırılmış `GET /plans` listesi de aynı şekilde davranır.

**2026-10-27-3**

Takaslar cüzdan bakiyesinin üzerindeki bir tutarı reddeder

[Create swap](https://docs.whop.com/tr/api-reference/swaps/create-swap.md) üzerinde, cüzdanın `from_token` bakiyesinin üzerindeki ondalık bir `amount` bir `400` döndürür. Hata mevcut bakiyeyi belirtir. Önceki sürümler takası başlatır, takas da daha sonra zincir üzerinde başarısız olur. Bakiye okunamadığında kontrol atlanır. USDT kontrol edilmez, çünkü bir USDT takası kart bakiyesinden de çekebilir.

**2026-10-27-2**

Diğer tüm kaynaklar varyantları varyant olarak adlandırır

**Üyelikler, üyeler ve bekleme listesi girişleri.** Üyeliklerde ve bekleme listesi girişlerinde `plan_id` artık `variant_id` oldu; bir bekleme listesi girişine gömülü varyantta ise `plan_type` artık `billing_type` oldu. [Invite to a membership](https://docs.whop.com/tr/api-reference/memberships/invite-to-a-membership.md) ve [Create waitlist entry](https://docs.whop.com/tr/api-reference/waitlist-entries/create-waitlist-entry.md) `variant_id` alır ve [Approve all waitlist entries](https://docs.whop.com/tr/api-reference/waitlist-entries/approve-all-waitlist-entries.md) `variant_id` alır ve döndürür. [List memberships](https://docs.whop.com/tr/api-reference/memberships/list-memberships.md) `variant_id` ve `variant_ids` ile, [List members](https://docs.whop.com/tr/api-reference/members/list-members.md) `variant_ids` ile ve [List waitlist entries](https://docs.whop.com/tr/api-reference/waitlist-entries/list-waitlist-entries.md) `variant_id` ile, `plan_id` ve `plan_ids` yerine filtreler.

**Ödemeler, faturalar ve itirazlar.** Ödemelerde, itirazlarda ve Resolution Center vakalarında `plan_id` artık `variant_id` oldu; bunların `line_items` alanlarında ise `plan_id` ve `plan_title` artık `variant_id` ve `variant_title` oldu. Ödeme teklifi ve fatura `line_items` alanlarında `plan_id` artık `variant_id` oldu. [List payments](https://docs.whop.com/tr/api-reference/payments/list-payments.md), `plan_ids` yerine `variant_ids` ile filtreler. [Create payment](https://docs.whop.com/tr/api-reference/payments/create-payment.md) ve [Create payment quote](https://docs.whop.com/tr/api-reference/payment-quotes/create-payment-quote.md), gövdede ve `line_items` içindeki her girişte `plan_id` ve `plan` yerine `variant_id` ve `variant` alır. Bir fatura oluşturmak ve güncellemek, `items` içindeki her girişte `plan_id` ve `plan` yerine `variant_id` ve `variant` alır. Satır içi bir `variant`, `plan_type` yerine `billing_type` alır. Olaylarda `related.plan` artık `related.variant` oldu.

**Ödeme sayfası.** Ödeme yapılandırmalarında `plan` artık `variant` oldu ve onun `plan_type` alanı artık `billing_type` oldu. [Create checkout configuration](https://docs.whop.com/tr/api-reference/checkout-configurations/create-a-checkout-configuration.md), `plan_id` yerine `variant_id` ve `plan` yerine satır içi bir `variant` (`billing_type` ile) alır ve [List checkout configurations](https://docs.whop.com/tr/api-reference/checkout-configurations/list-checkout-configurations.md) `variant_id` ile filtreler. Ödeme oturumu istekleri ve yanıtları `items[].plan` yerine `items[].variant` kullanır.

**Promosyon kodları ve ortaklar.** [List promo codes](https://docs.whop.com/tr/api-reference/promo-codes/list-promo-codes.md), `plan_ids` yerine `variant_ids` ile filtreler ve [Create promo code](https://docs.whop.com/tr/api-reference/promo-codes/create-promo-code.md) `variant_ids` alır.

**2026-10-27-1**

Ürünler ve varyantlar varyantları varyant olarak adlandırır

Ürünlerde `default_plan` artık `default_variant` oldu. Varyantlarda ve bir ürüne gömülü varyantlarda `plan_type` artık `billing_type` oldu. [Create variant](https://docs.whop.com/tr/api-reference/variants/create-variant.md) `billing_type` alır ve [List variants](https://docs.whop.com/tr/api-reference/variants/list-variants.md) ile [List products](https://docs.whop.com/tr/api-reference/products/list-products.md), `plan_types` yerine `billing_types` ile filtreler.

`/plans` yerine `/variants` ve `variants` SDK ad alanını kullanın. `/plans` uç noktaları, `Deprecation` ve successor `Link` başlıklarıyla her sürümde yanıt vermeye devam eder. Vergiyi önizlemek için, aynı şekilde kullanımdan kaldırılmış olan `POST /variants/{id}/calculate_tax` veya `POST /plans/{id}/calculate_tax` çağırmak yerine bir [ödeme teklifi](https://docs.whop.com/tr/api-reference/payment-quotes/create-payment-quote.md) oluşturun.

Varyant kimlikleri `plan_` önekini korur ve `plan:*` izin kapsamları ile `plan.*` webhook olay adları değişmez.

**2026-10-27**

Davetler bekleyen ekip üyesini döndürür

[Create team member](https://docs.whop.com/tr/api-reference/team-members/create-team-member.md) üyeyi eklemek yerine bir davet gönderdiğinde, `202` yanıtı artık bekleyen ekip üyesidir. Onun `status` değeri `pending` olur ve kimliği `ausri_` ile başlar. Yanıt artık `object` veya `invitation_sent` taşımaz.

**2026-10-24**

Makbuz tabanlı faturalar

Yerel Invoices API'si `pay_` kimliklerini ve satır içi varyant oluşturma dahil varyant tabanlı `items` kullanır. Oluşturma işlemi bir taslak kaydeder. Taslakları güncelleyebilir ve artık ihtiyacınız olmayan bir taslağı geçersiz kılabilirsiniz. Faturalandırılan müşteri bir üyedir. Bir Whop kullanıcısına ait olmayan bir e-posta, bir kullanıcı oluşturur. `recipient_emails`, faturalandırılan üyeden ayrı olarak faturanın kendi teslim adresleridir. Alıcı ücreti ayarlanabilir bir yüzdedir.

**2026-10-15-1**

Hesaplar artık stablecoin\_rails içermiyor

Hesaplar artık `stablecoin_rails` içermiyor.

**2026-10-15**

Doğrulama belgesi türleri küçük harflidir

[Create verification](https://docs.whop.com/tr/api-reference/verifications/create-verification.md) üzerinde ve `owners` içindeki sahiplerde `document_type` küçük harfli değerler alır: `passport`, `id_card`, `drivers` veya `residence_permit`. [Kimlik belgeleri](https://docs.whop.com/tr/developer/verification/identity-documents.md) kılavuzu her ülkenin hangilerini kabul ettiğini listeler.

**2026-10-14-1**

Yatırma kartı tahsilatı methods altına taşındı

[Create deposit](https://docs.whop.com/tr/api-reference/deposits/create-deposit.md) üzerinde, kaydedilmiş bir ödeme yöntemine yapılan tahsilat üst düzey `card` alanından `bank` ve `crypto` yanındaki `methods.card` alanına taşındı. Alanları değişmedi ve `payment_method_id` geçirilmedikçe hâlâ `null` olur. Daha önceki bir sürüme sabitlenmiş çağıranlar üst düzey `card` alanını korur.

**2026-10-14**

Ödeme yöntemi alan adları, domains lehine kullanımdan kaldırıldı

Ödeme yöntemi alan adları uç noktaları kullanımdan kaldırıldı ve artık API referansında listelenmiyor. Bunun yerine Apple Pay alan adlarını [domains](https://docs.whop.com/tr/api-reference/domains/domain) API'sinin `apple_pay` yeteneğiyle ekleyin, kontrol edin ve kaldırın:

* `GET /payment_method_domains`: `apple_pay=any` ile veya doğrulanmış alan adları için `apple_pay=ready` ile `GET /domains`. Ana bilgisayar adına göre `hostname` yerine `domain` ile filtreleyin.
* `GET /payment_method_domains/{id}`: `GET /domains/{id}`.
* `POST /payment_method_domains`: `domain`, `account_id` ve `apple_pay: {}` ile `POST /domains`. Hesapta alan adı zaten varsa, `apple_pay: {}` ile `PATCH /domains/{id}`.
* `POST /payment_method_domains/{id}/verify`: `POST /domains/{id}/check`.
* `DELETE /payment_method_domains/{id}`: `apple_pay: null` ile `PATCH /domains/{id}`. `DELETE /domains/{id}`, üzerindeki herhangi bir web sitesi dahil tüm alan adını kaldırır.
* `status: verified`, `apple_pay.state: ready` demektir. `status: pending`, Whop alan adını kaydederken `apple_pay.state: pending`, ilişkilendirme dosyasını barındırıp alan adını kontrol edene kadar ise `action_required` demektir.

Kayıt arka planda çalışır, bu nedenle bir alan adı oluşturmak veya kontrol etmek `pending` döndürür. `apple_pay.state` değeri `ready` veya `action_required` olana kadar alan adını alın.

`/payment_method_domains` uç noktaları, `Deprecation` ve successor `Link` başlıklarıyla her sürümde yanıt vermeye devam eder. Bir alan adı kimliğini korur, bu nedenle `/domains/{id}` bir ödeme yöntemi alan adının döndürdüğü kimliği alır. Domains API'si `company:manage_checkout` yerine `domain:read` ve `domain:manage` izinlerine ihtiyaç duyar.

**2026-10-13-1**

Yerel yorumlar

TypeScript SDK: [`@whop/sdk@2.5.0`](https://unpkg.com/@whop/sdk@2.5.0/dist/esm/BaseClient.mjs).

Yorumlar artık yerel bir kaynak kullanıyor.

* Yorumları listelemek ve almak yalnızca yayınlanmış yorumları döndürür. Bekleyen veya kaldırılmış bir yorumu almak `404` döndürür.
* Alınan bir yorum `company` yerine `account` döndürür.
* Yorumları listelemek `account_id` veya `product_id` ile filtreler, `order` ve `direction` ile sıralar ve varsayılan olarak sayfa başına 20 yorum döndürür. Filtre olmadan, bir kullanıcı yazdığı yorumları listeler; bir hesap veya uygulama API anahtarı ise hesabının yorumlarını listeler.
* `company_id` artık kabul edilmiyor. `account_id` kullanın.
* `DELETE /reviews/{id}`, oturum açmış kullanıcının yazdığı bir yorumu siler ve `review:delete` kapsamını gerektirir.

**2026-10-13**

Hesapların artık bir sektör grubu yok ve hesap sınıflandırması salt okunur

Hesaplar artık `industry_group` içermiyor ve `PATCH /accounts/{id}` artık bunu kabul etmiyor. `business_type` ve `industry_type` bir hesabı sınıflandırır.

Hesap sınıflandırması salt okunurdur. `business_type` ve `industry_type` değerlerini Whop ayarlar ve `PATCH /accounts/{id}` artık bunları kabul etmez.

**2026-10-09-2**

Uygulamalar artık önceki barındırılan URL'leri listelemiyor

TypeScript SDK: [`@whop/sdk@2.4.0`](https://unpkg.com/@whop/sdk@2.4.0/dist/esm/BaseClient.mjs).

Uygulamalar artık `previous_hosted_urls` içermiyor. Bir uygulamanın adresleri, onu sunan alan adlarıdır: bunları `GET /domains` ile listeleyin veya uygulamadaki `domains` alanını okuyun.

**2026-10-09-1**

Transfer profilleri, tutarları ve oluşturma türleri

Transferler, `name` ve `logo_url` içeren `origin` ve `destination` profillerini döndürür. `amount` ve `fee` para nesneleri, alıcıya yapılan alacak kaydını ve tüm transfer ücretlerini içerir. Yanıtlar ayrıca mevcut başarısızlık zaman damgalarını ve bir izleme URL'sini içerir. Bilinmeyen geçmiş para ve geçiş zamanları `null` olur.

Hesap filtreleri olmadan `GET /transfers`, çağıranın izin verilen hesapları ve kişisel cüzdanı genelindeki transferleri listeler. Hesap kapsamlı kimlik bilgileri kendi hesaplarıyla sınırlı kalır.

`POST /transfers`, `balance` veya `claim_link` olmak üzere bir `type` gerektirir. Bu olmadan yapılan istekler `400` döndürür. `ledger` türünün adı `balance` olarak değiştirildi ve `wallet_send` kaldırıldı. Önceki sürümler `ledger` ve `wallet_send` kabul eder ve `type` belirtilmediğinde bir `balance` transferi oluşturur.

**2026-10-09**

Bir ödemenin makbuz PDF'ini oluşturun

Ödemeler artık `pdf_url` içermiyor. Bir ödemenin makbuzunu PDF olarak almak için `POST /payments/{id}/generate_pdf` çağırın. Dosyayı indirmek için bir `url` ve bu bağlantının çalışmayı durduracağı `expires_at` değerini döndürür.

**2026-10-08**

Bekleyen fonlar bir uyumluluk incelemesi bekliyor olabilir

TypeScript SDK: [`@whop/sdk@2.3.0`](https://unpkg.com/@whop/sdk@2.3.0/dist/esm/BaseClient.mjs).

Bir hesabın `payment_controls.undated_pending_reason` değeri `compliance_review` olabilir. Bu, satıcının daha önce gönderdiği bir doğrulamanın incelemede olduğu anlamına gelir; bu nedenle bekleyen fonlar inceleme tamamlanana kadar beklemede kalır. Daha önceki bir sürüme sabitlenmiş çağıranlar bu durum için `null` görür.

**2026-10-07-2**

Economic Intelligence her hafta yenilenebilir

`economic_intelligence_offers`, kapatılana kadar her hafta yenilenen bir `weekly` teklifi içerir. Her teklifin bir `auto_renew` alanı vardır ve önerilen teklif `weekly` olur. Açmak için `PATCH /accounts/{account_id}/preferences` uç noktasına `economic_intelligence_duration_key: "weekly"` gönderin.

`economic_intelligence_offers` yalnızca hesabın şu anda seçebileceklerini listeler. Economic Intelligence açıkken artık `null` olmaz: taahhüt edilmiş bir dönem boyunca yalnızca bir yükseltme olarak `weekly` listelenir ve `weekly` yenilenirken liste boştur. Önceki sürümler Economic Intelligence açıkken `null` değerini korur, `weekly` teklifini dışarıda bırakır ve `1_day` önerir.

**2026-10-07-1**

Kaydedilmiş kartla ödemeler varsayılan olarak alıcının mevcut olduğunu varsayar

`return_url` içeren kaydedilmiş bir ödeme yöntemi tahsilatı (`member_id` ve `payment_method_id`) artık alıcıyı mevcut kabul eder. Bu, `off_session` değerini belirtmediğinizde geçerlidir. Kartı veren kuruluş alıcıdan kimlik doğrulaması isterse, ödeme bir `next_action` ile `requires_action` olur. Kartı alıcı olmadan, örneğin kendi programınıza göre bir yenilemede tahsil ettiğinizde, `off_session: true` geçirin.

**2026-10-07**

Fatura ödeme alıcılarının artık Whop hesaplarına ihtiyacı yok

`recipient` ile bir ödeme yöntemi oluşturmak, gönderenin defterine bağlı, varsayılan olmayan bir alıcı ödeme hesabı oluşturur. Herhangi bir Whop kullanıcısı, Whop hesabı veya alıcı defteri oluşturmaz. Alıcı yanıtı `first_name`, `last_name` ve `country` içerir. Artık `user_id` içermez. Önceki API sürümleri, Whop kullanıcısı olmadığında alıcı ayrıntılarını atlar. Önceki sürümler mevcut alıcılar için kullanıcı kimliğini korur.

**2026-10-06-2**

Uygulama derlemeleri artık bir yapay zekâ istemi almıyor

Bir uygulama derlemesi oluşturmak artık `ai_prompt_id` kabul etmiyor.

**2026-10-06-1**

Bir metriğin zaman serisinin kendi yolu var

Bir metriğin zaman serisini `GET /stats/time_series/{metric}` üzerinden alın. `GET /stats/{metric}` onu hâlâ sunar ve bir `Deprecation` başlığında yerine geçeni belirtir.

**2026-10-06**

Sosyal hesaplar artık harici hesaplar

Sosyal hesaplar artık harici hesaplardır. `/external_accounts` ve `externalAccounts` SDK ad alanını kullanın. Eski `/social_accounts` uç noktaları, `Deprecation` ve successor `Link` başlıklarıyla her sürümde yanıt vermeye devam eder. Harici hesap kimlikleri `sacc_` öneklerini korur ve `social_account:*` izin kapsamları değişmez.

Reklamlar, hesaplarını hem isteklerde hem de yanıtlarda `social_accounts` yerine `external_accounts` olarak adlandırır. Kitle etkileşim kuralları hesaplarını `social_account_id` yerine `external_account_id` olarak adlandırır. `/external_accounts` üzerinde, bir Instagram hesabının sahibi olan sayfa `parent_social_account` yerine `parent_external_account` olur. Sabitlenmiş bir API sürümü olmayan reklam webhook'ları `external_accounts` alır.

**2026-10-05-1**

Kullanıcılar artık sosyal hesapları içermiyor

Kullanıcılar artık `social_accounts` döndürmüyor.

**2026-10-05**

Kurulum niyetleri arka planda kaydedilir

Bir setup intent oluşturmak artık onu `processing` olarak döndürür ve ödeme yöntemini arka planda kaydeder. Bir ödeme oluşturmak zaten bu şekilde çalışır. Sonucu öğrenmek için setup intent'i yoklayın veya `client_secret` değerini `handleNextAction` fonksiyonuna geçirin. Sonuçta kaydedilir, reddedilir veya alıcıdan bir adım bekler. Önceki sürümler onu istek sırasında kaydetmeye devam eder.

**2026-09-29**

Önlenen itirazlar prevented olarak bildirilir

TypeScript SDK: [`@whop/sdk@2.1.0`](https://unpkg.com/@whop/sdk@2.1.0/dist/esm/BaseClient.mjs), [`@whop/sdk@2.2.0`](https://unpkg.com/@whop/sdk@2.2.0/dist/esm/BaseClient.mjs).

Herhangi bir karardan önce müşteriye iade yapılmış bir itiraz artık `closed` yerine `status: prevented` değerine sahiptir. İade, kart ağından (Visa RDR) veya daha önceki bir iadeden gelmiştir.

**2026-09-28**

Economic Intelligence çalıştırmalarının kendi durumları var

Whop AI'ın uygulamakta olduğu bir öneri `status: running` değerine sahiptir. Çalıştırma bittiğinde `executed` olur veya öneriyi uygulamadan bittiyse `incomplete` olur. Önceki sürümler çalışan bir öneriyi `ready`, tamamlanmamış bir öneriyi ise `superseded` olarak gösterir.

Öneriler ayrıca `run_started_at`, `run_ended_at`, `run_by_user_id`, `result_url` ve `acknowledged_at` döndürür. Bir öneriyi kendiniz çalıştırmak için `PATCH /economic_intelligence/{id}` uç noktasına `status: running`, ardından `status: executed` (isteğe bağlı bir `result_url` ile) veya `status: incomplete` gönderin. Tamamlanmış bir çalıştırmayı görüldü olarak işaretlemek için `status: acknowledged` gönderin. Öneri `executed` olarak kalır ve `acknowledged_at` değerini kaydeder.

**2026-09-25**

Economic Intelligence süreleri anahtarla seçilir

Economic Intelligence'ı açmak için `PATCH /accounts/{account_id}/preferences` uç noktasına `economic_intelligence_duration_days` yerine `economic_intelligence_duration_key` gönderin. `economic_intelligence_offers` içindeki bir girişin `key` değerini kullanın.

`economic_intelligence_offers` içindeki her giriş, `duration_days` yerine `key`, `duration` ve `duration_unit` alanlarına sahiptir. Bir süre `hours` veya `days` cinsinden sayılabilir.

**2026-09-24-1**

Reklam metinleri dil etiketlidir ve Meta reklamları başka dillerde yayınlanabilir

Bir reklamın `primary_texts`, `headlines` ve `descriptions` alanları, isteklerde ve yanıtlarda `{ language, text }` nesnelerinden oluşan dizilerdir. Çevirisi olmayan bir reklamda `language` değerini dışarıda bırakın. API düz dizeleri reddeder, bu nedenle bunun yerine `[{ "text": "…" }]` gönderin.

Bir Meta reklamı başka dillerde de yayınlanabilir. `translations: { source_language, automatic_languages }` değerini reklamın kendi metninin diline ve Meta'nın otomatik olarak çevirdiği dillere ayarlayın. Bu durumda o reklamdaki her metin ve `creatives` girişi kendi `language` değerini belirtir. Reklamın kendi metni ve kreatifi `source_language` kullanır ve kendiniz yazdığınız her dil, bir `primary_texts` ve bir `headlines` girişi ile isteğe bağlı `descriptions` ve `creatives` girişleri alır. `translations: null` diğer dilleri kapatır.

Önceki API sürümleri çevirileri olan bir reklamı güncelleyemez. Bu sürümü belirten bir 400 alırlar.

**2026-09-24**

Economic Intelligence seçilen bir süre için açılır

Economic Intelligence'ı açmak için `PATCH /accounts/{account_id}/preferences` uç noktasına `economic_intelligence_duration_days` gönderin. Her sürenin ücretini listeleyen `economic_intelligence_offers` içinden bir süre seçin. Economic Intelligence, `economic_intelligence_ends_at` zamanına kadar değiştirilemez veya kapatılamaz ve o zaman otomatik olarak kapanır.

`economic_intelligence` salt okunurdur. Gönderilmesi bir `400` hatası döndürür.

**2026-09-23**

Alım satım erişimi izin kontrollerinde görünür

TypeScript SDK: [`@whop/sdk@2.0.0`](https://unpkg.com/@whop/sdk@2.0.0/dist/esm/BaseClient.mjs).

`GET /permissions`, bir hesap için izin eylemlerini listelerken veya kontrol ederken `crypto_wallet:trade` ve `crypto_wallet:trade:read` değerlerini içerir.

**2026-09-22-4**

Economic Intelligence işlem açıklamaları

Economic Intelligence önerileri `expected_tool_calls` değerini `tool_name` ve `description` içeren nesnelerden oluşan sıralı bir dizi olarak döndürür. Açıklamalar planlanan eylemi ve etkilenen kaynağı tanımlar. Daha eski önerilerin açıklaması `null` olur.

**2026-09-22-3**

Ortak yönlendirme bağlantıları tek bir istek türü kullanır

Ortak yönlendirme talepleri, ödüllü veya ödülsüz bağlantılar için `request_type: "link"` kullanır. Bağlantı oluştururken veya filtrelerken `link` kullanın. Ödülleri yalnızca yetkili personel yapılandırabilir.

**2026-09-22-2**

Hesap ödülleri ortak ödülü ilerlemesini gösterir

Retrieve Account, ortak ödülü kilometre taşlarını `rewards` içinde döndürür. Her kilometre taşı o hesap için hak kazanma ilerlemesini ve ödeme durumunu içerir. Eşleşen ödül olmadığında veya çağıranın bakiye ya da istatistik okuma erişimi olmadığında alan boş bir dizi içerir.

Eski katılım ödülü biçimi kullanımdan kaldırıldı. Önceki API sürümleri hesap yanıtlarında `rewards` alanını atlar.

**2026-09-22-1**

Setup intent'ler yerel bir kaynak haline gelir

Yerel Payments API'si artık `POST /setup_intents`, `GET /setup_intents` ve `GET /setup_intents/{id}` uç noktalarını sunar. Setup Intent nesnesi diğer tüm yerel kaynakların yapısını alır.

* İlgili kayıtlar gömülü nesneler yerine yabancı anahtar kimlikleridir: `account_id` (önceden `company`), `member_id` (önceden `member`), `payment_method_id` (önceden `payment_method`) ve `checkout_configuration_id` (önceden `checkout_configuration`). Alıcı bir `user` özetidir (`id`, `username`, `name`, `profile_picture`).
* `error_message`, Retrieve setup status'un döndürdüğü aynı `{ code, message }` bloğu olan `last_setup_error` içine taşınır. Bir şey başarısız olana kadar `null` kalır ve kurulum başarılı olduğunda kaldırılır.
* `return_url`, `payment_method_type` ve `updated_at` yenidir. `created_at` ve `updated_at` ISO 8601 zaman damgalarıdır.
* Payment nesnesinin zaten taşıdığı görüntülemeye uygun yöntem olan `payment_instrument` Setup Intent'te de bulunur, böylece kaydedilmiş bir kart ikinci bir istek olmadan görüntülenir. Onun `card` alanı her iki kaynakta da `exp_month` ve `exp_year` kazanır. `card.brand` değeri `null` olabilir: ağını kasanın kaydetmediği kaydedilmiş bir kart, tüm `card` nesnesini kaybetmek yerine son dört hanesini ve son kullanma tarihini korur.
* Bir setup intent oluşturmak `201 Created` (önceden `200`) yanıtını verir, `Idempotency-Key` değerine uyar ve `confirmation_token` veya `payment_method_id` değerlerinden tam olarak birini gerektirir. Başka bir hesaba ait bir onay token'ı `404` döndürür.
* `client_secret` oluşturma ve alma işlemlerinde ve yalnızca bu API üzerinden oluşturulan kurulumlar için geri döner. Kurulum üzerinde işlem yapabilecek bir çağıran gerektirir: hesabın `payment:charge` kimlik bilgisi veya alıcının kendi token'ı. Liste satırları her zaman `null` taşır.
* Bu sürüme veya sonrasına sabitlenmiş `setup_intent.requires_action`, `setup_intent.succeeded` ve `setup_intent.canceled` webhook'ları, `data` olarak aynı Setup Intent nesnesini iletir. Daha önceki bir sürüme sabitlenmiş webhook'lar ve sabitlemesi olmayan webhook'lar önceki yükü korur.
* `GET /setup_intents`, standart `{ data, page_info }` zarfı ve imleç tabanlı sayfalama ile listeler. `account_id` isteğe bağlıdır: bir hesap API anahtarı kendi hesabını listeler ve bir kullanıcı token'ı okuyabildiği her hesabı listeler. `status` yeni bir filtredir ve geçersiz bir değer `400` döndürür. `created_before` ve `created_after` eskisi gibi çalışır.

**2026-09-22**

Reklam ödemesi yeniden denemeleri hesap uç noktasını kullanır

`POST /ad_campaigns/{id}/retry_payment`, `410 Gone` döndürür. Tüm kampanyaları için tek bir ödeme yeniden denemesini kuyruğa almak üzere hesabın `biz_` kimliğiyle `POST /accounts/{id}/retry_ads_payment` kullanın. Kabul edilen bir yeniden deneme ödemenin başarılı olduğunu onaylamaz. Sonuç için kampanyanın `delivery_status` ve `issues` değerlerini kontrol edin.

**2026-09-15**

Üç ayrı 3D Secure politikası

TypeScript SDK: [`@whop/sdk@1.1.5`](https://unpkg.com/@whop/sdk@1.1.5/dist/esm/BaseClient.mjs).

Hesaplar, varyantlar, ödeme yapılandırmaları ve ödeme oturumları üç 3D Secure seçeneği sunar:

* `mandate_challenge`, desteklenen bir oturum içi kart ödemesini işlemeden önce bir doğrulama ister.
* `mandate_if_required`, yalnızca ödeme işlemcisi gerektirdiğinde doğrulamayı zorunlu kılar.
* `frictionless_if_required`, normal sürtünmesiz 3DS akışını kullanır.

1.000 \$ veya üzerindeki ödemeler en az `mandate_if_required` kullanır. Risk ve kimlik doğrulama kurtarma gereksinimleri tercihi geçersiz kılabilir. Açıkça zorunlu kılınan doğrulamalar, platformda etkinleştirilene kadar reddedilir.

Eski API sürümleri mevcut değerlerini korur: yeni `mandate_challenge` seçimleri koşullu kalır, mevcut zorunlu tercihler korunur ve `frictionless`, `frictionless` olarak kalır. Eski sürümlerdeki hesaplar sürtünmesiz akışı `null` olarak gösterir.

**2026-09-13**

Alım satım transferlerinin ayrı finansal rapor kategorileri var

Finansal rapor satırları `trading_account_deposit`, `trading_account_withdrawal` ve bunların `_offset` girişlerini diğer zincir üstü transferlerden ayırır. Tutarlar ve bakiyeler değişmez.

Önceki sürümler mevcut kategorileri korur: hesap yatırmaları için `topup` ve hesap çekimleri için `onchain_withdrawal`. Genel raporlar ilgili `onchain_deposit`, `onchain_withdrawal` ve `_offset` kategorilerini kullanır. Eşleşen satırlar, transfer edilen tutarlar kaybedilmeden birleştirilir.

**2026-09-11-1**

Beyaz etiketli satıcılar için Triple Whale durumu yeniden adlandırıldı

Hesap tercihlerindeki `ads_triple_whale_integration.status`, `requires_shopify_store` yerine `requires_shop_domain` bildirir. Entegrasyonda artık açıkça bir `shop_domain` ayarlanabilir, bu nedenle bağlı bir Shopify mağazası artık bunu sağlamanın tek yolu değildir.

**2026-09-11**

İşletme kategorileri tek bir tablodan gelir

TypeScript SDK: [`@whop/sdk@1.1.4`](https://unpkg.com/@whop/sdk@1.1.4/dist/esm/BaseClient.mjs).

Hesabın `business_type`, `industry_group` ve `industry_type` alanları, sabit enum'lar yerine Whop'un işletme kategorileri tablosundan alınan dizelerdir. Yeni kategoriler yeni bir API sürümü olmadan görünür. [İşletme türleri ve sektörler sözlüğü](https://docs.whop.com/tr/api-reference/accounts/business-types.md) güncel değerleri listeler.

* `coaching_and_courses` artık `education`, `physical_product` artık `ecommerce` ve `marketplace` artık `platform` oldu.
* Sektör grupları ve türleri sekiz işletme türü altında yeniden düzenlendi. `PATCH /accounts/{id}` yalnızca sözlükteki slug'ları kabul eder. Bilinmeyen değerler `400` döndürür.

Daha önceki bir sürüme sabitlenmiş çağıranlar önceki işletme türü adlarını almaya devam eder ve bu sürümden önce var olmayan sektör değerleri `null` olarak döndürülür.

**2026-09-09-1**

Hesaba ait deneyler

Bir deney oluşturmak, `biz_` önekli, sahibi olan bir `account_id` gerektirir. Deneyler ayrıca isteğe bağlı kaynak referanslarını ve hesaba özgü bayrak anahtarlarını kabul eder. Listeleme tek bir hesabın deneylerini döndürür ve bunları okumak veya yönetmek hesap izinleri gerektirir. Hesap deneyleri ekip etiketlerini desteklemez veya bir raporlama sağlayıcısı sağlamaz.

Değerlendirme, öznenin kimliğini `subject[account_id]`, `subject[anonymous_id]` ve `subject[user_id]` aracılığıyla belirler. Eski sürümlerdeki çağıranlar mevcut değerlendirme kimliği parametrelerini korur. Hedefleme `properties` değerini bir JSON sorgu değeri olarak geçirin. Mevcut iç içe özellik sorgu anahtarları desteklenmeye devam eder. Exposure isteğe bağlı kimlik bilgilerini kabul eder ve bunların kimliğini olaya kaydeder.

**2026-09-09**

Bekleyen fonlarda adlandırılmış Whop para çekme blokajları

TypeScript SDK: [`@whop/sdk@1.1.3`](https://unpkg.com/@whop/sdk@1.1.3/dist/esm/BaseClient.mjs).

Whop para çekmeleri engellediğinde hesabın `payment_controls.undated_pending_reason` değeri `withdrawals_disabled` olabilir; bu durumda o bekleyen fonlar kullanılabilir hale gelemez.

`kyc_incomplete`, `pending_information_request` ve hâlâ takası yapılmakta olan fonlar için `null` değişmedi.

**2026-09-06**

Etkileşim kitlesi kaynakları

`POST /audiences`, türlendirilmiş bir `engagement` tanımı aracılığıyla videolar, potansiyel müşteri formları, Instagram profilleri ve Facebook sayfalarıyla etkileşimi destekler.

* Açık `source_type` değerleri, gerekli kaynak alanlarının mevcut olduğunu ve çakışan kaynak alanlarının bulunmadığını doğrular.
* Kitle yanıtları `engagement` içerir ve `source_type` değeri `engagement` olabilir. Etkileşim kitleleri benzer kitle kaynağı olarak da kullanılabilir.
* `GET /social_accounts/{id}/posts`, platform tanımlayıcılarını elle bulmadan videoları seçmeye yardımcı olmak için `video_id` ve `caption` içerir.

**2026-09-04**

Bir deneyi sonlandırmak bulgular gerektirir

`POST /experiments/{id}/end`, istek gövdesinde `findings` gerektirir: neyin öğrenildiğine ve deneyin neden bu şekilde sona erdiğine dair kısa bir açıklama.

Daha önceki bir sürüme sabitlenmiş çağıranlar bunu hâlâ atlayabilir. Bu durumda `400` yerine onlar adına bir yer tutucu bulgu değeri kaydedilir.

**2026-09-02-2**

Yatırma hedefleri bir hesap kimliğidir

TypeScript SDK: [`@whop/sdk@1.1.1`](https://unpkg.com/@whop/sdk@1.1.1/dist/esm/BaseClient.mjs), [`@whop/sdk@1.1.2`](https://unpkg.com/@whop/sdk@1.1.2/dist/esm/BaseClient.mjs).

`POST /deposits`, bir `destination` hesap kimliği dizesi (`biz_…` veya `user_…`) alır ve başka hiçbir şey almaz.

* Ham cüzdan adresleri artık kabul edilmiyor. Bir hesaba para yatırın ve adreslerini `methods.crypto` üzerinden okuyun.
* `destination` alanının nesne biçimi (`{ account_id }` / `{ address, network }`) kaldırıldı. Hesap kimliğini tek başına gönderin.
* Üst düzey `network` geçersiz kılma seçeneği kaldırıldı. Yanıtı hiçbir zaman değiştirmiyordu: her yatırma zaten desteklenen her ağ için bir adres döndürür, bu nedenle istediğinizi `methods.crypto` içinden seçin.
* `metadata` hem istekten hem de yanıttan kaldırıldı. Geri yansıtılıyordu ve hiç saklanmıyordu, bu nedenle daha sonraki bir yatırmayı eşleştirmek için kullanılamıyordu.
* Yanıttaki `account_id` artık null değildir, çünkü her hedef artık bir hesabı belirtir.

Daha önceki bir sürüme sabitlenmiş çağıranlar nesne biçimini ve kaldırılan girdileri göndermeye devam eder ve yanıtları hâlâ `metadata` taşır; ancak gönderdikleri değer yerine boş bir nesne olarak. Bir cüzdan adresi her sürümde reddedilir: hiçbir zaman bir hesabı tanımlamadı, bu nedenle sunulmaya devam edilecek eski bir yapı yoktur. Bir `payment_method_id` ile gönderilen `metadata`, kart tahsilatına eklendiği için her sürümde korunur.

**2026-09-02-1**

Ödemeler yerel bir kaynak haline gelir

TypeScript SDK: [`@whop/sdk@1.1.0`](https://unpkg.com/@whop/sdk@1.1.0/dist/esm/BaseClient.mjs).

`POST /payments`, `GET /payments` ve `GET /payments/{id}` artık yerel Payments API'si tarafından sunuluyor ve Payment nesnesi diğer tüm yerel kaynakların yapısını alıyor.

* İlgili kayıtlar gömülü nesneler yerine yabancı anahtar kimlikleridir: `account_id` (önceden `company`), `plan_id`, `product_id`, `membership_id`, `member_id`, `promo_code_id`, `shipment_id`, `payment_method_id`. Alıcı bir `user` özetidir (`id`, `username`, `name`, `profile_picture`).
* Tutarlar çıplak sayılar yerine para nesneleridir (`{ amount, currency, decimals, display_decimals }`): `total`, `subtotal`, `tax_amount`, `refunded_amount`, `tax_refunded_amount`, `amount_after_fees`, `usd_total`. `settlement_amount`, `settlement_currency` ve `settlement_exchange_rate`, `total` ve `currency` içine katlanmıştır. `refunded_amount` ve `tax_refunded_amount`, her iadenin yapıldığı anda geçerli olan kurla, takas edildikleri şekilde belirtilir ve `tax_refunded_amount` artık alma işleminin yanı sıra liste yanıtlarında da bulunur.
* İtirazlar, iadeler ve Resolution Center vakaları artık gömülü değildir; bunları `?payment_id=` ile kendi uç noktalarından listeleyin. Gömülü finansman işlemleri ve uygulama ücreti yerel yapıya taşınmaz.
* `last_payment_attempt` / `next_payment_attempt` artık `last_payment_attempt_at` / `next_payment_attempt_at` oldu. Kart bilgileri `payment_instrument` üzerinde bulunur.
* Bir ödeme oluşturmak `account_id` (önceden `company_id`) alır, `201 Created` yanıtını verir, `Idempotency-Key` değerine uyar ve bir yetkilendirme blokajı koymak için `capture: false` kabul eder.
* Yerel ödeme okumaları hesap kapsamlıdır: kimlik bilgisinin hesabın ödemelerini okuyabilmesi gerekir (bir ekip üyesinin token'ı veya hesabın API anahtarı). Sabitlenmiş proxy sürümlerinin kendi ödemelerini okumak için kabul ettiği bir alıcının kendi kullanıcı token'ı henüz yerel olarak desteklenmiyor; alıcılar sabitlenmiş sürümlerinde çalışmaya devam eder.
* `GET /payments/{id}/fees` satırları para nesneleriyle birlikte `{ type, origin, label, description, amount, settlement_amount, collected_at }` biçimindedir (önceden `name`/`amount`/`currency`/`type`).
* `GET /refunds` ve `GET /refunds/{id}` yerel Refund nesnesini döndürür: gömülü bir ödeme yerine `payment_id` ve `account_id`, ödemenin takas para biriminde bir para nesnesi olarak `amount`, işlemcinin para biriminde `original_amount`. `company_id` filtresi artık `account_id` oldu ve `company_id` göndermek bir 400 döndürür.
* `POST /payments/{id}/refund`, `POST /payments/{id}/retry` ve `POST /payments/{id}/void` de yereldir ve aynı Payment nesnesini döndürür. Refund hâlâ isteğe bağlı bir `partial_amount` alır.
* `GET /payments`, standart `{ data, page_info }` zarfı ve imleç tabanlı sayfalama ile listeler. Filtreler, proxy'nin çoğul dizileri yerine tekil eşitlik parametreleridir (`status`, `billing_reason`, `currency`, `plan_id`, `product_id`, `membership_id`, `member_id`, `user_id`, `account_id`). Proxy'de olduğu gibi `billing_reason=subscription_cycle`, `subscription_update` olarak kaydedilen yenilemeleri de eşleştirir. Sıfır tutarlı ödemeler dahildir, bu nedenle proxy'nin `include_free` parametresi kaldırıldı. Geçersiz bir `status` ve proxy'ye özgü herhangi bir filtre (`substatuses`, `updated_before`/`updated_after`, `checkout_configuration_ids`, çoğul diziler), filtrelenmemiş bir sayfa yerine `400` döndürür. `query` alıcı araması eskisi gibi çalışır. `created_before`/`created_after` aralığı yalnızca ödemenin oluşturulma zamanını kapsar. Proxy, mevcut olduğunda ödenme zamanına göre filtreliyordu. Liste satırlarında `settlement_time_at` null olur; bunun için ödemeyi alın.

**2026-09-02**

Eski reklam raporları uç noktası kullanımdan kaldırıldı

Eski `GET /ad_reports` uç noktası, yerel [Stats](https://docs.whop.com/tr/api-reference/stats/stats) metrikleri ve reklam varlığı uç noktaları lehine kullanımdan kaldırıldı. Bu sürümde artık sunulmuyor.

* `GET /ad_reports`, `error.type` değeri `gone` olan `410 Gone` döndürür. Zaman içindeki `spend`, `impressions` ve `clicks` için, `whop:adcamp_xxx:*` gibi bir `source` yoluyla kapsamlandırılmış `GET /stats/time_series/ad_delivery` kullanın. Atfedilen dönüşümler için `GET /stats/time_series/events` kullanın.
* Bir zaman aralığı için varlık başına performans, varlık uç noktalarında bulunur. `GET /ad_campaigns`, `GET /ad_groups` ve `GET /ads`, `stats_from` ve `stats_to` kabul eder ve her satırda `spend`, `results` ve `return_on_ad_spend` döndürür.
* Eski uç noktadan gelen her yanıt, her sürümde artık `Deprecation` ve `Link: <…/stats/ad_delivery>; rel="successor-version"` başlıklarını taşır. Daha önceki sürümlere sabitlenmiş istekler ve sürümü olmayan istekler, bir `Sunset` başlığı her sürüm için yanıt vermeyi durduracağı tarihi duyurana kadar değişmeden çalışmaya devam eder.

**2026-08-31**

Finansal rapor zaman damgası aralıkları

`GET /financial_reports` ve `GET /financial_reports/breakdown` artık rapor aralıkları için `from` ve `to` ISO 8601 zaman damgalarını kullanır.

* `from_date` ve `to_date` alanlarının adı `from` ve `to` olarak değiştirildi.
* Yalın tarihler artık kabul edilmiyor. Her iki zaman damgasına da bir saat ve saat farkı ekleyin.

**2026-08-25-2**

Açık uygulama doğrulama filtrelemesi

`GET /apps` artık herkese açık web sitesi listeleri için yokluğunu `verified=false` olarak değerlendirmek yerine `verified` alanını isteğe bağlı bir eşitlik filtresi olarak kullanır.

* Her iki doğrulama durumundan herkese açık olarak keşfedilebilir web sitesi şablonlarını döndürmek için `verified` değerini atlayın.
* Whop tarafından doğrulanmış şablonlar için `verified=true`, topluluk şablonları için `verified=false` ayarlayın.
* `recommended=true`, önerilen uygulamaları doğrulama durumundan bağımsız olarak filtreler.

**2026-08-25-1**

Eski para çekme uç noktaları kullanımdan kaldırıldı

Eski `/withdrawals` uç noktaları, yerel [Payouts](https://docs.whop.com/tr/api-reference/payouts/payout) API'si lehine kullanımdan kaldırıldı ve bu sürümde artık sunulmuyor.

* `GET /withdrawals` ve `POST /withdrawals`, `error.type` değeri `gone` olan `410 Gone` döndürür. Bunun yerine `GET /payouts` ve `POST /payouts` kullanın. Ödeme kimlikleri aynı `wdrl_` kimlikleridir, bu nedenle mevcut tanımlayıcılar çözümlenmeye devam eder.
* `GET /withdrawals/{id}` bu sürümde hâlâ yanıt verir. Yeni işler için `GET /payouts/{id}` kullanın.
* Eski uç noktalardan gelen her yanıt, her sürümde artık `Deprecation` ve `Link: <…/payouts>; rel="successor-version"` başlıklarını taşır. Bir `Sunset` başlığı her sürüm için yanıt vermeyi durduracakları tarihi duyuracaktır. O zamana kadar daha önceki sürümlere sabitlenmiş istekler ve sürümü olmayan istekler değişmeden çalışmaya devam eder.

**2026-08-25**

Reklam gönderi kimlikleri

Bir reklamın `post_id` değeri artık, reklam hangi yolla oluşturulmuş olursa olsun, reklam ağının sunduğu gönderiyi belirtir.

* `post_id`, ağın reklam için gönderisini döndürür: Meta'nın yüklenen bir kreatif için oluşturduğu gönderi veya tanıtılan gönderi. Önceden yüklenen kreatiflerden oluşturulan her reklam için `null` idi.
* Bir reklamı yönlendirdiğiniz gönderi, hem yanıtta hem de oluşturma/güncelleme gövdesinde `existing_post_id` alanına taşındı. `post_source` ve `post_thumbnail_url` bu alanı tanımlar.

**2026-08-21-1**

Yerel Files API'si

TypeScript SDK: [`@whop/sdk@1.0.14`](https://unpkg.com/@whop/sdk@1.0.14/dist/esm/BaseClient.mjs).

`POST /files` ve `GET /files/{id}` yeniden tasarlanmış bir dosya nesnesiyle yerel olarak sunulur ve çok parçalı yüklemeler yeni `POST /files/{id}/complete` aracılığıyla tamamlanır.

* Dosya yanıtları standart zarfı taşır: `object`, `visibility` ve ISO 8601 biçiminde bir `created_at`. `size` ve `url` alanları yükleme `ready` olana kadar `null` olur.
* `GET /files/{id}` yalnızca sizin oluşturduğunuz dosyaları çözümler; diğer çağıranlar bir 404 alır.

**2026-08-21**

Ödeme durumu v2

TypeScript SDK: [`@whop/sdk@1.0.13`](https://unpkg.com/@whop/sdk@1.0.13/dist/esm/BaseClient.mjs).

Payout nesnesinin yaşam döngüsü terminolojisi yeniden oluşturuldu ve para alanları ondalık dizelere dönüştü.

* `status` sekiz kelime kullanır: `requested`, `in_review`, `processing`, `completed`, `reversed`, `canceled`, `failed`, `denied`. Sağlayıcının geri çevirdiği, tamamlanmış bir ödeme `reversed` olarak okunur; iade kodu ve `funds_returned_at` değeri `failure` içinde bulunur.
* Yeni bir `status_detail` alanı, durum kelimesinin altındaki en ayrıntılı makine aşamasını taşır. Değerleri sürüm artışı olmadan genişleyebilir; sürümlenen sözleşme `status` alanıdır.
* `amount`, `fee_amount`, `net_amount`, `markup_fee` ve `destination_amount` ondalık dizelerdir. `exchange_rate` bir sayı olarak kalır.
* Ödemeler `wdrl_` kimlikleri altında oluşturulur: `POST /payouts` uç noktasının döndürdüğü kimlik, `GET /payouts` uç noktasının listelediği kimliktir ve bir ödemenin dönüştürme talebi `payout_request_id` olarak korunur. Bu sürümden önce oluşturulan dönüştürme talepleri `cofr_` kimlikleri altında yanıt vermeye devam eder.
* Idempotency anahtarı yalnızca `Idempotency-Key` başlığında gönderilir ve `idempotency_key` gövde alanı reddedilir.

Daha önceki sürümlere sabitlenmiş istekler önceki terminolojiyi, ondalıklı (float) para değerlerini ve gövde alanındaki idempotency anahtarlarını korur. Webhook yükleri de aynı şekilde aboneliğin `api_version_date` değerini izler: `2026-08-21` veya sonrasına sabitlenmiş abonelikler yeni ödeme yapısını alır, daha önceki veya sabitlenmemiş abonelikler öncekini korur.

**2026-08-14**

Webhook zarfında account\_id

Webhook zarfındaki `company_id` alanının adı `account_id` olarak değiştirildi.

* `2026-08-14` veya sonrasına sabitlenmiş webhook teslimatları zarfta `account_id` taşır.
* Daha önceki sürümlere sabitlenmiş webhook'lar ve bir `api_version_date` sabitlemesi olmayan webhook'lar `company_id` alanını korur.

**2026-08-13**

Aktarımdaki bakiye dökümleri

TypeScript SDK: [`@whop/sdk@1.0.11`](https://unpkg.com/@whop/sdk@1.0.11/dist/esm/BaseClient.mjs).

Hesap ve kişisel bakiye dökümleri artık `pending` yanında `in_transit` alanını da sunar.

* Takas bekleyen toplam tutarı göstermek için `pending` ve `in_transit` değerlerini toplayın.
* Daha önceki sürümlere sabitlenmiş çağıranlar birleşik tutarı `pending` içinde almaya devam eder.

**2026-08-12**

Webhook API sürümü girdisi kaldırıldı

`POST /webhooks` ve `PATCH /webhooks/{id}` üzerindeki `api_version` girdisi kaldırıldı.

* Yeni webhook'lar her zaman `v1` olaylarını ve yüklerini kullanır. `api_version` geçiren istekler bir `400` ile reddedilir.
* Bunun yerine bir webhook'un yük yapısını `api_version_date` ile sabitleyin.
* Mevcut `v2` ve `v5` webhook'ları teslimata devam eder. Artık bu sürümlerde webhook oluşturamaz veya webhook'ları bu sürümlere geçiremezsiniz.

**2026-08-10**

Yerel itiraz uyarısı uç noktaları

İtiraz uyarıları artık yerel bir REST kaynağıdır ve eski proxy ile birlikte ikili olarak sunulmaya devam eder.

* `GET /dispute_alerts`, bir hesabın uyarılarını imleç tabanlı sayfalama ile listeler ve `account_id`, `payment_id`, `type` ve bir oluşturma aralığına göre filtreler.
* `type`, `alert_type` alanının yerini alır ve kartı veren kuruluşun gönderdiği iki türü adlandırır: `early_fraud_warning` (Visa TC40 / Mastercard SAFE dolandırıcılık raporları) ve `dispute_alert` (itiraz öncesi bildirimler).
* `fee_charged`, `charge_for_alert` alanının yerini alır ve Whop'un hesabı gerçekten faturalandırıp faturalandırmadığını bildirir. Erken dolandırıcılık uyarıları asla faturalandırılmaz.
* `actionable`, ödemeyi iade etmenin bir ters ibrazı hâlâ önleyip önleyemeyeceğini bildirir.
* `payment` ve `dispute` nesnelerinin yerini `payment_id` ve `account_id` etiketleri alır. Zaman damgaları ISO 8601 biçimindedir; kartı veren kuruluşun raporu ne zaman verdiğini `reported_at` belirtir.

**2026-08-05-1**

Takaslarda itibari para birimi dönüştürme

İtibari para çifti takasları (iki itibari para birimiyle `POST /swaps`) artık serbest biçimli para birimi dönüştürmeyi destekler ve `amount` kripto takası semantiğiyle eşleşir.

* `amount`, orta piyasa kurundan dönüştürülecek `from_token` miktarıdır. Negatif bakiye gerekmez.
* Negatif bir `to_token` bakiyesinin kısmi geri ödemesini boyutlandırma, yeni `to_amount` alanına taşındı (`to_token` cinsinden, borçla sınırlı). `amount` ve `to_amount` birbirini dışlar.
* İkisini de atlamak hâlâ negatif `to_token` bakiyesinin tamamını geri öder.
* Daha önceki sürümlere sabitlenmiş çağıranlar önceki davranışı korur: itibari `amount` değerleri `to_token` geri ödeme tutarı olarak değerlendirilir.

**2026-08-05**

Düz doğrulama gereksinimleri

Bir doğrulamanın `requested_information` değeri artık düz bir listedir: giriş başına bir gereksinim, yanıt başına bir yazma.

* Her giriş gerekeni `requirement` içinde adlandırır: `bank_statement` gibi bir belge veya `ssn` gibi bir alan anahtarı; kullanıcıya gösterilecek bir `label` ile birlikte.
* `file` girişlerini `file` (doğrudan yükleme kimliği) ile yanıtlayın. `text`, `date`, `phone` ve `select` girişlerini `value` ile, `address` girişlerini ise `address` ile yanıtlayın. Yanıttan hiçbir şey geri yansıtılmaz.
* `multiple` olarak işaretlenmiş bir giriş, tek bir yanıtta yuva sırasına göre birkaç dosya alır; iki taraflı bir belge için önce ön yüz.
* `options` listeleyen bir giriş ayrıca bir `value` alır. `select` girişleri için seçenekler izin verilen yanıtlardır. Kimlik belgeleri için seçenekler kabul edilen kimlik türleridir.
* Uygulanmayan anahtarlar atlanır ve reddedilen gönderimler, sabit bir `code` ve bir `reason` içeren yapılandırılmış `errors` taşır.
* İç içe `requested_files`/`category` form yapısı bu sürümden kaldırıldı. Daha önceki sürümlere sabitlenmiş çağıranlar bunu korur ve yanıtları otomatik olarak dönüştürülür.

**2026-08-03**

Yerel promosyon kodu uç noktaları

Promosyon kodları artık eksiksiz bir üst düzey REST kaynağıdır ve eski proxy ile birlikte ikili olarak sunulmaya devam eder.

* `GET /promo_codes` bir hesabın promosyon kodlarını listeler ve `company_id` yerine `account_id` kullanır.
* `POST /promo_codes` promosyon kodları oluşturur. `GET` ve `DELETE /promo_codes/{id}` bunları alır ve arşivler.
* `POST /promo_codes/{id}/activate` ve `POST /promo_codes/{id}/deactivate`, eski `PATCH` durum yazmasının yerini alır.
* Liste yanıtları imleç tabanlı sayfalama kullanır ve durum, ürün, varyant, zaman damgası ve sıralama filtrelerini destekler.
* Daha önceki sürümlere sabitlenmiş çağıranlar eski proxy sözleşmesini değişmeden korur.

**2026-07-31**

Daha zengin üst hesaplar

Hesap yanıtları artık bağlı hesaplar için daha zengin bir üst hesap ilişkisi sunar.

* `parent_account`, `parent_account_id` alanının yerini alır.
* Üst hesap kendi `id`, `title`, `route` ve `logo_url` değerlerini içerir.

**2026-07-29-1**

Desteklenen ödeme yöntemleri

Desteklenen ödeme yöntemlerinin artık kendi sayfalanmış uç noktası var.

* `GET /payouts/supported_methods`, bir hesabın veya kullanıcının eklemeye uygun olduğu ödeme yöntemlerini listeler.
* Desteklenen yöntemler `object: "supported_payout_method"` kullanır ve `podst_` kimlikleri `supported_payout_method_id` olarak geçirilir.
* Kaydedilmiş ödeme yöntemleri `supported_payout_method` sunar. Ödemeler `payout_method.supported_payout_method` sunar.
* Ödeme hesabının ülkesi dışındaki bir ülke için desteklenen yöntemleri listelemek üzere `country` kullanın.
* `GET /payouts/methods` artık `include_available` kabul etmez veya `available_destinations` döndürmez.
* Daha önceki sürümlere sabitlenmiş çağıranlar `destination_id`, `payout_destination` ve `payout_token` alanlarını korur.

**2026-07-29**

Yerel kart işlemleri, ödeme yöntemi varış tahminleri

Kart işlemleri artık yerel REST uç noktalarını kullanır ve eski proxy ile birlikte ikili olarak sunulmaya devam eder.

* `GET /card_transactions` bir hesabın kart işlemlerini listeler ve `GET /card_transactions/{id}` birini `citx_` kimliğiyle alır. Liste ayrıca belirli işlemleri tek bir istekte getirmek için bir `transaction_ids` filtresi alır.
* Kart işlemleri hesap kapsamlıdır: sahip `account_id` ile seçilir ve varsayılan olarak kimlik bilgisinin ait olduğu hesaptır.
* `transaction_ids`, `card_id`, `cardholder_id`, `status`, `created_after` ve `created_before` üzerinde filtreler. Zaman damgası filtreleri ISO 8601 biçimindedir.
* `cardholder_id` yanıtta yenidir: kartın atandığı kullanıcı.

Ödeme yöntemleri artık tutardan bağımsız ücret ve teslimat koşulları taşır ve teklif artık varış tahminlerini yinelemez.

* Her ödeme yöntemi bir `amount` gerektirmeden `fee_structure` (yüzde, sabit tutar ve para birimi) ve `estimated_arrival` (hız başına zaman damgaları) döndürür.
* Teklifin `standard` ve `instant` nesneleri artık `estimated_arrival` içermez. Bunu yöntemin üst düzey `estimated_arrival` alanından okuyun.

**2026-07-27**

Yerel Resolution Center uç noktaları

Resolution Center vakaları artık yerel REST uç noktalarını kullanır ve eski proxy ile birlikte ikili olarak sunulmaya devam eder.

* `status`, `escalated`, `outcome`, `refund`, `reason` ve `available_actions`, vaka durumunu ve izin verilen eylemleri sunar.
* Olaylar sayfalanmış `GET /resolution_center_cases/{id}/events` üzerinden kullanılabilir. Özetler `GET /resolution_center_cases/summary` üzerinden kullanılabilir.
* Yazmalar `message` ve `attachments` kullanır. `due_date` alanının adı `response_due_at` olarak değiştirildi. Listeleme artık `account_id` gerektirmez.

**2026-07-26**

Yerel gönderi uç noktaları

Gönderiler (shipments) artık yerel REST uç noktalarını kullanır ve eski proxy ile birlikte ikili olarak sunulmaya devam eder.

* `GET /shipments` gönderileri listeler. `GET /shipments/{id}` gönderi kimliğine veya ödeme kimliğine göre alır.
* `POST /shipments` bir gönderi oluşturur ve `PATCH /shipments/{id}` takip numarasını günceller.
* Yanıtlar `carrier`, `tracking_url`, `order_id` ve `payment_id` ile birlikte `account_id` ve `tracking_number` kullanır.
* Bu tarihten önceye sabitlenmiş çağıranlar eski proxy sözleşmesini değişmeden korur.

**2026-07-25**

Yerel itiraz uç noktaları

İtirazlar artık yerel REST uç noktalarını kullanır ve eski proxy ile birlikte ikili olarak sunulmaya devam eder.

* `PATCH /disputes/{id}` kanıtları düzenler ve `POST /disputes/{id}/submit` bunları gönderir. Kanıtlar `evidence` altında iç içe bulunur.
* `GET /disputes/summary`, `status` ve `currency` değerlerine göre gruplandırılmış toplamlar sağlar. Listeleme ve alma aynı alanları döndürür.
* Yanıtlar `account_id`, `product_id` ve `plan_id` ile birlikte `payment` yanında `buyer` kullanır. Listeleme artık `account_id` gerektirmez.
* `status` ve `reason` normalleştirilmiş enum'lardır ve `needs_response_by`, `rdr` ve `editable` alanlarının yerini yeni alanları alır.
* Bu tarihten önceye sabitlenmiş çağıranlar eski proxy sözleşmesini değişmeden korur.

**2026-07-23**

Üyeler ve üyelikler

Üyeler ve üyelikler artık hesap odaklı bir üyelik modeli ve yeniden tasarlanmış yaşam döngüsü eylemleriyle yerel kaynakları kullanır.

* Üyelik yanıtları, iç içe uyumluluk `plan` ve `product` nesneleri yerine `plan_id` uyumluluk alanını ve `product_id` değerini döndürür.
* Üyelikleri listelemek, çağıranın okuyabildiği her şeyi (kendisininkiler ve yönettiği hesaplarınkiler) döndürür ve `account_id`/`user_id`, mod değiştirmek veya hata vermek yerine bu listeyi daraltır.
* İptali planlamak için `cancel_at_period_end` ayarlayın. `cancel` eylemi erişimi hemen sonlandırır.
* `extend` eylemi `add_free_days` eyleminin yerini alır.

**2026-07-22**

REST yanıtı ve zaman damgası tutarlılığı

Current API artık tutarlı silme yanıtları, zaman damgası girdileri ve Account adlandırması kullanır.

* Ürünler, varyantlar, ödeme yapılandırmaları, reklamlar, reklam grupları, reklam kampanyaları, sosyal hesaplar ve ödül görevi gönderimleri için silme uç noktaları, çıplak bir boolean yerine `{ id, deleted: true }` döndürür.
* Ürünler, varyantlar, ödeme yapılandırmaları, transferler ve finansal raporlardaki zaman damgası filtreleri, epoch saniyelerini de kabul etmek yerine yalnızca ISO 8601 kabul eder.
* Ürün yanıtları `company` yerine `account` döndürür.

**2026-07-20**

Ortak işletme ödeme yüzdeleri

Ortak işletmeler artık her gelir kaynağı için ayrı ödeme oranları sunar.

* `payout_percentage` alanının yerini `payout_percentages` alır.
* İç içe nesne `sales`, `ad_spend`, `transfer` ve `card_interchange` oranlarını içerir.

**2026-07-18**

Ürünler ve ödeme yapılandırmaları

Ürünler ve ödeme yapılandırmaları artık Account modelini tutarlı bir şekilde kullanır.

* Ürün istek parametreleri `company_id` yerine `account_id` kullanır.
* Ödeme yapılandırması istekleri, üst düzeyde ve `plan` uyumluluk alanının taşıdığı satır içi varyant nesnelerinin içinde `account_id` kullanır.
* Ödeme yapılandırması yanıtları `company_id` yerine `account_id` döndürür.

**2026-07-08-1**

Ödeme yapılandırması zaman damgaları

Ödeme yapılandırması zaman damgaları artık API'nin geri kalanıyla aynı biçimi kullanır.

* `created_at` ve `updated_at`, Unix epoch tam sayıları yerine ISO 8601 dizeleridir.

**2026-07-08**

Kullanıcı bakiyeleri

Kullanıcı bakiyeleri artık eksiksiz, yapılandırılmış bir bakiye özeti sunar.

* Düz `total_usd` ve `balances` alanlarının yerini iç içe bir `balance` nesnesi alır.
* Özet; nakit, kripto, işlemdeki hazine yatırmaları ve kullanıcının sahip olduğu hesapların bakiyelerini ayırır.

**2026-07-01**

İşletme yönlendirme kazancı kaynakları

İşletme yönlendirme kazançları artık kazancı oluşturan polimorfik kaynağı tanımlar.

* `receipt` alanının yerini `resource` alır.
* `access_pass` alanının yerini `product` alır.
* Makbuz tabanlı kazançlar, makbuz ödeme ayrıntılarıyla birlikte `resource.object: "receipt"` döndürür.
* `resource` alanı, makbuza özgü alanları yeniden kullanmadan gelecekteki sürümlerde ek kazanç kaynaklarını destekleyebilir.

**2026-06-20**

İşletme yönlendirmeleri kaynağı

İşletme yönlendirme hacmi ve kazançları artık mutabakat sağlayan gruplar olarak raporlanır.

* `processing_volume`, `total_earnings`, `pending_payout` ve `completed_payout` alanlarının yerini iç içe `volume_usd` ve `earnings_usd` nesneleri alır.
* Kazançlar `base_amount`/`amount` alanlarını `transaction_amount_usd`/`commission_amount_usd` olarak yeniden adlandırır ve `payout_percentage` değerini bir kesir olarak ifade eder.

**2026-06-09**

Varyantlar kaynağı (o zamanki adıyla Plans)

O zamanlar Plans olarak adlandırılan varyantlar artık Account modelini tutarlı bir şekilde kullanır.

* İstek parametreleri ve istek gövdeleri `company_id` yerine `account_id` kullanır.
* Varyant yanıtları `company` yerine `account` döndürür.

**2026-06-08**

Kullanıcılar kaynağı

Kullanıcı erişim istekleri artık Account modelini tutarlı bir şekilde kullanır.

* İstek parametreleri ve istek gövdeleri `company_id` yerine `account_id` kullanır.
* Yanıt yapıları değişmedi.

**2025-01-01**

Orijinal sürüm

Tarihli sürümleme var olmadan önceki orijinal Current API davranışı.

`Api-Version-Date` içermeyen istekler bu sürümü kullanır, böylece mevcut entegrasyonlar çalışmaya devam eder.


## Related topics

- [Verifications API](https://docs.whop.com/tr/api-reference/verifications/verification.md)
- [Members API](https://docs.whop.com/tr/api-reference/members/member.md)
- [Memberships API](https://docs.whop.com/tr/api-reference/memberships/membership.md)
