Skip to main content
Las apps de Whop se muestran dentro de un iframe en whop.com. Para saber quién hace una solicitud a tu app, Whop pasa un JSON Web Token (JWT) de corta duración en la cabecera x-whop-user-token en cada solicitud del mismo origen. Verificas este token con el SDK para obtener un ID de usuario y luego compruebas qué puede ver ese usuario.

Verificar el token de usuario del iframe

verifyUserToken no está disponible en el @whop/sdk actual, así que los fragmentos de TypeScript de esta página se mantienen como referencia y no funcionarán tal como están escritos. Python es distinto: whop-sdk incluye la función auxiliar como whop_sdk.lib.verify_user_token, que necesita PyJWT instalado junto a ella (pip install "pyjwt[crypto]"). La gema whop_sdk también la incluye, pero como función de módulo en un espacio de nombres raíz distinto al del cliente: WhopSDK::Helpers::VerifyUserToken.verify_user_token!, mientras que el cliente es Whop_sdk::Client. No es un método del cliente, y la gema ya depende de jwt.
Llama a verifyUserToken en cada solicitud. Lee la cabecera x-whop-user-token, valida la firma y la caducidad del JWT y devuelve el ID de usuario. Los tokens no válidos lanzan una excepción de forma predeterminada. TypeScript y Python también ofrecen una variante que no lanza excepciones:
El token solo se adjunta a las solicitudes dirigidas al window.location.origin de tu iframe. Ejemplos:
  • Navegación relativa entre páginas: <a href="/sub_page">...</a>
  • Fetch sin dominio: await fetch("/api/quizzes")
Estas se resuelven a tu dominio App.base_url.
Si tu frontend se ejecuta en example.com pero tu API se ejecuta en api.example.com, redirige las solicitudes a la API mediante un proxy inverso a través de example.com/api para que lleven la cabecera x-whop-user-token.
  • Cloudflare: crea una “origin rule” desde /api en example.com que reescriba a api.example.com/api.
  • Next.js: añade un rewrite en next.config.mjs.
  • nginx / Caddy: usa la primitiva de reescritura en la configuración de tu servidor.
Esta configuración es necesaria por las estrictas políticas de cookies entre orígenes de los navegadores.

Configuración local

Whop ofrece un proxy inverso local que reproduce el comportamiento del iframe y de las cookies de producción, para que el código que escribas funcione igual en localhost y en producción. Consulta la guía del proxy de desarrollo para configurarlo.

Comprobar el acceso

Ahora que sabes quién hace la solicitud, comprueba qué puede ver. Usa el método checkAccess para verificar el acceso a una experiencia, una cuenta o un producto.

IDs de recurso y niveles de acceso

El access_level de la respuesta es uno de los siguientes:

App para clientes (vista de experiencia)

Las apps para clientes deben restringir el acceso según el experienceId que se pasa en los parámetros de ruta. Devuelve no_access o redirige si el usuario no tiene una membresía válida.
El mismo patrón funciona en una ruta de API. Cambia headers() por request.headers y devuelve una 403 Response en lugar de JSX.

App de panel (vista de panel)

Las apps de panel deben restringir el acceso con access_level === "admin" para que solo los miembros del equipo de la cuenta puedan cargar la vista.
El mismo patrón en una ruta de API. Cambia headers() por request.headers y devuelve una 403 Response en lugar de JSX.

Próximos pasos

Ejecutar un proxy de desarrollo local

Reproduce en localhost la configuración del iframe y las cookies de producción.

Solicitar permisos

Añade los alcances que necesita tu app antes de publicarla.

Escuchar webhooks

Recibe eventos de pagos, membresías y entradas en tu servidor.

Crear una vista de app

Configura vistas de panel, experiencias y fichas de Discover.