Sesión de checkout headless de bajo nivel para una página que dibuja su propio botón de PayPal. load() crea la sesión de checkout a partir de lineItems; show("paypal", { termsAccepted: true }) envía al comprador a PayPal (una ventana emergente en escritorio, la pestaña completa en teléfonos) y se resuelve con el pago una vez que el comprador lo aprueba. Con paymentMethodOptions.paypal.requestShipping, PayPal le pide al comprador una dirección de envío y el webhook de la cuenta suscrito a shipping_address.changed calcula el precio de cada una en tu servidor mientras el comprador está en PayPal; el pago se crea solo después de que el comprador lo aprueba, a ese precio. Tras una redirección de página completa, la promesa nunca se resuelve; en su lugar, lee el resultado de los parámetros de consulta payment y status de redirectUrl.
Esta página documenta @whop/elements@1.10.0 y @whop/elements-react@1.10.0.
Desde v1.10.0.Crea este recurso de Checkout sin montar un elemento: whop.checkout.checkoutSession.create({ … }) en vanilla o useWhop().checkout.checkoutSession.create({ … }) en React.
Opciones
Pásalas a whop.checkout.checkoutSession.create({ … }).
string
requerido
ID de la cuenta, con prefijo biz_, que vende los artículos.
CheckoutSessionLineItem[]
requerido
Lo que compra el comprador: cada entrada nombra una variante (plan_…) y una quantity opcional (por defecto 1). Varias entradas forman un carrito.
Mostrar propiedades
string
requerido
number
string
requerido
Adónde llega el comprador después de PayPal cuando la pestaña fue redirigida, con payment y status añadidos: succeeded, canceled, failed o processing mientras Whop todavía está terminando el cobro (consulta el pago desde tu servidor para ver cuándo se completa). En escritorio, en cambio, la ventana emergente se cierra y show() se resuelve.
Record<string, string>
Tus propias claves y valores de tipo string, hasta 40, que se guardan en la sesión de checkout y se copian en el pago que crea, de modo que vuelven en el pago y en sus webhooks, por ejemplo para la atribución de anuncios y afiliados. Se establecen desde el navegador del comprador, así que nunca dependas de ellos para precios ni para el cumplimiento de pedidos.
"off_session"
Establécelo en off_session para guardar la cuenta de PayPal del comprador, de modo que tu servidor pueda cobrarle más tarde sin el comprador, por ejemplo para una venta adicional con un clic. PayPal le pide al comprador que acepte pagos futuros mientras aprueba. Establécelo solo después de informar al comprador de que se guardará su cuenta de PayPal.
string
El correo electrónico del comprador, al que pertenecen el pago y la membresía. Omítelo para usar el correo electrónico de la cuenta de PayPal que aprueba.
CheckoutSessionPaymentMethodOptions
Opciones para un método de pago. paypal.requestShipping hace que PayPal le pida al comprador una dirección de envío. Cuando la cuenta tiene un webhook https habilitado suscrito a shipping_address.changed, Whop lo llama para cada dirección y cobra los totales con los que responde. Por defecto es false.
Mostrar propiedades
CheckoutSessionPayPalOptions
Mostrar propiedades
boolean
Métodos
Llámalos en el recurso.
Llama a show de forma síncrona durante la activación del usuario. Espera primero los requisitos previos.
load
Crea la sesión de checkout a partir de lineItems. Llamarlo de nuevo devuelve la misma sesión. show() la carga primero si no se ha cargado. terms es lo que el comprador acepta al pagar: muestra sus links (las políticas publicadas del vendedor y los términos para compradores de Whop) junto a tu botón y, cuando terms.required es true, haz que el comprador los acepte de forma activa, por ejemplo con una casilla de verificación. requirements enumera lo que la sesión necesita antes de poder pagarse: cualquier cosa que no sea email, terms y, con paypal.requestShipping, shipping_address no puede recopilarse aquí, por lo que show() la rechaza.DevuelvePromise<CheckoutSessionLoaded>
string
requerido
string
requerido
string[]
requerido
CheckoutSessionTerms
requerido
Mostrar propiedades
boolean
requerido
CheckoutSessionTermsLink[]
requerido
Mostrar propiedades
string
requerido
Uno de "terms_of_service", "privacy_policy", "return_policy", "eula", "whop_buyer_terms" o "whop_privacy_policy".
string
requerido
show
Llámalo de forma síncrona en el controlador de clic de tu botón de PayPal: en escritorio abre ahí la ventana emergente, y una ventana emergente abierta más tarde se bloquea. Pasa termsAccepted: true solo cuando los terms.links de load() se mostraron junto al botón para esta pulsación y, cuando terms.required es true, el comprador los aceptó de forma activa. Se resuelve con { payment } una vez que el comprador aprueba y Whop cobra. Se rechaza con un error cuyo code es attestation_required sin termsAccepted, requirements_unsupported cuando la sesión necesita algo que PayPal no puede recopilar (consulta los requirements de load()), payment_request_cancelled cuando el comprador cancela o cierra PayPal, seller_pricing_unavailable cuando la cuenta no puede calcular el precio de este pago a través de su webhook (no gestiona sus propios impuestos, o el carrito tiene un código promocional, una comisión para el comprador, un reparto de marketplace o un plan que se renueva), o payment_failed en los demás casos. En teléfonos, la pestaña va a PayPal y la promesa nunca se resuelve. Llámalo de forma síncrona durante la activación del usuario. Espera primero los requisitos previos, porque los navegadores revocan la activación entre pasos asíncronos.Parámetros
"paypal"
requerido
CheckoutSessionShowOptions
Ocultar propiedades
boolean
DevuelvePromise<CheckoutSessionConfirmResult>
CheckoutSessionPayment
requerido
Mostrar propiedades
string
requerido
string
requerido
Assistant
Responses are generated using AI and may contain mistakes.