Skip to main content
Ce guide montre comment recréer le cœur de la démo Mercor Clone avec Whop Rails. Vous allez créer les pages clés, brancher les paiements avec l’élément Checkout et payer des sous-comptes à grande échelle. Pour voir le dépôt d’exemple, consultez le dépôt Mercor clone. Sinon, suivez le tutoriel ci-dessous pour commencer :
Définissez les variables d’environnement
Installez les dépendances
Créez un client Whop unique pour vos routes serveur. Le SDK envoie, à chaque requête, la version de l’API à partir de laquelle il a été généré.

  1. Structure du projet et pages

Créez une structure App Router (Next.js) qui reflète les parcours de la marketplace. Ajoutez des pages recruteur pour approvisionner et gérer les missions, des pages prestataire pour les versements et les soumissions, et une interface d’administration si nécessaire. Structure des dossiers
Exemple minimal de page de solde recruteur
Exemple minimal de page de versements prestataire

  1. Flux de paiement avec l’élément Checkout

Serveur : créez une configuration de checkout Whop avec une variante ponctuelle inline et vos propres métadonnées pour rattacher les paiements au compte recruteur.
Client : ouvrez une modale « Add Funds » et montez le checkout Whop Elements avec @whop/elements-react.
Un checkout terminé redirige l’onglet vers returnUrl, la modale n’a donc besoin d’aucun callback de fin. Créditez le solde du recruteur depuis le webhook ci-dessous et affichez-le sur la page vers laquelle pointe returnUrl. Webhook : vérifiez la signature, recevez les événements de paiement Whop et créditez le solde du recruteur sur payment.succeeded. Fixez l’api_version_date du webhook lorsque vous le créez afin que data soit l’objet Payment actuel, dans lequel total est un objet monétaire avec un amount sous forme de chaîne décimale.

  1. Versements aux sous-comptes (configuration du compte + portail de versement)

Créez un sous-compte Whop (compte prestataire) sous votre compte de plateforme. Transmettre votre ID utilisateur en tant que external_id garantit qu’une nouvelle tentative de création renvoie le même sous-compte. Stockez l’ID renvoyé dans whopId pour acheminer les transferts. Pour retrouver plus tard le compte à partir de votre ID utilisateur, appelez whop.accounts.list({ external_id }).
Intégrer un portail de versement avec Whop Elements Générez un jeton d’accès pour le compte du prestataire sur votre serveur (voir Activer les versements aux sous-comptes), puis montez les interfaces du wallet avec celui-ci :
Fin de mission : transférez les fonds de la plateforme vers le sous-compte du prestataire en utilisant le whopAccountId du prestataire et une clé d’idempotence par soumission.
Voilà le cœur de la marketplace de type Mercor. Les recruteurs approvisionnent leurs soldes via des paiements, les prestataires configurent des comptes de versement (sous-comptes), et les missions terminées transfèrent l’argent aux prestataires, déduction faite de vos frais de plateforme. Dépôt de référence : Mercor clone