Skip to main content
L’API actuelle vous permet de déplacer de l’argent par programmation. Acceptez des paiements avec des liens de checkout, conservez des soldes, envoyez des versements, émettez des cartes, transférez des fonds entre comptes et gérez les produits et variantes que vous vendez. Faites tout cela depuis votre serveur avec une seule clé API.

Effectuer une requête

L’URL de base est https://api.whop.com/api/v1. Authentifiez chaque requête avec une clé API de type Bearer :
Si vous débutez, le Démarrage rapide vous guide de la création d’une clé jusqu’à un lien de checkout actif en environ cinq minutes. Si vous migrez une intégration depuis l’API v2 ou l’API GraphQL publique, commencez par Migrer depuis les versions précédentes.

Fonctionnement des requêtes

Authentification

Créez une clé API ici sous Account API Keys. Les clés appartiennent à un compte et portent les permissions que vous leur accordez. Conservez les clés sur votre serveur, jamais dans du code exécuté dans le navigateur, des apps mobiles ou des dépôts publics.

Gestion des versions

Whop versionne l’API par date. Envoyez un en-tête Api-Version-Date, comme 2026-07-01, pour figer la structure de vos requêtes et réponses. Les modifications ultérieures ne casseront pas un appelant dont la version est figée. Lorsque vous omettez l’en-tête, les requêtes utilisent les structures d’origine 2025-01-01. Les SDK générés envoient toujours la dernière version disponible au moment où Whop les a générés. Consultez Gestion des versions.

Pagination

Les endpoints de liste renvoient un tableau data ainsi qu’un objet page_info. Passez first pour choisir la taille de la page. Passez after avec le page_info.end_cursor de la réponse précédente pour récupérer la page suivante. page_info.has_next_page vous indique quand vous arrêter. Les listes qui le prennent en charge acceptent include_total_count=true et renvoient le nombre de résultats correspondants dans page_info.total_count. Les décomptes s’arrêtent à 10 000 (total_count_capped: true) et valent null si le décompte échoue. Ajoutez first=0 pour obtenir uniquement le décompte.

Erreurs

Les requêtes qui échouent renvoient un statut HTTP conventionnel (400, 401, 403, 404) et un corps contenant un unique objet error : type est un code lisible par machine et message explique ce qui s’est mal passé.

Où tout se trouve

Cette référence couvre l’API actuelle. Les ressources suivantes sont documentées dans la référence de l’ancienne API : Utilisez le sélecteur d’API en haut de la barre latérale pour passer d’une référence à l’autre.

Ressources

Ressources principales

Les comptes et les personnes dont dépend tout le reste.

Paiements

Acceptez les paiements des acheteurs et gérez ce qui suit.

Argent

Soldes et services bancaires : toutes les façons dont les fonds entrent ou sortent.

Commerce

Vendez des produits et soyez payé.

Sites web

Les apps hébergées, leurs builds et domaines, et les expériences qui s’y exécutent.

Publicités

Lancez et mesurez des campagnes publicitaires depuis votre intégration.

Analytique

Qui visite, ce qui convertit et quelles sont les performances d’un compte.

Communication

Les canaux, les messages qui y sont échangés, les livestreams, les notifications que reçoivent les utilisateurs et les boîtes e-mail.

Partenaires

Recommandez des utilisateurs et des entreprises à Whop et suivez vos gains.

Main-d’œuvre

Publiez des tâches rémunérées et payez les personnes pour le travail accompli.

Médias

Générez des ressources multimédias depuis votre intégration.

Développeur

Identifiants, webhooks et journaux pour l’intégration avec l’API Whop.