Skip to main content
Whop gestiona el checkout, la facturación y la administración de suscripciones de tu software. Antes de que tu app deje entrar a alguien, comprueba con Whop que el cliente tiene acceso en ese momento. Esta página muestra las dos formas de hacer esa comprobación.

Elige tu integración

Ambas opciones comparten la misma configuración.

Configuración

1

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.
2

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.
3

Instala el SDK

Crea un único cliente y reutilízalo. Los ejemplos de esta página lo llaman client.

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.
1

Añade columnas de Whop a tu tabla de usuarios

2

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 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.
Para mantener a los compradores en tu propia página, integra el elemento Checkout y pasa los mismos metadata en su handle. Aceptar pagos compara todas las opciones de checkout.
3

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.
4

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.
5

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.
1

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.
2

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 hwid en sus metadatos): guarda el hwid de la máquina y concede el acceso.
  • El hwid guardado coincide: concede el acceso.
  • El hwid guardado es distinto: deniega el acceso. La clave está en uso en otra máquina hasta que el cliente la restablezca.
3

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.