Elige tu integración
Ambas opciones comparten la misma configuración.
Configuración
Crea tu whop y un producto
Empieza en whop.com/sell para ponerle nombre a tu whop y elegir su URL. Después, ve a Products en tu panel y añade un producto con el precio que pagan tus clientes. Copia el ID del producto (
prod_) y el ID de su plan (plan_). Necesitarás ambos más adelante.Crea una clave de API
En tu panel, ve a Developer → API keys y crea una clave de API de cuenta. Actúa en nombre de tu negocio, así que mantenla en tu servidor y nunca la incluyas en código de cliente ni en una app descargable. Guárdala como
WHOP_API_KEY.Integración con inicio de sesión por correo electrónico
Usa esta opción cuando los clientes inicien sesión en tu propia app web. Guarda el ID de usuario de Whop de cada cliente en tu registro de usuario y, después, úsalo para comprobar el acceso antes de ofrecer funciones de pago.Envía al checkout a los usuarios que han iniciado sesión
Crea una configuración de checkout desde tu servidor y pon tu propio ID de usuario en Para mantener a los compradores en tu propia página, integra el elemento Checkout y pasa los mismos
metadata. Whop copia esos metadatos en la membresía, que es como el siguiente paso vincula la compra con tu usuario. Después, redirige al usuario a purchase_url.metadata en su handle. Aceptar pagos compara todas las opciones de checkout.Guarda el ID de usuario de Whop desde el webhook
Abre la pestaña Developer de tu panel, selecciona Create webhook, suscríbete a
membership.activated y guarda el secreto de firma como WHOP_WEBHOOK_SECRET. El data del evento es la membresía, con el user_id del comprador y los metadata que estableciste en el checkout.membership.activated también se activa en las renovaciones, así que asegúrate de que la escritura se pueda repetir sin problemas. Webhooks explica los reintentos y las pruebas.Comprueba el acceso antes de ofrecer funciones de pago
Pregunta a Whop si el usuario tiene acceso a tu producto. La respuesta tiene en cuenta las renovaciones, cancelaciones y reembolsos, así que no necesitas hacer el seguimiento del estado de facturación tú mismo.
access_level en la misma respuesta es customer, admin o no_access.Permite que los clientes gestionen su facturación
Enlaza a los clientes a sus pedidos de Whop para que actualicen su método de pago o cancelen. Inician sesión con el correo electrónico con el que compraron.
Integración con claves de licencia
Usa esta opción para software que se ejecuta en la máquina del cliente. Cada compra incluye una clave de licencia única. Tu software pide la clave y tu servidor la comprueba con Whop.Añade la app Software a tu producto
Instala la app Software en tu whop, ábrela y añade el nombre de tu software y el enlace de descarga. Así, los compradores ven su clave de licencia y la descarga en sus pedidos. La API devuelve la
license_key de una membresía solo cuando su producto incluye esta app.Valida las claves desde tu servidor
Comprueba las claves desde tu propio servidor, nunca desde el software que distribuyes. Tu clave de API puede leer y modificar todas las membresías de tu negocio, así que nunca la incluyas en una app de escritorio o un script que descarguen los usuarios. Tu software envía la clave de licencia y un identificador de la máquina a tu servidor, y tu servidor la comprueba con Whop.Para limitar cada clave a una sola máquina, guarda un ID de hardware en los metadatos de la membresía la primera vez que alguien use la clave y, después, compáralo en cada comprobación posterior:
- La clave aún no está vinculada (no hay
hwiden sus metadatos): guarda elhwidde la máquina y concede el acceso. - El
hwidguardado coincide: concede el acceso. - El
hwidguardado es distinto: deniega el acceso. La clave está en uso en otra máquina hasta que el cliente la restablezca.
Restablece una clave de licencia
Los clientes pueden restablecer su clave desde sus pedidos. Para restablecerla desde tu servidor, actualiza la membresía con un objeto de metadatos vacío (
metadata: {}). La siguiente comprobación desde cualquier máquina vuelve a vincular la clave.Diseña la página de tu tienda
La página de tu tienda es donde la gente conoce tu software antes de comprarlo. Selecciona el nombre de tu whop en la parte superior izquierda y, a continuación, selecciona Design store page para abrir el editor. Selecciona Edit details para personalizar:- Nombre y titular: explica qué hace el software y a quién va dirigido.
- Descripción: céntrate en el problema que resuelve y en lo que obtienen los compradores, como actualizaciones, soporte o una comunidad.
- Logotipo: añade un logotipo limpio y sencillo.
- Imágenes o vídeo de la galería: muestra el software en uso. Un vídeo de demostración breve ayuda a los compradores a decidirse.
- Categoría: elige la categoría que ayude a la gente a encontrar tu software al explorar Whop.
Próximos pasos
Aceptar pagos
Compara los enlaces de checkout, el elemento Checkout y los payment elements.
Webhooks
Verifica firmas, gestiona reintentos y prueba eventos.
Gestionar membresías
Cancela, pausa, amplía y actualiza membresías desde tu servidor.
Iniciar sesión con Whop
Permite que los clientes inicien sesión con su cuenta de Whop en lugar de con una contraseña.

