> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Présentation de l'API Whop

> Fonctionnement des requêtes vers l'API Whop, avec une carte de chaque ressource et de l'endroit où elle est documentée.

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 :

```bash theme={null}
curl https://api.whop.com/api/v1/accounts/me \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

```json theme={null}
{
	"id": "biz_XXXXXXXX",
	"title": "Acme Studio",
	"route": "acme-studio",
	"status": "approved"
}
```

Si vous débutez, le [Démarrage rapide](https://docs.whop.com/fr/developer/quickstart.md) vous guide de la [création d'une clé](https://whop.com/dashboard/developer) 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](https://docs.whop.com/fr/developer/api/migrate-from-previous-versions.md).

## Fonctionnement des requêtes

### Authentification

[Créez une clé API ici](https://whop.com/dashboard/developer) 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](https://docs.whop.com/fr/developer/api/versioning.md).

### 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é.

```json theme={null}
{
	"error": {
		"type": "invalid_parameters",
		"message": "initial_price must be greater than 0"
	}
}
```

## 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](https://docs.whop.com/fr/api-reference/payments/payment) :

* Facturation : [Paiements](https://docs.whop.com/fr/api-reference/payments/payment), [Remboursements](https://docs.whop.com/fr/api-reference/refunds/refund), [Factures](https://docs.whop.com/fr/api-reference/legacy/invoices/legacy-invoice.md), [Moyens de paiement](https://docs.whop.com/fr/api-reference/legacy/payment-methods/payment-method.md)
* Contenu et communauté : [Cours](https://docs.whop.com/fr/api-reference/legacy/courses/course.md), [Forums](https://docs.whop.com/fr/api-reference/legacy/forums/forum.md), [Messages](https://docs.whop.com/fr/api-reference/legacy/messages/message.md)
* Croissance : [Affiliés](https://docs.whop.com/fr/api-reference/legacy/affiliates/affiliate.md), [Avis](https://docs.whop.com/fr/api-reference/legacy/reviews/review.md)

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.

| Ressource | À quoi elle sert |
| - | - |
| [Comptes](https://docs.whop.com/fr/api-reference/accounts/account) | Une entreprise sur Whop : profil, portefeuille, fonctionnalités, paramètres. |
| [Utilisateurs](https://docs.whop.com/fr/api-reference/users/user) | Une personne sur Whop : profil et identités connectées. |
| [Membres](https://docs.whop.com/fr/api-reference/members/member) | La relation d'un acheteur avec un compte, sur l'ensemble de ses achats. |
| [Membres de l'équipe](https://docs.whop.com/fr/api-reference/team-members/team-member) | Les membres de l'équipe d'un compte et les rôles qui délimitent leur accès. |
| [Recherche](https://docs.whop.com/fr/api-reference/search/search) | Trouvez les membres, paiements et autres enregistrements d'un compte en un seul appel, par ID, e-mail, carte, téléphone, numéro, lien ou texte. |
| [Comptes externes](https://docs.whop.com/fr/api-reference/external-accounts/external-account) | Comptes sur d'autres plateformes liés à un compte ou à un utilisateur. |
| [Comptes sociaux](https://docs.whop.com/fr/api-reference/social-accounts/social-account) | Endpoints de compatibilité obsolètes pour les comptes externes. |

### Paiements

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

| Ressource | À quoi elle sert |
| - | - |
| [Paiements](https://docs.whop.com/fr/api-reference/payments/payment) | Un débit sur un acheteur, et l'étape qu'il lui reste à accomplir. |
| [Factures](https://docs.whop.com/fr/api-reference/invoices/invoice) | Une demande de paiement qui conserve le même reçu du brouillon jusqu'à l'encaissement. |
| [Jetons de confirmation](https://docs.whop.com/fr/api-reference/confirmation-tokens/confirmation-token) | Une référence de courte durée aux informations de paiement collectées auprès d'un acheteur. |
| [Devis de paiement](https://docs.whop.com/fr/api-reference/payment-quotes/payment-quote) | Un achat dont le prix est calculé avant d'être payé : ses lignes, son code promo et sa taxe. |
| [Setup Intents](https://docs.whop.com/fr/api-reference/setup-intents/setup-intent) | Enregistrer le moyen de paiement d'un acheteur sans le débiter. |
| [Remboursements](https://docs.whop.com/fr/api-reference/refunds/refund) | L'argent restitué à un acheteur à partir d'un paiement. |
| [Dossiers du centre de résolution](https://docs.whop.com/fr/api-reference/resolution-center-cases/resolution-center-case) | Ouvrez un dossier contre un paiement ou répondez-y, en tant qu'acheteur ou marchand. |
| [Alertes de litige](https://docs.whop.com/fr/api-reference/dispute-alerts/dispute-alert) | Avertissements de l'émetteur qui arrivent avant une rétrofacturation. |
| [Litiges](https://docs.whop.com/fr/api-reference/disputes/dispute) | Rétrofacturations déposées contre un compte, avec leurs preuves et leurs résultats. |
| [Règles de paiement](https://docs.whop.com/fr/api-reference/payment-rules/payment-rule) | Règles qu'un compte rédige pour décider de ses propres paiements. |
| [Demandes de financement](https://docs.whop.com/fr/api-reference/financing-applications/financing-application) | La demande d'un compte pour accepter des moyens de paiement fractionné (achetez maintenant, payez plus tard). |

### Argent

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

| Ressource | À quoi elle sert |
| - | - |
| [Dépôts](https://docs.whop.com/fr/api-reference/deposits/deposit) | Ajoutez des fonds à un solde. |
| [Transferts](https://docs.whop.com/fr/api-reference/transfers/transfer) | Déplacez des fonds entre comptes et utilisateurs Whop. |
| [Versements](https://docs.whop.com/fr/api-reference/payouts/payout) | Envoyez de l'argent depuis un solde vers une banque ou un portefeuille. |
| [Activité financière](https://docs.whop.com/fr/api-reference/ledgers/ledger-activity) | Le fil d'activité derrière le solde d'un compte ou d'un utilisateur. |
| [Cartes](https://docs.whop.com/fr/api-reference/cards/card) | Émettez des cartes qui dépensent à partir d'un solde. |
| [Règles de cashback](https://docs.whop.com/fr/api-reference/cashback-rules/cashback-rule) | Configurez le cashback sur carte financé par la plateforme. |
| [Swaps](https://docs.whop.com/fr/api-reference/swaps/swap) | Convertissez un solde d'une devise à une autre. |
| [Trades](https://docs.whop.com/fr/api-reference/trades/trade) | Passez des ordres, clôturez des positions et déplacez des fonds pour le trading perpétuel et au comptant depuis un portefeuille géré par Whop. |
| [Vérifications](https://docs.whop.com/fr/api-reference/verifications/verification) | Identité légale requise avant les versements et l'émission de cartes. |

### Commerce

Vendez des produits et soyez payé.

| Ressource | À quoi elle sert |
| - | - |
| [Produits](https://docs.whop.com/fr/api-reference/products/product) | Ce que vous vendez. Chacun possède des variantes et une page boutique. |
| [Variantes](https://docs.whop.com/fr/api-reference/variants/variant) | Configurations achetables d'un produit. |
| [Codes promo](https://docs.whop.com/fr/api-reference/promo-codes/promo-code) | Remises que les créateurs configurent pour le checkout. |
| [Configurations de checkout](https://docs.whop.com/fr/api-reference/checkout-configurations/checkout-configuration) | Transformez une variante en un lien de checkout prérempli et partageable. |
| [Inscriptions sur liste d'attente](https://docs.whop.com/fr/api-reference/waitlist-entries/waitlist-entry) | Rejoignez des listes d'attente et gérez les inscriptions de clients en attente d'approbation. |
| [Abonnements](https://docs.whop.com/fr/api-reference/memberships/membership) | L'achat d'une variante par un client, du checkout jusqu'à l'annulation. |
| [Expéditions](https://docs.whop.com/fr/api-reference/shipments/shipment) | Suivez la livraison d'une commande grâce au numéro de suivi du transporteur. |
| [Avis](https://docs.whop.com/fr/api-reference/reviews/review) | Notes en étoiles et commentaires écrits des clients sur un produit. |
| [Signalements d'avis](https://docs.whop.com/fr/api-reference/review-reports/review-report) | Signalements déposés par les administrateurs d'un compte contre des avis de clients. |
| [Affiliés de produit](https://docs.whop.com/fr/api-reference/product-affiliates/product-affiliate) | Utilisateurs inscrits pour promouvoir un produit, y compris les affiliés sans parrainage. |

### Sites web

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

| Ressource | À quoi elle sert |
| - | - |
| [Domaines](https://docs.whop.com/fr/api-reference/domains/domain) | Domaines personnalisés attribués aux apps hébergées. |
| [Apps](https://docs.whop.com/fr/api-reference/apps/app) | Les apps que vous créez sur Whop : métadonnées, builds hébergés, journaux d'exécution. |
| [Builds d'app](https://docs.whop.com/fr/api-reference/app-builds/app-build) | Artefacts de build versionnés déployés sur les plateformes d'une app. |
| [Installations d'app](https://docs.whop.com/fr/api-reference/app-installations/app-installation) | Les installations de votre app sur des comptes, et les données qu'elle conserve sur chacune. |
| [Expériences](https://docs.whop.com/fr/api-reference/experiments/experiment) | Feature flags et tests A/B pour un déploiement progressif. |

### Publicités

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

| Ressource | À quoi elle sert |
| - | - |
| [Campagnes publicitaires](https://docs.whop.com/fr/api-reference/ad-campaigns/ad-campaign) | Objectif et budget d'un ensemble de publicités. |
| [Groupes d'annonces](https://docs.whop.com/fr/api-reference/ad-groups/ad-group) | Audience, calendrier et budget au sein d'une campagne. |
| [Publicités](https://docs.whop.com/fr/api-reference/ads/ad) | La création : texte, ressources et URL de destination. |
| [Audiences](https://docs.whop.com/fr/api-reference/audiences/audience) | Listes de ciblage réutilisables pour les groupes d'annonces. |
| [Pixels publicitaires](https://docs.whop.com/fr/api-reference/ad-pixels/ad-pixel) | Vos propres pixels qui reçoivent les conversions des campagnes que vous avez revendiquées. |

### Analytique

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

| Ressource | À quoi elle sert |
| - | - |
| [Statistiques](https://docs.whop.com/fr/api-reference/stats/stats) | Rapports agrégés sur les finances, l'audience et le trafic. |
| [Personnes](https://docs.whop.com/fr/api-reference/people/person) | Visiteurs et clients d'un compte, avec leurs profils d'identité, d'achat et de trafic. |
| [Événements](https://docs.whop.com/fr/api-reference/events/event) | Événements de conversion et d'engagement suivis pour l'attribution. |
| [Exports](https://docs.whop.com/fr/api-reference/exports/export) | Exports CSV asynchrones des données du tableau de bord d'un compte. |
| [Intelligence économique](https://docs.whop.com/fr/api-reference/economic-intelligence/economic-intelligence) | Ce qu'un compte devrait faire ensuite pour croître, généré à partir de ses propres données. |

### 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.

| Ressource | À quoi elle sert |
| - | - |
| [Canaux](https://docs.whop.com/fr/api-reference/channels/channel) | Canaux de chat privés, communautaires et de support. |
| [Membres de canal](https://docs.whop.com/fr/api-reference/channel-members/channel-member) | Participants d'un canal et état d'adhésion personnel. |
| [Messages](https://docs.whop.com/fr/api-reference/messages/message) | Messages de chat, pièces jointes, réactions et sondages. |
| [Livestreams](https://docs.whop.com/fr/api-reference/livestreams/livestream) | Diffusions vidéo en direct dans une expérience, et leurs enregistrements. |
| [Notifications](https://docs.whop.com/fr/api-reference/notifications/notification) | Le fil de notifications de l'utilisateur : badges non lus, marquage comme lu, envois par les apps et catalogue de sujets. |
| [Adresses e-mail](https://docs.whop.com/fr/api-reference/email-addresses/email-address) | Boîtes e-mail sur les domaines d'un compte, pour envoyer et recevoir des e-mails. |
| [Automatisations](https://docs.whop.com/fr/api-reference/automations/automation) | Workflows qu'un événement webhook ou une requête de déclenchement lance pour chaque membre, exécutant des étapes programmées qui leur envoient des messages. |
| [Étapes d'automatisation](https://docs.whop.com/fr/api-reference/automation-steps/automation-step) | Les étapes d'attente, d'e-mail et de message des versions d'une automatisation. |
| [Inscriptions aux automatisations](https://docs.whop.com/fr/api-reference/automation-enrollments/automation-enrollment) | Les membres qui suivent une automatisation, et l'étape sur laquelle chacun est en attente. |

### Partenaires

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

| Ressource | À quoi elle sert |
| - | - |
| [Partenaires](https://docs.whop.com/fr/api-reference/partners/partner) | Votre profil partenaire, vos liens de parrainage, vos taux de rémunération et vos entreprises parrainées. |
| [Demandes de parrainage partenaire](https://docs.whop.com/fr/api-reference/partner-referral-requests/partner-referral-request) | Demandez l'attribution d'une entreprise ou d'un partenaire et gérez l'approbation. |

### Main-d'œuvre

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

| Ressource | À quoi elle sert |
| - | - |
| [Bounties](https://docs.whop.com/fr/api-reference/bounties/bounty) | Tâches rémunérées avec soumissions vérifiées et récompenses placées sous séquestre. |
| [Soumissions de bounty](https://docs.whop.com/fr/api-reference/bounty-submissions/bounty-submission) | Travail soumis à un bounty, de la tentative jusqu'au versement. |

### Médias

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

| Ressource | À quoi elle sert |
| - | - |
| [Fichiers](https://docs.whop.com/fr/api-reference/files/file) | Téléversez des fichiers et joignez-les partout où Whop accepte des documents. |
| [Médias](https://docs.whop.com/fr/api-reference/media/media) | Ressources générées par IA, facturées sur un solde, et pouvant être jointes partout où les fichiers sont acceptés. |

### Développeur

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

| Ressource | À quoi elle sert |
| - | - |
| [Clés API](https://docs.whop.com/fr/api-reference/api-keys/api-key) | Identifiants programmatiques pour un compte ou une app. |
| [Webhooks](https://docs.whop.com/fr/api-reference/webhooks/webhook) | Notifications d'événements envoyées à votre serveur au fur et à mesure qu'ils se produisent. |
| [Permissions](https://docs.whop.com/fr/api-reference/permissions/permission) | Ce que vos identifiants sont autorisés à faire sur une ressource. |
| [Journaux d'API](https://docs.whop.com/fr/api-reference/api-logs/api-log) | Requêtes effectuées vers l'API de Whop avec les clés API de votre compte. |
| [Feedback](https://docs.whop.com/fr/api-reference/feedback/feedback) | Problèmes et questions sans réponse envoyés à Whop pour examen. |


## Related topics

- [Versions de l'API](https://docs.whop.com/fr/developer/api/versioning.md)
- [Démarrage rapide de l'API Whop](https://docs.whop.com/fr/developer/quickstart.md)
- [Concepts clés de l'API Whop](https://docs.whop.com/fr/developer/concepts.md)
