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.
Bir WhopPayments kapsamı içine bağlanır. Değer alanının yanında, alıcının ülkesine göre önceden seçilmiş bir kayıt türü seçici bulunur.
Ücretin ve onay token’ının sahibi olan <Payments> içine bağlayın. <Payments> ise <WhopElements> içine bağlanır. Bir değer girişinin yanında bir kayıt türü seçici bulunur; böylece KDV (VAT) veya CUIT numarası giren bir alıcı önce doğru türü seçer.

Örnek veriler. Deneme alanını açın.

Prop’lar

boolean
Host son kesinleşmiş kaydı kaydederken her iki alanı da devre dışı bırakır. Varsayılan değer false.
string
Türü önceden seçmek için kullanılan, ISO 3166-1 alpha-2 biçimindeki alıcı ülkesi. AR, ar_cuit seçer; LI, li_uid seçer. AB ve eşlenmemiş ya da boş değerler eu_vat seçer. Eşlenmiş diğer ülkeler kendi ilk türlerini seçer. Elle yapılan bir seçim ülke değişikliklerinde korunur. Varsayılan değer "".
object
Devam ettirilen bir oturumdan gelen başlangıç type ve value değerleri. Desteklenmeyen bir type, ülke varsayılanına geri döner.
string
Değer girişinin altında gösterilen API doğrulama hatası. Boş (varsayılan) hiçbir şey göstermez. Varsayılan değer "".

Olaylar

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

onChange

Değer boş değilken odak kaybında veya Enter tuşunda ya da bir değer mevcutken tür değiştiğinde tetiklenir. Art arda gelen aynı değerler bir kez tetiklenir. Değeri temizlemek tetiklemez. Saklanan kayıtları host temizlemelidir.
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<TaxIdElementProps>
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

Binding<WhopTaxID?>?
Her kesinleşmiş kaydı alır.
String?
Türü önceden seçmek için kullanılan, ISO 3166-1 alpha-2 biçimindeki alıcı ülkesi.
WhopTaxID?
Devam ettirilen bir oturumdan gelen başlangıç çifti. Desteklenmeyen bir tür varsayılana geri döner.
Bool
Son kesinleşmiş kaydı kaydederken her iki alanı da devre dışı bırakır. Varsayılan değer false.
String?
Değer girişinin altında gösterilen bir API doğrulama hatası.

WhopTaxID

Bir seçimin döndürdüğü değerler:
  • type: WhopTaxIDType: kayıt türü; eu_vat, ar_cuit, …
  • value: String: kaydın kendisi

Durumlar

Hemen görüntülenir. Seçilen türün biçimiyle eşleşmeyen bir değer kendi hatasını gösterir. error, bir API doğrulama hatasını değer alanının altında gösterir.

Bilmekte fayda var

  • AR, ar_cuit değerini önceden seçer; AB üyeleri ve eşlenmemiş her şey eu_vat değerini önceden seçer. Elle yapılan bir seçim ülke değişikliklerinde korunur.
  • İkisinin uyumlu kalması için ülkeyi adres elementinden iletin.
  • Binding her tuş vuruşunda değil, her kesinleşmiş kayıtta tetiklenir.

Kurulum

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

Prop’lar

string
Türü önceden seçmek için kullanılan, ISO 3166-1 alpha-2 biçimindeki alıcı ülkesi. AR, ar_cuit seçer; AB ve eşlenmemiş değerler eu_vat seçer.
{ type: string; value: string }
Devam ettirilen bir oturumdan gelen başlangıç çifti. Desteklenmeyen bir tür varsayılana geri döner.
boolean
Son kesinleşmiş kaydı kaydederken kullanmak için her iki alanı da devre dışı bırakır.
string
Değer girişinin altında gösterilen, API’nizden gelen bir doğrulama mesajı.
(payload: TaxIdChangePayload) => void
Her tür veya değer değişikliğinde 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.

TaxIdChangePayload

onChange geri çağırmasının döndürdüğü değerler:
  • taxId: { type: TaxIdType; value: string }: seçilen kayıt türü ve alıcının yazdığı değer

Durumlar

Hemen görüntülenir. Tür country değerinden önceden seçilir ve değer girişi o türün biçimine göre doğrulanır. onChange geçerli çiftle tetiklenir.

Bilmekte fayda var

  • country yalnızca önceden seçim yapar. Bir türü elle seçen alıcı, ülke değişikliklerinde bu seçimi korur.
  • Kendi API doğrulamanızdan gelen bir mesajı değer girişinin altında göstermek için error iletin.
  • Element çifti bildirir. Onu göndermek size kalmıştır: kendi sipariş veya müşteri kaydınıza ekleyin.
Uygulamanızı bir kez <WhopElements getToken={…}> ile sarın, ardından elementlerin etrafına <Payments> bağlayın. Bkz. Başlarken ve Görünüm.