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.
Payments içine bağlanır. Prop’ları ve geri çağırmaları oluşturma seçenekleri veya React prop’ları aracılığıyla iletin. select() çağırmak için oluşturulan tanıtıcıyı veya React ref değerini saklayın.Dışlayıcı.
PaymentElement, bu Payments tanıtıcısında CardElement veya CardFields için bir alternatiftir. Aynı anda yalnızca birini bağlayın. Başka birini bağlamadan önce onu yok edin.BrandingElement öğesini bekler. Bu element, aynı Payments tanıtıcısında BrandingElement bağlanana kadar yükleme durumunda kalır.Örnek veriler. Deneme alanını açın.
Prop’lar
Her iki düzende de görüntüleme sırasını kontrol eder. Listelenen türler sırayla önce görünür. Listelenmeyen türler göreli sıralarını korur. Kullanılabilirliği etkilemez. Varsayılan değer
[].Elementin hangi cüzdanları sunduğunu kontrol eder. Her anahtar varsayılan olarak
'auto' değerini alır; bu, cüzdanı hesabın, alıcının cihazının ve ücretin desteklediği her yerde sunar. 'never', o cüzdanı yöntem listesinden kaldırır. Sayfanız kendi Apple Pay, Google Pay veya PayPal düğmelerini paymentRequest ile çiziyorsa, alıcıların her cüzdanı yalnızca bir kez görmesi için bunu kullanın. payPal: 'never', PayPal yöntemini kaldırır. Kayıtlı ödeme yöntemleri etkilenmez. Varsayılan değer {}. v1.8.0 sürümünden beri.Fatura bilgilerinin toplanmasını kontrol eder.
billingDetails: 'minimal' (varsayılan) her yöntemin matrisini izler. Yöntemler varsayılan olarak adı ve ülkenin eksiksiz biçimini toplar. Bir geçersiz kılma yalnızca bildirilen minimumu topluyor ya da hiçbir şey toplamıyor olabilir. Kartlar için minimum, kart üzerindeki ad, ülke ve posta kodudur. 'full', her yeni yöntem için adı ve ülkenin eksiksiz biçimini zorunlu kılar. 'never' bloğu gizler. address: 'minimal' yalnızca her yöntemin bildirdiği minimumu ve bu minimumun ülke içermediği her yerde bir ülkeyi toplar (billingDetails: 'full' ödemenin vergilendirildiğini belirtiyorsa posta kodunu da); ancak hiç adres toplamayan cüzdanlar, kripto, banka borçlandırmaları, banka havaleleri, kartın fiziksel olarak sunulduğu ödemeler ve uygulama içi satın almalar ile sağlayıcısı eksiksiz fatura adresi gerektiren (requires_full_billing_address) ve kutucuğu işaretlenmemiş bir ödemeyle aynı kuralları izleyen yöntemler bunun dışındadır; aksi takdirde billingDetails: 'full' ayarına üstün gelir; satıcı eksiksiz bir fatura adresi toplamıyorsa bunu kullanın. phone: 'never', formunuz fatura telefonunu zaten topluyorsa yalnızca o girişi gizler; bunu gerektiren yöntemler için billingDetails.phone değerini createConfirmationToken metoduna iletin. Bunun yerine adresi createConfirmationToken metoduna iletin. Ülke seçici yalnızca yöntemin ve ödeme para biriminin desteklediği ülkeleri içerir. Bir taksit planı seçiliyken, planın hizmet verdiği ülkelere daralır; fatura ülkesi, ücretin altında işlendiği işlem ülkesidir. Yalnızca bir ülke mevcut olduğunda kilitlenir. Varsayılan değer {"billingDetails":"minimal"}.Her yöntemin fatura bloğu ilk kez görüntülendiğinde fatura bilgilerini önceden doldurur. Alıcı önceden doldurulan her alanı düzenleyebilir.
address.country bir ISO 3166-1 alpha-2 kodudur ve yalnızca seçilen yöntem bunu kabul ettiğinde uygulanır. phone, telefon toplayan yöntemler için fatura telefonu girişini +14155552671 gibi E.164 biçiminde doldurur; yöntemin desteklediği telefon ülkelerinin dışındaki bir numara yok sayılır. Yalnızca bloğun görüntülediği alanlar önceden doldurulur ve gönderilir. Diğer her şeyi billingDetails içinde createConfirmationToken metoduna iletin. v1.1.0 sürümünden beri.Seçici düzeni.
accordion (varsayılan) yöntemleri üst üste dizer ve ayrıntıları satır içinde genişletir. horizontal, eşit genişlikte, kaydırılmayan kutucuklar ve altında seçili ayrıntıları gösterir. Dört yöntemden sonra bir Daha Fazla kutucuğu yerel bir seçici açar. Orada seçilen yöntem, bir sonraki seçime kadar son kutucuğu kaplar. Seçim ve onay aynı şekilde davranır. Varsayılan değer "accordion".Yalnızca
accordion. Yöntemler arasına boşluk ve ayrı kart stili ekler. layout değeri horizontal olduğunda yok sayılır. Varsayılan değer false.Çözümlemeden sonra sunulan ilk yöntemin seçilip seçilmeyeceği. Varsayılan
true değeri order ayarına uyar ve bir alıcı etkileşimi gibi selected ile change olaylarını yayar. Alıcı etkileşiminden önce bir kez çalışır ve hiçbir yöntem sunulmadığında hiçbir şey yapmaz. Seçimsiz bağlamak için false olarak ayarlayın. Bundan bağımsız olarak, bir güncelleme seçili yöntemi kaldırırsa seçim, sunulan ilk yönteme geri döner. Zaten seçimsiz olan bir element seçimsiz kalır. Varsayılan değer true.Olaylar
Geri çağırmaları oluşturma seçeneklerinde veya React prop’larında iletin.onChange
Seçim değiştiğinde tetiklenir. complete: true, alıcının bir yöntem seçtiği ve kart alanlarını veya gerekli girişlerini tamamladığı anlamına gelir. Onayı etkinleştirmek için bunu kullanın. paymentMethod, kayıtlı ya da yeni seçili ödeme yöntemidir veya hiçbir şey seçili değilken null olur: displayName ve icons seçimi elementin gösterdiği şekilde adlandırır (balance.imageUrl ile bir bakiye sahibinin görseli), card bir kartın ağını, son dört hanesini ve fon türünü taşır, requiresBillingPhone yöntemin fatura bilgilerinde telefon gerektirip gerektirmediğini belirtir ve countries yöntemin ücretin para biriminde hangi ülkelerden ödeme yapabileceğini listeler. Üst düzeydeki type, requiresBillingPhone ve method kullanımdan kaldırılmıştır: bunları paymentMethod içinden okuyun. Üst düzeydeki supportsBuyerFee de herhangi bir alternatifi olmadan kullanımdan kaldırılmıştır: Whop alıcı hizmet ücretini kendisi fiyatlandırır.onAddressChange
Dahili fatura adresi değiştikten yaklaşık 300 ms sonra tetiklenir. Vergi, kargo veya adrese bağlı diğer güncellemeler için bunu kullanın. country bir ISO 3166-1 alpha-2 kodudur. Yük, boş olan veya o ülke için kullanılmayan diğer adres anahtarlarını içermez. complete: true, fatura bloğunun geçerli ve eksiksiz olduğu anlamına gelir. Bu olay yalnızca adres toplama ödeme elementine ait olduğu sürece tetiklenir. fields.billingDetails: 'never' ile kendi adres kaynağınızı kullanın. Bağlı bir AddressElement ile onun change olayını kullanı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.Metotlar
Bunlarıcreate tarafından döndürülen tanıtıcı (handle) üzerinde veya bir React ref aracılığıyla çağırın.select
Bir alıcı etkileşimiyle aynı yoldan bir yöntem seçer. Örneğin select('cashapp') kutucuğu genişletir ve selected ile change olaylarını yayar. Kartlar, alanları tamamlanana kadar complete: false olarak kalır. Bilinmeyen, kullanılamayan veya tutara bağlı olarak kısıtlanan yöntemler METHOD_NOT_OFFERED koduyla reddedilir. select(null) seçimi temizler ve complete: false ile change yayar. Tam harici kontrol için autoSelect={false} ile birlikte kullanın.ParametrelerDöndürür Promise<void>mount
Elementi target içine bağlar ve yüklemeyi başlatır. React bileşenleri kendilerini bağlar.Parametrelerdestroy
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.ParametrelerStil verme
Bu parçalaraappearance.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.appearance değerini <Payments> bileşenine iletin. Genel olarak WhopElements({ appearance }) ile ayarlayın.
