Skip to main content
Deze pagina documenteert @whop/elements@1.10.0 en @whop/elements-react@1.10.0.
Sinds v1.10.0. Maak deze Checkout-resource aan zonder een element te mounten: whop.checkout.checkoutSession.create({ … }) in vanilla of useWhop().checkout.checkoutSession.create({ … }) in React.

Opties

Geef deze mee aan whop.checkout.checkoutSession.create({ … }).
string
vereist
Account-ID, met prefix biz_, dat de regelitems verkoopt.
CheckoutSessionLineItem[]
vereist
Wat de koper koopt: elke vermelding noemt een variant (plan_…) en een optionele quantity (standaard 1). Meerdere vermeldingen vormen een winkelwagen.
string
vereist
Waar de koper na PayPal terechtkomt wanneer het tabblad werd doorgestuurd, met payment en status toegevoegd: succeeded, canceled, failed of processing zolang Whop de afschrijving nog afrondt (lees de betaling vanaf je server om te zien wanneer die is verwerkt). Op desktop sluit in plaats daarvan de pop-up en wordt show() afgehandeld.
Record<string, string>
Je eigen stringsleutels en -waarden, maximaal 40, bewaard op de checkoutsessie en gekopieerd naar de betaling die deze aanmaakt, zodat ze terugkomen op de betaling en de bijbehorende webhooks, bijvoorbeeld voor advertentie- en affiliate-attributie. Ze worden ingesteld vanuit de browser van de koper, dus vertrouw er nooit op voor prijzen of levering.
"off_session"
Stel in op off_session om het PayPal-account van de koper op te slaan, zodat je server het later zonder de koper kan belasten, bijvoorbeeld voor een upsell met één klik. PayPal vraagt de koper tijdens het akkoord om in te stemmen met toekomstige betalingen. Stel dit pas in nadat je de koper hebt verteld dat het PayPal-account wordt opgeslagen.
string
Het e-mailadres van de koper, waartoe de betaling en het lidmaatschap behoren. Laat het weg om het e-mailadres te gebruiken van het PayPal-account dat akkoord geeft.
CheckoutSessionPaymentMethodOptions
Opties voor één betaalmethode. Met paypal.requestShipping vraagt PayPal de koper om een verzendadres. Wanneer het account een ingeschakelde https-webhook heeft die is geabonneerd op shipping_address.changed, roept Whop die aan voor elk adres en rekent de totalen af waarmee die antwoordt. Standaard false.

Methoden

Roep deze aan op de resource.
Roep show synchroon aan tijdens gebruikersactivatie. Wacht eerst op vereisten.

load

Maak de checkoutsessie aan op basis van lineItems. Opnieuw aanroepen geeft dezelfde sessie terug. show() laadt deze eerst wanneer die nog niet is geladen. terms is wat de koper accepteert door te betalen: toon de links ervan (het gepubliceerde beleid van de verkoper en de kopersvoorwaarden van Whop) naast je knop, en laat de koper ze actief accepteren wanneer terms.required true is, bijvoorbeeld met een selectievakje. requirements geeft aan wat de sessie nodig heeft voordat die kan worden betaald: alles behalve email, terms en, met paypal.requestShipping, shipping_address kan hier niet worden verzameld, dus show() weigert het. Retourneert Promise<CheckoutSessionLoaded>
string
vereist
string
vereist
string[]
vereist
CheckoutSessionTerms
vereist

show

Roep het synchroon aan in de klikhandler van je PayPal-knop: op desktop opent het daar de pop-up, en een later geopende pop-up wordt geblokkeerd. Geef termsAccepted: true alleen mee wanneer de terms.links van load() voor deze klik naast de knop werden getoond en, wanneer terms.required true is, de koper ze actief heeft geaccepteerd. Wordt opgelost met { payment } zodra de koper akkoord geeft en Whop afschrijft. Wordt afgewezen met een fout waarvan de code attestation_required is zonder termsAccepted, requirements_unsupported wanneer de sessie iets nodig heeft dat PayPal niet kan verzamelen (zie requirements van load()), payment_request_cancelled wanneer de koper PayPal annuleert of sluit, seller_pricing_unavailable wanneer het account deze betaling niet via zijn webhook kan prijzen (het verwerkt zijn eigen belasting niet, of de winkelwagen bevat een promotiecode, kopersvergoeding, marketplace-verdeling of een abonnement dat wordt verlengd), of anders payment_failed. Op telefoons gaat het tabblad naar PayPal en wordt de promise nooit afgehandeld. Roep het synchroon aan tijdens gebruikersactivatie. Wacht eerst op vereisten, omdat browsers de activatie intrekken over asynchrone stappen heen. Parameters
"paypal"
vereist
CheckoutSessionShowOptions
Retourneert Promise<CheckoutSessionConfirmResult>
CheckoutSessionPayment
vereist