Los endpoints de OAuth están en
https://api.whop.com/oauth/.Paso 1: Crea tu app de OAuth
- API
- Dashboard
Usa el endpoint Create App para crear una app de OAuth mediante programación:Actualiza las URI de redirección más adelante con el endpoint Update App.
Paso 2: Envía a los usuarios a autorizar
En tu cliente web o móvil, usa PKCE para redirigir de forma segura a los usuarios al flujo de OAuth de Whop.startWhopOAuth para redirigir al usuario:
Si pasas un ID de cuenta como
company_id, los tokens quedan limitados a esa cuenta
para el usuario. Solo puedes acceder a los recursos que el usuario puede controlar en
esa cuenta de Whop.Paso 3: Gestiona el callback e intercambia el código
Whop redirige de vuelta a turedirect_uri con code y state. Usa esta función para verificar el state, intercambiar el código por tokens y obtener las credenciales:
Paso 4: Usa los tokens
Inicializa el SDK de Whop con el token de acceso del usuario:Paso 5: Renueva los tokens
Los tokens de acceso caducan al cabo de 1 hora. Usa el refresh token para obtener credenciales nuevas:Los refresh tokens rotan con cada uso. Guarda siempre los nuevos tokens que devuelve
el endpoint de renovación. Si proporcionaste
company_id durante la autorización,
debes proporcionar el mismo company_id al renovar.Paso 6: Userinfo y revocación
Obtén la información del usuario
Obtén el perfil del usuario autenticado con el endpoint userinfo:Los campos devueltos dependen de los scopes concedidos.
openid es obligatorio,
profile añade nombre/nombre de usuario/foto y email añade los campos de email.Revoca los tokens al cerrar sesión
Cuando un usuario cierre sesión, revoca su refresh token. Los tokens de acceso caducan al cabo de 1 hora y no se pueden revocar desde el servidor.Gestión de errores
Los errores de OAuth siguen el formato estándar:invalid_request: parámetro ausente o no válido.invalid_grant: código o token caducado o revocado.invalid_client:client_iddesconocido.insufficient_scope: el token no tiene el scope requerido.rate_limit_exceeded: demasiadas solicitudes (consulta el encabezadoRetry-After).
Próximos pasos
Referencia de la API
Todos los endpoints a los que puede llamar un token de acceso concedido.
Acepta pagos
Combina el inicio de sesión con el checkout para flujos de compra de principio a fin.
Escucha webhooks
Reacciona en el servidor a eventos de pagos, membresías y entradas.
Solicita permisos
Configura los scopes de OAuth que tu app realmente necesita.

