Skip to main content
Bu sayfa @whop/elements@1.10.0 ve @whop/elements-react@1.10.0 sürümlerini belgeler.
v1.0.0 sürümünden beri. Wallet içine bağlanır. accountId ve accessToken oradan gelir. Prop’ları ve geri çağırmaları oluşturma seçenekleri veya React prop’ları aracılığıyla iletin. showStep() ve refresh() çağırmak için oluşturulan tanıtıcıyı veya React ref değerini saklayın.
Bu elementi satır içi (create) olarak bağlayabilir veya bir modal katman (createOverlay) olarak açabilirsiniz.

Örnek veriler. Playground’u açın.

Prop’lar

string
Kanal çözümlemesinin kişisel (user_) bir hesabı okumasına izin veren kapsamlı bir token — payout:account:read ve banka kanalının hazırlanması için ayrıca payout:account:update gerektirir. Onu sunucunuzda POST /api/v1/access_tokens ile oluşturun. Atlanırsa çağrı izleyicinin kendi oturumunu taşır; bu da yalnızca aynı origin’de yanıt verir. İşletme hesapları herhangi bir kimlik bilgisi olmadan çözümlenir.
string
Tutarı önceden doldurur ve salt okunur yapar — borçlu olunan tutarı zaten bilen akışlar için. Sıfır veya altındaki bir tutar yok sayılır, 12 tam basamaktan uzun olan da öyle; geri kalanı para biriminin ondalık basamaklarına yuvarlanır. Varsayılan değer "".
boolean
Hesabın bir para yatırma adresi olduğunda kripto kanalını sunar. Varsayılan değer true.
boolean
Banka havalesi kanalını sunar. Hesabın banka bilgileri olmadan önce bile gösterilir — o durumda onu seçmek, hesabın hâlâ borçlu olduğu şey buysa izleyiciden kimliğini doğrulamasını ister, değilse kanalı henüz kullanılamaz olarak bildirir. Varsayılan değer true.
DepositSavedCard[]
Bu ödeyici için zaten tuttuğunuz kartlar, fonlama satırları olarak gösterilir. Birini seçmek tutarla birlikte cardDepositRequested yayar — element hiçbir zaman kart ödemesi toplamaz. Varsayılan değer [].
boolean
Kendi kart toplama akışınızı açabilmeniz için addCardRequested yayan bir “Add card” satırı ekler. Varsayılan değer false.
boolean
Tutar adımı olmadan hemen platformBalanceSelected yayan bir “Platform balance” satırı sunar. Varsayılan değer false.
DepositCardFee | null
Bir kart satırı seçildiğinde tutarın altında önizlenecek işlem ücretleri. percentageFee yüzde PUANI cinsindendir (2.9 %2,9’dur); fixedFee ve radarFee ana birimlerdir (0.3 0,30 $‘dır). Varsayılan değer null.
Partial<Record<"crypto" | "bank", DepositRailFee>>
Kanal seçicinin altındaki hesabın para yatırma ücretlerini kanala göre anahtarlanmış şekilde (bank, crypto) geçersiz kılar. Atlanan kanallar hesabın döndürdüğü ücretleri kullanır. percentageFee yüzde PUANI cinsindendir (1.5 %1,5’tir); fixedFeeUsd, para yatırma para birimi ne olursa olsun USD ana birimidir (2 2,00 $‘dır). Bir tutar yazılmadan önce oranı, sonra ise tahsil edilen tutarı gösterir. Varsayılan değer {}.
string
Bir kanalı kimliğe göre önceden seçer (bank, crypto, platform_balance veya kayıtlı bir kart kimliği). O kanal henüz sunulmuyorsa, başka bir kanal üzerinden fonlamak yerine Continue devre dışı kalır. Varsayılan değer "".
boolean
Havale alanlarını göstermek yerine bankSelected yayar ve tutar ekranında kalır — hesabın zaten bir sanal banka hesabı olduktan sonra kendi adımını çalıştıran ana uygulamalar için. Varsayılan değer false.
boolean
Kripto ekranında depositConfirmed yayan bir “I have deposited my funds” düğmesi gösterir; böylece transferi izlemeye başlayabilirsiniz. Varsayılan değer false.
"amount" | "crypto" | "bank"
Seçici yerine doğrudan bir kanalda açılır. crypto ve bank tutar gerektirmez; arkalarında seçici olmadığı için geri düğmeleri dismissed yayar. Varsayılan değer "amount".

Olaylar

Geri çağırmaları oluşturma seçeneklerinde veya React prop’larında iletin.

onDepositInitiated

Ödeyici bir tutarı ve kanalı onayladı. Herhangi bir talimat gösterilmeden önce her kanal için tetiklenir — analitik/huni kancası.
object

onCardDepositRequested

Kayıtlı bir kart seçildi. Ödemeyi kendi tarafınızda toplayın, ardından elementi seçiciye döndürmek için showStep({ step: "amount" }) çağırın.
object

onAddCardRequested

“Add card” satırı seçildi — kart toplama akışınızı açın.

onBankSelected

deferBankToHost ayarlıyken banka kanalı seçildi — adımınızı çalıştırın, ardından alanları kendiniz gösterin veya showStep({ step: "bank" }) çağırın.

onIdentityVerificationRequested

İzleyici, bu hesabın henüz bir sanal banka hesabı olmadan banka havalesini seçti. Element tutar ekranında kalır ve hiçbir zaman gezinme yapmaz — buna yanıt olarak verifications denetleyicisi gibi kendi doğrulamanızı bağlayın.
object

onPlatformBalanceSelected

Platform bakiyesi satırı seçildi. Hiçbir tutar taşımaz — onu kendi ekranınız toplar.

onDepositConfirmed

Ödeyici kriptoyu gönderdiğini söyledi. since, gelen transferleri eşleştirmeye başlamak için unix saniyesi cinsinden bir alt sınırdır (biraz geriye bakar; böylece tıklamadan hemen önce gönderilen bir transfer de eşleşir).
object

onStepChanged

Görünür ekran değişti.
object

onDismissed

Ödeyici, elementin doğrudan açıldığı bir kanaldan geri çıktı — onu barındıran yüzeyi kapatın.

onLoaderStart

Yükleme iskeleti ilk kez çizildikten sonra ve onReady öncesinde çalışır.

onReady

Elementin ilk eksiksiz çiziminden sonra çalışır.

onError

Element yüklenemediğinde veya çöktüğünde çalışır. Yedek görünüm görünür kalır. Programatik işleme için code kullanın. sourceKey, başarısız olan host-state kaynağını tanımlar.
object

Metotlar

Bunları create tarafından döndürülen tanıtıcı (handle) üzerinde veya bir React ref aracılığıyla çağırın.

showStep

Elementi bir ekrana taşır. { step: "amount" }, kendi tarafınızda bir kart veya platform bakiyesi para yatırma işlemini tamamladıktan sonra kontrolü geri vermenin yoludur. Parametreler
object
gerekli
Döndürür Promise<void>

refresh

Hesabın fonlama kanallarını yeniden çözümler. Kendi tarafınızda hesabın sunabileceklerini değiştiren herhangi bir şeyden sonra — örneğin banka kaydını tamamlamak — çağırın; böylece yeni kanal önbelleğin süresinin dolmasını beklemeden görünür. Döndürür Promise<void>

mount

Elementi target içine bağlar ve yüklemeyi başlatır. React bileşenleri kendilerini bağlar. Parametreler
string | HTMLElement
gerekli

destroy

Elementi kaldırır ve çerçevesini ile aboneliklerini serbest bırakır. Birden fazla kez çağırabilirsiniz. React elementi otomatik olarak kaldırır.

update

Yeni prop’ları bağlı elementle birleştirir. React’te bunun yerine bileşen prop’larını değiştirin. Parametreler
Partial<DepositElementProps>
gerekli

Stil verme

Bu parçalara appearance.classes aracılığıyla stil verin. Özellik adları için camel case veya kebab case kullanın ve birimleri ekleyin. Sayfa stil sayfaları elementin çerçevesine ulaşamaz. Framework her bildirimi eklemeden önce doğrular.
React’te appearance değerini <Wallet> bileşenine iletin. Genel olarak WhopElements({ appearance }) ile ayarlayın.