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.
Bu
Hesap sunduğunda, cihaz desteklediğinde ve bu sayfanın kaynağı (origin) hesap için onaylandığında her cüzdan için kullanılabilirliği döndürür (birinci taraf whop.com sayfaları önceden onaylıdır; bir satıcı sayfası, Domains API aracılığıyla kendi alan adında Apple Pay’in hazır olmasını gerektirir ve orada Google Pay sunmak Google Pay API Hizmet Koşulları’na tabidir). Kendisi bir iframe içinde olan bir sayfada, tarayıcı bunu açığa çıkardığında Apple Pay bunun yerine üst düzey sayfanın alan adını denetler. WebKit dışı tarayıcılarda Apple Pay, masaüstünden iPhone’a devretme akışıdır, bu nedenle oradaki mobil cihazlar onu kullanılamaz olarak bildirir; iOS tarayıcılarındaki yerel Apple Pay bundan etkilenmez.
Bu örnekteki
Alıcı bir teslimat adresi seçti (yetkilendirme öncesi kısaltılmış: yalnızca şehir, eyalet, posta kodu ve ülke; Apple Pay bir ABD ZIP kodunu beş haneye indirir ve bir Kanada veya Birleşik Krallık posta kodunun son üç karakterini atar). Adres ve seçili kargo seçeneği için toplamlarla yanıt verin: alıcı başka birini seçene kadar ilk seçenek.
Alıcı bir kargo seçeneği seçti ya da Apple Pay seçili olanı yeniden duyurdu: adres değişikliklerinin tümü yanıtlandığında ve bekleyen yoksa Apple Pay bunu hâlâ seçili olan seçenek için tetikler. Seçili seçeneği çıkaran bir yanıttan sonra asla tetiklenmez; bu durumda ilk seçenek bir olay olmadan seçim hâline gelir, bu nedenle yanıtladığınız her toplam seçili seçeneği fiyatlandırır: alıcı başka birini seçene kadar ilk seçenek, yanıtlarınız
Alıcı, kısaltılmış fatura adresiyle (yalnızca şehir, eyalet, posta kodu ve ülke) birlikte bir kart seçti: toplamı, ücretin vergilendirildiği adrese göre yeniden fiyatlandırın. Apple Pay bunu alıcı bir kart seçtiğinde, Google Pay ise ödeme ekranı açıldığında ve alıcı her kart değiştirdiğinde tetikler. Küçük birimlerle
Alıcı bir ödeme yöntemi seçti: toplamı onun için yeniden fiyatlandırın; örneğin kredi kartlarına ek ücret. Apple Pay bunu alıcı bir kart seçtiğinde, Google Pay ise ödeme ekranı açıldığında ve alıcı her kart değiştirdiğinde tetikler; her biri o kartın
Alıcı, ödeme ekranının promosyon alanına (
Alıcı ödemeyi yetkilendirdi ve henüz bir onay token’ı yok. Önce onaylamak veya reddetmek için abone olun: ödeme ekranı yanıtınızı bekler ve bir işleyici olmadan token hemen oluşturulur. Olay; ödeyeni, ödeme yöntemini (kısaltılmış fatura adresiyle ve
Ödeme ekranı bir onay token’ı oluşturdu; ödeme ekranı kapandıktan sonra bildirilir. Bu,
Alıcı ödeme ekranını kapattı veya PayPal’ı kapattı. Abonelikten çıkma fonksiyonunu döndürür.
Payments kaynağını bir element bağlamadan oluşturun: vanilla’da whop.payments.paymentRequest.create({ … }), React’te useWhop().payments.paymentRequest.create({ … }).Seçenekler
Bunlarıwhop.payments.paymentRequest.create({ … }) metoduna iletin.Yalnızca kaydetme onayını gösterdikten sonra ayarlayın. Token’ı
off_session veya on_session kullanımı için işaretler.API’nin
enabled, disabled ve include_platform_defaults biçimindeki ödeme yöntemi filtreleri. canMakePayment() metodunun bildirdiği cüzdanları daraltırlar: disabled türleri kaldırır, enabled sunulan türleri geri getirir ve include_platform_defaults: false yalnızca etkin türleri bırakır. Hesabın sunmadığı bir yöntemi asla eklemezler. PayPal, paypal türünü izler. v1.9.0 sürümünden beri.Ödeme ekranından ödeyenin e-postasını isteyin; onay token’ı bunu gerektirir. Varsayılan değer
true.Ödeme ekranından ödeyenin telefon numarasını isteyin; sonuçta
payer.phone olarak teslim edilir: onu sağlayan kişinin ülkesine göre ayrıştırılabildiğinde E.164 biçiminde, aksi hâlde cüzdanın verdiği şekliyle; payer.country fatura ülkesidir. Google Pay bunu ödeme ekranının zaten istediği fatura adresi üzerinden toplar. PayPal bunu iletişim bölümü üzerinden toplar ve telefonu olmayan bir hesabı reddeder. Varsayılan değer false.Ödeme ekranından bir teslimat adresi isteyin (ve verildiğinde
shippingOptions sunun). PayPal her zaman bir adres ister, çünkü vergi bu adrese göre hesaplanır; ve adresi yalnızca bu ayarlandığında shipping olarak döndürür. Varsayılan değer false.Ödeme ekranının kendi promosyon kodu alanını sunun ve
onPromoCodeChange olayını yanıtlayın. Apple Pay bu alanı Apple Pay sürüm 12’yi destekleyen cihazlarda (iOS 15 ve macOS 12) gösterir; Google Pay ise hesabın Google Pay kurulumunun tekliflere izin verdiği yerlerde gösterir. Diğer cihazlar ödeme ekranını bu alan olmadan açar. Varsayılan değer false. v1.5.0 sürümünden beri.Ücrete zaten uygulanmış bir promosyon kodu; alıcının görebilmesi, değiştirebilmesi veya kaldırabilmesi için ödeme ekranına önceden doldurulur.
v1.5.0 sürümünden beri.appliedPromoCode kodunun ne işe yaradığı; Google Pay’de kodun yanında gösterilir. Apple Pay’in kupon alanında açıklama yoktur. v1.5.0 sürümünden beri.Apple Pay ödeme ekranı için hesabın ISO 3166-1 alpha-2 ülke kodu. Hesabın yayımlanmış kayıt ülkesini kullanmak için bunu atlayın. Hiçbiri mevcut olmadığında ödeme ekranı varsayılan olarak
US kullanır.Ödeme ekranının toplamın altında listelediği satır kalemleri. Daha sonra
update() ile değiştirin.requestShipping ayarlandığında ödeme ekranının sunduğu kargo seçenekleri. Yalnızca görüntüleme amaçlıdır; amount değerini değişiklik işleyicinizden güncelleyin. Ödeme ekranı ilk seçenek seçili olarak açılır ve bunun için onShippingOptionChange tetiklemez, bu nedenle amount onun fiyatını zaten içermelidir. Daha sonra update() ile değiştirin.Metotlar
Bunları kaynak üzerinde çağırın.canMakePayment
Hesap sunduğunda, cihaz desteklediğinde ve bu sayfanın kaynağı (origin) hesap için onaylandığında her cüzdan için kullanılabilirliği döndürür (birinci taraf whop.com sayfaları önceden onaylıdır; bir satıcı sayfası, Domains API aracılığıyla kendi alan adında Apple Pay’in hazır olmasını gerektirir ve orada Google Pay sunmak Google Pay API Hizmet Koşulları’na tabidir). Kendisi bir iframe içinde olan bir sayfada, tarayıcı bunu açığa çıkardığında Apple Pay bunun yerine üst düzey sayfanın alan adını denetler. WebKit dışı tarayıcılarda Apple Pay, masaüstünden iPhone’a devretme akışıdır, bu nedenle oradaki mobil cihazlar onu kullanılamaz olarak bildirir; iOS tarayıcılarındaki yerel Apple Pay bundan etkilenmez. order, cüzdanları hangi ödeme ekranının tarayıcıya yerel olduğuna göre sıralar (Safari’de önce Apple Pay, başka yerlerde önce Google Pay, en son PayPal), böylece hızlı ödeme düğmeleri en iyisinden başlayarak dizilebilir. payPal, hesap PayPal’ı bu para biriminde sunduğunda, tutar PayPal’ın sınırları içinde olduğunda, istek ödeyenin telefonunu istemediğinde (bir off_session isteği $0 olabilir; bu, PayPal’ı ücret almadan kaydeder), PayPal’ın betikleri bu sayfada yüklendiğinde ve bu sayfanın kaynağı diğer cüzdanlarda olduğu gibi hesap için onaylandığında PayPal’ı bildirir. İçerik Güvenliği Politikası olan bir sayfa, contentSecurityPolicy() tarafından dahil edilen PayPal ana makinelerine izin vermelidir. PayPal’ın kendi v5 JavaScript SDK’sını zaten yükleyen bir sayfa payPal: false bildirir. Yalnızca listelediğiniz cüzdanları denetlemek için types iletin; show(type) o cüzdanın denetlenmiş olmasını gerektirir. wallets, kullanılabilir her cüzdanın resmî düğme görselini (light ve dark renk ve görsel) taşır. Bu, show() metodunu hazırlar. Her zaman önce bunun sonucunu bekleyin.ParametrelerDöndürür Promise<WalletAvailability>Cüzdanlar, hangi ödeme ekranının bu tarayıcıya yerel olduğuna göre sıralanır (WebKit’te önce Apple Pay, diğer her yerde önce Google Pay, en son PayPal), böylece hızlı ödeme düğmeleri en iyisinden başlayarak dizilebilir. Tüketici tarafından belirtilen kullanılabilirlikte (önizlemeler) ve bundan önceki bağlantılarda bulunmaz. Payment-request’in WalletSheetType türü değil, satır içi bir birleşimdir: o modül zaten bunu içe aktarır.
Kullanılabilir her cüzdanın cüzdan türüne göre anahtarlanmış ayrıntıları. Tüketici tarafından belirtilen kullanılabilirlikte (önizlemeler) bulunmaz.
show
canMakePayment() sonucunu bekledikten sonra, seçilen cüzdanı basma anında senkron olarak açın: Apple, oturumun hareket yığını içinde oluşturulmasını gerektirir ve PayPal penceresini orada açar (masaüstünde bir açılır pencere; açılır pencere engellendiğinde ve mobilde PayPal’ın sayfa içi penceresi). Sayfanız zaten bir e-posta topladıysa email iletin; cüzdan onu alır ve ikinci kez sormaz. requestPayerEmail: false ile bir e-posta iletmek zorunludur ve onay token’ları e-posta gerektirdiğinden cüzdan o olmadan açılmayı reddeder. Ödeme ekranı açıkken update() hata fırlatır: değiştirmek için değişiklik olaylarını yanıtlayın. Kullanıcı etkinleştirmesi sırasında senkron olarak çağırın. Tarayıcılar etkinleştirmeyi asenkron adımlar boyunca iptal ettiğinden ön koşulları önceden bekleyin.ParametrelerDöndürür Promise<PaymentRequestResult>phone, kişinin ülkesine göre ayrıştırılabildiğinde E.164 biçimindedir, aksi hâlde verildiği şekliyledir; PayPal bunu yalnızca requestPayerPhone için verir ve telefonu olmayan bir hesabı reddeder. country, her ödeme ekranının topladığı fatura ülkesidir.Değişiklik olaylarının taşıdığı kısaltılmış adresin aksine, onay token’ının taşıdığı eksiksiz fatura adresi; cüzdan adres vermediğinde
null. Apple Pay ve Google Pay kartın fatura adresini verir. PayPal’da bu, alıcının PayPal’da seçtiği ve toplamın üzerinden vergilendirildiği adrestir.requestShipping ayarlanmadıkça null. option seçili kargo seçeneğidir: alıcı başka birini seçene kadar sunulan ilk seçenek; bir yanıt seçenekleri seçilen id olmadan değiştirdiğinde yine ilk seçenek. Apple Pay ve Google Pay, seçenekler sunulduğunda bunu her zaman ayarlar, PayPal ise asla ayarlamaz.update
Bu örnekteki amount, lineItems ve shippingOptions değerlerini değiştirin. Diğer tüm seçenekler create() sırasında sabitlenir: değiştirmek için yeni bir örnek oluşturun.ParametrelerOlaylar
Aşağıdaki olaylara abone olun. Her metot bir abonelikten çıkma fonksiyonu döndürür.onShippingAddressChange
Alıcı bir teslimat adresi seçti (yetkilendirme öncesi kısaltılmış: yalnızca şehir, eyalet, posta kodu ve ülke; Apple Pay bir ABD ZIP kodunu beş haneye indirir ve bir Kanada veya Birleşik Krallık posta kodunun son üç karakterini atar). Adres ve seçili kargo seçeneği için toplamlarla yanıt verin: alıcı başka birini seçene kadar ilk seçenek. shippingOptions seçenekleri değiştirir (boş bir liste hiçbir şeyi değiştirmez). Seçilen bir seçenek, yanıt onun id değerini koruduğu sürece seçili kalır; yanıt onu çıkardığında, ilk seçenek bir onShippingOptionChange olmadan seçim hâline gelir, bu nedenle onu fiyatlandırın. Yanıttaki her hata, sonraki bir adres yanıtı onu temizleyene kadar adreste kalır: bir field (city, state, postal_code, country) adlandıran hata Apple Pay’de o alanı işaretler, Google Pay ise yalnızca mesajı gösterir. Adreste bir hata durduğu sürece ödeme reddedilir. Kargo gönderemeyeceğiniz bir adresi, field olmadan bir shipping_address_unserviceable hatasıyla reddedin. Apple Pay, Google Pay ve PayPal’da 25 saniye içinde yanıt vermeyen bir işleyici, hata fırlatan bir işleyici gibi adresi başarısız kılar ve sonraki yanıtı yok sayılır. PayPal bunu alıcının seçtiği adresle tetikler ve bir field adlandıran hata, adresin o kısmını PayPal içinde reddeder. Her olay için updateWith(…) metodunu tam olarak bir kez çağırın. Onu çağırmadan önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar. Abonelikten çıkma fonksiyonunu döndürür.onShippingOptionChange
Alıcı bir kargo seçeneği seçti ya da Apple Pay seçili olanı yeniden duyurdu: adres değişikliklerinin tümü yanıtlandığında ve bekleyen yoksa Apple Pay bunu hâlâ seçili olan seçenek için tetikler. Seçili seçeneği çıkaran bir yanıttan sonra asla tetiklenmez; bu durumda ilk seçenek bir olay olmadan seçim hâline gelir, bu nedenle yanıtladığınız her toplam seçili seçeneği fiyatlandırır: alıcı başka birini seçene kadar ilk seçenek, yanıtlarınız id değerini koruduğu sürece seçilen seçenek ve bir yanıt onu çıkardığında yine ilk seçenek. Yalnızca tutar sözleşmesi: updateWith amount/lineItems/shippingOptions/errors taşır. errors içeren bir yanıt, alıcı işleyicinizin kabul ettiği bir seçeneği seçene kadar seçeneği reddeder. Apple Pay’de kargo seçeneği için bir hata yuvası yoktur, bu nedenle yanıt başka ne taşırsa taşısın son kabul edilen toplamı korur ve alıcı Öde’ye dokunduğunda ilk hatanın mesajı gösterilir. Google Pay mesajı seçenek seçildiğinde gösterir. Apple Pay, Google Pay ve PayPal’da 25 saniye içinde yanıt vermeyen bir işleyici, hata fırlatan bir işleyici gibi seçeneği reddeder ve sonraki yanıtı yok sayılır. Her olay için updateWith(…) metodunu tam olarak bir kez çağırın. Onu çağırmadan önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar. Abonelikten çıkma fonksiyonunu döndürür.onBillingAddressChange
Alıcı, kısaltılmış fatura adresiyle (yalnızca şehir, eyalet, posta kodu ve ülke) birlikte bir kart seçti: toplamı, ücretin vergilendirildiği adrese göre yeniden fiyatlandırın. Apple Pay bunu alıcı bir kart seçtiğinde, Google Pay ise ödeme ekranı açıldığında ve alıcı her kart değiştirdiğinde tetikler. Küçük birimlerle updateWith({ amount }), geçerli toplamı korumak için updateWith({}) veya kartı reddetmek için updateWith({ errors }) ile yanıt verin. Her olay tam olarak bir kez yanıtlanır: hata fırlatan, reddedilen veya 10 saniye içinde yanıt vermeyen bir işleyici kartı reddeder, böylece alıcı başka bir kart seçer. Apple Pay ve Google Pay’de aynı seçim ardından paymentMethodChange tetikler ve ödeme ekranı her ikisi de yanıtlandığında güncellenir. PayPal bunu, alıcının PayPal’da seçtiği her teslimat adresiyle tetikler; bu, token’ının faturalandırdığı ve vergilendirdiği adrestir ve oradaki bir ret, o adresi PayPal içinde reddeder. Her olay için updateWith(…) metodunu tam olarak bir kez çağırın. Onu çağırmadan önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar. Abonelikten çıkma fonksiyonunu döndürür.onPaymentMethodChange
Alıcı bir ödeme yöntemi seçti: toplamı onun için yeniden fiyatlandırın; örneğin kredi kartlarına ek ücret. Apple Pay bunu alıcı bir kart seçtiğinde, Google Pay ise ödeme ekranı açıldığında ve alıcı her kart değiştirdiğinde tetikler; her biri o kartın billingAddressChange olayından hemen sonra gelir. paymentMethod.type değeri card olur. paymentMethod.card, alıcı yetkilendirmeden önce cüzdanın kart hakkında söylediklerini taşır: Apple Pay funding bilgisini bildirir (Apple genellikle ağı o zamana kadar saklar), Google Pay ise network bilgisini. paymentMethod.billingAddress, kartın kısaltılmış fatura adresidir. Yeniden fiyatlandırmak için updateWith({ amount, lineItems }), geçerli toplamı korumak için updateWith({}) veya yöntemi reddetmek için updateWith({ errors }) ile yanıt verin; shippingOptions yok sayılır. Apple Pay bir reddi kartın fatura iletişim bilgisinde (verildiğinde adlandırılan field üzerinde) işaretler ve alıcı başka bir yöntem seçene kadar Öde düğmesini tutar. Google Pay mesajı kartta gösterir ve alıcı kabul ettiğiniz bir kartı seçene kadar o karttaki Öde dokunuşunu reddeder. Reddedilen bir kart, bu yanıtın veya billingAddressChange yanıtının fiyatlandırmasından bağımsız olarak toplamları olduğu gibi bırakır. Her olay tam olarak bir kez yanıtlanır: hata fırlatan, reddedilen veya 10 saniye içinde yanıt vermeyen bir işleyici yöntemi reddeder. Her ödeme ekranı, alıcı ödeme yapmadan önce yanıtınızı bekler. PayPal bunu asla tetiklemez. Her olay için updateWith(…) metodunu tam olarak bir kez çağırın. Onu çağırmadan önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar. Abonelikten çıkma fonksiyonunu döndürür.onPromoCodeChange
Alıcı, ödeme ekranının promosyon alanına (requestPromoCode) bir kod yazdı, kodu değiştirdi veya kaldırdı. Kodu yeni bir toplamla uygulamak için updateWith({ amount }), geçerli toplamla uygulamak için updateWith({}) veya yerinde reddetmek için updateWith({ error }) ile yanıt verin. Bir kaldırma code null olarak gelir ve aynı şekilde yanıtlanır. Uygulanmış bir kodu değiştirmek, asla önce bir kaldırma olarak değil, yeni kodla tek bir olay olarak gelir ve reddedilen yeni bir kod uygulanmış olanı yerinde bırakır. shippingOptions seçili seçeneği çıkardığında, ilk seçenek bir onShippingOptionChange olmadan seçim hâline gelir, bu nedenle onu fiyatlandırın. appliedDescription, Google Pay’de koda açıklama ekler; Apple Pay’in kupon alanında açıklama yoktur, bu nedenle alıcının görmesi gereken her şeyi bir satır kalemi etiketine koyun. Hata fırlatan, reddedilen veya 10 saniye içinde yanıt vermeyen bir işleyici kodu reddeder. Her olay için updateWith(…) metodunu tam olarak bir kez çağırın. Onu çağırmadan önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar. Abonelikten çıkma fonksiyonunu döndürür.onPaymentAuthorization
Alıcı ödemeyi yetkilendirdi ve henüz bir onay token’ı yok. Önce onaylamak veya reddetmek için abone olun: ödeme ekranı yanıtınızı bekler ve bir işleyici olmadan token hemen oluşturulur. Olay; ödeyeni, ödeme yöntemini (kısaltılmış fatura adresiyle ve displayName içinde cüzdanın onun için kendi etiketiyle, örneğin Visa 1234), teslimat adresini ve seçeneğini, alıcının yetkilendirdiği toplamı ve satır kalemlerini taşır. Token’ı oluşturmak için respondWith({ approved: true }) ile yanıt verin; ardından show() ve onConfirmationToken onu her zamanki gibi teslim eder. Reddetmek için respondWith({ approved: false, message }) ile yanıt verin: token oluşturulmaz, Apple Pay ve Google Pay message değerini ödeme ekranında gösterir ve alıcı bir şeyi değiştirip yeniden ödeme yapabilir veya ödeme ekranını kapatabilir. PayPal mesajınızı gösteremez, bu nedenle oradaki bir ret denemeyi sonlandırır: show(), payment_request_refused ile reddedilir ve alıcı PayPal’a yeniden basabilir. Her olay tam olarak bir kez yanıtlanır ve yalnızca approved: true bir token oluşturur: hata fırlatan, reddedilen veya 25 saniye içinde yanıt vermeyen bir işleyici ödemeyi reddeder; bu, Apple Pay ve Google Pay’in kendi 30 saniyelik sınırlarından önce reddi gösterebilmesi için yeterince erkendir. Her olay için respondWith(…) metodunu tam olarak bir kez çağırın. Onu çağırmadan önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar. Abonelikten çıkma fonksiyonunu döndürür.onConfirmationToken
Ödeme ekranı bir onay token’ı oluşturdu; ödeme ekranı kapandıktan sonra bildirilir. Bu, show() metodunun döndürdüğü sonuçla aynıdır. Abonelikten çıkma fonksiyonunu döndürür.onCancel
Alıcı ödeme ekranını kapattı veya PayPal’ı kapattı. Abonelikten çıkma fonksiyonunu döndürür.İçerik güvenliği politikası
Bu kaynak bir çerçevede değil, sayfanızda çalışır. İçerik Güvenliği Politikası olan bir sayfa bu kaynaklara ihtiyaç duyar.@whop/elements içindeki contentSecurityPolicy() bu tablodaki her kaynağı döndürür. Sandbox kaynağı environment: "sandbox" ile geçerlidir.
