whop.com. Pour savoir qui envoie une requête à votre application, Whop transmet un JSON Web Token (JWT) de courte durée dans l’en-tête x-whop-user-token de chaque requête de même origine. Vous vérifiez ce jeton avec le SDK pour obtenir un ID utilisateur, puis vous contrôlez ce que cet utilisateur peut voir.
Vérifier le jeton utilisateur de l’iframe
AppelezverifyUserToken à chaque requête. Cette fonction lit l’en-tête x-whop-user-token, valide la signature et l’expiration du JWT, puis renvoie l’ID utilisateur. Par défaut, les jetons invalides lèvent une exception. TypeScript et Python proposent aussi une variante qui ne lève pas d’exception :
window.location.origin de votre iframe. Exemples :
- Navigation relative entre pages :
<a href="/sub_page">...</a> - Requêtes fetch sans domaine :
await fetch("/api/quizzes")
App.base_url.
L'API se trouve sur un autre domaine
L'API se trouve sur un autre domaine
Si votre frontend s’exécute sur
example.com mais votre API sur api.example.com, faites passer les requêtes API par un reverse proxy via example.com/api afin qu’elles portent l’en-tête x-whop-user-token.- Cloudflare : créez une « origin rule » de
/apisurexample.compour réécrire versapi.example.com/api. - Next.js : ajoutez un rewrite dans
next.config.mjs. - nginx / Caddy : utilisez la primitive de réécriture dans la configuration de votre serveur.
Cette configuration est nécessaire en raison des politiques strictes des navigateurs en matière de cookies cross-origin.
Configuration locale
Whop fournit un reverse proxy local qui reproduit le comportement de l’iframe et des cookies en production, afin que le code que vous écrivez fonctionne de la même manière surlocalhost et en production. Consultez le guide du proxy de développement pour la configuration.
Vérifier l’accès
Maintenant que vous savez qui envoie la requête, vérifiez ce que cette personne est autorisée à voir. Utilisez la méthodecheckAccess pour vérifier l’accès à une Experience, un Account ou un Product.
ID de ressource et niveaux d’accès
Le champ
access_level de la réponse prend l’une des valeurs suivantes :
Application client (vue Experience)
Les applications client doivent contrôler l’accès à partir de l’experienceId transmis dans les paramètres de chemin. Renvoyez no_access ou effectuez une redirection si l’utilisateur ne dispose pas d’une adhésion valide.
headers() par request.headers et renvoyez une 403 Response au lieu du JSX.
Application Dashboard (vue Dashboard)
Les applications Dashboard doivent contrôler l’accès avecaccess_level === "admin" afin que seuls les membres de l’équipe du compte puissent charger la vue.
headers() par request.headers et renvoyez une 403 Response au lieu du JSX.
Étapes suivantes
Exécuter un proxy de développement local
Reproduisez la configuration iframe et cookies de production sur localhost.
Demander des permissions
Ajoutez les scopes dont votre application a besoin avant de la publier.
Écouter les webhooks
Recevez sur votre serveur les événements de paiement, d’adhésion et d’inscription.
Créer une vue d'application
Configurez les vues Dashboard, les expériences et les fiches de découverte.

