Örnek
Alt hesap için bir hesap oluşturun: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 olanseller_tiergibi ö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.idiçerir
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
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ı birexternal_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_idzaten başka bir e-postayla kullanılıyor: Whop bu kimlikle ikinci bir hesap oluşturmak yerine409dö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_idyok: Varsa, Whop o e-postaya aitexternal_iddeğeri olmayan mevcut alt hesabı döndürür.
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_iddeğerinullolarak ayarlanmış şekilde etkin kalır,metadatadeğerini ve bakiyesini korur ve biraccount.updatedwebhook’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_childizninin yanı sıracompany:updateiznini de gerektirir. - Mevcut bir alt hesapla aynı e-posta ve
external_iddeğ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.
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.- 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:- Bir platform hesabına kaydolun: whop.com/dashboard adresinde bir hesap oluşturun
- Bir Account API anahtarı oluşturun: Geliştirici ayarları sayfanıza gidin ve bir Account API anahtarı oluşturun
- 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
Ö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
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

