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.
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.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.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.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.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.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 ü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 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.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.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 taksit, önce 115 , sonra 40 $ olarak faturalandırılır.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.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.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.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.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.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.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.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.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.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.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.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ı 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.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ı 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 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.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 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.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.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.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.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.Ü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ü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.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.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.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.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ı 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=anyile veya doğrulanmış alan adları içinapple_pay=readyileGET /domains. Ana bilgisayar adına görehostnameyerinedomainile filtreleyin.GET /payment_method_domains/{id}:GET /domains/{id}.POST /payment_method_domains:domain,account_idveapple_pay: {}ilePOST /domains. Hesapta alan adı zaten varsa,apple_pay: {}ilePATCH /domains/{id}.POST /payment_method_domains/{id}/verify:POST /domains/{id}/check.DELETE /payment_method_domains/{id}:apple_pay: nullilePATCH /domains/{id}.DELETE /domains/{id}, üzerindeki herhangi bir web sitesi dahil tüm alan adını kaldırır.status: verified,apple_pay.state: readydemektir.status: pending, Whop alan adını kaydederkenapple_pay.state: pending, ilişkilendirme dosyasını barındırıp alan adını kontrol edene kadar iseaction_requireddemektir.
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.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
404döndürür. - Alınan bir yorum
companyyerineaccountdöndürür. - Yorumları listelemek
account_idveyaproduct_idile filtreler,ordervedirectionile 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_idartık kabul edilmiyor.account_idkullanın.DELETE /reviews/{id}, oturum açmış kullanıcının yazdığı bir yorumu siler vereview:deletekapsamını gerektirir.
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.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.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.Ö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.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_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.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.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.Bir uygulama derlemesi oluşturmak artık
ai_prompt_id kabul etmiyor.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 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.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.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.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’ı 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.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’ı 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.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 ö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 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.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.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(öncedencompany),member_id(öncedenmember),payment_method_id(öncedenpayment_method) vecheckout_configuration_id(öncedencheckout_configuration). Alıcı biruserözetidir (id,username,name,profile_picture). error_message, Retrieve setup status’un döndürdüğü aynı{ code, message }bloğu olanlast_setup_erroriçine taşınır. Bir şey başarısız olana kadarnullkalır ve kurulum başarılı olduğunda kaldırılır.return_url,payment_method_typeveupdated_atyenidir.created_atveupdated_atISO 8601 zaman damgalarıdır.- Payment nesnesinin zaten taşıdığı görüntülemeye uygun yöntem olan
payment_instrumentSetup Intent’te de bulunur, böylece kaydedilmiş bir kart ikinci bir istek olmadan görüntülenir. Onuncardalanı her iki kaynakta daexp_monthveexp_yearkazanır.card.branddeğerinullolabilir: ağını kasanın kaydetmediği kaydedilmiş bir kart, tümcardnesnesini kaybetmek yerine son dört hanesini ve son kullanma tarihini korur. - Bir setup intent oluşturmak
201 Created(önceden200) yanıtını verir,Idempotency-Keydeğerine uyar veconfirmation_tokenveyapayment_method_iddeğerlerinden tam olarak birini gerektirir. Başka bir hesaba ait bir onay token’ı404döndürür. client_secretoluş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ınpayment:chargekimlik bilgisi veya alıcının kendi token’ı. Liste satırları her zamannulltaşır.- Bu sürüme veya sonrasına sabitlenmiş
setup_intent.requires_action,setup_intent.succeededvesetup_intent.canceledwebhook’ları,dataolarak 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_idisteğe bağlıdır: bir hesap API anahtarı kendi hesabını listeler ve bir kullanıcı token’ı okuyabildiği her hesabı listeler.statusyeni bir filtredir ve geçersiz bir değer400döndürür.created_beforevecreated_aftereskisi gibi çalışı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.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.
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.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.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.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_coursesartıkeducation,physical_productartıkecommercevemarketplaceartıkplatformoldu.- 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ğerler400döndürür.
null olarak döndürülür.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.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.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_typedeğerleri, gerekli kaynak alanlarının mevcut olduğunu ve çakışan kaynak alanlarının bulunmadığını doğrular. - Kitle yanıtları
engagementiçerir vesource_typedeğeriengagementolabilir. 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çinvideo_idvecaptioniçerir.
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.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. destinationalanının nesne biçimi ({ account_id }/{ address, network }) kaldırıldı. Hesap kimliğini tek başına gönderin.- Üst düzey
networkgeç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ğinizimethods.cryptoiçinden seçin. metadatahem 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_idartık null değildir, çünkü her hedef artık bir hesabı belirtir.
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.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(öncedencompany),plan_id,product_id,membership_id,member_id,promo_code_id,shipment_id,payment_method_id. Alıcı biruserö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_currencyvesettlement_exchange_rate,totalvecurrencyiçine katlanmıştır.refunded_amountvetax_refunded_amount, her iadenin yapıldığı anda geçerli olan kurla, takas edildikleri şekilde belirtilir vetax_refunded_amountartı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_attemptartıklast_payment_attempt_at/next_payment_attempt_atoldu. Kart bilgileripayment_instrumentüzerinde bulunur.- Bir ödeme oluşturmak
account_id(öncedencompany_id) alır,201 Createdyanıtını verir,Idempotency-Keydeğerine uyar ve bir yetkilendirme blokajı koymak içincapture: falsekabul 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}/feessatırları para nesneleriyle birlikte{ type, origin, label, description, amount, settlement_amount, collected_at }biçimindedir (öncedenname/amount/currency/type).GET /refundsveGET /refunds/{id}yerel Refund nesnesini döndürür: gömülü bir ödeme yerinepayment_idveaccount_id, ödemenin takas para biriminde bir para nesnesi olarakamount, işlemcinin para birimindeoriginal_amount.company_idfiltresi artıkaccount_idoldu vecompany_idgöndermek bir 400 döndürür.POST /payments/{id}/refund,POST /payments/{id}/retryvePOST /payments/{id}/voidde yereldir ve aynı Payment nesnesini döndürür. Refund hâlâ isteğe bağlı birpartial_amountalı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 gibibilling_reason=subscription_cycle,subscription_updateolarak kaydedilen yenilemeleri de eşleştirir. Sıfır tutarlı ödemeler dahildir, bu nedenle proxy’nininclude_freeparametresi kaldırıldı. Geçersiz birstatusve proxy’ye özgü herhangi bir filtre (substatuses,updated_before/updated_after,checkout_configuration_ids, çoğul diziler), filtrelenmemiş bir sayfa yerine400döndürür.queryalıcı araması eskisi gibi çalışır.created_before/created_afteraralığı yalnızca ödemenin oluşturulma zamanını kapsar. Proxy, mevcut olduğunda ödenme zamanına göre filtreliyordu. Liste satırlarındasettlement_time_atnull olur; bunun için ödemeyi alın.
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.typedeğerigoneolan410 Gonedöndürür. Zaman içindekispend,impressionsveclicksiçin,whop:adcamp_xxx:*gibi birsourceyoluyla kapsamlandırılmışGET /stats/time_series/ad_deliverykullanın. Atfedilen dönüşümler içinGET /stats/time_series/eventskullanın.- Bir zaman aralığı için varlık başına performans, varlık uç noktalarında bulunur.
GET /ad_campaigns,GET /ad_groupsveGET /ads,stats_fromvestats_tokabul eder ve her satırdaspend,resultsvereturn_on_ad_spenddöndürür. - Eski uç noktadan gelen her yanıt, her sürümde artık
DeprecationveLink: <…/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, birSunsetbaşlığı her sürüm için yanıt vermeyi durduracağı tarihi duyurana kadar değişmeden çalışmaya devam eder.
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_dateveto_datealanlarının adıfromvetoolarak değiştirildi.- Yalın tarihler artık kabul edilmiyor. Her iki zaman damgasına da bir saat ve saat farkı ekleyin.
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
verifieddeğerini atlayın. - Whop tarafından doğrulanmış şablonlar için
verified=true, topluluk şablonları içinverified=falseayarlayın. recommended=true, önerilen uygulamaları doğrulama durumundan bağımsız olarak filtreler.
Eski
/withdrawals uç noktaları, yerel Payouts API’si lehine kullanımdan kaldırıldı ve bu sürümde artık sunulmuyor.GET /withdrawalsvePOST /withdrawals,error.typedeğerigoneolan410 Gonedöndürür. Bunun yerineGET /payoutsvePOST /payoutskullanı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çinGET /payouts/{id}kullanın.- Eski uç noktalardan gelen her yanıt, her sürümde artık
DeprecationveLink: <…/payouts>; rel="successor-version"başlıklarını taşır. BirSunsetbaş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.
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çinnullidi.- Bir reklamı yönlendirdiğiniz gönderi, hem yanıtta hem de oluşturma/güncelleme gövdesinde
existing_post_idalanına taşındı.post_sourcevepost_thumbnail_urlbu alanı tanımlar.
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,visibilityve ISO 8601 biçiminde bircreated_at.sizeveurlalanları yüklemereadyolana kadarnullolur. GET /files/{id}yalnızca sizin oluşturduğunuz dosyaları çözümler; diğer çağıranlar bir 404 alır.
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ü.statussekiz kelime kullanır:requested,in_review,processing,completed,reversed,canceled,failed,denied. Sağlayıcının geri çevirdiği, tamamlanmış bir ödemereversedolarak okunur; iade kodu vefunds_returned_atdeğerifailureiçinde bulunur.- Yeni bir
status_detailalanı, 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şmestatusalanıdır. amount,fee_amount,net_amount,markup_feevedestination_amountondalık dizelerdir.exchange_ratebir sayı olarak kalır.- Ödemeler
wdrl_kimlikleri altında oluşturulur:POST /payoutsuç noktasının döndürdüğü kimlik,GET /payoutsuç noktasının listelediği kimliktir ve bir ödemenin dönüştürme talebipayout_request_idolarak korunur. Bu sürümden önce oluşturulan dönüştürme taleplericofr_kimlikleri altında yanıt vermeye devam eder. - Idempotency anahtarı yalnızca
Idempotency-Keybaşlığında gönderilir veidempotency_keygövde alanı reddedilir.
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ındaki
company_id alanının adı account_id olarak değiştirildi.2026-08-14veya sonrasına sabitlenmiş webhook teslimatları zarftaaccount_idtaşır.- Daha önceki sürümlere sabitlenmiş webhook’lar ve bir
api_version_datesabitlemesi olmayan webhook’larcompany_idalanını korur.
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
pendingvein_transitdeğerlerini toplayın. - Daha önceki sürümlere sabitlenmiş çağıranlar birleşik tutarı
pendingiçinde almaya devam eder.
POST /webhooks ve PATCH /webhooks/{id} üzerindeki api_version girdisi kaldırıldı.- Yeni webhook’lar her zaman
v1olaylarını ve yüklerini kullanır.api_versiongeçiren istekler bir400ile reddedilir. - Bunun yerine bir webhook’un yük yapısını
api_version_dateile sabitleyin. - Mevcut
v2vev5webhook’ları teslimata devam eder. Artık bu sürümlerde webhook oluşturamaz veya webhook’ları bu sürümlere geçiremezsiniz.
İ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 veaccount_id,payment_id,typeve bir oluşturma aralığına göre filtreler.type,alert_typealanı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ı) vedispute_alert(itiraz öncesi bildirimler).fee_charged,charge_for_alertalanı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.paymentvedisputenesnelerinin yerinipayment_idveaccount_idetiketleri alır. Zaman damgaları ISO 8601 biçimindedir; kartı veren kuruluşun raporu ne zaman verdiğinireported_atbelirtir.
İ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ülecekfrom_tokenmiktarıdır. Negatif bakiye gerekmez.- Negatif bir
to_tokenbakiyesinin kısmi geri ödemesini boyutlandırma, yenito_amountalanına taşındı (to_tokencinsinden, borçla sınırlı).amountveto_amountbirbirini dışlar. - İkisini de atlamak hâlâ negatif
to_tokenbakiyesinin tamamını geri öder. - Daha önceki sürümlere sabitlenmiş çağıranlar önceki davranışı korur: itibari
amountdeğerlerito_tokengeri ödeme tutarı olarak değerlendirilir.
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
requirementiçinde adlandırır:bank_statementgibi bir belge veyassngibi bir alan anahtarı; kullanıcıya gösterilecek birlabelile birlikte. filegirişlerinifile(doğrudan yükleme kimliği) ile yanıtlayın.text,date,phoneveselectgirişlerinivalueile,addressgirişlerini iseaddressile yanıtlayın. Yanıttan hiçbir şey geri yansıtılmaz.multipleolarak 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.optionslisteleyen bir giriş ayrıca birvaluealır.selectgiriş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
codeve birreasoniçeren yapılandırılmışerrorstaşır. - İç içe
requested_files/categoryform 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.
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_codesbir hesabın promosyon kodlarını listeler vecompany_idyerineaccount_idkullanır.POST /promo_codespromosyon kodları oluşturur.GETveDELETE /promo_codes/{id}bunları alır ve arşivler.POST /promo_codes/{id}/activatevePOST /promo_codes/{id}/deactivate, eskiPATCHdurum 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.
Hesap yanıtları artık bağlı hesaplar için daha zengin bir üst hesap ilişkisi sunar.
parent_account,parent_account_idalanının yerini alır.- Üst hesap kendi
id,title,routevelogo_urldeğerlerini içerir.
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 vepodst_kimliklerisupported_payout_method_idolarak geçirilir. - Kaydedilmiş ödeme yöntemleri
supported_payout_methodsunar. Ödemelerpayout_method.supported_payout_methodsunar. - Ödeme hesabının ülkesi dışındaki bir ülke için desteklenen yöntemleri listelemek üzere
countrykullanın. GET /payouts/methodsartıkinclude_availablekabul etmez veyaavailable_destinationsdöndürmez.- Daha önceki sürümlere sabitlenmiş çağıranlar
destination_id,payout_destinationvepayout_tokenalanlarını korur.
Kart işlemleri artık yerel REST uç noktalarını kullanır ve eski proxy ile birlikte ikili olarak sunulmaya devam eder.
GET /card_transactionsbir hesabın kart işlemlerini listeler veGET /card_transactions/{id}birinicitx_kimliğiyle alır. Liste ayrıca belirli işlemleri tek bir istekte getirmek için birtransaction_idsfiltresi alır.- Kart işlemleri hesap kapsamlıdır: sahip
account_idile seçilir ve varsayılan olarak kimlik bilgisinin ait olduğu hesaptır. transaction_ids,card_id,cardholder_id,status,created_aftervecreated_beforeüzerinde filtreler. Zaman damgası filtreleri ISO 8601 biçimindedir.cardholder_idyanıtta yenidir: kartın atandığı kullanıcı.
- Her ödeme yöntemi bir
amountgerektirmedenfee_structure(yüzde, sabit tutar ve para birimi) veestimated_arrival(hız başına zaman damgaları) döndürür. - Teklifin
standardveinstantnesneleri artıkestimated_arrivaliçermez. Bunu yöntemin üst düzeyestimated_arrivalalanından okuyun.
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,reasonveavailable_actions, vaka durumunu ve izin verilen eylemleri sunar.- Olaylar sayfalanmış
GET /resolution_center_cases/{id}/eventsüzerinden kullanılabilir. ÖzetlerGET /resolution_center_cases/summaryüzerinden kullanılabilir. - Yazmalar
messageveattachmentskullanır.due_datealanının adıresponse_due_atolarak değiştirildi. Listeleme artıkaccount_idgerektirmez.
Gönderiler (shipments) artık yerel REST uç noktalarını kullanır ve eski proxy ile birlikte ikili olarak sunulmaya devam eder.
GET /shipmentsgönderileri listeler.GET /shipments/{id}gönderi kimliğine veya ödeme kimliğine göre alır.POST /shipmentsbir gönderi oluşturur vePATCH /shipments/{id}takip numarasını günceller.- Yanıtlar
carrier,tracking_url,order_idvepayment_idile birlikteaccount_idvetracking_numberkullanır. - Bu tarihten önceye sabitlenmiş çağıranlar eski proxy sözleşmesini değişmeden korur.
İ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 vePOST /disputes/{id}/submitbunları gönderir. Kanıtlarevidencealtında iç içe bulunur.GET /disputes/summary,statusvecurrencydeğerlerine göre gruplandırılmış toplamlar sağlar. Listeleme ve alma aynı alanları döndürür.- Yanıtlar
account_id,product_idveplan_idile birliktepaymentyanındabuyerkullanır. Listeleme artıkaccount_idgerektirmez. statusvereasonnormalleştirilmiş enum’lardır veneeds_response_by,rdrveeditablealanları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 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
planveproductnesneleri yerineplan_iduyumluluk alanını veproduct_iddeğ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_endayarlayın.canceleylemi erişimi hemen sonlandırır. extendeylemiadd_free_dayseyleminin yerini alır.
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ı
companyyerineaccountdöndürür.
Ortak işletmeler artık her gelir kaynağı için ayrı ödeme oranları sunar.
payout_percentagealanının yerinipayout_percentagesalır.- İç içe nesne
sales,ad_spend,transfervecard_interchangeoranlarını içerir.
Ürünler ve ödeme yapılandırmaları artık Account modelini tutarlı bir şekilde kullanır.
- Ürün istek parametreleri
company_idyerineaccount_idkullanır. - Ödeme yapılandırması istekleri, üst düzeyde ve
planuyumluluk alanının taşıdığı satır içi varyant nesnelerinin içindeaccount_idkullanır. - Ödeme yapılandırması yanıtları
company_idyerineaccount_iddöndürür.
Ödeme yapılandırması zaman damgaları artık API’nin geri kalanıyla aynı biçimi kullanır.
created_atveupdated_at, Unix epoch tam sayıları yerine ISO 8601 dizeleridir.
Kullanıcı bakiyeleri artık eksiksiz, yapılandırılmış bir bakiye özeti sunar.
- Düz
total_usdvebalancesalanlarının yerini iç içe birbalancenesnesi 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 kazançları artık kazancı oluşturan polimorfik kaynağı tanımlar.
receiptalanının yeriniresourcealır.access_passalanının yeriniproductalır.- Makbuz tabanlı kazançlar, makbuz ödeme ayrıntılarıyla birlikte
resource.object: "receipt"döndürür. resourcealanı, makbuza özgü alanları yeniden kullanmadan gelecekteki sürümlerde ek kazanç kaynaklarını destekleyebilir.
İşletme yönlendirme hacmi ve kazançları artık mutabakat sağlayan gruplar olarak raporlanır.
processing_volume,total_earnings,pending_payoutvecompleted_payoutalanlarının yerini iç içevolume_usdveearnings_usdnesneleri alır.- Kazançlar
base_amount/amountalanlarınıtransaction_amount_usd/commission_amount_usdolarak yeniden adlandırır vepayout_percentagedeğerini bir kesir olarak ifade eder.
O zamanlar Plans olarak adlandırılan varyantlar artık Account modelini tutarlı bir şekilde kullanır.
- İstek parametreleri ve istek gövdeleri
company_idyerineaccount_idkullanır. - Varyant yanıtları
companyyerineaccountdöndürür.
Kullanıcı erişim istekleri artık Account modelini tutarlı bir şekilde kullanır.
- İstek parametreleri ve istek gövdeleri
company_idyerineaccount_idkullanır. - Yanıt yapıları değişmedi.

