Skip to main content
Ce démarrage rapide se déroule dans le sandbox, un environnement Whop distinct où l’argent ne circule jamais. Vous allez obtenir une clé API sandbox, effectuer votre premier appel, créer un checkout, le payer avec une carte de test et recevoir le webhook payment.succeeded sur votre serveur. La mise en production est la dernière étape, et consiste surtout à échanger des clés.
Si vous utilisez un agent de code, donnez-lui cette page au format Markdown, https://docs.whop.com/developer/quickstart.md, ou collez le prompt de la page Vue d’ensemble.

Sandbox et production

Whop exécute deux environnements qui ne partagent rien : ni comptes, ni clés, ni produits, ni webhooks. Vous développez dans le sandbox et lancez en production. Chacune des valeurs ci-dessous change de l’un à l’autre.
Les clés API sandbox et production se ressemblent en tout point : rien dans une clé n’indique à quel environnement elle appartient. Les extraits de code de cette page choisissent l’environnement à partir d’une variable WHOP_ENVIRONMENT au lieu de le coder en dur, de sorte que le même code fonctionne dans les deux. Le serveur MCP Whop agit uniquement sur les données de production.

Obtenir une clé API sandbox

1

Inscrivez-vous au sandbox

Rendez-vous sur sandbox.whop.com et créez un compte. Il est distinct de tout compte que vous possédez sur whop.com. Le parcours d’inscription crée votre première entreprise, c’est-à-dire le compte qui possède les clés API, les produits, les webhooks et les paiements.
2

Créez une clé API de compte

Ouvrez sandbox.whop.com/dashboard/developer. Dans Account API Keys, sélectionnez Create et donnez à la clé un nom comme Local development.Pour ce démarrage rapide, utilisez le rôle Admin. Avant la production, passez à un ensemble de permissions personnalisé qui couvre uniquement les endpoints que vous appelez.
3

Stockez la clé sur votre serveur

Copiez la clé lorsque Whop l’affiche, puis placez-la dans votre fichier .env local avec l’environnement auquel elle appartient :
Section Account API Keys du tableau de bord Whop affichant un nom de clé, une valeur masquée et le bouton Create
Conservez WHOP_API_KEY sur votre serveur. Ne placez pas de clés API dans du code exécuté dans le navigateur, dans des applications mobiles ou dans des dépôts publics. Les clés sandbox et production se ressemblent en tout point : nommez-les de manière à pouvoir les distinguer.
Une clé API de compte convient lorsque votre serveur agit pour votre propre entreprise. Pour créer une app que d’autres entreprises installent, ou pour permettre aux utilisateurs de se connecter avec Whop, consultez Authentification et clés API.

Installer le SDK

Cette page nécessite le SDK 2.7.0 ou une version ultérieure. Les versions antérieures n’acceptent pas le variant en ligne dans les configurations de checkout.

Effectuer votre premier appel

Pointez le client vers l’environnement indiqué dans WHOP_ENVIRONMENT et récupérez le compte associé à votre clé. Cela confirme que la clé fonctionne et affiche l’ID de votre compte, qui commence par biz_.
Voici votre compte sandbox. La clé fonctionne.

Créer un checkout

Un seul appel crée une variante et renvoie une purchase_url, une page de checkout hébergée sur sandbox.whop.com.
Vous ouvrirez cette URL lors de l’étape de paiement. Si vous avez déjà une variante, passez son ID dans variant_id au lieu du variant en ligne. Vous ne pouvez pas envoyer les deux. Créer une configuration de checkout liste toutes les options, notamment la tarification récurrente, les essais et les URL de redirection.

Écouter le webhook

Configurez votre endpoint avant de payer, afin que l’événement payment.succeeded ait un point d’arrivée.
1

Ajoutez un endpoint

Ajoutez une route POST qui vérifie la signature et journalise l’événement. La vérification nécessite le corps brut de la requête : lisez-le donc avant tout parsing JSON.
Pendant le développement, exposez la route en HTTPS avec ngrok, Cloudflare Tunnel ou un autre tunnel.
2

Créez le webhook dans le tableau de bord sandbox

Ouvrez Developer > Webhooks dans le tableau de bord sandbox, puis sélectionnez Create webhook. Collez l’adresse HTTPS de votre endpoint, conservez la version d’API v1 et sélectionnez payment.succeeded.
Formulaire de création de webhook avec l'événement payment_succeeded sélectionné dans la liste des événements
3

Stockez le secret de signature

Copiez le secret depuis la colonne Secret du webhook et ajoutez-le à .env exactement tel qu’affiché, préfixe ws_ compris :
Redémarrez votre serveur pour qu’il prenne en compte la nouvelle valeur.

Payer avec une carte de test

Ouvrez la purchase_url obtenue à l’étape du checkout et payez avec : En quelques secondes, votre serveur journalise payment.succeeded et l’ID du paiement, qui commence par pay_.
Vous avez encaissé un paiement et traité son webhook de bout en bout. Rien n’a été débité.
Pour tester une carte refusée ou 3D Secure, utilisez les autres numéros de Cartes de test. Si rien n’arrive, consultez le journal de livraison du webhook dans le tableau de bord ainsi que Livraison des webhooks.

Passer en production

Le sandbox et la production ne partagent rien : passer en production signifie donc refaire la configuration sur whop.com avec des identifiants de production. Votre code ne change pas. Seules les valeurs de votre environnement changent.
1

Créez une clé de production

Connectez-vous sur whop.com, ouvrez whop.com/dashboard/developer et créez une clé API de compte avec uniquement les permissions qu’utilise votre intégration.
2

Remplacez chaque valeur par son équivalent de production

Dans votre environnement de production, définissez les trois variables avec des valeurs de production. Ne réutilisez jamais une clé ou un secret sandbox en production, ni l’inverse.
Si vous appelez l’API directement, remplacez l’URL de base par https://api.whop.com/api/v1.
3

Recréez ce que vous avez créé dans le sandbox

Les produits, variantes, configurations de checkout et webhooks ne sont pas transférés. Créez le webhook de production avec votre URL de production et stockez son nouveau secret de signature.
4

Fixez votre version d'API

Le SDK envoie la version avec laquelle il a été construit. Si vous appelez l’API directement, envoyez Api-Version-Date avec chaque requête afin que les changements ultérieurs ne modifient pas vos réponses. Consultez Versionnage de l’API.
Les liens de checkout de production encaissent de l’argent réel. Vérifiez quelle clé vous utilisez avant d’exécuter quoi que ce soit qui crée un débit ou déplace un solde.

Construisez maintenant ce pour quoi vous êtes venu

Vous vendez un abonnement ou un produit à paiement unique

Liens de checkout, élément Checkout, variantes et essais.

Vous devez de l'argent à d'autres personnes

Versements, transferts, soldes et portail de versement.

Vous prélevez une part de ce que d'autres vendent

Sous-comptes, encaissement en leur nom et versements.

Vous voulez de la distribution, pas seulement de l'infrastructure

Des apps qui s’exécutent dans Whop, avec authentification, vues et CLI.

Votre produit a besoin que les gens échangent entre eux

Chat, messages privés et forums intégrables.

Vous voulez simplement lire la référence

Chaque ressource de l’API actuelle, avec un playground sur chaque endpoint.