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.
Payments içine bağlanır. Prop’ları ve geri çağırmaları oluşturma seçenekleri veya React prop’ları aracılığıyla iletin.
Münhasır. CardElement, bu Payments tanıtıcısında PaymentElement veya CardFields yerine kullanılan bir alternatiftir. Aynı anda yalnızca birini bağlayın. Başka birini bağlamadan önce onu yok edin.
BrandingElement için bekler. Bu element, aynı Payments tanıtıcısında BrandingElement bağlanana kadar yükleme durumunda kalır.
Bir WhopPayments kapsamı içine bağlanır. Üç kart girişi tek bir birim olarak, tokenizer tarafından PCI’dan yalıtılmış şekilde sunulur; böylece numara, son kullanma tarihi ve güvenlik kodu asla sizin işleminize girmez.
Ödemeyi ve onay token’ını yöneten <Payments> içine bağlayın. <Payments> ise <WhopElements> içine bağlanır. Form yalnızca kart kabul ettiğinde bunu kullanın: kendisini toplama yüzeyi olarak kaydeder, böylece createConfirmationToken başka hiçbir bağlantı gerekmeden onu token’a dönüştürür.

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

Prop’lar

"compact" | "stacked"
stacked (varsayılan), kart numarasını son kullanma tarihi ve güvenlik kodunun üstüne yerleştirir. compact üçünü de tek bir satıra yerleştirir. Varsayılan değer "stacked".

Olaylar

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

onChange

Kart alanları değiştiğinde tetiklenir. Alıcı üç alanı da doldurduktan sonra complete true olur. Onayı etkinleştirmek için bunu kullanın. brand, algılanan kart ağıdır. funding, algılanan fonlama türüdür (credit, debit veya prepaid); numara bir türü belirleyene kadar null olur. issuingCountry, kartın verildiği ülkenin küçük harfli iki harfli kodudur; numara bir ülkeyi belirleyene kadar null olur.
object

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.

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<CardElementProps>
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 <Payments> bileşenine iletin. Genel olarak WhopElements({ appearance }) ile ayarlayın.

Parametreler

WhopCardElement.Layout
.stacked numarayı son kullanma tarihi ve güvenlik kodunun üstüne koyar; .compact üçünü de tek bir satıra koyar. Varsayılan değer .stacked.
String?
Gelişmiş bir yayınlanabilir anahtar. Belirtmezseniz hesabın kendi anahtarı getirilir.
Binding<WhopCardState>?
Tamamlanma durumunu ve algılanan markayı geri okur.

WhopCardState

Bir seçimin döndürdüğü değerler:
  • isComplete: Bool: üç alanın tümü geçerli
  • brand: String?: numara bir ağı belirlediğinde algılanan ağ

Durumlar

Hemen görüntülenir ve alıcı yazdıkça doğrular. Numara bir markayı belirlediğinde marka görünür. Üç alanın tümü geçerli olduğunda state.isComplete true olur.

Bilmekte fayda var

  • Kabul ettiğiniz tek yöntem kart olduğunda WhopPaymentElement yerine bunu kullanın. İkisini birden bağlamak bir çakışmadır: denetleyici tek bir toplama yüzeyinden token üretir.
  • createConfirmationToken(billingDetails:) kart yolu için bir kart sahibi adı gerektirir; bu nedenle bir ad iletin veya bunu toplayan bir adres elementi bağlayın.
  • publicKey gelişmiş bir kaçış yoludur. Belirtmezseniz SDK hesabın tokenizer anahtarını getirir.

Kurulum

Denetleyiciyi oluşturan ve içeriğine ileten bir WhopPayments(accountID:charge:) kapsamı içine bağlayın. Bir e-posta oturum açma işlemi alıcıyı doğruladığında payments.buyer oturum açmış alıcıdır. WhopBrandingElement da ekranda olmalıdır; çünkü bu satışlarda kayıtlı satıcı (merchant of record) Whop’tur ve createConfirmationToken onsuz reddeder. .whopElementsAppearance(_:) ile stil verin. Modül, cüzdan SDK’sının WhopElements modülü değil, Elements modülüdür. Başlarken ve Görünüm sayfalarına bakın.

Prop’lar

'stacked' | 'compact'
stacked numarayı son kullanma tarihi ve güvenlik kodunun üstüne koyar. compact üçünü de tek bir satıra koyar. Varsayılan değer stacked.
(payload: CardFieldsChangePayload) => void
Her düzenlemede tamamlanma durumu ve alan başına hatalarla tetiklenir.
StyleProp<ViewStyle>
Elementin dış View bileşenine uygulanır. Tema için, bu yüzeydeki her elementi kapsayan sağlayıcı üzerindeki appearance.parts seçeneğini tercih edin. React Native parça adlarının bugün web’in whop-* sınıf adlarından farklı, kendine ait bir küme olduğunu unutmayın; bu nedenle bir web appearance nesnesi değiştirilmeden aktarılamaz.
ReactNode
Element yüklenirken yerleşik iskelet yerine gösterilir.
() => void
Element etkileşimli hâle geldiğinde bir kez tetiklenir. <Payments> bunları gruplar, bu nedenle genellikle istediğiniz şey onun kendi onLoadingChange geri çağırmasıdır.
(error: { message: string; code?: string }) => void
Bu element için bir yükleme veya yapılandırma hatası. Element her iki durumda da kendi hata ekranını gösterir.

CardFieldsChangePayload

onChange geri çağırmasının döndürdüğü değerler:
  • complete: boolean: her alan doldurulmuş ve geçerli
  • errors: Record<string, string>: alan başına mesajlar; tam olarak complete true olduğunda boştur

Durumlar

Yayınlanabilir anahtar çözümlendiğinde üç alan birlikte görüntülenir. Üçü de geçerli olduğunda onChange complete bildirir ve element alan başına kendi hatalarını gösterir.

Bilmekte fayda var

  • Kart numaraları asla kodunuzdan geçmez. Alanlar PCI’dan yalıtılmış yerel girişlerdir ve SDK Whop’a bir token iletir; böylece uygulamanız PCI kapsamı dışında kalır.
  • Bunu bağlamak sağlayıcının toplama yüzeyini kart yapar; böylece createConfirmationToken ek bir bağlantı olmadan onu token’a dönüştürür. Bunu bir PaymentElement yanına bağlamayın: aynı anda tam olarak bir toplama yüzeyi etkin olur.
  • Üç alanın kendi düzeninizde yer aldığı bir form için bunun yerine CardFields kullanın.
Uygulamanızı bir kez <WhopElements getToken={…}> ile sarın, ardından elementlerin etrafına <Payments> bağlayın. Başlarken ve Görünüm sayfalarına bakın.