Skip to main content
La API actual es la forma de mover dinero de manera programática. Acepta pagos con enlaces de checkout, mantén saldos, envía retiros, emite tarjetas, transfiere fondos entre cuentas y gestiona los productos y variantes que vendes. Hazlo todo desde tu servidor con una sola API key.

Hacer una solicitud

La URL base es https://api.whop.com/api/v1. Autentica cada solicitud con una API key de tipo Bearer:
Si eres nuevo, el Quickstart te lleva desde crear una clave hasta un enlace de checkout activo en unos cinco minutos. Si estás migrando una integración desde la API v2 o la API pública de GraphQL, empieza por Migrar desde versiones anteriores.

Cómo funcionan las solicitudes

Autenticación

Crea una API key aquí en Account API Keys. Las claves pertenecen a una cuenta y llevan los permisos que les concedas. Mantén las claves en tu servidor, nunca en código del navegador, apps móviles o repositorios públicos.

Versionado

Whop versiona la API por fecha. Envía un encabezado Api-Version-Date, como 2026-07-01, para fijar la forma de tus solicitudes y respuestas. Los cambios posteriores no romperán a un cliente con la versión fijada. Cuando omites el encabezado, las solicitudes usan las formas originales de 2025-01-01. Los SDK generados siempre envían la última versión disponible cuando Whop los compiló. Consulta Versionado.

Paginación

Los endpoints de lista devuelven un array data más un objeto page_info. Pasa first para elegir el tamaño de página. Pasa after con el page_info.end_cursor de la respuesta anterior para obtener la página siguiente. page_info.has_next_page te indica cuándo parar. Las listas que lo admiten aceptan include_total_count=true y devuelven el número de resultados coincidentes en page_info.total_count. Los recuentos se detienen en 10,000 (total_count_capped: true) y son null si el recuento falla. Añade first=0 para obtener solo el recuento.

Errores

Las solicitudes fallidas devuelven un estado HTTP convencional (400, 401, 403, 404) y un cuerpo con un único objeto error: type es un código legible por máquina y message explica qué salió mal.

Dónde está cada cosa

Esta referencia cubre la API actual. Estos recursos están documentados en la referencia de la API Legacy: Usa el selector de API en la parte superior de la barra lateral para cambiar entre referencias.

Recursos

Recursos principales

Las cuentas y las personas de las que depende todo lo demás.

Pagos

Acepta pagos de compradores y gestiona lo que viene después.

Dinero

Saldos y banca: todas las formas en que entran o salen los fondos.

Comercio

Vende productos y recibe pagos.

Sitios web

Apps alojadas, sus builds y dominios, y los experimentos que se ejecutan en ellas.

Anuncios

Ejecuta y mide campañas publicitarias desde tu integración.

Analítica

Quién visita, qué convierte y cómo está rindiendo una cuenta.

Comunicación

Channels, los mensajes que se intercambian en ellos, livestreams, las notificaciones que reciben los usuarios y buzones de correo electrónico.

Partners

Refiere usuarios y negocios a Whop y haz seguimiento de lo que ganas.

Fuerza laboral

Publica tareas pagadas y paga a personas por el trabajo completado.

Medios

Genera recursos multimedia desde tu integración.

Desarrollador

Credenciales, webhooks y logs para integrarse con la API de Whop.