Skip to main content
Cette page documente @whop/elements@1.10.0 et @whop/elements-react@1.10.0.
Depuis v1.10.0. Créez cette ressource Checkout sans monter d’élément : whop.checkout.checkoutSession.create({ … }) en vanilla ou useWhop().checkout.checkoutSession.create({ … }) avec React.

Options

Transmettez-les à whop.checkout.checkoutSession.create({ … }).
string
requis
ID du compte, préfixé par biz_, qui vend les articles.
CheckoutSessionLineItem[]
requis
Ce que l’acheteur achète : chaque entrée désigne une variante (plan_…) et une quantity facultative (1 par défaut). Plusieurs entrées forment un panier.
string
requis
L’endroit où l’acheteur arrive après PayPal lorsque l’onglet a été redirigé, avec payment et status ajoutés : succeeded, canceled, failed, ou processing tant que Whop finalise encore le débit (lisez le paiement depuis votre serveur pour voir son règlement). Sur ordinateur, la pop-up se ferme à la place et show() se résout.
Record<string, string>
Vos propres clés et valeurs de type chaîne, jusqu’à 40, conservées sur la session de checkout et copiées sur le paiement qu’elle crée, de sorte qu’elles reviennent sur le paiement et ses webhooks, par exemple pour l’attribution publicitaire et d’affiliation. Elles sont définies depuis le navigateur de l’acheteur, donc ne vous y fiez jamais pour les prix ou l’exécution des commandes.
"off_session"
Définissez sur off_session pour enregistrer le compte PayPal de l’acheteur afin que votre serveur puisse le débiter plus tard sans l’acheteur, par exemple pour un upsell en un clic. PayPal demande à l’acheteur d’accepter les paiements futurs au moment de l’approbation. Ne le définissez qu’après avoir informé l’acheteur que son compte PayPal sera enregistré.
string
L’e-mail de l’acheteur, auquel appartiennent le paiement et l’adhésion. Omettez-le pour utiliser l’e-mail du compte PayPal qui approuve.
CheckoutSessionPaymentMethodOptions
Options pour un moyen de paiement. paypal.requestShipping fait demander une adresse de livraison à l’acheteur par PayPal. Lorsque le compte dispose d’un webhook https activé abonné à shipping_address.changed, Whop l’appelle pour chaque adresse et débite les totaux qu’il renvoie. Par défaut : false.

Méthodes

Appelez-les sur la ressource.
Appelez show de manière synchrone pendant l’activation utilisateur. Attendez d’abord les prérequis.

load

Crée la session de checkout à partir de lineItems. Un nouvel appel renvoie la même session. show() la charge d’abord si elle n’a pas été chargée. terms correspond à ce que l’acheteur accepte en payant : affichez ses links (les politiques publiées du vendeur et les conditions acheteur de Whop) à côté de votre bouton, et lorsque terms.required vaut true, faites-les accepter activement par l’acheteur, par exemple avec une case à cocher. requirements liste ce dont la session a besoin avant de pouvoir être payée : tout ce qui n’est pas email, terms et, avec paypal.requestShipping, shipping_address ne peut pas être collecté ici, donc show() le refuse. Renvoie Promise<CheckoutSessionLoaded>
string
requis
string
requis
string[]
requis
CheckoutSessionTerms
requis

show

Appelez-la de manière synchrone dans le gestionnaire de clic de votre bouton PayPal : sur ordinateur, elle ouvre la pop-up à ce moment-là, et une pop-up ouverte plus tard est bloquée. Transmettez termsAccepted: true uniquement lorsque les terms.links de load() ont été affichés à côté du bouton pour ce clic et, lorsque terms.required vaut true, que l’acheteur les a activement acceptés. Se résout avec { payment } une fois que l’acheteur a approuvé et que Whop a débité. Rejette avec une erreur dont le code est attestation_required sans termsAccepted, requirements_unsupported lorsque la session a besoin de quelque chose que PayPal ne peut pas collecter (voir les requirements de load()), payment_request_cancelled lorsque l’acheteur annule ou ferme PayPal, seller_pricing_unavailable lorsque le compte ne peut pas calculer le prix de ce paiement via son webhook (il ne gère pas ses propres taxes, ou le panier contient un code promo, des frais acheteur, une répartition marketplace ou un plan qui se renouvelle), ou payment_failed dans les autres cas. Sur téléphone, l’onglet part vers PayPal et la promesse ne se résout jamais. Appelez-la de manière synchrone pendant l’activation utilisateur. Attendez d’abord les prérequis, car les navigateurs révoquent l’activation au fil des étapes asynchrones. Paramètres
"paypal"
requis
CheckoutSessionShowOptions
Renvoie Promise<CheckoutSessionConfirmResult>
CheckoutSessionPayment
requis