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. Bir tanıtıcı almak için oluşturun, ardından elementlerini o tanıtıcı üzerinde bağlayın. Alt denetleyiciyi kaldırmak ve yuvasını boşaltmak için destroy() çağırın. Yeni bir tanıtıcı almak için yeniden oluşturun.
Münhasır. CardFields, bu Payments tanıtıcısında PaymentElement veya CardElement yerine kullanılan bir alternatiftir. Aynı anda yalnızca birini bağlayın. Başka birini bağlamadan önce onu yok edin.

Önizleme

Bu alt denetleyicinin varsayılan düzeninin örnek verilerle canlı, etkileşimli bir demosu:
Bir WhopPayments kapsamı içine bağlanır. WhopCardElement ile aynı üç barındırılan giriş, içerik oluşturucusunun içinde tek tek yerleştirilir; böylece her birinin nerede duracağına kendi düzeniniz karar verir.
Tek tek yerleştirilen kart alanları için sağlayıcı. Formunuzun bunları içeren bölümünü sarın, ardından CardNumberElement, CardExpiryElement ve CardCvcElement bileşenlerini düzeninizin istediği yere koyun.

Önizleme

React Native örnek uygulamasında çalışıyor:

Seçenekler

Bunları payments.create('cardFields', { … }) çağrısına veya React’te <CardFields> üzerinde prop olarak iletin. Üst öğe tarafından enjekte edilen prop’lar burada asla görünmez.
CardNetworkArt[]
Satıcının kabul ettiği kart ağları, görüntülenme sırasıyla — matris kart girişinin networks nesneleri; API tarafından sunulan simgeleri numara alanının marka görselini belirler. Anahtarla birlikte getirilmesi için belirtmeyin.
"compact" | "stacked"
stacked (varsayılan), birlikte oluşturulan alanları son kullanma tarihi ve güvenlik kodunun üstünde bir numara satırı olarak şekillendirir. compact tek bir satır olarak şekillendirir. Ayrı ayrı bağlanan alanlar bu düzeni yok sayar ve tam kenarlıklar ile yuvarlatılmış köşelerle görüntülenir. Varsayılan değer "stacked".
string
Gelişmiş Basis Theory yayınlanabilir anahtarı. Anahtarın otomatik olarak getirilmesi için belirtmeyin.

Olaylar

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

onChange

Tamamlanma durumu değiştiğinde tetiklenir. Alıcı üç alanın tümünü doldurduktan sonra complete true olur. Onayı etkinleştirmek için bunu kullanın. brand, alanın bildirdiği şekliyle algılanan kart ağıdır; network ise aynı algılamanın API’nin ağ terimleriyle ifadesidir (matris kart girişinin networks değeriyle eşleşir, bilinmediği sürece null olur). last4, numaranın son dört hanesidir; numara yeterince ilerleyene kadar null olur. 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

Metotlar

Bunları payments.create('cardFields', { … }) çağrısından dönen alt tanıtıcı üzerinde çağırın.

tokenize

Üç alanı bir onay token’ı oluşturmadan token’a dönüştüren gelişmiş bir metot. Ödeme denetleyicisine tokenized yayar. Doğrulama hataları başarısız olan alanda görünür ve metot hata fırlatır. Bir ödemeyi onaylamak için payments.createConfirmationToken() kullanın.Parametreler
object
gerekli
Döndürür Promise<object>
string
gerekli

collect

payments.createConfirmationToken(), cardFields için bu eylemi çağırır. Doğrudan çağırmayın. Alanları token’a dönüştürür ve onay token’ını oluşturmak için kullanılan verileri döndürür.Parametreler
object
gerekli
Döndürür Promise<object>
object
gerekli
object
gerekli

update

Yeni prop’ları ve geri çağırmaları alt denetleyiciyle birleştirir.Parametreler
Partial<CardFieldsSubOptions>
gerekli

destroy

Alt denetleyiciyi ve elementlerini yok eder, ardından münhasır yuvasını boşaltır. Sonraki bir create("cardFields") çağrısı sıfırdan başlar.

Parametreler

String?
Gelişmiş bir yayınlanabilir anahtar. Belirtmezseniz hesabın kendi anahtarı getirilir.
WhopCardElement.Layout
Yalnızca alanları bir oluşturma birimi kendisi düzenlediğinde okunur. Ayrı ayrı bağlanan alanlar bunu yok sayar.
Binding<WhopCardState>?
Tamamlanma durumunu ve algılanan markayı geri okur.
() -> Content
gerekli
Üç alan görünümünün yer aldığı yer. Buradaki diğer her şey normal şekilde görüntülenir.

WhopCardState

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

Durumlar

Her alan hemen görüntülenir ve alıcı yazdıkça doğrular. Alanları nereye koyarsanız koyun, üçü de geçerli olduğunda state.isComplete true olur.

Bilmekte fayda var

  • Üç alan görünümü yalnızca bir WhopCardFields oluşturucusu içinde çalışır: onun oluşturduğu birimi okurlar. Başka bir yere bağlandıklarında hiçbir şey görüntülemezler.
  • Üçünü de bağlayın. Birinin eksik olduğu bir birim asla tamamlanmaz, bu nedenle onay düğmesi asla etkinleşmez.

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

ReactNode
gerekli
İçinde bir yerde üç alan elementini barındıran düzeniniz.
string
Gelişmiş bir tokenizer yayınlanabilir anahtarı. Belirtmezseniz SDK hesabın anahtarını kendisi getirir.
'stacked' | 'compact'
Birlikte oluşturulan alanları şekillendirir. Ayrı ayrı bağlanan alanlar bunu yok sayar ve tam kenarlıklarla görüntülenir. Varsayılan değer stacked.
(payload: CardFieldsChangePayload) => void
Her düzenlemede bağlı alanların birleşik durumuyla tetiklenir.

CardFieldsChangePayload

onChange geri çağırmasının döndürdüğü değerler:
  • complete: boolean: bağlı her alan doldurulmuş ve geçerli
  • errors: Record<string, string>: cardNumber, cardExpiry, cardCvc anahtarlarıyla alan başına mesajlar

Durumlar

Yayınlanabilir anahtar çözümlendiğinde alt öğeleri görüntülenir. onChange bağlı her alanın birleşik durumunu bildirir; böylece tek bir işleyici kartın tamamını kapsar.

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.
  • Her alan aynı CardFields içinde olmalıdır. Tek bir token’a dönüştürme işlemini paylaşırlar, bu nedenle bunun dışına bağlanan bir alan hiçbir şey toplamaz.
  • CardFields toplama yüzeyini kaydeder; böylece createConfirmationToken ek bir bağlantı olmadan kartı token’a dönüştürür.
  • Yayınlanabilir anahtarın getirilmesi otomatiktir. publicKey değerini yalnızca zaten bir anahtarınız varsa iletin.
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.

Elementler

Bu alt denetleyicinin bağladığı elementler. Her birinin kendi sayfası vardır:

CardNumberElement

PCI’dan yalıtılmış, barındırılan kart numarası alanı. Kart numaraları asla ana sayfaya ulaşmaz.

CardExpiryElement

PCI’dan yalıtılmış, barındırılan kart son kullanma tarihi alanı.

CardCvcElement

PCI’dan yalıtılmış, barındırılan kart güvenlik kodu alanı.