Skip to main content
Usa OAuth 2.1 + PKCE con OpenID Connect (OIDC) para que los usuarios inicien sesión con Whop en tu sitio web o app. Los tokens de acceso devueltos te permiten acceder a datos y actuar en nombre de esos usuarios.
Los endpoints de OAuth están en https://api.whop.com/oauth/.

Paso 1: Crea tu app de OAuth

El objeto App que devuelve apps.create en el @whop/sdk actual no expone un campo client_secret. Copia el client secret desde la pestaña 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.
Llama a startWhopOAuth para redirigir al usuario:
Si el usuario no ha iniciado sesión, Whop le pedirá que lo haga y luego mostrará la pantalla de consentimiento. Si el usuario ya aprobó tu aplicación para los scopes solicitados, se le redirigirá automáticamente de vuelta sin tener que confirmar dos veces.
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 tu redirect_uri con code y state. Usa esta función para verificar el state, intercambiar el código por tokens y obtener las credenciales:
En tu página de callback:

Paso 4: Usa los tokens

Inicializa el SDK de Whop con el token de acceso del usuario:
Consulta la referencia de la API para ver todos los endpoints disponibles.

Paso 5: Renueva los tokens

Los tokens de acceso caducan al cabo de 1 hora. Usa el refresh token para obtener credenciales nuevas:
Uso:
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.
Revoca siempre los tokens cuando los usuarios cierren sesión. Esto invalida el refresh token de inmediato y evita accesos no autorizados aunque el token se haya visto comprometido.

Gestión de errores

Los errores de OAuth siguen el formato estándar:
Códigos de error comunes:
  • invalid_request: parámetro ausente o no válido.
  • invalid_grant: código o token caducado o revocado.
  • invalid_client: client_id desconocido.
  • insufficient_scope: el token no tiene el scope requerido.
  • rate_limit_exceeded: demasiadas solicitudes (consulta el encabezado Retry-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.