payment.succeeded sur votre serveur. La mise en production est la dernière étape, et consiste surtout à échanger des clés.
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.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 :
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.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é dansWHOP_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 unepurchase_url, une page de checkout hébergée sur sandbox.whop.com.
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énementpayment.succeeded ait un point d’arrivée.
1
Ajoutez un endpoint
Ajoutez une route Pendant le développement, exposez la route en HTTPS avec ngrok, Cloudflare Tunnel ou un autre tunnel.
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.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.
3
Stockez le secret de signature
Copiez le secret depuis la colonne Secret du webhook et ajoutez-le à Redémarrez votre serveur pour qu’il prenne en compte la nouvelle valeur.
.env exactement tel qu’affiché, préfixe ws_ compris :Payer avec une carte de test
Ouvrez lapurchase_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é.
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.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.

