Skip to main content
Satış ortakları, yönlendirdikleri satışlardan komisyon kazanır. API akışı iki bölümden oluşur: bir satış ortağı kaydı oluşturun, ardından komisyonu tanımlayan geçersiz kılmalar (override) ekleyin.

Atıf nasıl çalışır

  1. Bir kullanıcı için satış ortağı kaydı oluşturursunuz, ardından geçersiz kılmalar eklersiniz. Her geçersiz kılma product_direct_link ve checkout_direct_link alanlarını döndürür. Bunlar satış ortağının paylaştığı yönlendirme URL’leridir (?a=<username> içerirler).
  2. Bir alıcı bağlantıyı kullanır. Whop, satış ortağı çerezini saklar (varsayılan olarak 30 günlük atıf penceresi).
  3. Alıcı pencere içinde ödemeyi tamamlar. Eşleşen geçersiz kılma komisyonu hesaplar: standard (varyant başına, yüzde veya sabit ücret) ya da rev_share (gelirin yüzdesi, ürüne özel veya hesap genelinde).
  4. Whop komisyonu satış ortağına atfeder ve geçersiz kılmanın total_referral_earnings_usd alanına yansıtır.
İadeler komisyonları geri alır. Bir alıcı pencere içinde iade alırsa, satış ortağının o satıştan elde ettiği kazanç otomatik olarak geri alınır.
Satış ortaklarının ödeme alabilmek için bir Whop hesabına ihtiyacı vardır. Kazançlar kayıt üzerinde birikir. Ödemeler transferler aracılığıyla hesap bakiyelerine gider. Henüz bir hesapları yoksa, onları alt hesap kaydı ile sisteme dahil edin.

Bir satış ortağı oluşturun

user_identifier esnek şekilde çözümlenir. Bir kullanıcı adı, e-posta, kullanıcı kimliği veya Discord kimliği iletin. Hesap ve kullanıcı çifti için zaten bir satış ortağı kaydı varsa, Whop mevcut kaydı döndürür (idempotent).

Komisyon geçersiz kılmaları ekleyin

Bir satış ortağı kaydı tek başına bir komisyon tanımlamaz. Satış ortağına ne ödeneceğini belirlemek için geçersiz kılmalar ekleyin.

Standart (varyant başına)

commission_value kuralları:
  • "percentage": 1–100 arası tam sayı (40 = %40).
  • "flat_fee": dolar tutarı (10 = 10 $).
applies_to_payments:
  • "first_payment": satış ortağı yalnızca ilk satın alımdan kazanır.
  • "all_payments": satış ortağı her yinelenen ödemeden de kazanır.

Gelir paylaşımı (gelir yüzdesi)

Gelir paylaşımı geçersiz kılmaları her zaman yüzdeye dayalıdır. commission_type: "flat_fee" iletmeyin.

Geçersiz kılmaları yönetin

Satış ortaklarını yönetin

Hesap düzeyinde satış ortağı ayarları

Üç hesap alanı, Whop’un satış ortaklığı programını kullanıcılara nasıl sunduğunu kontrol eder. Bunları Account kaynağı üzerinden güncelleyin.

Kazançları takip etme

Her geçersiz kılma, o belirli geçersiz kılma için birikmiş kazançları (ABD doları cinsinden) yansıtan bir total_referral_earnings_usd alanı içerir. Güncel toplamı almak için geçersiz kılmayı yeniden getirin (veya bir satış ortağının geçersiz kılmalarını listeleyin).
v1’de özel bir affiliate.* webhook’u yoktur ve herkese açık payment şeması satış ortağı bağlantısını göstermez. Ödeme takviminize göre affiliates.overrides.list sorgusunu düzenli olarak çalıştırın ve en son total_referral_earnings_usd değerlerini sakladığınız son değerlerle karşılaştırın.

Geçersiz kılma yanıt alanları

Sonraki adımlar

Satış ortağı kazançlarını ödeyin

Birikmiş komisyonları bakiyenizden satış ortağı hesaplarına aktarın.

Ödeme alın

Yönlendirme çerezleri ayarlandığında ödeme yapılandırmaları satışları otomatik olarak atfeder.

Webhook'ları dinleyin

Genel satış telemetrisi için payment.succeeded kullanın. Satış ortağı atfı yine de düzenli sorgulama gerektirir.

Satış Ortakları API referansı

Kaynağın tamamı. Uç noktalar, alanlar ve geçersiz kılma şemaları.