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.
Checkout 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. ExpressCheckoutElement, bu Checkout tanıtıcısında CheckoutElement elementine bir alternatiftir. Aynı anda yalnızca birini bağlayın. Başka birini bağlamadan önce onu yok edin.
Ödeme oturumunu plan, items veya checkoutConfiguration değerinizden açan ve kimlik bilgisini kendine saklayan <Checkout> içine bağlayın. <Checkout> ise <WhopElements> içine bağlanır. Düğmeye tek bir dokunuş satın alma işleminin tamamıdır: sunucunuza iletilecek bir onay token’ı yoktur.

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

Prop’lar

object | ("apple_pay" | "google_pay" | "paypal_express")[]
Dizi olarak wallets kullanımdan kaldırılmıştır ve bir sonraki ana sürümde kaldırılacaktır. Bunun yerine "auto" veya "never" değerleriyle { applePay, googlePay, payPal } iletin.
Hangi cüzdanların gösterilebileceği. Bir düğmeyi dışarıda bırakmak için applePay, googlePay veya payPal değerini 'never' olarak ayarlayın; her anahtarın varsayılanı 'auto' değeridir; bu, alıcının cihazının ve satıcının gerçekte sunduğu şeyler üzerinde bir filtredir. Element, cihazın, sunulan matrisin veya ödemenin ödeme yöntemi yapılandırmasının destekleyemediği bir cüzdanı asla göstermez ve gösterim sırası en iyi yerel seçenek önce olacak şekilde kalır, PayPal en sondadır. Cüzdan türlerinden oluşan bir liste (['apple_pay', 'google_pay']) hâlâ izin listesi olarak kabul edilir ancak kullanımdan kaldırılmıştır ve bir sonraki ana sürümde kaldırılacaktır; boş bir liste hiçbir şey göstermez (geliştirme derlemelerinde uyarı verilir). Her cüzdan, Domains API aracılığıyla sayfanın alan adında Apple Pay’in hazır olmasını gerektirir; birinci taraf whop.com sayfaları önceden onaylıdır; diğer tüm sitelerde alan adına Apple Pay ekleyin, aksi takdirde düğmeler gizli kalır. Google Pay’i kendi sitenizde sunmak Google Pay API Hizmet Şartları’na tabidir. Varsayılan değer {}.
"auto" | "horizontal" | "vertical"
Düğmelerin nasıl dizileceği. auto, elementin kendi kapsayıcısını izler: dar kapsayıcılarda üst üste, geniş olanlarda yan yana; horizontal ve vertical tek bir düzeni zorunlu kılar. Varsayılan değer "auto".

Olaylar

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

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

Prop’lar

('apple_pay' | 'google_pay')[]
Cihazın sunduğu şeyler üzerinde bir filtre olarak hangi cüzdanların gösterilebileceği. Element, cihazın, hesabın veya ödemenin ödeme yöntemi yapılandırmasının destekleyemediği bir cüzdanı asla göstermez. Boş bir liste hiçbir şey göstermez. Varsayılan olarak her ikisidir.
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 yerine oturduğunda bir kez tetiklenir: düğme görünür hâldedir veya element hiçbir şey göstermeyeceğini bilir. <Checkout> bunu bekler, 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.

Durumlar

Oturum açılırken ve cihaza ödeme yapıp yapamayacağı sorulurken tek bir iskelet hap düğme, ardından Powered by Whop bildiriminin üzerinde platformun kendi Apple Pay veya Google Pay düğmesi. Cüzdanı olmayan bir cihaz, ödemenin ödeme yöntemi yapılandırmasının devre dışı bıraktığı bir cüzdan veya tükenmiş ya da arşivlenmiş bir plan hiçbir şey göstermez. Bir sayfanın dürüstçe tamamlayamayacağı bir ödeme (bir kurulum, bekleme listesine katılma, bir aktarım, yalnızca bir sayfanın sorabileceği bir form sorusu) açıklayıcı bir ekran gösterir ve onError aracılığıyla EXPRESS_CHECKOUT_UNAVAILABLE bildirir. Satın alma işleminden sonra element sonucunu gösterir: tamamlandı, işleniyor veya ödeme hâlâ alıcıya ihtiyaç duyduğunda bir Finish payment ya da Try again düğmesi.

Bilmekte fayda var

  • Bir cihaz tek bir cüzdan sunar: iOS’ta Apple Pay, Android’de Google Pay. Burada layout prop’unun olmamasının nedeni budur: düzenlenecek ikinci bir düğme asla yoktur.
  • Sayfa, oturumun hâlâ ihtiyaç duyduğu şeyleri toplar: oturumda e-posta yoksa e-posta, satıcı bir telefon numarası topluyorsa telefon numarası ve fiziksel ürünler için bir teslimat adresi. Telefon numaralarını doğrulayan bir satıcı, sayfa kapandıktan sonra yerel bir modalda bir kod adımı alır.
  • iOS’ta sayfa, alıcı kart değiştirdikçe yeniden fiyatlandırır, böylece vergi fatura adresini izler ve satıcı kodlara izin verdiğinde bir promosyon kodu alanı sunar. Google’ın Android sayfası ödemenin toplamını gösterir ve kod alanı yoktur.
  • Uygulamanızda asla gezinme yapılmaz. <Checkout> üzerindeki onComplete, satın alma işlemi kesinleştiğinde sessionId ve receiptId ile bir kez tetiklenir; alıcıyı ilerlettiğiniz yer burasıdır. Teslimatı bu geri çağırmadan değil, webhook’lardan yapın.
  • 3D Secure ve diğer site dışı adımlar iOS’ta ASWebAuthenticationSession, Android’de Custom Tabs açar ve element ödeme sonuçlanana kadar sorgular. <Checkout> üzerindeki returnUrl, barındırdığınız bir https URL’si olmalıdır.
  • Her <Checkout> seçeneği oluşturma zamanında belirlenir. Bağlandıktan sonra birini değiştirmek CHECKOUT_OPTIONS_FROZEN bildirir ve orijinal siparişi korur; başka bir şey satmak için <Checkout> bileşenine yeni bir key verin.
Uygulamanızı bir kez <WhopElements getToken={…}> ile sarın, ardından elementin etrafına <Checkout> bağlayın. <Checkout>; plan, items, checkoutConfiguration, quantity, promoCode, affiliateCode, attribution, metadata ve returnUrl ile birlikte onComplete, onError, onLoadingChange ve fallback alır. Başlarken ve Görünüm sayfalarına bakın.