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
Llama averifyUserToken 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:
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")
App.base_url.
La API está en otro dominio
La API está en otro dominio
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
/apienexample.comque reescriba aapi.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 enlocalhost 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étodocheckAccess 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 elexperienceId que se pasa en los parámetros de ruta. Devuelve no_access o redirige si el usuario no tiene una membresía válida.
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 conaccess_level === "admin" para que solo los miembros del equipo de la cuenta puedan cargar la vista.
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.

