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

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. Devuelve Promise<CheckoutSessionLoaded>
string
requerido
string
requerido
string[]
requerido
CheckoutSessionTerms
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
Devuelve Promise<CheckoutSessionConfirmResult>
CheckoutSessionPayment
requerido