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

# Migrer depuis les versions précédentes

> Migrez une intégration depuis l'API v2 ou l'API GraphQL publique. Trouvez l'équivalent dans la Current API de chaque route ou opération et ce qui fonctionne différemment.

Whop retire deux anciennes API. Toutes deux sont remplacées par la Current API à l'adresse `https://api.whop.com/api/v1`, avec les mêmes clés API.

| Si votre intégration appelle | Elle cesse de fonctionner le | Guide |
| - | - | - |
| `https://api.whop.com/api/v2` ou `https://api.whop.com/v2` | 13 novembre 2026 | [API v2](#v2) |
| `https://api.whop.com/public-graphql`, ou utilise le paquet `@whop/api` | 26 octobre 2026 | [GraphQL public](#public-graphql) |

## Passer à la Current API

**1. Conservez votre clé API**

La Current API utilise les mêmes clés API de compte et d'application. Si une requête renvoie `403`, il manque à la clé la permission requise par cet endpoint. Ajoutez-la dans **Developer → API keys**, ou demandez-la dans les permissions de votre application.

**2. Installez le SDK et fixez une version**

Les SDK officiels appellent la Current API et envoient la version d'API pour laquelle ils ont été conçus. Si vous utilisez `@whop/api`, remplacez-le par `@whop/sdk`. Ses helpers `withUser` et `withCompany` n'ont pas d'équivalent : passez plutôt l'ID de l'utilisateur ou du compte à chaque requête.

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: process.env.WHOP_API_KEY });

const access = await client.users.checkAccess({
  id: "user_xxxxxxxxxxxxx",
  resource_id: "exp_xxxxxxxxxxxxx",
});
```

```python Python theme={null}
import os

from whop_sdk import Whop

client = Whop(token=os.environ["WHOP_API_KEY"])

membership = client.memberships.retrieve("mem_xxxxxxxxxxxxx")
```

```bash cURL theme={null}
curl https://api.whop.com/api/v1/memberships/mem_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-08-21-1"
```

Si vous appelez l'API sans SDK, envoyez `Api-Version-Date` à chaque requête. [Versions de l'API](https://docs.whop.com/fr/developer/api/versioning.md) explique comment fixer une version.

**3. Remplacez chaque appel**

Utilisez l'onglet correspondant à l'API que vous quittez, puis supprimez l'ancienne URL de base ou l'ancien paquet de votre code.

> [tab] API v2
>
> ### Trouver vos appels v2
>
> Chaque réponse v2 comporte trois en-têtes :
>
> | En-tête | Exemple | Signification |
> | - | - | - |
> | `Deprecation` | `@1791417600` | Whop a déprécié cet endpoint. La valeur est la date de dépréciation en secondes Unix. |
> | `Sunset` | `Fri, 13 Nov 2026 00:00:00 GMT` | L'API v2 cesse de fonctionner le 13 novembre 2026. |
> | `Link` | `<https://api.whop.com/api/v1/memberships/mem_xxxxxxxxxxxxx>; rel="successor-version", <https://docs.whop.com/developer/api/migrate-from-previous-versions#v2>; rel="deprecation"` | L'URL `successor-version` est la requête de la Current API qui remplace celle-ci. L'URL `deprecation` correspond à ce guide. |
>
> Journalisez les réponses qui incluent `Deprecation` pour retrouver chaque appel v2 que votre intégration effectue encore.
>
> ### Correspondance des routes
>
> #### Adhésions et licences
>
> | Route v2 | Current API | Remarques |
> | - | - | - |
> | `GET /memberships` | `GET /memberships` | Pagination par curseur. Voir [Pagination](#pagination). Remplacez `discord_id=<id>` par `external_account=discord_<id>`. |
> | `GET /memberships/{id}` | `GET /memberships/{id}` | Accepte également une clé de licence à la place de l'ID `mem_`. |
> | `POST /memberships/{id}` | `PATCH /memberships/{id}` | Envoyez `metadata` pour fusionner les clés. Envoyez `{}` pour le vider. |
> | `POST /memberships/{id}/cancel` | `POST /memberships/{id}/cancel` | Passez `cancel_at_period_end: true` pour conserver l'accès jusqu'à la date de renouvellement. |
> | `POST /memberships/{id}/terminate` | `POST /memberships/{id}/cancel` | Omettez `cancel_at_period_end` pour révoquer l'accès immédiatement. |
> | `POST /memberships/{id}/add_free_days` | `POST /memberships/{id}/extend` | |
> | `POST /memberships/{id}/validate_license` | `GET /memberships/{id}` et `PATCH /memberships/{id}` | Vérifiez la clé et associez une machine depuis votre serveur. Voir [Clés de licence](#license-keys). |
> | `GET /licenses` | `GET /memberships` | Chaque adhésion possède une `license_key` lorsque son produit inclut l'application Software. |
>
> #### Membres et clients
>
> | Route v2 | Current API | Remarques |
> | - | - | - |
> | `GET /members` | `GET /members` | |
> | `GET /customers` | `GET /members` | Les clients et les membres sont la même ressource. |
> | `GET /members/{search}` | `GET /members` | Filtrez avec `user_ids` ou `query`. `GET /members/{id}` n'accepte qu'un ID `mber_`. Pour trouver un membre par son ID Discord, appelez `GET /memberships?external_account=discord_<id>` et lisez le `member_id` de chaque adhésion. |
> | `GET /customers/{search}` | `GET /members` | Comme ci-dessus. |
>
> #### Paiements et checkout
>
> | Route v2 | Current API | Remarques |
> | - | - | - |
> | `GET /payments` | `GET /payments` | Les filtres sont au singulier, comme `status` et `membership_id`. |
> | `GET /payments/{id}` | `GET /payments/{id}` | |
> | `POST /payments/{id}/refund` | `POST /payments/{id}/refund` | |
> | `GET /payment_fees?payment_id=` | `GET /payments/{id}/fees` | |
> | `GET /payment_methods` | `GET /payment_methods` | |
> | `POST /checkout_requests` | `POST /payments` | Passez `member_id` (`mber_`) et `payment_method_id`. La réponse est le paiement. |
> | `GET /checkout_requests/{id}` | `GET /payments/{id}` | `POST /payments` renvoie directement le paiement, vous n'avez donc pas besoin d'interroger l'API en boucle. |
> | `GET /checkout_sessions` | `GET /checkout_configurations` | Les sessions de checkout s'appellent désormais des configurations de checkout. |
> | `GET /checkout_sessions/{id}` | `GET /checkout_configurations/{id}` | |
> | `POST /checkout_sessions` | `POST /checkout_configurations` | La réponse inclut `purchase_url`. |
> | `DELETE /checkout_sessions/{id}` | `DELETE /checkout_configurations/{id}` | |
>
> #### Produits et plans
>
> Les plans s'appellent désormais des variantes. Les ID de variantes conservent le préfixe `plan_`, donc les ID enregistrés fonctionnent toujours.
>
> | Route v2 | Current API | Remarques |
> | - | - | - |
> | `GET /products`, `GET /access_passes` | `GET /products` | Les access passes s'appellent désormais des produits. |
> | `GET /products/{id}`, `GET /access_passes/{id}` | `GET /products/{id}` | |
> | `POST /products/{id}`, `POST /access_passes/{id}` | `PATCH /products/{id}` | |
> | `GET /plans` | `GET /variants` | |
> | `GET /plans/{id}` | `GET /variants/{id}` | |
> | `POST /plans` | `POST /variants` | |
> | `POST /plans/{id}` | `PATCH /variants/{id}` | |
> | `POST /plans/{id}/create_quick_link` | `POST /variants` | Créez une variante avec `visibility: "quick_link"`, `stock` et `short_link`. La Current API ne copie pas un plan existant : envoyez donc également ses champs de prix. |
> | `GET /promo_codes` | `GET /promo_codes` | |
> | `GET /promo_codes/{id}` | `GET /promo_codes/{id}` | |
> | `POST /promo_codes` | `POST /promo_codes` | |
> | `POST /promo_codes/{id}` | `POST /promo_codes/{id}/activate`, `POST /promo_codes/{id}/deactivate` | Ne couvre que `status`. Créez un nouveau code promo pour modifier ses variantes, son stock ou ses métadonnées. Désactivez ensuite l'ancien. |
> | `DELETE /promo_codes/{id}` | `DELETE /promo_codes/{id}` | |
>
> #### Compte, expériences, avis et webhooks
>
> | Route v2 | Current API | Remarques |
> | - | - | - |
> | `GET /company` | `GET /accounts/me` | |
> | `GET /experiences` | `GET /experiences` | |
> | `GET /experiences/{id}` | `GET /experiences/{id}` | |
> | `POST /experiences/{id}` | `PATCH /experiences/{id}` | |
> | `DELETE /experiences/{id}` | `DELETE /experiences/{id}` | |
> | `GET /reviews` | `GET /reviews` | |
> | `GET /reviews/{id}` | `GET /reviews/{id}` | |
> | `GET /webhooks` | `GET /webhooks` | |
> | `GET /webhooks/{id}` | `GET /webhooks/{id}` | |
> | `POST /webhooks` | `POST /webhooks` | Voir [Webhooks](#webhooks). |
> | `POST /webhooks/{id}` | `PATCH /webhooks/{id}` | |
> | `DELETE /webhooks/{id}` | `DELETE /webhooks/{id}` | |
>
> ### Ce qui a changé depuis la v2
>
> #### Mises à jour partielles
>
> La v2 mettait à jour une ressource avec `POST /resource/{id}`. La Current API utilise `PATCH /resource/{id}` et ne modifie que les champs que vous envoyez.
>
> #### Clés de licence
>
> Le `validate_license` de la v2 vérifiait une clé et l'associait à une machine en un seul appel. Dans la Current API, votre serveur récupère l'adhésion à partir de la clé de licence, vérifie son `status` et écrit un ID matériel dans `metadata` la première fois que quelqu'un utilise la clé. Le [guide SaaS](https://docs.whop.com/fr/supported-business-models/saas.md#license-key-integration) contient l'exemple complet.
>
> Conservez ces appels sur votre serveur. La clé API de votre compte peut modifier chaque adhésion de votre entreprise : ne l'intégrez donc jamais dans un logiciel téléchargeable.
>
> #### Webhooks au format v2
>
> Les webhooks créés via la v2 continuent d'envoyer des payloads au format v2. Pour recevoir le format actuel, créez un nouveau webhook depuis le tableau de bord ou avec `POST /webhooks`, déplacez-y votre gestionnaire, puis supprimez le webhook v2. [Webhooks](https://docs.whop.com/fr/developer/guides/webhooks.md) couvre la vérification des signatures et les types d'événements.

> [tab] GraphQL public
>
> ### Trouver vos appels GraphQL
>
> Si votre application importe `WhopServerSdk` ou `makeWhopServerSdk` depuis `@whop/api`, elle appelle l'API GraphQL. Chaque méthode de ce client, comme `whopSdk.access.checkIfUserHasAccessToExperience`, envoie une opération GraphQL portant le même nom.
>
> Chaque réponse GraphQL comporte également ces en-têtes :
>
> | En-tête | Exemple | Signification |
> | - | - | - |
> | `Deprecation` | `@1789948800` | Whop a déprécié cette API. La valeur est la date de dépréciation en secondes Unix. |
> | `Sunset` | `Mon, 26 Oct 2026 00:00:00 GMT` | L'API GraphQL cesse de fonctionner le 26 octobre 2026. |
> | `Link` | `<https://docs.whop.com/developer/api/migrate-from-previous-versions#public-graphql>; rel="deprecation"` | Ce guide. |
>
> Recherchez `@whop/api` dans votre code, ou journalisez les réponses qui incluent `Deprecation`, pour retrouver chaque appel que votre application effectue encore.
>
> > [!NOTE]
> >
> > `verifyUserToken` de `@whop/api` vérifie l'en-tête `x-whop-user-token` localement et n'appelle jamais l'API GraphQL : il continue donc de fonctionner après la date de fin. [Authentification](https://docs.whop.com/fr/developer/guides/authentication.md) explique comment vérifier le jeton dans d'autres langages.
>
> ### Correspondance des opérations
>
> #### Vérifications d'accès
>
> La plupart des applications appellent l'une de ces opérations à chaque chargement de page. Toutes trois correspondent à un seul endpoint qui prend l'ID de l'utilisateur et l'ID de l'expérience, du produit ou du compte.
>
> | Opération GraphQL | Current API | Remarques |
> | - | - | - |
> | `checkIfUserHasAccessToExperience` | `GET /users/{id}/access/{resource_id}` | Passez un ID `exp_` comme `resource_id`. |
> | `checkIfUserHasAccessToAccessPass` | `GET /users/{id}/access/{resource_id}` | Passez un ID `prod_`. Les access passes s'appellent désormais des produits. |
> | `checkIfUserHasAccessToCompany` | `GET /users/{id}/access/{resource_id}` | Passez un ID `biz_`. |
>
> La réponse contient `has_access` et `access_level`, qui vaut `customer`, `admin` ou `no_access`, les mêmes valeurs que `hasAccess` et `accessLevel` en GraphQL.
>
> #### Chat et messages
>
> | Opération GraphQL | Current API | Remarques |
> | - | - | - |
> | `listMessagesFromChat` | `GET /messages` | Passez l'ID de l'expérience de chat comme `channel_id`. Voir [Arrêter d'interroger le chat en boucle](#stop-polling-chat). |
> | `sendMessageToChat` | `POST /messages` | Passez l'ID de l'expérience de chat comme `channel_id` et le texte comme `content`. |
> | `sendDirectMessageToUser` | `POST /channels`, puis `POST /messages` | Créez la conversation avec `kind` défini sur `private` et le destinataire dans `participant_user_ids`, puis envoyez le message à son ID comme `channel_id`. |
> | `listDirectMessageConversations` | `GET /channels` | Passez `kind=private`. |
>
> #### Utilisateurs
>
> | Opération GraphQL | Current API | Remarques |
> | - | - | - |
> | `getUser` | `GET /users/{id}` | |
> | `getCurrentUser` | `GET /users/me` | Renvoie l'utilisateur auquel appartient le jeton. Avec une clé API d'application, lisez l'ID de l'utilisateur depuis `verifyUserToken` et appelez `GET /users/{id}`. |
> | `listUsersForExperience` | `GET /members` | Filtrez avec `product_ids`. |
>
> #### Expériences et produits
>
> | Opération GraphQL | Current API | Remarques |
> | - | - | - |
> | `getExperience` | `GET /experiences/{id}` | |
> | `listExperiences` | `GET /experiences` | Filtrez avec `product_id` ou `app_id`. |
> | `getAccessPass` | `GET /products/{id}` | |
> | `listAccessPasses` | `GET /products` | |
> | `listAccessPassesForExperience` | `GET /products` | |
> | `createAccessPass` | `POST /products` | |
> | `updateAccessPass` | `PATCH /products/{id}` | |
> | `deleteAccessPass` | `DELETE /products/{id}` | |
> | `listPlans` | `GET /variants` | Les plans s'appellent désormais des variantes. Les ID de variantes conservent le préfixe `plan_`. |
>
> #### Votre compte
>
> | Opération GraphQL | Current API | Remarques |
> | - | - | - |
> | `getCompany` | `GET /accounts/me` | Les entreprises (companies) s'appellent désormais des comptes. |
> | `listMemberships` | `GET /memberships` | |
> | `listMembers`, `getMember` | `GET /members`, `GET /members/{id}` | |
> | `listAuthorizedUsers` | `GET /authorized_users` | |
> | `listWaitlistEntries` | `GET /waitlist_entries` | |
> | `listReceiptsForCompany` | `GET /payments` | |
>
> #### Paiements
>
> | Opération GraphQL | Current API | Remarques |
> | - | - | - |
> | `chargeUser` | `POST /payments` | |
> | `createCheckoutSession` | `POST /checkout_configurations` | Les sessions de checkout s'appellent désormais des configurations de checkout. La réponse inclut `purchase_url`. |
> | `payUser` | `POST /transfers` | |
> | `listInvoices`, `getInvoice`, `createInvoice` | `GET /invoices`, `GET /invoices/{id}`, `POST /invoices` | |
> | `listPromoCodes`, `createPromoCode` | `GET /promo_codes`, `POST /promo_codes` | |
> | `listAffiliates`, `createAffiliate` | `GET /affiliates`, `POST /affiliates` | |
>
> #### Fichiers et notifications
>
> | Opération GraphQL | Current API | Remarques |
> | - | - | - |
> | `uploadMedia`, `processAttachment` | `POST /files`, puis `POST /files/{id}/complete` | |
> | `getAttachment` | `GET /files/{id}` | |
> | `sendPushNotification` | `POST /notifications` | Ciblez un `experience_id` ou une liste de `user_ids`. |
>
> #### Cours et forums
>
> | Opération GraphQL | Current API | Remarques |
> | - | - | - |
> | `listCoursesForExperience` | `GET /courses` | Filtrez avec `experience_id`. |
> | `listCoursesForCompany` | `GET /courses` | Filtrez avec `account_id`. |
> | `getCourse` | `GET /courses/{id}` | |
> | `getLesson` | `GET /course_lessons/{id}` | |
> | `getUserLessonInteractions` | `GET /course_lesson_interactions` | Filtrez avec `user_id`, `lesson_id` ou `course_id`. |
> | `markLessonAsCompleted` | `POST /course_lessons/{lesson_id}/mark_as_completed` | |
> | `listForumPostsFromForum` | `GET /forum_posts` | Filtrez avec `experience_id`. |
> | `createForumPost` | `POST /forum_posts` | |
>
> #### Opérations sur les webhooks
>
> | Opération GraphQL | Current API | Remarques |
> | - | - | - |
> | `listWebhooks`, `getWebhook` | `GET /webhooks`, `GET /webhooks/{id}` | |
> | `createWebhook` | `POST /webhooks` | |
> | `updateWebhook` | `PATCH /webhooks/{id}` | |
> | `deleteWebhook` | `DELETE /webhooks/{id}` | |
> | `testWebhook` | `POST /webhooks/{id}/test` | |
>
> Si une opération utilisée par votre application ne figure pas dans la liste, recherchez la ressource dans la [référence de l'API](https://docs.whop.com/fr/api-reference.md), ou contactez le support en indiquant le nom de l'opération.
>
> ### Changements de comportement
>
> #### Arrêter d'interroger le chat en boucle
>
> Les applications qui réagissent aux messages de chat appelaient souvent `listMessagesFromChat` à intervalles réguliers. Abonnez-vous plutôt au webhook `chat.message.created` : Whop envoie chaque nouveau message à votre serveur dès sa publication, vous n'avez donc pas besoin d'interroger l'API en boucle. N'utilisez `GET /messages` que pour charger l'historique.
>
> #### Noms des champs
>
> Les champs de la Current API utilisent le `snake_case` (`has_access`, `access_level`) là où GraphQL utilisait le `camelCase` (`hasAccess`, `accessLevel`). Les ID de ressources conservent leurs préfixes, donc les ID que vous avez enregistrés fonctionnent toujours.

## Pagination

La v2 paginait avec `page` et `per` et renvoyait `pagination.current_page` et `pagination.total_page`. Les listes de la Current API renvoient un tableau `data` et un objet `page_info`. Passez `first` pour définir la taille de la page et `after` avec le `page_info.end_cursor` précédent pour obtenir la page suivante. Arrêtez-vous lorsque `page_info.has_next_page` vaut `false`. Les SDK gèrent la pagination à votre place.

```typescript TypeScript theme={null}
for await (const membership of client.memberships.list({ product_id: "prod_xxxxxxxxxxxxx" })) {
  console.log(membership.id);
}
```

```python Python theme={null}
for membership in client.memberships.list(product_id="prod_xxxxxxxxxxxxx"):
    print(membership.id)
```

## Étapes suivantes

> [card] [Versions de l'API](https://docs.whop.com/fr/developer/api/versioning.md)
>
> Fixez une version pour que les changements ultérieurs ne cassent jamais votre intégration.

> [card] [Webhooks](https://docs.whop.com/fr/developer/guides/webhooks.md)
>
> Vérifiez les signatures, gérez le format d'événement actuel et recevez les messages de chat au lieu d'interroger l'API en boucle.

> [card] [Gérer les adhésions](https://docs.whop.com/fr/developer/guides/memberships.md)
>
> Annulez, suspendez, prolongez et mettez à jour des adhésions.

> [card] [Vues d'application](https://docs.whop.com/fr/developer/guides/app-views.md)
>
> Vérifiez l'accès des membres dans les vues d'expérience et de tableau de bord.


## Related topics

- [Présentation de l'API Whop](https://docs.whop.com/fr/api-reference/overview.md)
- [Migrer depuis les factures legacy](https://docs.whop.com/fr/developer/guides/migrate-from-legacy-invoices.md)
- [Versions de l'API](https://docs.whop.com/fr/developer/api/versioning.md)
