Skip to main content
Esta guía muestra cómo recrear el núcleo de la demo Mercor Clone usando Whop Rails. Crearás las páginas clave, conectarás los pagos con el elemento Checkout y pagarás a subcuentas a escala. Para ver el repositorio de ejemplo, visita el repositorio de Mercor clone. Si no, sigue el tutorial a continuación para empezar:
Configura las variables de entorno
Instala las dependencias
Crea un único cliente de Whop para tus rutas de servidor. El SDK envía en cada solicitud la versión de la API a partir de la cual se generó.

  1. Estructura del proyecto y páginas

Crea una estructura de App Router (Next.js) que refleje los flujos del marketplace. Añade páginas de reclutador para aportar fondos y gestionar trabajos, páginas de trabajador para pagos y envíos, y una superficie de administración si la necesitas. Estructura de carpetas
Ejemplo mínimo de página de saldo del reclutador
Ejemplo mínimo de página de pagos del trabajador

  1. Flujo de pago con el elemento Checkout

Servidor: crea una configuración de checkout de Whop con una variante de pago único en línea y tus propios metadatos para vincular los pagos con la cuenta del reclutador.
Cliente: abre un modal “Add Funds” y monta el checkout de Whop Elements con @whop/elements-react.
Un checkout finalizado redirige la pestaña a returnUrl, así que el modal no necesita un callback de finalización. Acredita el saldo del reclutador desde el webhook de abajo y muéstralo en la página a la que apunta returnUrl. Webhook: verifica la firma, recibe los eventos de pago de Whop y acredita el saldo del reclutador en payment.succeeded. Fija el api_version_date del webhook cuando lo crees para que data sea el objeto Payment actual, donde total es un objeto de dinero con un amount en cadena decimal.

  1. Pagos a subcuentas (configuración de la cuenta + portal de pagos)

Crea una subcuenta de Whop (cuenta del trabajador) bajo tu cuenta de plataforma. Pasar tu ID de usuario como external_id hace que una creación reintentada devuelva la misma subcuenta. Guarda el ID devuelto como whopId para dirigir las transferencias. Para encontrar la cuenta por tu ID de usuario más adelante, llama a whop.accounts.list({ external_id }).
Integra un portal de pagos con Whop Elements Genera un token de acceso para la cuenta del trabajador en tu servidor (consulta Activa los pagos a subcuentas) y luego monta con él las superficies del wallet:
Finalización del trabajo: transfiere fondos de la plataforma a la subcuenta del trabajador usando el whopAccountId del trabajador y una clave de idempotencia por envío.
Ese es el núcleo del marketplace al estilo de Mercor. Los reclutadores financian sus saldos mediante pagos, los trabajadores configuran cuentas de pago (subcuentas) y los trabajos completados transfieren dinero a los trabajadores menos tu comisión de plataforma. Repositorio de referencia: Mercor clone