whop.com. Om te bepalen wie een request naar je app doet, geeft Whop bij elk same-origin-request een kortlevende JSON Web Token (JWT) mee in de header x-whop-user-token. Je verifieert dit token met de SDK om een gebruikers-ID te krijgen en controleert daarna wat die gebruiker mag zien.
Het iframe-gebruikerstoken verifiëren
RoepverifyUserToken bij elk request aan. De functie leest de header x-whop-user-token, valideert de handtekening en vervaldatum van de JWT en retourneert de gebruikers-ID. Ongeldige tokens geven standaard een fout. TypeScript en Python bieden ook een variant die geen fout gooit:
window.location.origin van je iframe. Voorbeelden:
- Relatieve paginanavigatie:
<a href="/nl/sub_page">...</a> - Fetches zonder domein:
await fetch("/api/quizzes")
App.base_url-domein.
De API staat op een ander domein
De API staat op een ander domein
Als je frontend op
example.com draait maar je API op api.example.com, stuur API-requests dan via een reverse proxy door example.com/api, zodat ze de header x-whop-user-token bevatten.- Cloudflare: maak een “origin rule” die
/apiopexample.comherschrijft naarapi.example.com/api. - Next.js: voeg een rewrite toe in
next.config.mjs. - nginx / Caddy: gebruik de rewrite-functie in je serverconfiguratie.
Deze setup is nodig vanwege het strikte cross-origin-cookiebeleid van browsers.
Lokale setup
Whop levert een lokale reverse proxy die het iframe- en cookiegedrag van productie nabootst, zodat de code die je schrijft precies hetzelfde werkt oplocalhost als in productie. Zie de gids voor de development proxy voor de setup.
Toegang controleren
Nu je weet wie het request doet, controleer je wat die persoon mag zien. Gebruik de methodecheckAccess om de toegang tot een Experience, Account of Product te verifiëren.
Resource-ID’s en toegangsniveaus
De
access_level in de response is een van de volgende:
Klantapp (experience-weergave)
Klantapps moeten de toegang afschermen op basis van deexperienceId die in de padparameters wordt meegegeven. Retourneer no_access of stuur door als de bezoeker geen geldig lidmaatschap heeft.
headers() door request.headers en retourneer een 403 Response in plaats van JSX.
Dashboardapp (dashboardweergave)
Dashboardapps moeten de toegang afschermen opaccess_level === "admin", zodat alleen teamleden van het account de weergave kunnen laden.
headers() door request.headers en retourneer een 403 Response in plaats van JSX.
Volgende stappen
Een lokale development proxy draaien
Boots de iframe- en cookiesetup van productie na op localhost.
Permissies aanvragen
Voeg de scopes toe die je app nodig heeft voordat je publiceert.
Naar webhooks luisteren
Ontvang events voor betalingen, lidmaatschappen en entries op je server.
Een app-weergave bouwen
Stel dashboardweergaven, experiences en Discover-vermeldingen in.

