Skip to main content
Gebruik OAuth 2.1 + PKCE met OpenID Connect (OIDC) om gebruikers met Whop te laten inloggen op je website of in je app. Met de teruggegeven access tokens kun je gegevens benaderen en namens die gebruikers handelen.
OAuth-endpoints staan op https://api.whop.com/oauth/.

Stap 1: Maak je OAuth-app aan

Het App-object dat apps.create in de huidige @whop/sdk teruggeeft, bevat geen client_secret-veld. Kopieer de client secret in plaats daarvan via het tabblad 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.
Roep startWhopOAuth aan om de gebruiker door te sturen:
Als de gebruiker niet is ingelogd, vraagt Whop eerst om in te loggen en toont daarna het toestemmingsscherm. Als de gebruiker je applicatie al heeft goedgekeurd voor de gevraagde scopes, wordt hij automatisch teruggestuurd zonder twee keer te hoeven bevestigen.
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 je redirect_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:
Op je callbackpagina:

Stap 4: Gebruik de tokens

Initialiseer de Whop SDK met het access token van de gebruiker:
Bekijk de API-referentie voor alle beschikbare endpoints.

Stap 5: Tokens vernieuwen

Access tokens verlopen na 1 uur. Gebruik het refresh token om nieuwe credentials te krijgen:
Gebruik:
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.
Trek tokens altijd in wanneer gebruikers uitloggen. Dit maakt het refresh token direct ongeldig en voorkomt ongeautoriseerde toegang, zelfs als het token is gecompromitteerd.

Foutafhandeling

OAuth-fouten volgen het standaardformaat:
Veelvoorkomende foutcodes:
  • invalid_request: ontbrekende of ongeldige parameter.
  • invalid_grant: code of token verlopen of ingetrokken.
  • invalid_client: onbekende client_id.
  • insufficient_scope: token heeft niet de vereiste scope.
  • rate_limit_exceeded: te veel requests (controleer de Retry-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.