Lavniveau, headless checkout-session til en side, der tegner sin egen PayPal-knap. load() opretter checkout-sessionen ud fra lineItems; show("paypal", { termsAccepted: true }) sender køberen til PayPal — et pop op-vindue på desktop, hele fanen på telefoner — og resolver med betalingen, når køberen godkender. Med paymentMethodOptions.paypal.requestShipping beder PayPal køberen om en leveringsadresse, og kontoens webhook, der abonnerer på shipping_address.changed, prissætter hver adresse på din server, mens køberen er på PayPal; betalingen oprettes først, når køberen godkender, til den pris. Efter en helsidesomdirigering bliver promiset aldrig afgjort; aflæs i stedet udfaldet fra query-parametrene payment og status på redirectUrl.
Denne side dokumenterer @whop/elements@1.10.0 og @whop/elements-react@1.10.0.
Siden v1.10.0.Opret denne Checkout-ressource uden at montere et element: whop.checkout.checkoutSession.create({ … }) i vanilla eller useWhop().checkout.checkoutSession.create({ … }) i React.
Indstillinger
Angiv disse til whop.checkout.checkoutSession.create({ … }).
string
påkrævet
Konto-ID med præfikset biz_, der sælger linjeposterne.
CheckoutSessionLineItem[]
påkrævet
Det, køberen køber: hver post angiver en variant (plan_…) og en valgfri quantity (standard 1). Flere poster udgør en kurv.
Vis egenskaber
string
påkrævet
number
string
påkrævet
Hvor køberen lander efter PayPal, når fanen blev omdirigeret, med payment og status tilføjet: succeeded, canceled, failed eller processing, mens Whop stadig er ved at gennemføre opkrævningen (læs betalingen fra din server for at se den blive afgjort). På desktop lukkes pop op-vinduet i stedet, og show() bliver afgjort.
Record<string, string>
Dine egne strengnøgler og -værdier, op til 40, som gemmes på checkout-sessionen og kopieres over på den betaling, den opretter, så de kommer tilbage på betalingen og dens webhooks, for eksempel til annonce- og affiliate-attribution. De angives fra køberens browser, så stol aldrig på dem til priser eller levering.
"off_session"
Sæt til off_session for at gemme køberens PayPal-konto, så din server senere kan opkræve den uden køberen, for eksempel til et upsell med ét klik. PayPal beder køberen om at acceptere fremtidige betalinger, mens de godkender. Angiv det kun, efter at du har fortalt køberen, at deres PayPal-konto bliver gemt.
string
Køberens e-mail, som betalingen og medlemskabet tilhører. Udelad den for at bruge e-mailen fra den PayPal-konto, der godkender.
CheckoutSessionPaymentMethodOptions
Indstillinger for én betalingsmetode. paypal.requestShipping får PayPal til at bede køberen om en leveringsadresse. Når kontoen har et aktiveret https-webhook, der abonnerer på shipping_address.changed, kalder Whop det for hver adresse og opkræver de totaler, det svarer med. Standard er false.
Vis egenskaber
CheckoutSessionPayPalOptions
Vis egenskaber
boolean
Metoder
Kald disse på ressourcen.
Kald show synkront under brugeraktivering. Afvent forudsætninger først.
load
Opret checkout-sessionen ud fra lineItems. Kalder du den igen, returneres den samme session. show() indlæser den først, hvis den ikke er indlæst. terms er det, køberen accepterer ved at betale: vis dens links (sælgerens offentliggjorte politikker og Whops købervilkår) ved siden af din knap, og når terms.required er true, skal køberen aktivt acceptere dem, for eksempel med et afkrydsningsfelt. requirements angiver, hvad sessionen skal bruge, før den kan betales: alt andet end email, terms og, med paypal.requestShipping, shipping_address kan ikke indsamles her, så show() afviser det.ReturnererPromise<CheckoutSessionLoaded>
string
påkrævet
string
påkrævet
string[]
påkrævet
CheckoutSessionTerms
påkrævet
Vis egenskaber
boolean
påkrævet
CheckoutSessionTermsLink[]
påkrævet
Vis egenskaber
string
påkrævet
En af "terms_of_service", "privacy_policy", "return_policy", "eula", "whop_buyer_terms" eller "whop_privacy_policy".
string
påkrævet
show
Kald den synkront i din PayPal-knaps klik-handler: på desktop åbner den pop op-vinduet der, og et pop op-vindue, der åbnes senere, bliver blokeret. Angiv kun termsAccepted: true, når load()’s terms.links blev vist ved siden af knappen for dette tryk, og, når terms.required er true, køberen aktivt har accepteret dem. Resolver med { payment }, når køberen godkender, og Whop opkræver. Afviser med en fejl, hvis code er attestation_required uden termsAccepted, requirements_unsupported, når sessionen kræver noget, PayPal ikke kan indsamle (se requirements fra load()), payment_request_cancelled, når køberen annullerer eller lukker PayPal, seller_pricing_unavailable, når kontoen ikke kan prissætte denne betaling via sit webhook (den håndterer ikke selv sin moms, eller kurven har en rabatkode, et køber-gebyr, en marketplace-deling eller en plan, der fornyes), eller ellers payment_failed. På telefoner går fanen til PayPal, og promiset bliver aldrig afgjort. Kald synkront under brugeraktivering. Afvent forudsætninger først, fordi browsere tilbagekalder aktiveringen på tværs af asynkrone trin.Parametre
"paypal"
påkrævet
CheckoutSessionShowOptions
Skjul egenskaber
boolean
ReturnererPromise<CheckoutSessionConfirmResult>
CheckoutSessionPayment
påkrævet
Vis egenskaber
string
påkrævet
string
påkrævet
Assistant
Responses are generated using AI and may contain mistakes.