OAuth-endpoints staan op
https://api.whop.com/oauth/.Stap 1: Maak je OAuth-app aan
- API
- Dashboard
Gebruik het endpoint Create App om programmatisch een OAuth-app aan te maken:Werk redirect-URI’s later bij met het endpoint Update App.
Stap 2: Stuur gebruikers door om te autoriseren
Gebruik in je web- of mobiele client PKCE om gebruikers veilig door te sturen naar de OAuth-flow van Whop.startWhopOAuth aan om de gebruiker door te sturen:
Als je een account-ID meegeeft als
company_id, worden tokens voor de gebruiker
beperkt tot dat account. Je hebt dan alleen toegang tot de resources die de gebruiker
op dat Whop-account kan beheren.Stap 3: Verwerk de callback en wissel de code in
Whop stuurt terug naar jeredirect_uri met code en state. Gebruik deze functie om de state te verifiëren, de code in te wisselen voor tokens en credentials op te halen:
Stap 4: Gebruik de tokens
Initialiseer de Whop SDK met het access token van de gebruiker:Stap 5: Tokens vernieuwen
Access tokens verlopen na 1 uur. Gebruik het refresh token om nieuwe credentials te krijgen:Refresh tokens roteren bij elk gebruik. Sla altijd de nieuwe tokens op die het
refresh-endpoint teruggeeft. Als je tijdens de autorisatie
company_id hebt meegegeven,
moet je bij het vernieuwen dezelfde company_id meegeven.Stap 6: Userinfo en intrekken
Gebruikersinformatie ophalen
Haal het profiel van de geauthenticeerde gebruiker op via het userinfo-endpoint:Welke velden worden teruggegeven, hangt af van de verleende scopes.
openid is vereist,
profile voegt naam/gebruikersnaam/afbeelding toe, email voegt e-mailvelden toe.Tokens intrekken bij uitloggen
Trek het refresh token van een gebruiker in wanneer die uitlogt. Access tokens verlopen na 1 uur en kunnen niet server-side worden ingetrokken.Foutafhandeling
OAuth-fouten volgen het standaardformaat:invalid_request: ontbrekende of ongeldige parameter.invalid_grant: code of token verlopen of ingetrokken.invalid_client: onbekendeclient_id.insufficient_scope: token heeft niet de vereiste scope.rate_limit_exceeded: te veel requests (controleer deRetry-After-header).
Volgende stappen
API-referentie
Elk endpoint dat een verleend access token kan aanroepen.
Betalingen accepteren
Combineer inloggen met checkout voor complete aankoopflows.
Luisteren naar webhooks
Reageer server-side op betalings-, lidmaatschaps- en entry-events.
Machtigingen aanvragen
Configureer de OAuth-scopes die je app daadwerkelijk nodig heeft.

