Skip to main content
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.
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.

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. Returnerer Promise<CheckoutSessionLoaded>
string
påkrævet
string
påkrævet
string[]
påkrævet
CheckoutSessionTerms
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
Returnerer Promise<CheckoutSessionConfirmResult>
CheckoutSessionPayment
påkrævet