Skip to main content
Este inicio rápido se ejecuta en el sandbox, un entorno de Whop independiente en el que el dinero nunca se mueve. Obtendrás una clave de API de sandbox, harás tu primera llamada, crearás un checkout, lo pagarás con una tarjeta de prueba y recibirás el webhook payment.succeeded en tu servidor. Pasar a producción es el último paso y consiste, sobre todo, en cambiar las claves.
Si usas un agente de programación, dale esta página en Markdown, https://docs.whop.com/developer/quickstart.md, o pega el prompt de la Descripción general.

Sandbox y producción

Whop ejecuta dos entornos que no comparten nada: ni cuentas, ni claves, ni productos, ni webhooks. Construyes en el sandbox y lanzas en producción. Todos los valores siguientes cambian entre uno y otro.
Las claves de API de sandbox y de producción tienen el mismo aspecto, así que nada en una clave te indica a qué entorno pertenece. Los fragmentos de esta página eligen el entorno a partir de una variable WHOP_ENVIRONMENT en lugar de fijarlo en el código, de modo que el mismo código funciona en ambos. El servidor MCP de Whop solo actúa sobre datos de producción.

Obtén una clave de API de sandbox

1

Regístrate en el sandbox

Ve a sandbox.whop.com y crea una cuenta. Es independiente de cualquier cuenta que tengas en whop.com. El proceso de registro crea tu primer negocio, que es la Account propietaria de las claves de API, los productos, los webhooks y los pagos.
2

Crea una clave de API de Account

Abre sandbox.whop.com/dashboard/developer. En Account API Keys, selecciona Create y ponle a la clave un nombre como Local development.Para este inicio rápido, usa el rol Admin. Antes de pasar a producción, cambia a un conjunto de permisos personalizado que cubra solo los endpoints que llamas.
3

Guarda la clave en tu servidor

Copia la clave cuando Whop la muestre y ponla en tu archivo .env local junto con el entorno al que pertenece:
Sección Account API Keys del panel de Whop con el nombre de una clave, su valor enmascarado y el botón Create
Mantén WHOP_API_KEY en tu servidor. No pongas claves de API en código del navegador, apps móviles ni repositorios públicos. Las claves de sandbox y de producción tienen el mismo aspecto, así que ponles nombres que te permitan distinguirlas.
Una clave de API de Account es lo adecuado cuando tu servidor actúa en nombre de tu propio negocio. Para crear una app que instalen otros negocios, o para permitir que los usuarios inicien sesión con Whop, consulta Autenticación y claves de API.

Instala el SDK

Esta página requiere el SDK 2.7.0 o posterior. Las versiones anteriores no aceptan el variant en línea en las configuraciones de checkout.

Haz tu primera llamada

Apunta el cliente al entorno indicado en WHOP_ENVIRONMENT y recupera la cuenta asociada a tu clave. Esto confirma que la clave funciona e imprime el ID de tu cuenta, que empieza por biz_.
Esa es tu cuenta de sandbox. La clave funciona.

Crea un checkout

Una sola llamada crea una variante y devuelve una purchase_url, una página de checkout alojada en sandbox.whop.com.
Abrirás esta URL en el paso del pago. Si ya tienes una variante, pasa su ID como variant_id en lugar del variant en línea. No puedes enviar ambos. Crear configuración de checkout enumera todas las opciones, incluidos los precios recurrentes, las pruebas gratuitas y las URL de redirección.

Escucha el webhook

Configura tu endpoint antes de pagar, para que el evento payment.succeeded tenga dónde llegar.
1

Añade un endpoint

Añade una ruta POST que verifique la firma y registre el evento. La verificación necesita el cuerpo sin procesar de la solicitud, así que léelo antes de cualquier análisis de JSON.
Mientras desarrollas, expón la ruta por HTTPS con ngrok, Cloudflare Tunnel u otro túnel.
2

Crea el webhook en el panel del sandbox

Abre Developer > Webhooks en el panel del sandbox y selecciona Create webhook. Pega la dirección HTTPS de tu endpoint, deja la versión de la API en v1 y selecciona payment.succeeded.
Formulario para crear un webhook con el evento payment_succeeded seleccionado en la lista de eventos
3

Guarda el secreto de firma

Copia el secreto de la columna Secret del webhook y añádelo a .env exactamente como se muestra, con el prefijo ws_ incluido:
Reinicia tu servidor para que cargue el nuevo valor.

Paga con una tarjeta de prueba

Abre la purchase_url del paso del checkout y paga con: En unos segundos, tu servidor registra payment.succeeded y el ID del pago, que empieza por pay_.
Has cobrado un pago y gestionado su webhook de principio a fin. No se ha cobrado nada.
Para probar una tarjeta rechazada o 3D Secure, usa los otros números de Tarjetas de prueba. Si no llega nada, revisa el registro de entregas del webhook en el panel y Entrega de webhooks.

Pasa a producción

El sandbox y la producción no comparten nada, así que pasar a producción significa repetir la configuración en whop.com con credenciales de producción. Tu código no cambia. Solo cambian los valores de tu entorno.
1

Crea una clave de producción

Inicia sesión en whop.com, abre whop.com/dashboard/developer y crea una clave de API de Account solo con los permisos que usa tu integración.
2

Cambia cada valor por su equivalente de producción

En tu entorno de producción, establece las tres variables con valores de producción. Nunca reutilices una clave o un secreto de sandbox en producción, ni al revés.
Si llamas a la API directamente, cambia la URL base a https://api.whop.com/api/v1.
3

Vuelve a crear lo que hiciste en el sandbox

Los productos, las variantes, las configuraciones de checkout y los webhooks no se trasladan. Crea el webhook de producción con tu URL de producción y guarda su nuevo secreto de firma.
4

Fija tu versión de la API

El SDK envía la versión con la que se compiló. Si llamas a la API directamente, envía Api-Version-Date en cada solicitud para que los cambios posteriores no alteren tus respuestas. Consulta Versionado de la API.
Los enlaces de checkout de producción cobran dinero real. Comprueba qué clave tienes antes de ejecutar cualquier cosa que cree un cargo o mueva un saldo.

Ahora construye lo que viniste a hacer

Vendes una suscripción o un producto de pago único

Enlaces de checkout, el elemento Checkout, variantes y pruebas gratuitas.

Debes dinero a otras personas

Pagos salientes, transferencias, saldos y el portal de pagos.

Te quedas con una parte de lo que venden otros

Subcuentas, cobros en su nombre y pagos a ellas.

Quieres distribución, no solo infraestructura

Apps que se ejecutan dentro de Whop, con autenticación, vistas y la CLI.

Tu producto necesita que las personas hablen entre sí

Chat, mensajes directos y foros que puedes integrar.

Solo quieres leer la referencia

Todos los recursos de la API actual, con un playground en cada endpoint.