Skip to main content
Whop integra las apps en el sitio mediante iframes. Este SDK te ofrece una forma con tipado seguro de comunicarte con la aplicación de Whop a través de una API de solicitud y respuesta que usa window.postMessage. Como este paquete depende de window.postMessage, solo funciona en Client Components o en JavaScript del lado del cliente.

Paquetes relevantes

  • @whop/iframe - El paquete principal del SDK del iframe.
  • @whop/react - Un wrapper de React para las Whop Apps que incluye helpers para el SDK del iframe.

Configuración

La función principal que exporta el paquete @whop/iframe es createSdk. Al llamarla, esta función configura un listener de mensajes del sitio principal de Whop usando window.on('message', ...). También se expone a través del componente WhopIframeSdkProvider de @whop/react.

React

Si usas React, añade el componente WhopIframeSdkProvider de @whop/react para proporcionar el SDK del iframe a todos los componentes hijos.
1

Monta el provider en el layout raíz

2

Consume el SDK del iframe en un componente

Otros frameworks

En otros frameworks, puedes usar la función createSdk de @whop/iframe para crear una instancia del SDK del iframe.
1

Crea la instancia del SDK del iframe

2

Usa la instancia del SDK del iframe

El SDK y el iframe ya están configurados.
Después de inicializar el SDK del iframe, puedes usarlo para abrir enlaces externos. Esto cierra tu app y navega a un nuevo sitio web.

Abrir perfiles de usuario

Si quieres mostrar el perfil de un usuario de Whop, puedes usar el método openExternalUrl y pasar el enlace de su página de perfil, que tiene el formato https://whop.com/@username. La app de Whop lo intercepta y muestra un modal con su perfil de usuario en lugar de salir de la página.
También puedes usar un ID de usuario en lugar del nombre de usuario. El enlace final debería tener este aspecto: https://whop.com/@user_XXXXXXXX

Compras dentro de la app

El SDK del iframe ofrece un método para activar compras dentro de la app directamente en tu app. Esto te permite aceptar pagos únicos o suscripciones usando el checkout de Whop. Para procesar compras dentro de la app, tendrás que:
  1. Crear una configuración de checkout en tu servidor (con los detalles de la variante en el campo de compatibilidad plan y tus metadatos)
  2. Usar el método inAppPurchase del SDK del iframe para abrir el modal de pago
  3. Gestionar la respuesta y validar el pago mediante webhooks
Para ver una guía completa sobre cómo configurar compras dentro de la app, incluida la creación de configuraciones de checkout, la gestión de webhooks y la validación de pagos, consulta la documentación sobre cómo aceptar pagos.