Esta página documenta
@whop/elements@1.10.0 y @whop/elements-react@1.10.0.Whop Elements son componentes de interfaz alojados y personalizables que incrustas en tu propio sitio. Cada elemento se renderiza en un frame aislado servido desde la CDN de Whop. Instalas un paquete ligero y completamente tipado, y el código de los elementos se mantiene actualizado por sí solo.
Instalación
Requisitos
Política de seguridad de contenido
contentSecurityPolicy() de @whop/elements devuelve todas las fuentes de esta tabla para el entorno que le pases. Las filas del trabajo del lado de la página se ejecutan en tu página, no en un frame. Los scripts que cargan los elementos para Apple Pay, Google Pay y PayPal y para la vinculación de cuentas bancarias con Plaid provienen de otras empresas y pueden cargar recursos más allá de estas filas. Consulta también las indicaciones sobre Content Security Policy de cada proveedor.Un elemento modal oscurece tu página detrás de él con un estilo en línea. Un
style-src que no permite estilos en línea deja la página sin oscurecer, pero el modal sigue funcionando.Antes de empezar
Necesitas dos cosas:- Un
accountId. Un ID de cuenta, con prefijobiz_, o un ID de usuario, con prefijouser_, para los datos propios del usuario. Las superficies de pago aceptan en su lugar un plan o un importe, y cada página de elemento indica cuál necesita. - Un endpoint de servidor que cree un token de acceso, con el alcance de los elementos que montes.
Monta tu primer elemento
¿Prefieres npm en lugar de la etiqueta script? El token es un valor que estableces tú, no un callback al que llama el SDK. Establece uno nuevo antes de que caduque:En React, el mismo objeto se pasa en
loadWhop() inyecta el mismo script alojado y resuelve el constructor global:Autenticación
Pasa unaccessToken al crear el handle. Usa un token para todo el handle, no uno por elemento. El handle envía ese token a todos los elementos que contiene, así que solicita en ese único token todos los alcances que necesites. Cada página de elemento enumera los alcances que lee.Si omites
accessToken, las solicitudes usan en su lugar la cookie de sesión del visitante. Esto funciona solo en whop.com. La API no envía Access-Control-Allow-Credentials en las solicitudes preflight de origen cruzado, así que una página en tu propio dominio no tiene ninguna sesión a la que recurrir y debe pasar un token.Configuración global
Todo lo que pasas en la construcción se aplica a todos los grupos de elementos creados a partir de esa instancia (las opciones propias de un handle pueden anularlo por grupo):Personalización visual para todos los elementos:
theme (claro/oscuro + paletas), variables (propiedades personalizadas de CSS) y classes (declaraciones de estilo por parte). El esquema de color se aplica antes del primer pintado de un elemento, así que las páginas oscuras nunca muestran un destello claro. Consulta Appearance.Configuración regional para el texto de la interfaz de los elementos: una de las configuraciones regionales incluidas en la app; cualquier otro valor recurre a la configuración regional predeterminada. Por defecto es
"en".Uno de "en", "es", "zh", "nl", "pt", "de", "hu", "it", "fr", "ja", "pl" o "tr".Con qué entorno de la API de Whop se comunican los elementos:
"sandbox" apunta a la API de sandbox (datos de prueba; no se mueve dinero real). Elegir un entorno es la única forma de cambiar adónde envían los elementos lo que escribe un comprador, y ambos entornos son de Whop. El entorno sandbox todavía no está disponible de forma general. Por defecto es "production".Si los elementos pueden mostrar notificaciones toast en tu página: mensajes de estado breves (“Payment method added”, “Payment failed”) que se muestran en la esquina inferior derecha. Establécelo en
false para desactivarlas por completo. Por defecto es true.Omite el píxel de Whop. Por defecto, los elementos cargan el píxel de anuncios de Whop en una página que todavía no lo ejecuta, limitado a la cuenta para la que trabajan (el
accountId de un grupo de elementos, o el vendedor del plan de un checkout), y vinculan las analíticas de los elementos al ID de visitante del píxel, un vínculo de identidad único que permite unir la actividad de los elementos con tus datos de atribución de anuncios en el grafo de identidad de Whop. Establécelo en true para no hacer ninguna de las dos cosas. Las analíticas de uso en sí no se ven afectadas (desactívalas por handle con analytics: false). Por defecto es false.<WhopElements appearance={…} locale={…}>.La opción global toasts está activa en esta página: el botón de abajo envía una a través del mismo canal que usan los elementos, con el tema del appearance de esta página:De qué se encargan los elementos y de qué te encargas tú
Cada elemento obtiene sus propios datos y renderiza sus propios estados de carga, vacío y error.Tú te encargas de la navegación y el almacenamiento. Los elementos informan de las selecciones y los resultados como eventos, y nunca escriben en tu base de datos.La excepción es un flujo que sale de la página. Cuando un elemento acepta unareturnUrl, navega la pestaña hasta ella, por lo que el comprador puede acabar fuera de tu página. El comprador llega ahí tanto después de un paso externo fallido o abandonado como después de uno exitoso, con status (succeeded, failed o canceled) y el ID del intento añadidos a la URL, así que la página en returnUrl tiene que leer status antes de mostrar un mensaje de éxito. Realiza el cumplimiento a partir de webhooks en lugar de un callback del navegador.Los elementos se ejecutan en frames, así que solo los valores serializables cruzan el límite. No hay DOM compartido y la identidad de los objetos no se conserva.Solución de problemas
Elementos disponibles
Payments
Cobra un pago a partir de un ID
plan_ o de una moneda e importe en línea, o guarda un método de pago sin cobrar con mode: "setup".Verifications
Recopila y verifica la información de identidad de una cuenta.
Checkout
Gestiona un checkout alojado completo para uno o más planes (resumen de precios detallado, códigos promocionales, la moneda en la que paga el comprador y toda la superficie de cobro, con los elementos de pagos compuestos dentro) contra la API de sesiones de checkout de Whop.
Ads
Una cuenta publicitaria.
Tracking
La audiencia rastreada de una cuenta: todas las personas que ha visto su píxel y todos los eventos que realizaron.
Wallet
Gestiona las superficies de dinero de una cuenta.
Websites
Los sitios web de una cuenta: todos los sitios creados en whop.site más todos los dominios de los que informa el Whop Pixel, con el tráfico y los ingresos atribuidos por dominio.
Dashboard
Las superficies del propio panel de una cuenta, incrustadas en tu sitio.
Delivery
Seguimiento de entregas para los clientes de una empresa.
Chat
Chat en tiempo real con una lista de canales y búsqueda de mensajes.
Siguientes pasos
- Appearance: temas, variables CSS y cambio de estilo por parte
- Create Access Token: el endpoint con el que tu servidor genera tokens

