Les endpoints OAuth se trouvent à l’adresse
https://api.whop.com/oauth/.Étape 1 : Créer votre app OAuth
- API
- Dashboard
Utilisez l’endpoint Create App pour créer une app OAuth par programmation :Mettez à jour les URI de redirection plus tard avec l’endpoint Update App.
Étape 2 : Rediriger les utilisateurs vers l’autorisation
Dans votre client web ou mobile, utilisez PKCE pour rediriger de manière sécurisée les utilisateurs vers le flux OAuth de Whop.startWhopOAuth pour rediriger l’utilisateur :
Si vous passez un ID de compte en tant que
company_id, les jetons sont limités à ce compte
pour l’utilisateur. Vous ne pouvez accéder qu’aux ressources que l’utilisateur peut contrôler sur
ce compte Whop.Étape 3 : Gérer le callback et échanger le code
Whop redirige vers votreredirect_uri avec code et state. Utilisez cette fonction pour vérifier le state, échanger le code contre des jetons et récupérer les identifiants :
Étape 4 : Utiliser les jetons
Initialisez le SDK Whop avec le jeton d’accès de l’utilisateur :Étape 5 : Rafraîchir les jetons
Les jetons d’accès expirent au bout d’une heure. Utilisez le jeton de rafraîchissement pour obtenir de nouveaux identifiants :Les jetons de rafraîchissement changent à chaque utilisation. Stockez toujours les nouveaux jetons renvoyés par
l’endpoint de rafraîchissement. Si vous avez fourni
company_id lors de l’autorisation, vous
devez fournir le même company_id lors du rafraîchissement.Étape 6 : Userinfo et révocation
Obtenir les informations de l’utilisateur
Récupérez le profil de l’utilisateur authentifié avec l’endpoint userinfo :Les champs renvoyés dépendent des scopes accordés.
openid est requis,
profile ajoute le nom, le nom d’utilisateur et la photo, email ajoute les champs d’e-mail.Révoquer les jetons à la déconnexion
Lorsqu’un utilisateur se déconnecte, révoquez son jeton de rafraîchissement. Les jetons d’accès expirent au bout d’une heure et ne peuvent pas être révoqués côté serveur.Gestion des erreurs
Les erreurs OAuth suivent le format standard :invalid_request: paramètre manquant ou invalide.invalid_grant: code ou jeton expiré ou révoqué.invalid_client:client_idinconnu.insufficient_scope: le jeton ne dispose pas du scope requis.rate_limit_exceeded: trop de requêtes (vérifiez l’en-têteRetry-After).
Étapes suivantes
Référence API
Tous les endpoints qu’un jeton d’accès accordé peut appeler.
Accepter des paiements
Associez la connexion au checkout pour des parcours d’achat de bout en bout.
Écouter les webhooks
Réagissez côté serveur aux événements de paiement, d’adhésion et d’inscription.
Demander des autorisations
Configurez les scopes OAuth dont votre app a réellement besoin.

