Choisissez votre intégration
Les deux approches partagent la même configuration.
Configuration
Créez votre whop et un produit
Commencez sur whop.com/sell pour nommer votre whop et choisir son URL. Rendez-vous ensuite dans Products dans votre tableau de bord et ajoutez un produit avec le prix que paient vos clients. Copiez l’ID du produit (
prod_) et l’ID de son plan (plan_). Vous aurez besoin des deux ci-dessous.Créez une clé API
Dans votre tableau de bord, accédez à Developer → API keys et créez une clé API de compte. Elle agit au nom de votre entreprise : conservez-la donc sur votre serveur et ne l’incluez jamais dans du code client ou dans une app téléchargeable. Stockez-la dans
WHOP_API_KEY.Intégration avec connexion par e-mail
Utilisez cette approche lorsque les clients se connectent à votre propre application web. Stockez l’ID utilisateur Whop de chaque client dans votre fiche utilisateur, puis utilisez-le pour vérifier l’accès avant de fournir les fonctionnalités payantes.Envoyez les utilisateurs connectés vers le checkout
Créez une configuration de checkout depuis votre serveur et placez votre propre ID utilisateur dans Pour garder plutôt les acheteurs sur votre propre page, intégrez l’élément Checkout et passez les mêmes
metadata. Whop copie ces métadonnées sur l’abonnement, ce qui permet à l’étape suivante de relier l’achat à votre utilisateur. Redirigez ensuite l’utilisateur vers purchase_url.metadata sur son handle. Accepter des paiements compare toutes les options de checkout.Enregistrez l'ID utilisateur Whop à partir du webhook
Ouvrez l’onglet Developer de votre tableau de bord, sélectionnez Create webhook, abonnez-vous à
membership.activated et stockez le secret de signature dans WHOP_WEBHOOK_SECRET. Le champ data de l’événement est l’abonnement, avec le user_id de l’acheteur et les metadata que vous avez définies lors du checkout.membership.activated se déclenche aussi lors des renouvellements : assurez-vous donc que l’écriture peut être répétée sans risque. Webhooks couvre les nouvelles tentatives et les tests.Vérifiez l'accès avant de fournir les fonctionnalités payantes
Demandez à Whop si l’utilisateur a accès à votre produit. La réponse tient compte des renouvellements, des annulations et des remboursements : vous n’avez donc pas besoin de suivre vous-même l’état de la facturation.Dans la même réponse,
access_level vaut customer, admin ou no_access.Laissez les clients gérer leur facturation
Renvoyez les clients vers leurs commandes Whop pour mettre à jour leur moyen de paiement ou annuler. Ils se connectent avec l’e-mail utilisé lors de l’achat.
Intégration par clé de licence
Utilisez cette approche pour les logiciels qui s’exécutent sur la machine du client. Chaque achat s’accompagne d’une clé de licence unique. Votre logiciel demande la clé, et votre serveur la vérifie auprès de Whop.Ajoutez l'app Software à votre produit
Installez l’app Software sur votre whop, ouvrez-la et ajoutez le nom de votre logiciel ainsi que son lien de téléchargement. Les acheteurs voient alors leur clé de licence et le téléchargement dans leurs commandes. L’API ne renvoie le
license_key d’un abonnement que lorsque son produit inclut cette app.Validez les clés depuis votre serveur
Vérifiez les clés depuis votre propre serveur, jamais depuis le logiciel que vous distribuez. Votre clé API peut lire et modifier tous les abonnements de votre entreprise : ne l’intégrez donc jamais dans une application de bureau ou un script téléchargé par les utilisateurs. Votre logiciel envoie la clé de licence et un identifiant de machine à votre serveur, et votre serveur la vérifie auprès de Whop.Pour limiter chaque clé à une seule machine, stockez un identifiant matériel dans les métadonnées de l’abonnement la première fois que quelqu’un utilise la clé, puis comparez-le à chaque vérification ultérieure :
- La clé n’est pas encore liée (pas de
hwiddans ses métadonnées) : enregistrez lehwidde la machine et accordez l’accès. - Le
hwidstocké correspond : accordez l’accès. - Le
hwidstocké est différent : refusez l’accès. La clé est utilisée sur une autre machine jusqu’à ce que le client la réinitialise.
Réinitialisez une clé de licence
Les clients peuvent réinitialiser leur clé depuis leurs commandes. Pour la réinitialiser depuis votre serveur, mettez à jour l’abonnement avec un objet de métadonnées vide (
metadata: {}). La vérification suivante, depuis n’importe quelle machine, lie de nouveau la clé.Concevez votre page boutique
Votre page boutique est l’endroit où les gens découvrent votre logiciel avant de l’acheter. Sélectionnez le nom de votre whop en haut à gauche, puis sélectionnez Design store page pour ouvrir l’éditeur. Sélectionnez Edit details pour personnaliser :- Nom et titre : indiquez ce que fait le logiciel et à qui il s’adresse.
- Description : mettez l’accent sur le problème qu’il résout et sur ce que les acheteurs obtiennent, comme des mises à jour, de l’assistance ou une communauté.
- Logo : ajoutez un logo simple et soigné.
- Images ou vidéo de la galerie : montrez le logiciel en action. Une courte vidéo de démonstration aide les acheteurs à se décider.
- Catégorie : choisissez la catégorie qui aide les gens à trouver votre logiciel lorsqu’ils parcourent Whop.
Étapes suivantes
Accepter des paiements
Comparez les liens de checkout, l’élément Checkout et les payment elements.
Webhooks
Vérifiez les signatures, gérez les nouvelles tentatives et testez les événements.
Gérer les abonnements
Annulez, suspendez, prolongez et mettez à jour les abonnements depuis votre serveur.
Se connecter avec Whop
Permettez aux clients de se connecter avec leur compte Whop plutôt qu’avec un mot de passe.

