Skip to main content
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.
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.
Latest
Bir seviye yalnızca kendi seviyesini ve puanlarını tutar
Retrieve user ve Retrieve account ü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.
Bir seviyenin `applied_level` alanı artık `current`
Retrieve user ve Retrieve account ü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.
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.
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, 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 üzerindeki target_user_id filtresi hiçbir talep döndürmez ve bir talepteki user her zaman null olur.
Bir kullanıcının seviyesi herkese açıktır
Retrieve user, 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.
Kendi satın alımlarınızı listeleyin ve alın
Bir kullanıcı kimlik bilgisiyle, list payments ü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 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.
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.
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 kullanın. E-posta ile bir üye eklemek için Create member kullanın. Birini okumak veya güncellemek için Retrieve member ve Update member kullanın.
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.
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ıkbiro¨no¨demeu¨cretiveu¨c\cadet40'lık bir ön ödeme ücreti ve üç adet 40 ‘lık taksit, önce 115 ,sonra40, sonra 40 , sonra 40 $ olarak faturalandırılır.
Yenilenen Economic Intelligence teklifi `3_days`
TypeScript SDK: @whop/sdk@2.8.0.Retrieve account preferences ü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 uç noktasına economic_intelligence_duration_key: "3_days" gönderin. weekly anahtarı reddedilir.
Reklam istatistikleri artık `clicks` almıyor
clicks alanı Create ad stats 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.
Chat API: kanallar, üyeler ve mesajlar
Uygulamanıza sohbet ekleyin. Kanallar doğrudan mesajları, grup sohbetlerini, topluluk sohbetlerini ve destek sohbetlerini kapsar. Kanal üyeleri kişi ekler ve çıkarır. Mesajlar 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 204 döndürür. POST /messages/{id}/react, /unreact ve /vote ile tepki verin ve oy verin.
`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 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.
Ödeme listeleri Whop Card'ı içerir
List saved payout methods, hesabın Whop Card’ını içerir. List payouts, fonları ona aktaran ödemeleri içerir. Kaydedilmiş bir ödeme yöntemi ve bir ödemenin 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.
İşlemdeki bir itiraz başvurusu `generating_response` bildirir
Kanıtı ödeme işlemcisinde olan ve henüz kabul edilmemiş bir itiraz, 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.
Whop Levels: uygulanan seviye `applied_level`
Bir kullanıcının ve bir hesabın 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 üzerinden okuyun. Bir hesabın level alanı ayrıca kendi puanlarının ulaştığı seviye olan account_level alanını ekler.
Reklam sertifikaları kaldırıldı
Whop artık reklam sertifikaları sunmuyor. Retrieve account preferences ve Update account preferences artık ads_certifications döndürmez ve bir güncelleme artık bunu kabul etmez.
Bağlı hesaplar artık alt hesaplar
Platform alt hesapları artık subaccount (alt hesap) olarak adlandırılıyor. List payments ve List disputes üzerinde ve bunların özet uç noktalarında include_connected_accounts artık include_subaccounts oldu. Update account preferences ü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.
Ödeme talepleri bir teklif gerektirir
Create a payout 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.
Taslak oluşturulduktan sonra bir faturanın müşterisi değiştirilemez
Update invoice ü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. Ardından yeni bir fatura oluşturun. Müşterisi olmadan kaydedilmiş bir taslağa yine de müşteri eklenebilir.
Snapchat bağlantıları kaldırıldı
Connect an External Account 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.
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.
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 artık meta_business almaz ve tiktok artık advertise kapsamını almaz. Bunlardan birini göndermek bir 400 döndürür.
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.
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 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.
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.
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, Duplicate an Ad Group veya Duplicate an Ad 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.
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.
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 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, Create ad veya Update ad uç noktasına göndermek bir 400 döndürür.
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, Update ad group, Create ad veya Update ad uç noktasına göndermek, alanı adlandıran bir 400 döndürür.
Hesap varyant listeleri eski fatura varyantlarını dışarıda bırakır
account_id ile List variants, faturası sonradan silinmiş olanlar dahil, eski bir fatura için oluşturulmuş varyantları dışarıda bırakır. Birini okumak için varyantı kimliğiyle alın. Kullanımdan kaldırılmış GET /plans listesi de aynı şekilde davranır.
Takaslar cüzdan bakiyesinin üzerindeki bir tutarı reddeder
Create swap ü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.
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 ve Create waitlist entry variant_id alır ve Approve all waitlist entries variant_id alır ve döndürür. List memberships variant_id ve variant_ids ile, List members variant_ids ile ve List waitlist entries 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, plan_ids yerine variant_ids ile filtreler. Create payment ve Create payment quote, 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, plan_id yerine variant_id ve plan yerine satır içi bir variant (billing_type ile) alır ve List checkout configurations variant_id ile filtreler. Ödeme oturumu istekleri ve yanıtları items[].plan yerine items[].variant kullanır.Promosyon kodları ve ortaklar. List promo codes, plan_ids yerine variant_ids ile filtreler ve Create promo code variant_ids alır.
Ü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 billing_type alır ve List variants ile List products, 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 oluşturun.Varyant kimlikleri plan_ önekini korur ve plan:* izin kapsamları ile plan.* webhook olay adları değişmez.
Davetler bekleyen ekip üyesini döndürür
Create team member ü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.
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.
Hesaplar artık stablecoin_rails içermiyor
Hesaplar artık stablecoin_rails içermiyor.
Doğrulama belgesi türleri küçük harflidir
Create verification üzerinde ve owners içindeki sahiplerde document_type küçük harfli değerler alır: passport, id_card, drivers veya residence_permit. Kimlik belgeleri kılavuzu her ülkenin hangilerini kabul ettiğini listeler.
Yatırma kartı tahsilatı methods altına taşındı
Create deposit ü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.
Ö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 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.
Yerel yorumlar
TypeScript SDK: @whop/sdk@2.5.0.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.
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.
Uygulamalar artık önceki barındırılan URL'leri listelemiyor
TypeScript SDK: @whop/sdk@2.4.0.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.
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.
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.
Bekleyen fonlar bir uyumluluk incelemesi bekliyor olabilir
TypeScript SDK: @whop/sdk@2.3.0.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.
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.
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.
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.
Uygulama derlemeleri artık bir yapay zekâ istemi almıyor
Bir uygulama derlemesi oluşturmak artık ai_prompt_id kabul etmiyor.
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.
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.
Kullanıcılar artık sosyal hesapları içermiyor
Kullanıcılar artık social_accounts döndürmüyor.
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.
Önlenen itirazlar prevented olarak bildirilir
TypeScript SDK: @whop/sdk@2.1.0, @whop/sdk@2.2.0.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.
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.
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.
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.
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.
Alım satım erişimi izin kontrollerinde görünür
TypeScript SDK: @whop/sdk@2.0.0.GET /permissions, bir hesap için izin eylemlerini listelerken veya kontrol ederken crypto_wallet:trade ve crypto_wallet:trade:read değerlerini içerir.
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.
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.
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.
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.
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.
Üç ayrı 3D Secure politikası
TypeScript SDK: @whop/sdk@1.1.5.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.
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.
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.
İşletme kategorileri tek bir tablodan gelir
TypeScript SDK: @whop/sdk@1.1.4.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üğü 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.
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.
Bekleyen fonlarda adlandırılmış Whop para çekme blokajları
TypeScript SDK: @whop/sdk@1.1.3.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.
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.
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.
Yatırma hedefleri bir hesap kimliğidir
TypeScript SDK: @whop/sdk@1.1.1, @whop/sdk@1.1.2.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.
Ödemeler yerel bir kaynak haline gelir
TypeScript SDK: @whop/sdk@1.1.0.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.
Eski reklam raporları uç noktası kullanımdan kaldırıldı
Eski GET /ad_reports uç noktası, yerel 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.
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.
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.
Eski para çekme uç noktaları kullanımdan kaldırıldı
Eski /withdrawals uç noktaları, yerel Payouts 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.
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.
Yerel Files API'si
TypeScript SDK: @whop/sdk@1.0.14.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.
Ödeme durumu v2
TypeScript SDK: @whop/sdk@1.0.13.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.
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.
Aktarımdaki bakiye dökümleri
TypeScript SDK: @whop/sdk@1.0.11.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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Ü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.
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.
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.
Ü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.
Ö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.
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.
İş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.
İş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.
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.
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.
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.