Kendi PayPal düğmesini çizen bir sayfa için düşük seviyeli, arayüzsüz (headless) ödeme oturumu. load(), ödeme oturumunu lineItems üzerinden oluşturur; show("paypal", { termsAccepted: true }) alıcıyı PayPal’a gönderir (masaüstünde bir açılır pencere, telefonlarda sekmenin tamamı) ve alıcı onayladığında ödemeyle birlikte çözümlenir. paymentMethodOptions.paypal.requestShipping ile PayPal alıcıdan bir teslimat adresi ister ve hesabın shipping_address.changed olayına abone olan webhook’u, alıcı PayPal’dayken her adresi sunucunuzda fiyatlandırır; ödeme yalnızca alıcı onayladıktan sonra, o fiyattan oluşturulur. Tam sayfa yönlendirmeden sonra promise hiçbir zaman sonuçlanmaz; bunun yerine sonucu redirectUrl adresinin payment ve status sorgu parametrelerinden okuyun.
Bu sayfa @whop/elements@1.10.0 ve @whop/elements-react@1.10.0 sürümlerini belgeler.
v1.10.0 sürümünden beri.Bu Checkout kaynağını bir element bağlamadan oluşturun: vanilla’da whop.checkout.checkoutSession.create({ … }) veya React’te useWhop().checkout.checkoutSession.create({ … }).
Seçenekler
Bunları whop.checkout.checkoutSession.create({ … }) çağrısına iletin.
string
gerekli
Satır öğelerini satan, biz_ önekli hesap kimliği.
CheckoutSessionLineItem[]
gerekli
Alıcının satın aldığı şey: her giriş bir varyantı (plan_…) ve isteğe bağlı bir quantity değerini (varsayılan 1) belirtir. Birden fazla giriş bir sepet oluşturur.
Göster özellikler
string
gerekli
number
string
gerekli
Sekme yönlendirildiğinde alıcının PayPal’dan sonra ulaştığı adres; sonuna payment ve status eklenir: succeeded, canceled, failed veya Whop ödemeyi hâlâ tamamlarken processing (sonuçlandığını görmek için ödemeyi sunucunuzdan okuyun). Masaüstünde bunun yerine açılır pencere kapanır ve show() sonuçlanır.
Record<string, string>
Ödeme oturumunda tutulan ve oluşturduğu ödemeye kopyalanan, en fazla 40 adet kendi dize anahtarınız ve değeriniz; böylece ödemede ve webhook’larında geri gelirler, örneğin reklam ve satış ortaklığı ilişkilendirmesi için. Alıcının tarayıcısından ayarlandıkları için fiyatlar veya teslimat için asla bunlara güvenmeyin.
"off_session"
Alıcının PayPal hesabını kaydetmek için off_session olarak ayarlayın; böylece sunucunuz daha sonra alıcı olmadan, örneğin tek tıklamalı bir ek satış için ücretlendirme yapabilir. PayPal, alıcı onay verirken gelecekteki ödemeleri kabul etmesini ister. Bunu yalnızca alıcıya PayPal hesabının kaydedileceğini söyledikten sonra ayarlayın.
string
Ödemenin ve üyeliğin ait olduğu alıcının e-postası. Onay veren PayPal hesabının e-postasını kullanmak için atlayın.
CheckoutSessionPaymentMethodOptions
Tek bir ödeme yöntemi için seçenekler. paypal.requestShipping, PayPal’ın alıcıdan bir teslimat adresi istemesini sağlar. Hesabın shipping_address.changed olayına abone olan etkin bir https webhook’u olduğunda Whop her adres için onu çağırır ve yanıt olarak döndürdüğü toplamları tahsil eder. Varsayılan değer false.
Göster özellikler
CheckoutSessionPayPalOptions
Göster özellikler
boolean
Metotlar
Bunları kaynak üzerinde çağırın.
show metodunu kullanıcı etkinleştirmesi sırasında senkron olarak çağırın. Ön koşulları önceden bekleyin (await).
load
Ödeme oturumunu lineItems üzerinden oluşturur. Tekrar çağırmak aynı oturumu döndürür. show(), oturum henüz yüklenmemişse önce onu yükler. terms, alıcının ödeme yaparak kabul ettiği şeydir: links değerlerini (satıcının yayımlanmış politikaları ve Whop’un alıcı koşulları) düğmenizin yanında gösterin ve terms.required değeri true olduğunda alıcının bunları etkin biçimde, örneğin bir onay kutusuyla kabul etmesini sağlayın. requirements, oturumun ödenebilmesi için gerekenleri listeler: email, terms ve paypal.requestShipping ile shipping_address dışındaki hiçbir şey burada toplanamaz, bu nedenle show() bunları reddeder.DöndürürPromise<CheckoutSessionLoaded>
string
gerekli
string
gerekli
string[]
gerekli
CheckoutSessionTerms
gerekli
Göster özellikler
boolean
gerekli
CheckoutSessionTermsLink[]
gerekli
Göster özellikler
string
gerekli
"terms_of_service", "privacy_policy", "return_policy", "eula", "whop_buyer_terms" veya "whop_privacy_policy" değerlerinden biri.
string
gerekli
show
Bunu PayPal düğmenizin tıklama işleyicisinde senkron olarak çağırın: masaüstünde açılır pencereyi orada açar ve daha sonra açılan bir açılır pencere engellenir. termsAccepted: true değerini yalnızca load() çağrısının terms.links değerleri bu basış için düğmenin yanında gösterildiyse ve terms.required değeri true olduğunda alıcı bunları etkin biçimde kabul ettiyse iletin. Alıcı onaylayıp Whop ücreti tahsil ettiğinde { payment } ile çözümlenir. termsAccepted olmadan code değeri attestation_required, oturum PayPal’ın toplayamayacağı bir şeye ihtiyaç duyduğunda requirements_unsupported (load() çağrısının requirements değerine bakın), alıcı PayPal’ı iptal ettiğinde veya kapattığında payment_request_cancelled, hesap bu ödemeyi webhook’u aracılığıyla fiyatlandıramadığında seller_pricing_unavailable (kendi vergisini yönetmiyorsa veya sepette bir promosyon kodu, alıcı ücreti, pazar yeri bölüşümü ya da yenilenen bir plan varsa) ve diğer durumlarda payment_failed olan bir hatayla reddedilir. Telefonlarda sekme PayPal’a gider ve promise hiçbir zaman sonuçlanmaz. Kullanıcı etkinleştirmesi sırasında senkron olarak çağırın. Tarayıcılar asenkron adımlar arasında etkinleştirmeyi iptal ettiği için ön koşulları önceden bekleyin.Parametreler
"paypal"
gerekli
CheckoutSessionShowOptions
Gizle özellikler
boolean
DöndürürPromise<CheckoutSessionConfirmResult>
CheckoutSessionPayment
gerekli
Göster özellikler
string
gerekli
string
gerekli
Assistant
Responses are generated using AI and may contain mistakes.