Skip to main content
Platformunuza bir alt hesap kaydetmek için platform hesabınızın altında onun için bir Account nesnesi oluşturun. Bu hesap daha sonra doğrudan ücretlendirmeleri kabul edebilir, transfer alabilir ve Whop para çekme akışlarını kullanabilir.

Örnek

Alt hesap için bir hesap oluşturun:
Bu örnekte:
  • email, alt hesabın e-posta adresidir. Whop bunu alt hesabı tanımlamak ve önemli bildirimler göndermek için kullanır.
  • Account API anahtarı, alt hesabın hangi platform hesabına ait olduğunu belirler.
  • title, alt hesap için zorunlu görünen addır.
  • external_id, platformunuzun bu alt hesap için kullandığı kendi kimliğidir; örneğin mağaza kimliğiniz. Her kimlik tek bir alt hesaba karşılık gelir ve hesabı daha sonra bununla arayabilirsiniz.
  • metadata, alt hesap için bir sınıflandırma veya seviye olan seller_tier gibi özel anahtar-değer çiftlerini içerir (ör. “bronze”, “silver” veya “gold”).
  • Yanıt, gelecekteki API çağrılarında bu alt hesaba başvurmak için kullanabileceğiniz bir account.id içerir
E-posta adresi, hesabı yönetecek olan alt hesaba (işletme veya birey) ait olmalıdır. Bu kişi hesap kurulumu ve ödeme bildirimlerini alır.

Kendi kimliğinizle bir alt hesap bulun

Kayıtlarınızdan birine ait hesabı almak için alt hesaplarınızı external_id ile listeleyin. Kimliği, seçtiğiniz bir ad alanıyla (ör. shopline:%) başlayan tüm hesapları almak için değeri % ile bitirin. Eşleştirme büyük/küçük harfe duyarlıdır, _ harfiyen eşleşir ve % yalnızca sonda çalışır; bu nedenle oluşturduğunuz kimlikler bunu içeremez.
TypeScript
Update Account, mevcut bir alt hesapta external_id değerini ayarlar veya temizler. Bunu yalnızca platformunuz değiştirebilir. Alt hesap bunu okuyabilir ancak düzenleyemez.

Bir e-posta adresini yeniden kullanma

Her birinin farklı bir external_id değeri olduğu sürece birden fazla alt hesap tek bir e-posta adresini paylaşabilir. Hesap oluşturma, e-posta ve external_id çifti üzerinde idempotent’tir:
  • Yeni external_id: E-posta zaten kullanımda olsa bile Whop yeni bir alt hesap oluşturur.
  • Aynı e-posta ve external_id: Whop bir kopya oluşturmak yerine mevcut alt hesabı döndürür; böylece yeniden denemeler güvenlidir.
  • external_id zaten başka bir e-postayla kullanılıyor: Whop bu kimlikle ikinci bir hesap oluşturmak yerine 409 döndürür. Kimliği aynı istekte yeni hesaba taşımak için Bir kimliğin arkasındaki hesabı değiştirin bölümüne bakın.
  • external_id yok: Varsa, Whop o e-postaya ait external_id değeri olmayan mevcut alt hesabı döndürür.
Bir e-postayı paylaşan hesaplar aynı Whop kullanıcısı, yani o gelen kutusunu alan kişi tarafından yönetilir.
Bu kılavuzun önceki sürümleri external_id değerini metadata içine koyuyordu. Whop bunu her API sürümünde hâlâ orada kabul eder, external_id değerini buradan ayarlar ve metadata içinde döndürür. Başka bir alt hesapta zaten bulunduğunda verilen 409 dahil olmak üzere üst düzey alanla aynı kurallara uyar; bu nedenle birini yeniden kullanmak için reassign_external_id: true gönderin. metadata.external_id değerini sonradan değiştirmek external_id değerini değiştirmez. Değiştirmek için Update Account kullanın. Yeni entegrasyonlar üst düzey alanı göndermelidir.

Bir kimliğin arkasındaki hesabı değiştirin

Kendi tarafınızda bir hesabı yeniden düzenlediğinizde, örneğin yeni bir sahibe geçen bir mağaza için, yeni alt hesabı aynı external_id ve reassign_external_id: true ile oluşturun. Whop 409 döndürmek yerine kimliği aynı istekte yeni alt hesaba taşır.
TypeScript
  • Kimliğe sahip olan alt hesap silinmez veya başka hiçbir şekilde değiştirilmez. external_id değeri null olarak ayarlanmış şekilde etkin kalır, metadata değerini ve bakiyesini korur ve bir account.updated webhook’u gönderir. Artık ihtiyacınız yoksa kendiniz silin.
  • Oluşturma başarısız olursa kimlik olduğu yerde kalır.
  • Mevcut bir alt hesabı değiştirdiği için istek, platform hesabınızda company:create_child izninin yanı sıra company:update iznini de gerektirir.
  • Mevcut bir alt hesapla aynı e-posta ve external_id değerine sahip bir istek, bayrağı ayarlasa bile o alt hesabı döndürür.
  • Kimlik yalnızca kendi alt hesaplarınız arasında taşınır.
Bir kimliği zaten var olan iki alt hesap arasında taşımak için Update Account’u iki kez çağırın: eskisinde external_id değerini temizleyin, ardından diğerinde ayarlayın. Update Account’ta reassign_external_id yoktur ve kimliği temizlemeden önce ayarlamak 409 döndürür.

Kayıt sürecini tamamlayın

Alıcının zaten bir Whop hesabı yoksa, hesabı oluşturduktan sonra ona bir hesap kayıt bağlantısı gönderin. Alıcı bu bağlantı üzerinden Know Your Customer (KYC) doğrulamasını tamamlar; ardından hesap transferleri ve diğer para çekme akışlarını alabilir.
Alıcı kayıt sürecini tamamladıktan sonra şunları yapabilirsiniz:
  • onlar için uygulama ücretleriyle ödeme akışları oluşturabilirsiniz.
  • hesap bakiyelerine para transfer edebilirsiniz.
  • para çekme portalıyla para çekmelerine izin verebilirsiniz.

Başlarken

Alt hesapları kaydedebilmeniz için önce platform hesabınızı kurmanız gerekir:
  1. Bir platform hesabına kaydolun: whop.com/dashboard adresinde bir hesap oluşturun
  2. Bir Account API anahtarı oluşturun: Geliştirici ayarları sayfanıza gidin ve bir Account API anahtarı oluşturun
  3. Kimlik doğrulama için API anahtarını kullanın: Bu API anahtarı, Current API ile kimlik doğrulamanızı ve alt hesaplarınızı kontrol etmenizi sağlar
Account API anahtarı, platform hesabınız altında alt hesap oluşturmak ve yönetmek için gerekli izinleri sağlar.

Özel meta veriler

Hesapları oluştururken onlara özel meta veriler ekleyebilirsiniz. Meta veriler, her alt hesap hakkında ek bilgileri anahtar-değer çiftleri olarak saklamanızı sağlar. Bu şunlar için kullanışlıdır:
  • Alt hesap seviyelerini veya sınıflandırmalarını takip etme
  • Platformunuzun veritabanı kayıtlarına bağlama
Whop meta verileri Account nesnesinde saklar ve her okumada döndürür, ancak hesapları buna göre filtreleyemezsiniz. Hesapları aramak için kullandığınız tanımlayıcıyı bunun yerine external_id alanına koyun.

API referansı

Create Account API

Hesap oluşturma ve tüm kullanılabilir parametreler için API referansının tamamına bakın

Sonraki adımlar

Bir alt hesap için Account oluşturduktan sonra:

Ödemeleri tahsil edin ve bölüştürün

Doğrudan ücretlendirmeler ile transferler arasında seçim yapın

Para çekme portalını görüntüleyin

Alt hesapların paralarını çekmesine izin verin