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

# Versions de l'API

> Fixez vos requêtes sur une version datée de l'API afin que les changements apportés à l'API ne cassent jamais votre intégration.

La Current API est versionnée par dates. Les changements incompatibles ne sont publiés que dans une nouvelle version datée que vous choisissez d'adopter. Fixez une version, et les formats de requête et de réponse sur lesquels vous vous êtes appuyé ne changeront jamais. Les SDK officiels envoient automatiquement la version utilisée pour les générer.

```bash theme={null}
curl https://api.whop.com/api/v1/variants \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-07-23"
```

| Vous envoyez | Vous obtenez |
| - | - |
| `Api-Version-Date: 2026-07-23` | L'API telle qu'elle fonctionnait à cette date |
| Aucun en-tête, la clé API a une version fixée | La version de l'API enregistrée sur la clé API |
| Ni en-tête, ni version enregistrée | Le comportement d'origine `2025-01-01` |
| Une date inconnue | Une erreur `400` avec les versions prises en charge |

> [!NOTE]
>
> **Si vous ne passez pas d'`Api-Version-Date` et n'avez pas de version fixée enregistrée sur la clé API, le modèle d'API stable est utilisé.** Les requêtes sans l'un ni l'autre sont servies avec le comportement antérieur au versionnement, de sorte que les intégrations existantes continuent de fonctionner sans changement. Fixez une version datée pour adopter la dernière API.

## Versions fixées sur les clés API

Les clés API portent leur propre version d'API fixée. Les requêtes authentifiées avec une clé API utilisent cette version lorsqu'elles omettent `Api-Version-Date`. Les clés existantes sans version enregistrée utilisent `2025-01-01`. Les clés nouvellement créées utilisent la dernière version publiée.

Un en-tête `Api-Version-Date` explicite a toujours priorité sur la version fixée de la clé API, ce qui vous permet de tester une mise à niveau avant de modifier la version enregistrée.

Chaque version reçoit automatiquement les nouveaux endpoints et les champs facultatifs. Les changements incompatibles créent une nouvelle version datée, répertoriée dans le journal des modifications ci-dessous.

Lors d'une mise à niveau, passez en revue chaque entrée postérieure à votre version fixée actuelle jusqu'à votre version cible, et pas seulement les entrées du mois cible. En particulier, passer de `2026-07-20` à septembre implique de franchir la migration des membres et adhésions de `2026-07-23`.

## Journal des modifications

Les versions du SDK TypeScript indiquées ci-dessous utilisent par défaut la version d'API de l'entrée correspondante. Remplacer `apiVersionDate` modifie la version de la réponse, mais pas les types du SDK.

**2026-11-17**

Un niveau ne conserve que son niveau et ses points

`level` sur [Retrieve user](https://docs.whop.com/fr/api-reference/users/retrieve-user.md) et [Retrieve account](https://docs.whop.com/fr/api-reference/accounts/retrieve-account.md) contient désormais `current`, `points`, `points_by_source` et `resets_at`, ainsi que `account_level` sur un compte.

Ces champs sont retirés de `level` : `levels`, `points_to_next`, `monthly_qualifying_spend`, `monthly_card_spend`, `monthly_ads_spend` et `monthly_trading_volume`. `boosted` est retiré du `level` d'un compte. Un compte est boosté lorsque son `account_level` est inférieur à `current`.

**2026-11-16-2**

Le `applied_level` d'un niveau devient `current`

`level.applied_level` est renommé en `level.current` sur [Retrieve user](https://docs.whop.com/fr/api-reference/users/retrieve-user.md) et [Retrieve account](https://docs.whop.com/fr/api-reference/accounts/retrieve-account.md). La valeur est inchangée : le niveau qui s'applique, de `0` à `10`.

**2026-11-16-1**

La liste des utilisateurs parrainés cesse de répondre après le 17 novembre

`GET /partners/referred_users` cesse de répondre après le 17 novembre 2026. À partir du 18 novembre, toutes les versions renvoient une erreur `410`. D'ici là, chaque réponse comporte les en-têtes `Deprecation` et `Sunset`. La liste n'a pas de remplaçant.

**2026-11-16**

Les demandes d'attribution adressées à un utilisateur ont pris fin

Les partenaires ne peuvent plus envoyer de demande d'attribution à un utilisateur. Cela s'applique à toutes les versions de l'API, et pas seulement à celle-ci.

[Create a partner referral request](https://docs.whop.com/fr/api-reference/partner-referral-requests/create-a-partner-referral-request.md) rejette `target_user_id`, `target_username` et `target_email` avec une erreur `400` dont le `code` est `user_referral_requests_retired`. Envoyez `account_id` ou `account_url` pour demander l'attribution d'une entreprise. Les demandes envoyées à un utilisateur ne sont plus listées ni récupérables, le filtre `target_user_id` de [list partner referral requests](https://docs.whop.com/fr/api-reference/partner-referral-requests/list-partner-referral-requests.md) ne renvoie aucune demande, et le `user` d'une demande vaut toujours `null`.

**2026-11-14-1**

Le niveau d'un utilisateur est public

[Retrieve user](https://docs.whop.com/fr/api-reference/users/retrieve-user.md) renvoie `level` pour tout utilisateur dont les comptes font partie de Whop Levels, et pas seulement pour vous-même. `level.applied_level` est le niveau de l'utilisateur, de `0` à `10`.

Les autres champs de `level`, comme `points`, `points_by_source`, les montants `monthly_*` et `levels`, valent `null` sauf si vous récupérez votre propre profil avec l'ID réservé `me` et disposez du scope de lecture du solde. Vérifiez s'ils valent `null` avant de les lire.

**2026-11-14**

Lister et récupérer vos propres achats

Avec des identifiants utilisateur, `user_id=me` sur [list payments](https://docs.whop.com/fr/api-reference/payments/list-payments.md) renvoie vos propres paiements. Cela couvre vos achats auprès de tous les comptes et vos paiements sur les comptes pour lesquels vous vendez. Ajoutez l'`account_id` d'un compte auprès duquel vous avez acheté pour ne lister que ces achats. [Retrieve payment](https://docs.whop.com/fr/api-reference/payments/retrieve-payment.md) renvoie un paiement que vous avez effectué.

Un achat affiche ce que vous pouvez voir en tant qu'acheteur. Les champs côté compte, comme `amount_after_fees`, `usd_total`, `holds` et `metadata`, y sont nuls ou vides. `amount_charged` indique ce qui vous a été facturé, frais acheteur compris.

**2026-11-13-1**

Les membres de l'équipe portent leur compte sous forme d'objet

Les membres de l'équipe n'ont plus d'`account_id` au premier niveau. Lisez l'ID du compte depuis `account.id`. L'objet `account` contient également le `title`, la `route` et le `logo_url` du compte.

**2026-11-13**

L'API des prospects est retirée

Les endpoints `/leads` sont dépréciés et ne figurent plus dans la référence de l'API. À partir de cette version, ils renvoient une erreur `410`. Les versions antérieures continuent de fonctionner jusqu'au 20 novembre 2026, avec les en-têtes `Deprecation`, `Sunset` et `Link` vers le successeur. Après cette date, toutes les versions renvoient une erreur `410`.

Chaque prospect est également membre de son entreprise, avec l'ID du prospect dans le `metadata` du membre sous la clé `lead_id`. Utilisez [List members](https://docs.whop.com/fr/api-reference/members/list-members.md) au lieu de lister les prospects. Ajoutez un membre par e-mail avec [Create member](https://docs.whop.com/fr/api-reference/members/create-member.md). Lisez-en un ou mettez-le à jour avec [Retrieve member](https://docs.whop.com/fr/api-reference/members/retrieve-member.md) et [Update member](https://docs.whop.com/fr/api-reference/members/update-member.md).

**2026-11-12**

La liste des utilisateurs parrainés est dépréciée

`GET /partners/referred_users` est déprécié et ne figure plus dans la référence de l'API. Il continue de répondre pour les intégrations existantes, avec un en-tête `Deprecation` sur chaque réponse, et n'a pas de remplaçant.

**2026-11-11**

Les factures récurrentes incluent les frais initiaux

La création d'une facture ou le remplacement de ses articles facture l'`initial_price` d'une variante récurrente plus son `renewal_price` sur la première facture. Les factures de renouvellement ne facturent que le `renewal_price`. La modification d'autres champs conserve les prix enregistrés de la facture.

Le paiement de la première facture démarre immédiatement une période de facturation payante, sans l'essai de la variante. Un nombre fini de paiements inclut cette facture : des frais initiaux de 75 $avec trois versements de 40$ facturent 115 $, puis 40 $, puis 40 \$.

**2026-11-10-1**

L'offre Economic Intelligence renouvelable est `3_days`

SDK TypeScript : [`@whop/sdk@2.8.0`](https://unpkg.com/@whop/sdk@2.8.0/dist/esm/BaseClient.mjs).

L'offre renouvelable dans `economic_intelligence_offers` sur [Retrieve account preferences](https://docs.whop.com/fr/api-reference/accounts/retrieve-account-preferences.md) a désormais la clé `3_days`. Elle se renouvelle tous les 3 jours. Pour l'activer, envoyez `economic_intelligence_duration_key: "3_days"` à [Update account preferences](https://docs.whop.com/fr/api-reference/accounts/update-account-preferences.md). La clé `weekly` est rejetée.

**2026-11-10**

Les statistiques d'annonces n'acceptent plus `clicks`

Le champ `clicks` est retiré de [Create ad stats](https://docs.whop.com/fr/api-reference/ads/create-ad-stats.md). Les `clicks` d'une heure correspondent aux pages vues de l'annonce enregistrées par le pixel Whop, et une valeur `clicks` envoyée dans n'importe quelle version est ignorée.

**2026-11-07**

API de chat : canaux, membres et messages

Intégrez le chat à votre application. Les [canaux](https://docs.whop.com/fr/api-reference/channels/list-channels.md) couvrent les messages directs, les discussions de groupe, les chats de communauté et les chats de support. Les [membres de canal](https://docs.whop.com/fr/api-reference/channel-members/list-channel-members.md) permettent d'ajouter et de retirer des personnes. Les [messages](https://docs.whop.com/fr/api-reference/messages/list-messages.md) peuvent être envoyés, modifiés, épinglés, faire l'objet de réactions et de votes.

`/messages` change de format à partir de cette version. Un message possède `channel_id` et `author` au lieu de `user`, et `edited` et `pinned` au lieu de `is_edited` et `is_pinned`. Épinglez avec `POST /messages/{id}/pin` et `/unpin` au lieu d'une mise à jour. [Delete message](https://docs.whop.com/fr/api-reference/messages/delete-message.md) renvoie `204`. Réagissez et votez avec `POST /messages/{id}/react`, `/unreact` et `/vote`.

**2026-11-06**

Le type de ligne de grand livre `bank_transfer` est retiré

Les dépôts bancaires Iron sont des lignes d'[activité du grand livre](https://docs.whop.com/fr/api-reference/ledgers/ledger-activity) avec le `line_type` `onchain_deposit`, et leur `source.sender_address` vaut `iron`. Le filtre `line_types` de l'activité financière et des rapports financiers n'accepte plus `bank_transfer`.

**2026-11-05-1**

Les listes de versements incluent la Whop Card

[List saved payout methods](https://docs.whop.com/fr/api-reference/payouts/list-saved-payout-methods.md) inclut la Whop Card du compte. [List payouts](https://docs.whop.com/fr/api-reference/payouts/list-payouts.md) inclut les versements qui ont transféré des fonds vers celle-ci. Une méthode de versement enregistrée, ainsi que le `payout_method` d'un [versement](https://docs.whop.com/fr/api-reference/payouts/payout), possède un `type`. `external` envoie les fonds hors de Whop. `whop_card` transfère les fonds vers la propre Whop Card du compte. Excluez les méthodes `whop_card` d'une liste dans laquelle un utilisateur choisit où retirer ses fonds.

**2026-11-05**

Un dossier de litige en cours de dépôt indique `generating_response`

Un [litige](https://docs.whop.com/fr/api-reference/disputes/dispute) dont les preuves sont chez le processeur de paiement et pas encore acceptées indique `generating_response` au lieu de `under_review`. Lorsque le processeur les accepte, le litige passe à `under_review`. Lorsque le processeur les refuse, le litige revient à `needs_response`, et sa récupération fournit `submission_failure_reason`. Les deux transitions sont envoyées sous forme de `dispute.updated`.

**2026-11-04-1**

Whop Levels : le niveau appliqué est `applied_level`

Sur le `level` d'un [utilisateur](https://docs.whop.com/fr/api-reference/users/user) et d'un [compte](https://docs.whop.com/fr/api-reference/accounts/account), `current` devient `applied_level`, et `processing_rate_percentage` est retiré. Lisez le pourcentage de traitement standard des cartes d'un niveau depuis son entrée dans `levels`, et le taux propre d'un compte depuis [Retrieve account fees](https://docs.whop.com/fr/api-reference/accounts/retrieve-account-fees.md). Le `level` d'un compte ajoute également `account_level`, le niveau atteint par ses propres points.

**2026-11-04**

Les certifications publicitaires sont supprimées

Whop ne propose plus de certifications publicitaires. [Retrieve account preferences](https://docs.whop.com/fr/api-reference/accounts/retrieve-account-preferences.md) et [Update account preferences](https://docs.whop.com/fr/api-reference/accounts/update-account-preferences.md) ne renvoient plus `ads_certifications`, et une mise à jour ne l'accepte plus.

**2026-11-03-1**

Les comptes connectés deviennent des sous-comptes

Les comptes enfants de plateforme s'appellent désormais des sous-comptes. Sur [List payments](https://docs.whop.com/fr/api-reference/payments/list-payments.md) et [List disputes](https://docs.whop.com/fr/api-reference/disputes/list-disputes.md), ainsi que sur leurs endpoints de synthèse, `include_connected_accounts` devient `include_subaccounts`. Sur [Update account preferences](https://docs.whop.com/fr/api-reference/accounts/update-account-preferences.md), `covers_connected_account_negative_balances` devient `covers_subaccount_negative_balances`, à la fois dans la réponse et dans le corps de la mise à jour. Les lignes de rapports financiers qui utilisaient le regroupement `connected_accounts` utilisent désormais `subaccounts`.

**2026-11-03**

Les demandes de versement nécessitent un devis

[Create a payout](https://docs.whop.com/fr/api-reference/payouts/create-payout.md) exige désormais `quote_token`. Appelez d'abord `POST /payouts/quotes`, puis soumettez son jeton avec les mêmes détails de versement avant l'expiration du devis. Les devis manquants ou invalides renvoient une erreur `400` avec `invalid_payout_quote`. Lorsque vous relancez un versement incertain, renvoyez le jeton d'origine et l'`Idempotency-Key` afin que le versement existant puisse être récupéré même après l'expiration de son devis.

**2026-11-02-1**

Le client d'une facture ne peut plus changer après la création du brouillon

Sur [Update invoice](https://docs.whop.com/fr/api-reference/invoices/update-invoice.md), un `member_id` différent du client actuel du brouillon renvoie une erreur `400`, y compris `null`. Pour facturer quelqu'un d'autre, [annulez d'abord le brouillon](https://docs.whop.com/fr/api-reference/invoices/void-invoice.md). Puis [créez une nouvelle facture](https://docs.whop.com/fr/api-reference/invoices/create-invoice.md). Un brouillon enregistré sans client peut toujours en recevoir un.

**2026-11-02**

Les connexions Snapchat sont supprimées

[Connect an External Account](https://docs.whop.com/fr/api-reference/external-accounts/connect-an-external-account.md) n'accepte plus `snapchat`, la dernière plateforme qui utilisait le scope `advertise` ; son champ `scopes` disparaît donc également. L'envoi de `snapchat` ou de tout `scopes` renvoie une erreur `400`.

**2026-10-30**

Les campagnes publicitaires abandonnent bid\_type

Les campagnes publicitaires n'acceptent et ne renvoient plus `bid_type`. Chaque réseau publicitaire choisit sa propre stratégie d'enchères de campagne, et `desired_cost_per_result` est votre objectif sur chaque réseau : il ne modifie jamais la façon dont les annonces enchérissent. L'envoi de `bid_type` renvoie une erreur `400`.

**2026-10-29-8**

Les connexions publicitaires sont supprimées

Les annonces sont diffusées sous les propres pages et profils de Whop, vous n'avez donc plus à connecter de comptes pour la publicité. [Connect an External Account](https://docs.whop.com/fr/api-reference/external-accounts/connect-an-external-account.md) n'accepte plus `meta_business`, et `tiktok` n'accepte plus le scope `advertise`. L'envoi de l'un ou l'autre renvoie une erreur `400`.

**2026-10-29-5**

Les règles de valeur de conversion sont supprimées

Les règles de valeur de conversion sont supprimées, et les réseaux publicitaires reçoivent la valeur d'origine de chaque conversion. Le listage des règles de valeur de conversion est déprécié : il renvoie une liste vide, n'est plus documenté, et ses réponses comportent un en-tête `Deprecation`. Tous les autres endpoints de règles de valeur de conversion renvoient une erreur `410`.

**2026-10-29-4**

Les audiences abandonnent les règles d'engagement, et les cibles de règles abandonnent platform

Les audiences ne peuvent plus être construites à partir de l'engagement social. Les audiences d'engagement existantes apparaissent toujours dans les listes avec le `source_type` `engagement`, mais elles ne renvoient plus `engagement`. L'envoi de `engagement`, ou de `engagement` comme `source_type`, à [Create audience](https://docs.whop.com/fr/api-reference/audiences/create-audience.md) renvoie une erreur `400`. Les cibles de règles de valeur de conversion n'acceptent et ne renvoient plus `platform`. Chaque cible couvre tous les réseaux sur lesquels Whop la diffuse, et l'envoi de `platform` sur une cible renvoie une erreur `400`.

**2026-10-29-3**

Les partenaires de comptes externes sont dépréciés

Les annonces en partenariat ne sont plus disponibles. Le listage des partenaires d'un compte externe renvoie une liste vide. L'ajout ou la suppression d'un partenaire renvoie une erreur `400`. Ces endpoints ne sont plus documentés, et leurs réponses comportent un en-tête `Deprecation`.

**2026-10-29-2**

Les duplications abandonnent preserve\_engagement, et les listes de publications et de formulaires de prospects sont dépréciées

La duplication d'une campagne publicitaire, d'un groupe d'annonces ou d'une annonce n'accepte plus `preserve_engagement`. L'envoyer à [Duplicate an Ad Campaign](https://docs.whop.com/fr/api-reference/ad-campaigns/duplicate-an-ad-campaign.md), [Duplicate an Ad Group](https://docs.whop.com/fr/api-reference/ad-groups/duplicate-an-ad-group.md) ou [Duplicate an Ad](https://docs.whop.com/fr/api-reference/ads/duplicate-an-ad.md) renvoie une erreur `400`. Le listage des publications ou des formulaires de prospects d'un compte externe est déprécié : les deux renvoient une liste vide, ne sont plus documentés, et leurs réponses comportent un en-tête `Deprecation`.

**2026-10-29-1**

Les annonces abandonnent post\_id, et la recherche de ciblage est dépréciée

Les annonces ne renvoient plus `post_id`. La recherche d'options de ciblage de groupes d'annonces et l'estimation de la portée des groupes d'annonces sont dépréciées : les deux continuent de fonctionner, mais ne sont plus documentées, et leurs réponses comportent un en-tête `Deprecation`. Une cible de règle de valeur de conversion peut omettre `platform` pour couvrir tous les réseaux sur lesquels Whop la diffuse.

**2026-10-29**

Les annonces abandonnent les champs propres aux réseaux et l'objectif de notoriété

Les campagnes publicitaires, groupes d'annonces et annonces ne renvoient plus `platform`, et [Create an Ad Campaign](https://docs.whop.com/fr/api-reference/ad-campaigns/create-an-ad-campaign.md) ne l'accepte plus. Les nouvelles campagnes ne peuvent pas utiliser l'objectif `awareness`. Les campagnes de notoriété existantes le renvoient toujours. Les annonces n'acceptent et ne renvoient plus `existing_post_id`, `post_source`, `external_accounts` ou `translations`, et ne renvoient plus `post_thumbnail_url`. L'envoi d'un champ supprimé, ou de `awareness` comme objectif, à [Create an Ad Campaign](https://docs.whop.com/fr/api-reference/ad-campaigns/create-an-ad-campaign.md), [Create ad](https://docs.whop.com/fr/api-reference/ads/create-an-ad.md) ou [Update ad](https://docs.whop.com/fr/api-reference/ads/update-an-ad.md) renvoie une erreur `400`.

**2026-10-28-1**

Les annonces abandonnent les champs avancés de diffusion et de création

Les campagnes publicitaires ne renvoient plus `optimization_goal`. Les groupes d'annonces n'acceptent et ne renvoient plus `optimization_goal`, `conversion_location`, `message_apps`, `minimum_daily_spend`, `dynamic_creative`, `placements`, `frequency_cap` ou `detailed_targeting`, et Whop définit la diffusion à partir de l'`objective` de la campagne. Les annonces n'acceptent et ne renvoient plus `messaging_config`, `multi_advertiser_ads`, `lead_form`, `lead_form_id` ou `music`. L'envoi de l'un de ces champs à [Create ad group](https://docs.whop.com/fr/api-reference/ad-groups/create-an-ad-group.md), [Update ad group](https://docs.whop.com/fr/api-reference/ad-groups/update-an-ad-group.md), [Create ad](https://docs.whop.com/fr/api-reference/ads/create-an-ad.md) ou [Update ad](https://docs.whop.com/fr/api-reference/ads/update-an-ad.md) renvoie une erreur `400` qui nomme le champ.

**2026-10-28**

Les listes de variantes d'un compte excluent les variantes de factures héritées

[List variants](https://docs.whop.com/fr/api-reference/variants/list-variants.md) avec `account_id` exclut les variantes générées pour une facture héritée, y compris celles dont la facture a depuis été supprimée. Pour en lire une, [récupérez la variante](https://docs.whop.com/fr/api-reference/variants/retrieve-variant.md) par son ID. La liste dépréciée `GET /plans` se comporte de la même manière.

**2026-10-27-3**

Les swaps rejettent un montant supérieur au solde du portefeuille

Sur [Create swap](https://docs.whop.com/fr/api-reference/swaps/create-swap.md), un `amount` décimal supérieur au solde `from_token` du portefeuille renvoie une erreur `400`. L'erreur indique le solde disponible. Les versions antérieures lancent le swap, qui échoue ensuite sur la chaîne. La vérification est ignorée lorsque le solde ne peut pas être lu. L'USDT n'est pas vérifié, car un swap USDT peut également puiser dans le solde de la carte.

**2026-10-27-2**

Toutes les autres ressources nomment les variantes « variants »

**Adhésions, membres et entrées de liste d'attente.** Sur les adhésions et les entrées de liste d'attente, `plan_id` devient `variant_id`, et sur la variante intégrée à une entrée de liste d'attente, `plan_type` devient `billing_type`. [Invite to a membership](https://docs.whop.com/fr/api-reference/memberships/invite-to-a-membership.md) et [Create waitlist entry](https://docs.whop.com/fr/api-reference/waitlist-entries/create-waitlist-entry.md) acceptent `variant_id`, et [Approve all waitlist entries](https://docs.whop.com/fr/api-reference/waitlist-entries/approve-all-waitlist-entries.md) accepte et renvoie `variant_id`. [List memberships](https://docs.whop.com/fr/api-reference/memberships/list-memberships.md) filtre avec `variant_id` et `variant_ids`, [List members](https://docs.whop.com/fr/api-reference/members/list-members.md) avec `variant_ids`, et [List waitlist entries](https://docs.whop.com/fr/api-reference/waitlist-entries/list-waitlist-entries.md) avec `variant_id`, au lieu de `plan_id` et `plan_ids`.

**Paiements, factures et litiges.** Sur les paiements, les litiges et les dossiers du Resolution Center, `plan_id` devient `variant_id`, et sur leurs `line_items`, `plan_id` et `plan_title` deviennent `variant_id` et `variant_title`. Sur les `line_items` des devis de paiement et des factures, `plan_id` devient `variant_id`. [List payments](https://docs.whop.com/fr/api-reference/payments/list-payments.md) filtre avec `variant_ids` au lieu de `plan_ids`. [Create payment](https://docs.whop.com/fr/api-reference/payments/create-payment.md) et [Create payment quote](https://docs.whop.com/fr/api-reference/payment-quotes/create-payment-quote.md) acceptent `variant_id` et `variant` au lieu de `plan_id` et `plan`, dans le corps et dans chaque entrée de `line_items`. La création et la mise à jour d'une facture acceptent `variant_id` et `variant` au lieu de `plan_id` et `plan` dans chaque entrée de `items`. Une `variant` en ligne accepte `billing_type` au lieu de `plan_type`. Sur les événements, `related.plan` devient `related.variant`.

**Checkout.** Sur les configurations de checkout, `plan` devient `variant`, et son `plan_type` devient `billing_type`. [Create checkout configuration](https://docs.whop.com/fr/api-reference/checkout-configurations/create-a-checkout-configuration.md) accepte `variant_id` au lieu de `plan_id` et une `variant` en ligne (avec `billing_type`) au lieu de `plan`, et [List checkout configurations](https://docs.whop.com/fr/api-reference/checkout-configurations/list-checkout-configurations.md) filtre avec `variant_id`. Les requêtes et réponses des sessions de checkout utilisent `items[].variant` au lieu de `items[].plan`.

**Codes promo et partenaires.** [List promo codes](https://docs.whop.com/fr/api-reference/promo-codes/list-promo-codes.md) filtre avec `variant_ids` au lieu de `plan_ids`, et [Create promo code](https://docs.whop.com/fr/api-reference/promo-codes/create-promo-code.md) accepte `variant_ids`.

**2026-10-27-1**

Les produits et les variantes nomment les variantes « variants »

Sur les produits, `default_plan` devient `default_variant`. Sur les variantes, et sur les variantes intégrées à un produit, `plan_type` devient `billing_type`. [Create variant](https://docs.whop.com/fr/api-reference/variants/create-variant.md) accepte `billing_type`, et [List variants](https://docs.whop.com/fr/api-reference/variants/list-variants.md) et [List products](https://docs.whop.com/fr/api-reference/products/list-products.md) filtrent avec `billing_types` au lieu de `plan_types`.

Utilisez `/variants` et l'espace de noms `variants` du SDK au lieu de `/plans`. Les endpoints `/plans` répondent toujours dans toutes les versions, avec les en-têtes `Deprecation` et `Link` vers le successeur. Pour prévisualiser les taxes, créez un [devis de paiement](https://docs.whop.com/fr/api-reference/payment-quotes/create-payment-quote.md) au lieu d'appeler `POST /variants/{id}/calculate_tax` ou `POST /plans/{id}/calculate_tax`, qui sont dépréciés de la même manière.

Les ID de variantes conservent le préfixe `plan_`, et les scopes de permission `plan:*` ainsi que les noms d'événements webhook `plan.*` restent inchangés.

**2026-10-27**

Les invitations renvoient le membre de l'équipe en attente

Lorsque [Create team member](https://docs.whop.com/fr/api-reference/team-members/create-team-member.md) envoie une invitation au lieu d'ajouter le membre, la réponse `202` est désormais le membre de l'équipe en attente. Son `status` est `pending` et son ID commence par `ausri_`. La réponse ne contient plus `object` ni `invitation_sent`.

**2026-10-24**

Factures adossées à des reçus

L'API native Invoices utilise des ID `pay_` et des `items` adossés à des variantes, y compris la création de variantes en ligne. La création enregistre un brouillon. Vous pouvez mettre à jour les brouillons et annuler un brouillon dont vous n'avez plus besoin. Le client facturé est un membre. Une adresse e-mail qui n'appartient à aucun utilisateur Whop en crée un. Les `recipient_emails` sont les adresses de livraison propres à la facture, distinctes du membre facturé. Les frais acheteur sont un pourcentage ajustable.

**2026-10-15-1**

Les comptes n'incluent plus stablecoin\_rails

Les comptes n'incluent plus `stablecoin_rails`.

**2026-10-15**

Les types de documents de vérification sont en minuscules

Sur [Create verification](https://docs.whop.com/fr/api-reference/verifications/create-verification.md), ainsi que sur les propriétaires dans `owners`, `document_type` accepte des valeurs en minuscules : `passport`, `id_card`, `drivers` ou `residence_permit`. Le guide des [documents d'identité](https://docs.whop.com/fr/developer/verification/identity-documents.md) indique ceux qu'accepte chaque pays.

**2026-10-14-1**

Le prélèvement par carte d'un dépôt est déplacé sous methods

Sur [Create deposit](https://docs.whop.com/fr/api-reference/deposits/create-deposit.md), le prélèvement sur un moyen de paiement enregistré passe du `card` de premier niveau à `methods.card`, à côté de `bank` et `crypto`. Ses champs sont inchangés, et il vaut toujours `null` sauf si `payment_method_id` a été passé. Les appelants fixés sur une version antérieure conservent le `card` de premier niveau.

**2026-10-14**

Les domaines de moyens de paiement sont dépréciés au profit des domaines

Les endpoints de domaines de moyens de paiement sont dépréciés et ne figurent plus dans la référence de l'API. Ajoutez, vérifiez et supprimez plutôt les domaines Apple Pay avec la capacité `apple_pay` de l'API des [domaines](https://docs.whop.com/fr/api-reference/domains/domain) :

* `GET /payment_method_domains` : `GET /domains` avec `apple_pay=any`, ou `apple_pay=ready` pour les domaines vérifiés. Filtrez par nom d'hôte avec `domain` au lieu de `hostname`.
* `GET /payment_method_domains/{id}` : `GET /domains/{id}`.
* `POST /payment_method_domains` : `POST /domains` avec `domain`, `account_id` et `apple_pay: {}`. Si le compte possède déjà le domaine, `PATCH /domains/{id}` avec `apple_pay: {}`.
* `POST /payment_method_domains/{id}/verify` : `POST /domains/{id}/check`.
* `DELETE /payment_method_domains/{id}` : `PATCH /domains/{id}` avec `apple_pay: null`. `DELETE /domains/{id}` supprime le domaine entier, y compris tout site web hébergé dessus.
* `status: verified` correspond à `apple_pay.state: ready`. `status: pending` correspond à `apple_pay.state: pending` pendant que Whop enregistre le domaine, ou à `action_required` jusqu'à ce que vous hébergiez le fichier d'association et vérifiiez le domaine.

L'enregistrement s'effectue en arrière-plan, donc la création ou la vérification d'un domaine renvoie `pending`. Récupérez le domaine jusqu'à ce que `apple_pay.state` soit `ready` ou `action_required`.

Les endpoints `/payment_method_domains` répondent toujours dans toutes les versions, avec les en-têtes `Deprecation` et `Link` vers le successeur. Un domaine conserve son ID, donc `/domains/{id}` accepte l'ID renvoyé par un domaine de moyen de paiement. L'API des domaines nécessite les permissions `domain:read` et `domain:manage` au lieu de `company:manage_checkout`.

**2026-10-13-1**

Avis natifs

SDK TypeScript : [`@whop/sdk@2.5.0`](https://unpkg.com/@whop/sdk@2.5.0/dist/esm/BaseClient.mjs).

Les avis utilisent désormais une ressource native.

* Le listage et la récupération des avis ne renvoient que les avis publiés. La récupération d'un avis en attente ou supprimé renvoie `404`.
* Un avis récupéré renvoie `account` au lieu de `company`.
* Le listage des avis filtre par `account_id` ou `product_id`, trie avec `order` et `direction`, et renvoie par défaut 20 avis par page. Sans filtre, un utilisateur liste les avis qu'il a rédigés, et une clé API de compte ou d'application liste les avis de son compte.
* `company_id` n'est plus accepté. Utilisez `account_id`.
* `DELETE /reviews/{id}` supprime un avis rédigé par l'utilisateur connecté et nécessite le scope `review:delete`.

**2026-10-13**

Les comptes n'ont plus de groupe sectoriel, et la classification des comptes est en lecture seule

Les comptes n'incluent plus `industry_group`, et `PATCH /accounts/{id}` ne l'accepte plus. `business_type` et `industry_type` classifient un compte.

La classification des comptes est en lecture seule. Whop définit `business_type` et `industry_type`, et `PATCH /accounts/{id}` ne les accepte plus.

**2026-10-09-2**

Les applications ne listent plus les anciennes URL hébergées

SDK TypeScript : [`@whop/sdk@2.4.0`](https://unpkg.com/@whop/sdk@2.4.0/dist/esm/BaseClient.mjs).

Les applications n'incluent plus `previous_hosted_urls`. Les adresses d'une application sont les domaines qui la servent : listez-les avec `GET /domains`, ou lisez `domains` sur l'application.

**2026-10-09-1**

Profils, montants et types de création des transferts

Les transferts renvoient des profils `origin` et `destination` avec `name` et `logo_url`. Les objets monétaires `amount` et `fee` contiennent le crédit du destinataire et l'ensemble des frais de transfert. Les réponses incluent également les horodatages d'échec disponibles et une URL de suivi. Les montants et heures de transition historiques inconnus valent `null`.

Sans filtre de compte, `GET /transfers` liste les transferts de l'ensemble des comptes autorisés de l'appelant et de son portefeuille personnel. Les identifiants limités à un compte restent limités à ce compte.

`POST /transfers` exige `type`, soit `balance`, soit `claim_link`. Les requêtes sans ce champ renvoient `400`. Le type `ledger` est renommé `balance`, et `wallet_send` est supprimé. Les versions antérieures acceptent `ledger` et `wallet_send`, et créent un transfert `balance` lorsque `type` est omis.

**2026-10-09**

Générer le reçu PDF d'un paiement

Les paiements n'incluent plus `pdf_url`. Pour obtenir le reçu d'un paiement au format PDF, appelez `POST /payments/{id}/generate_pdf`. Il renvoie une `url` pour télécharger le fichier et un `expires_at` indiquant quand ce lien cesse de fonctionner.

**2026-10-08**

Les fonds en attente peuvent attendre une vérification de conformité

SDK TypeScript : [`@whop/sdk@2.3.0`](https://unpkg.com/@whop/sdk@2.3.0/dist/esm/BaseClient.mjs).

Le `payment_controls.undated_pending_reason` d'un compte peut valoir `compliance_review`. Cela signifie qu'une vérification déjà soumise par le marchand est en cours d'examen, et que les fonds en attente le restent jusqu'à sa validation. Les appelants fixés sur une version antérieure voient `null` pour cet état.

**2026-10-07-2**

Economic Intelligence peut se renouveler chaque semaine

`economic_intelligence_offers` inclut une offre `weekly` qui se renouvelle chaque semaine jusqu'à sa désactivation. Chaque offre possède `auto_renew`, et `weekly` est l'offre recommandée. Pour l'activer, envoyez `economic_intelligence_duration_key: "weekly"` à `PATCH /accounts/{account_id}/preferences`.

`economic_intelligence_offers` ne liste que ce que le compte peut choisir à l'instant. Il ne vaut plus `null` lorsque Economic Intelligence est activé : pendant une période d'engagement, il ne liste que `weekly`, en tant que mise à niveau, et pendant le renouvellement de `weekly`, il est vide. Les versions antérieures conservent `null` lorsque Economic Intelligence est activé, omettent `weekly` et recommandent `1_day`.

**2026-10-07-1**

Les paiements par carte enregistrée considèrent l'acheteur présent par défaut

Un prélèvement sur un moyen de paiement enregistré (`member_id` et `payment_method_id`) avec un `return_url` considère désormais l'acheteur comme présent. Cela s'applique lorsque vous omettez `off_session`. Si l'émetteur demande à l'acheteur de s'authentifier, le paiement est `requires_action` avec une `next_action`. Lorsque vous débitez la carte sans l'acheteur, par exemple pour un renouvellement selon votre propre calendrier, passez `off_session: true`.

**2026-10-07**

Les bénéficiaires de paiements de factures n'ont plus besoin de compte Whop

La création d'une méthode de versement avec `recipient` crée un compte de versement bénéficiaire non par défaut, lié au grand livre de l'expéditeur. Elle ne crée ni utilisateur Whop, ni compte Whop, ni grand livre pour le bénéficiaire. La réponse du bénéficiaire contient `first_name`, `last_name` et `country`. Elle ne contient plus `user_id`. Les versions antérieures de l'API omettent les détails du bénéficiaire lorsqu'il n'y a pas d'utilisateur Whop. Les versions antérieures conservent l'ID utilisateur pour les bénéficiaires existants.

**2026-10-06-2**

Les builds d'applications n'acceptent plus de prompt IA

La création d'un build d'application n'accepte plus `ai_prompt_id`.

**2026-10-06-1**

La série temporelle d'une métrique a son propre chemin

Récupérez la série temporelle d'une métrique depuis `GET /stats/time_series/{metric}`. `GET /stats/{metric}` la sert toujours et indique son successeur dans un en-tête `Deprecation`.

**2026-10-06**

Les comptes sociaux deviennent des comptes externes

Les comptes sociaux s'appellent désormais des comptes externes. Utilisez `/external_accounts` et l'espace de noms `externalAccounts` du SDK. Les anciens endpoints `/social_accounts` répondent toujours dans toutes les versions, avec les en-têtes `Deprecation` et `Link` vers le successeur. Les ID de comptes externes conservent leur préfixe `sacc_`, et les scopes de permission `social_account:*` sont inchangés.

Les annonces nomment leurs comptes `external_accounts` au lieu de `social_accounts`, dans les requêtes comme dans les réponses. Les règles d'engagement des audiences nomment leur compte `external_account_id` au lieu de `social_account_id`. Sur `/external_accounts`, la page propriétaire d'un compte Instagram est `parent_external_account` au lieu de `parent_social_account`. Les webhooks d'annonces sans version d'API fixée reçoivent `external_accounts`.

**2026-10-05-1**

Les utilisateurs n'incluent plus les comptes sociaux

Les utilisateurs ne renvoient plus `social_accounts`.

**2026-10-05**

Les setup intents sont enregistrés en arrière-plan

La création d'un setup intent le renvoie désormais avec le statut `processing` et enregistre le moyen de paiement en arrière-plan. La création d'un paiement fonctionne déjà ainsi. Pour connaître le résultat, interrogez le setup intent ou passez son `client_secret` à `handleNextAction`. Il finit enregistré, refusé ou en attente d'une étape de l'acheteur. Les versions antérieures continuent de l'enregistrer pendant la requête.

**2026-09-29**

Les litiges évités indiquent prevented

SDK TypeScript : [`@whop/sdk@2.1.0`](https://unpkg.com/@whop/sdk@2.1.0/dist/esm/BaseClient.mjs), [`@whop/sdk@2.2.0`](https://unpkg.com/@whop/sdk@2.2.0/dist/esm/BaseClient.mjs).

Un litige pour lequel le client a été remboursé avant toute décision a désormais `status: prevented` au lieu de `closed`. Le remboursement provient du réseau de cartes (Visa RDR) ou d'un remboursement antérieur.

**2026-09-28**

Les exécutions Economic Intelligence ont leurs propres statuts

Une recommandation en cours d'exécution par Whop AI a `status: running`. À la fin de l'exécution, elle devient `executed`, ou `incomplete` si elle s'est terminée sans appliquer la recommandation. Les versions antérieures affichent une recommandation en cours comme `ready` et une recommandation incomplète comme `superseded`.

Les recommandations renvoient également `run_started_at`, `run_ended_at`, `run_by_user_id`, `result_url` et `acknowledged_at`. Pour exécuter vous-même une recommandation, envoyez `status: running` à `PATCH /economic_intelligence/{id}`, puis `status: executed` (avec un `result_url` facultatif) ou `status: incomplete`. Envoyez `status: acknowledged` pour marquer une exécution comme vue. La recommandation reste `executed` et enregistre `acknowledged_at`.

**2026-09-25**

Les durées Economic Intelligence sont choisies par clé

Pour activer Economic Intelligence, envoyez `economic_intelligence_duration_key` à `PATCH /accounts/{account_id}/preferences` au lieu de `economic_intelligence_duration_days`. Utilisez la `key` d'une entrée de `economic_intelligence_offers`.

Chaque entrée de `economic_intelligence_offers` possède `key`, `duration` et `duration_unit` au lieu de `duration_days`. Une durée peut être exprimée en `hours` ou en `days`.

**2026-09-24-1**

Les textes des annonces sont étiquetés par langue, et les annonces Meta peuvent être diffusées dans d'autres langues

Les `primary_texts`, `headlines` et `descriptions` d'une annonce sont des tableaux d'objets `{ language, text }` dans les requêtes et les réponses. Sur une annonce sans traductions, omettez `language`. L'API rejette les chaînes simples : envoyez plutôt `[{ "text": "…" }]`.

Une annonce Meta peut également être diffusée dans d'autres langues. Définissez `translations: { source_language, automatic_languages }` avec la langue du texte propre de l'annonce et les langues vers lesquelles Meta traduit automatiquement. Chaque texte et chaque entrée `creatives` de cette annonce indique alors sa `language`. Le texte et la création propres de l'annonce utilisent `source_language`, et chaque langue que vous rédigez vous-même reçoit une entrée `primary_texts` et une entrée `headlines`, ainsi que des entrées `descriptions` et `creatives` facultatives. `translations: null` désactive les autres langues.

Les versions antérieures de l'API ne peuvent pas mettre à jour une annonce qui possède des traductions. Elles reçoivent une erreur 400 qui indique cette version.

**2026-09-24**

Economic Intelligence s'active pour une durée choisie

Pour activer Economic Intelligence, envoyez `economic_intelligence_duration_days` à `PATCH /accounts/{account_id}/preferences`. Choisissez une durée dans `economic_intelligence_offers`, qui liste les frais de chaque durée. Economic Intelligence ne peut pas être modifié ni désactivé avant `economic_intelligence_ends_at`, et se désactive alors automatiquement.

`economic_intelligence` est en lecture seule. L'envoyer renvoie une erreur `400`.

**2026-09-23**

L'accès au trading apparaît dans les vérifications de permissions

SDK TypeScript : [`@whop/sdk@2.0.0`](https://unpkg.com/@whop/sdk@2.0.0/dist/esm/BaseClient.mjs).

`GET /permissions` inclut `crypto_wallet:trade` et `crypto_wallet:trade:read` lors du listage ou de la vérification des actions de permission d'un compte.

**2026-09-22-4**

Descriptions des opérations Economic Intelligence

Les recommandations Economic Intelligence renvoient `expected_tool_calls` sous forme de tableau ordonné d'objets avec `tool_name` et `description`. Les descriptions identifient l'action prévue et la ressource concernée. Les recommandations plus anciennes ont une description `null`.

**2026-09-22-3**

Les liens de parrainage partenaire utilisent un seul type de demande

Les demandes de parrainage partenaire utilisent `request_type: "link"` pour les liens avec ou sans récompenses. Utilisez `link` lors de la création ou du filtrage des liens. Seul le personnel autorisé peut configurer les récompenses.

**2026-09-22-2**

Les récompenses du compte affichent la progression des récompenses partenaires

Retrieve Account renvoie les paliers de récompenses partenaires dans `rewards`. Chaque palier inclut la progression de qualification et le statut de versement pour ce compte. Le champ contient un tableau vide lorsqu'il n'y a aucune récompense correspondante ou que l'appelant n'a pas d'accès en lecture au solde ou aux statistiques.

L'ancien format de récompense d'intégration est retiré. Les versions antérieures de l'API omettent `rewards` des réponses de compte.

**2026-09-22-1**

Les setup intents deviennent une ressource native

L'API native Payments sert désormais `POST /setup_intents`, `GET /setup_intents` et `GET /setup_intents/{id}`. L'objet Setup Intent adopte la même forme que toutes les autres ressources natives.

* Les enregistrements associés sont des ID de clés étrangères au lieu d'objets intégrés : `account_id` (anciennement `company`), `member_id` (anciennement `member`), `payment_method_id` (anciennement `payment_method`) et `checkout_configuration_id` (anciennement `checkout_configuration`). L'acheteur est un résumé `user` (`id`, `username`, `name`, `profile_picture`).
* `error_message` est déplacé dans `last_setup_error`, le même bloc `{ code, message }` que renvoie Retrieve setup status. Il reste `null` jusqu'à ce qu'un échec survienne, et disparaît une fois la configuration réussie.
* `return_url`, `payment_method_type` et `updated_at` sont nouveaux. `created_at` et `updated_at` sont des horodatages ISO 8601.
* `payment_instrument`, le moyen de paiement mis en forme pour l'affichage que l'objet Payment contient déjà, figure également sur le Setup Intent, de sorte qu'une carte enregistrée s'affiche sans seconde requête. Son `card` gagne `exp_month` et `exp_year` sur les deux ressources. `card.brand` peut valoir `null` : une carte enregistrée dont le coffre-fort n'a pas consigné le réseau conserve ses quatre derniers chiffres et sa date d'expiration au lieu de perdre l'objet `card` entier.
* La création d'un setup intent répond `201 Created` (anciennement `200`), respecte `Idempotency-Key` et exige exactement l'un des champs `confirmation_token` ou `payment_method_id`. Un jeton de confirmation provenant d'un autre compte renvoie `404`.
* `client_secret` est renvoyé lors de la création et de la récupération, uniquement pour les configurations créées via cette API. Il exige un appelant autorisé à agir sur la configuration : les identifiants `payment:charge` du compte ou le propre jeton de l'acheteur. Les lignes de liste contiennent toujours `null`.
* Les webhooks `setup_intent.requires_action`, `setup_intent.succeeded` et `setup_intent.canceled` fixés sur cette version ou une version ultérieure livrent ce même objet Setup Intent comme `data`. Les webhooks fixés sur une version antérieure, et les webhooks sans version fixée, conservent le payload précédent.
* `GET /setup_intents` liste avec l'enveloppe standard `{ data, page_info }` et une pagination par curseur. `account_id` est facultatif : une clé API de compte liste son propre compte, et un jeton utilisateur liste tous les comptes qu'il peut lire. `status` est un nouveau filtre, et une valeur invalide renvoie `400`. `created_before` et `created_after` fonctionnent comme avant.

**2026-09-22**

Les nouvelles tentatives de paiement des publicités utilisent l'endpoint de compte

`POST /ad_campaigns/{id}/retry_payment` renvoie `410 Gone`. Utilisez `POST /accounts/{id}/retry_ads_payment` avec l'ID `biz_` du compte pour mettre en file d'attente une seule nouvelle tentative de paiement pour toutes ses campagnes. Une nouvelle tentative acceptée ne confirme pas la réussite du paiement. Consultez le `delivery_status` et les `issues` des campagnes pour connaître le résultat.

**2026-09-15**

Trois politiques 3D Secure distinctes

SDK TypeScript : [`@whop/sdk@1.1.5`](https://unpkg.com/@whop/sdk@1.1.5/dist/esm/BaseClient.mjs).

Les comptes, variantes, configurations de checkout et sessions de checkout exposent trois choix 3D Secure :

* `mandate_challenge` demande une authentification forte avant le traitement d'un paiement par carte pris en charge avec l'acheteur présent.
* `mandate_if_required` impose une authentification forte uniquement lorsque le processeur de paiement l'exige.
* `frictionless_if_required` utilise le parcours 3DS sans friction habituel.

Les paiements de 1 000 \$ ou plus utilisent au minimum `mandate_if_required`. Les exigences de risque et de récupération d'authentification peuvent prévaloir sur la préférence. Les authentifications fortes obligatoires explicites sont rejetées tant qu'elles ne sont pas activées sur la plateforme.

Les versions antérieures de l'API conservent leurs valeurs existantes : les nouvelles sélections `mandate_challenge` restent conditionnelles, les préférences obligatoires existantes sont conservées, et `frictionless` reste `frictionless`. Les comptes sur des versions antérieures représentent le mode sans friction par `null`.

**2026-09-13**

Les transferts de trading ont des catégories de rapport financier distinctes

Les lignes des rapports financiers distinguent `trading_account_deposit`, `trading_account_withdrawal` et leurs entrées `_offset` des autres transferts on-chain. Les montants et les soldes sont inchangés.

Les versions antérieures conservent les catégories existantes : `topup` pour les dépôts sur le compte et `onchain_withdrawal` pour les retraits du compte. Les rapports globaux utilisent les catégories correspondantes `onchain_deposit`, `onchain_withdrawal` et `_offset`. Les lignes correspondantes sont combinées sans perte des montants transférés.

**2026-09-11-1**

Statut Triple Whale renommé pour les marchands en marque blanche

Le `ads_triple_whale_integration.status` des préférences du compte indique `requires_shop_domain` au lieu de `requires_shopify_store`. Un `shop_domain` peut désormais être défini explicitement sur l'intégration, si bien qu'une boutique Shopify connectée n'est plus le seul moyen d'en fournir un.

**2026-09-11**

Les catégories d'entreprise proviennent d'une seule table

SDK TypeScript : [`@whop/sdk@1.1.4`](https://unpkg.com/@whop/sdk@1.1.4/dist/esm/BaseClient.mjs).

Les champs `business_type`, `industry_group` et `industry_type` d'un compte sont des chaînes issues de la table des catégories d'entreprise de Whop au lieu d'enums fixes. Les nouvelles catégories apparaissent sans nouvelle version d'API. Le [glossaire des types d'entreprises et des secteurs](https://docs.whop.com/fr/api-reference/accounts/business-types.md) liste les valeurs actuelles.

* `coaching_and_courses` devient `education`, `physical_product` devient `ecommerce`, et `marketplace` devient `platform`.
* Les groupes et types de secteurs ont été réorganisés sous les huit types d'entreprise. `PATCH /accounts/{id}` n'accepte que les slugs du glossaire. Les valeurs inconnues renvoient `400`.

Les appelants fixés sur une version antérieure reçoivent toujours les anciens noms de types d'entreprise, et les valeurs de secteur qui n'existaient pas avant cette version sont renvoyées comme `null`.

**2026-09-09-1**

Expériences A/B rattachées à un compte

La création d'une expérience A/B exige un `account_id` propriétaire, préfixé par `biz_`. Les expériences acceptent également des références de ressources facultatives et des clés de flag propres au compte. Le listage renvoie les expériences d'un seul compte, et leur lecture ou leur gestion nécessite des permissions sur le compte. Les expériences de compte ne prennent pas en charge les tags d'équipe et ne provisionnent pas de fournisseur de reporting.

L'évaluation identifie le sujet via `subject[account_id]`, `subject[anonymous_id]` et `subject[user_id]`. Les appelants sur des versions antérieures conservent leurs paramètres d'identité d'évaluation existants. Passez les `properties` de ciblage sous forme de valeur de requête JSON. Les clés de requête de propriétés imbriquées existantes restent prises en charge. L'exposition accepte des identifiants facultatifs et enregistre leur identité sur l'événement.

**2026-09-09**

Blocages de retrait Whop nommés sur les fonds en attente

SDK TypeScript : [`@whop/sdk@1.1.3`](https://unpkg.com/@whop/sdk@1.1.3/dist/esm/BaseClient.mjs).

Le `payment_controls.undated_pending_reason` d'un compte peut valoir `withdrawals_disabled` lorsque Whop a bloqué les retraits, de sorte que ces fonds en attente ne peuvent pas devenir disponibles.

`kyc_incomplete`, `pending_information_request` et `null` pour les fonds encore en cours de compensation sont inchangés.

**2026-09-06**

Sources d'audience basées sur l'engagement

`POST /audiences` prend en charge l'engagement avec les vidéos, les formulaires de prospects, les profils Instagram et les pages Facebook via une définition `engagement` typée.

* Les valeurs `source_type` explicites vérifient que les champs de source requis sont présents et que les champs de source contradictoires sont absents.
* Les réponses d'audience incluent `engagement`, et `source_type` peut valoir `engagement`. Les audiences d'engagement peuvent également servir de sources pour des audiences similaires.
* `GET /social_accounts/{id}/posts` inclut `video_id` et `caption` pour aider à sélectionner des vidéos sans avoir à retrouver manuellement leurs identifiants de plateforme.

**2026-09-04**

Mettre fin à une expérience A/B exige des conclusions

`POST /experiments/{id}/end` exige `findings` dans le corps de la requête — une courte explication de ce qui a été appris et de la raison pour laquelle l'expérience s'est terminée ainsi.

Les appelants fixés sur une version antérieure peuvent toujours l'omettre. Une valeur de conclusions provisoire est enregistrée en leur nom au lieu d'une erreur `400`.

**2026-09-02-2**

Les destinations de dépôt sont un ID de compte

SDK TypeScript : [`@whop/sdk@1.1.1`](https://unpkg.com/@whop/sdk@1.1.1/dist/esm/BaseClient.mjs), [`@whop/sdk@1.1.2`](https://unpkg.com/@whop/sdk@1.1.2/dist/esm/BaseClient.mjs).

`POST /deposits` accepte une chaîne d'ID de compte `destination` — `biz_…` ou `user_…` — et rien d'autre.

* Les adresses de portefeuille brutes ne sont plus acceptées. Approvisionnez un compte et lisez ses adresses depuis `methods.crypto`.
* La forme objet de `destination` (`{ account_id }` / `{ address, network }`) est supprimée. Envoyez l'ID du compte seul.
* Le remplacement `network` de premier niveau est supprimé. Il ne modifiait jamais la réponse : chaque dépôt renvoie déjà une adresse pour chaque réseau pris en charge, choisissez donc celle que vous voulez dans `methods.crypto`.
* `metadata` est supprimé de la requête comme de la réponse. Il était renvoyé à l'identique et jamais enregistré, il ne pouvait donc pas servir à rapprocher un dépôt ultérieur.
* `account_id` dans la réponse n'est plus nul, car chaque destination désigne désormais un compte.

Les appelants fixés sur une version antérieure continuent d'envoyer la forme objet et les entrées supprimées, et leurs réponses contiennent toujours `metadata` — sous forme d'objet vide plutôt que la valeur envoyée. Une adresse de portefeuille est refusée dans toutes les versions : elle n'a jamais identifié un compte, il n'y a donc pas d'ancienne forme à continuer de servir. Un `metadata` envoyé avec un `payment_method_id` est conservé dans toutes les versions, car il est rattaché au prélèvement par carte.

**2026-09-02-1**

Les paiements deviennent une ressource native

SDK TypeScript : [`@whop/sdk@1.1.0`](https://unpkg.com/@whop/sdk@1.1.0/dist/esm/BaseClient.mjs).

`POST /payments`, `GET /payments` et `GET /payments/{id}` sont désormais servis par l'API native Payments, et l'objet Payment adopte la même forme que toutes les autres ressources natives.

* Les enregistrements associés sont des ID de clés étrangères au lieu d'objets intégrés : `account_id` (anciennement `company`), `plan_id`, `product_id`, `membership_id`, `member_id`, `promo_code_id`, `shipment_id`, `payment_method_id`. L'acheteur est un résumé `user` (`id`, `username`, `name`, `profile_picture`).
* Les montants sont des objets monétaires (`{ amount, currency, decimals, display_decimals }`) au lieu de simples nombres : `total`, `subtotal`, `tax_amount`, `refunded_amount`, `tax_refunded_amount`, `amount_after_fees`, `usd_total`. `settlement_amount`, `settlement_currency` et `settlement_exchange_rate` sont intégrés à `total` et `currency`. `refunded_amount` et `tax_refunded_amount` sont exprimés tels qu'ils ont été réglés, au taux en vigueur lors de l'émission de chaque remboursement, et `tax_refunded_amount` figure désormais dans les réponses de liste ainsi que de récupération.
* Les litiges, remboursements et dossiers du Resolution Center ne sont plus intégrés — listez-les depuis leurs propres endpoints avec `?payment_id=`. Les transactions de financement intégrées et les frais d'application ne sont pas repris dans la forme native.
* `last_payment_attempt` / `next_payment_attempt` deviennent `last_payment_attempt_at` / `next_payment_attempt_at`. Les informations sur la carte se trouvent dans `payment_instrument`.
* La création d'un paiement accepte `account_id` (anciennement `company_id`), répond `201 Created`, respecte `Idempotency-Key` et accepte `capture: false` pour placer une autorisation en attente.
* Les lectures natives de paiements sont limitées au compte : les identifiants doivent pouvoir lire les paiements du compte (le jeton d'un membre de l'équipe ou la clé API du compte). Le propre jeton utilisateur d'un acheteur, que les versions proxy fixées acceptent pour lire son propre paiement, n'est pas encore pris en charge nativement — les acheteurs continuent de fonctionner sur leur version fixée.
* Les lignes de `GET /payments/{id}/fees` sont `{ type, origin, label, description, amount, settlement_amount, collected_at }` avec des objets monétaires (anciennement `name`/`amount`/`currency`/`type`).
* `GET /refunds` et `GET /refunds/{id}` renvoient le Refund natif : `payment_id` et `account_id` au lieu d'un paiement intégré, `amount` sous forme d'objet monétaire dans la devise de règlement du paiement, `original_amount` dans la devise du processeur. Le filtre `company_id` devient `account_id`, et l'envoi de `company_id` renvoie une erreur 400.
* `POST /payments/{id}/refund`, `POST /payments/{id}/retry` et `POST /payments/{id}/void` sont également natifs et renvoient le même objet Payment. Le remboursement accepte toujours un `partial_amount` facultatif.
* `GET /payments` liste avec l'enveloppe standard `{ data, page_info }` et une pagination par curseur. Les filtres sont des paramètres d'égalité au singulier (`status`, `billing_reason`, `currency`, `plan_id`, `product_id`, `membership_id`, `member_id`, `user_id`, `account_id`) au lieu des tableaux au pluriel du proxy. Comme sur le proxy, `billing_reason=subscription_cycle` correspond également aux renouvellements enregistrés comme `subscription_update`. Les paiements d'un montant nul sont inclus, donc le `include_free` du proxy disparaît. Un `status` invalide renvoie une erreur `400`, tout comme tout filtre propre au proxy (`substatuses`, `updated_before`/`updated_after`, `checkout_configuration_ids`, tableaux au pluriel), au lieu d'une page non filtrée. La recherche d'acheteur `query` fonctionne comme avant. La fenêtre `created_before`/`created_after` ne couvre que l'heure de création du paiement. Le proxy filtrait sur la date de paiement lorsqu'elle existait. Dans les lignes de liste, `settlement_time_at` est nul — récupérez le paiement pour l'obtenir.

**2026-09-02**

L'ancien endpoint de rapports publicitaires est retiré

L'ancien endpoint `GET /ad_reports` est déprécié au profit des métriques natives [Stats](https://docs.whop.com/fr/api-reference/stats/stats) et des endpoints d'entités publicitaires. Il n'est plus servi à partir de cette version.

* `GET /ad_reports` renvoie `410 Gone` avec un `error.type` valant `gone`. Utilisez `GET /stats/time_series/ad_delivery` pour `spend`, `impressions` et `clicks` dans le temps, limités avec un chemin `source` comme `whop:adcamp_xxx:*`. Utilisez `GET /stats/time_series/events` pour les conversions attribuées.
* Les performances par entité sur une période se trouvent sur les endpoints d'entités. `GET /ad_campaigns`, `GET /ad_groups` et `GET /ads` acceptent `stats_from` et `stats_to` et renvoient `spend`, `results` et `return_on_ad_spend` sur chaque ligne.
* Chaque réponse de l'ancien endpoint, dans toutes les versions, comporte désormais les en-têtes `Deprecation` et `Link: <…/stats/ad_delivery>; rel="successor-version"`. Les requêtes fixées sur des versions antérieures, et les requêtes sans version, continuent de fonctionner sans changement jusqu'à ce qu'un en-tête `Sunset` annonce la date à laquelle il cessera de répondre pour toutes les versions.

**2026-08-31**

Plages d'horodatage des rapports financiers

`GET /financial_reports` et `GET /financial_reports/breakdown` utilisent désormais des horodatages ISO 8601 `from` et `to` pour les fenêtres de rapport.

* `from_date` et `to_date` sont renommés en `from` et `to`.
* Les dates seules ne sont plus acceptées. Incluez une heure et un décalage dans les deux horodatages.

**2026-08-25-2**

Filtrage explicite de la vérification des applications

`GET /apps` utilise désormais `verified` comme filtre d'égalité facultatif au lieu de traiter son absence comme `verified=false` pour les listes de sites web publics.

* Omettez `verified` pour renvoyer les modèles de sites web publiquement découvrables des deux états de vérification.
* Définissez `verified=true` pour les modèles vérifiés par Whop ou `verified=false` pour les modèles de la communauté.
* `recommended=true` filtre les applications recommandées indépendamment du statut de vérification.

**2026-08-25-1**

Les anciens endpoints de retraits sont retirés

Les anciens endpoints `/withdrawals` sont dépréciés au profit de l'API native [Payouts](https://docs.whop.com/fr/api-reference/payouts/payout) et ne sont plus servis à partir de cette version.

* `GET /withdrawals` et `POST /withdrawals` renvoient `410 Gone` avec un `error.type` valant `gone`. Utilisez plutôt `GET /payouts` et `POST /payouts`. Les ID de versements sont les mêmes ID `wdrl_`, donc les identifiants existants continuent d'être résolus.
* `GET /withdrawals/{id}` répond toujours dans cette version. Utilisez `GET /payouts/{id}` pour les nouveaux développements.
* Chaque réponse des anciens endpoints, dans toutes les versions, comporte désormais les en-têtes `Deprecation` et `Link: <…/payouts>; rel="successor-version"`. Un en-tête `Sunset` annoncera la date à laquelle ils cesseront de répondre pour toutes les versions. D'ici là, les requêtes fixées sur des versions antérieures, et les requêtes sans version, continuent de fonctionner sans changement.

**2026-08-25**

ID de publication des annonces

Le `post_id` d'une annonce désigne désormais la publication que le réseau publicitaire diffuse, quelle que soit la façon dont l'annonce a été construite.

* `post_id` renvoie la publication du réseau pour l'annonce — celle que Meta a créée pour une création importée, ou la publication mise en avant. Il valait auparavant `null` pour toutes les annonces construites à partir de créations importées.
* La publication vers laquelle vous dirigez une annonce est déplacée vers `existing_post_id`, dans la réponse comme dans le corps de création/mise à jour. `post_source` et `post_thumbnail_url` décrivent ce champ.

**2026-08-21-1**

API native Files

SDK TypeScript : [`@whop/sdk@1.0.14`](https://unpkg.com/@whop/sdk@1.0.14/dist/esm/BaseClient.mjs).

`POST /files` et `GET /files/{id}` sont servis nativement avec un objet fichier repensé, et les téléversements en plusieurs parties se terminent via le nouveau `POST /files/{id}/complete`.

* Les réponses de fichier comportent l'enveloppe standard : `object`, `visibility` et un `created_at` ISO 8601. Les champs `size` et `url` valent `null` jusqu'à ce que le téléversement soit `ready`.
* `GET /files/{id}` ne résout que les fichiers que vous avez créés — les autres appelants reçoivent une erreur 404.

**2026-08-21**

Statut des versements v2

SDK TypeScript : [`@whop/sdk@1.0.13`](https://unpkg.com/@whop/sdk@1.0.13/dist/esm/BaseClient.mjs).

Le vocabulaire du cycle de vie de l'objet versement est repensé et ses champs monétaires deviennent des chaînes décimales.

* `status` comprend huit valeurs : `requested`, `in_review`, `processing`, `completed`, `reversed`, `canceled`, `failed`, `denied`. Un versement réglé que le fournisseur annule indique `reversed`, avec le code de retour et `funds_returned_at` dans `failure`.
* Un nouveau champ `status_detail` contient la phase machine la plus fine sous la valeur de statut. Ses valeurs peuvent s'étendre sans changement de version — `status` constitue le contrat versionné.
* `amount`, `fee_amount`, `net_amount`, `markup_fee` et `destination_amount` sont des chaînes décimales. `exchange_rate` reste un nombre.
* Les versements sont créés sous leur ID `wdrl_` : l'ID renvoyé par `POST /payouts` est l'ID listé par `GET /payouts`, et la demande de conversion d'un versement est conservée sous `payout_request_id`. Les demandes de conversion créées avant cette version continuent de répondre sous leur ID `cofr_`.
* La clé d'idempotence n'est envoyée que dans l'en-tête `Idempotency-Key`, et le champ de corps `idempotency_key` est rejeté.

Les requêtes fixées sur des versions antérieures conservent l'ancien vocabulaire, les montants en nombres flottants et les clés d'idempotence dans le corps. Les payloads de webhook suivent de la même manière l'`api_version_date` de l'abonnement : les abonnements fixés sur `2026-08-21` ou une version ultérieure reçoivent la nouvelle forme de versement, les abonnements antérieurs ou sans version fixée conservent l'ancienne.

**2026-08-14**

account\_id dans l'enveloppe des webhooks

Le champ `company_id` de l'enveloppe des webhooks est renommé en `account_id`.

* Les livraisons de webhooks fixées sur `2026-08-14` ou une version ultérieure contiennent `account_id` dans l'enveloppe.
* Les webhooks fixés sur des versions antérieures — et les webhooks sans `api_version_date` fixée — conservent `company_id`.

**2026-08-13**

Détail des soldes en transit

SDK TypeScript : [`@whop/sdk@1.0.11`](https://unpkg.com/@whop/sdk@1.0.11/dist/esm/BaseClient.mjs).

Le détail des soldes du compte et des soldes personnels expose désormais `in_transit` à côté de `pending`.

* Additionnez `pending` et `in_transit` pour présenter le montant total en attente de règlement.
* Les appelants fixés sur des versions antérieures continuent de recevoir le montant combiné dans `pending`.

**2026-08-12**

Le paramètre de version d'API des webhooks est supprimé

Le paramètre `api_version` de `POST /webhooks` et `PATCH /webhooks/{id}` est supprimé.

* Les nouveaux webhooks utilisent toujours les événements et payloads `v1`. Les requêtes qui passent `api_version` sont rejetées avec une erreur `400`.
* Fixez plutôt la forme du payload d'un webhook avec `api_version_date`.
* Les webhooks `v2` et `v5` existants continuent d'être livrés. Vous ne pouvez plus créer de webhooks dans ces versions ni y basculer.

**2026-08-10**

Endpoints natifs d'alertes de litige

Les alertes de litige sont désormais une ressource REST native et restent servies en parallèle avec l'ancien proxy.

* `GET /dispute_alerts` liste les alertes d'un compte avec une pagination par curseur, et filtre par `account_id`, `payment_id`, `type` et une fenêtre de création.
* `type` remplace `alert_type` et désigne les deux types qu'un émetteur envoie : `early_fraud_warning` (signalements de fraude Visa TC40 / Mastercard SAFE) et `dispute_alert` (avis de pré-litige).
* `fee_charged` remplace `charge_for_alert` et indique si Whop a réellement facturé le compte. Les alertes précoces de fraude ne sont jamais facturées.
* `actionable` indique si le remboursement du paiement peut encore éviter une rétrofacturation.
* Les objets `payment` et `dispute` sont remplacés par les tags `payment_id` et `account_id`. Les horodatages sont au format ISO 8601, avec `reported_at` pour la date à laquelle l'émetteur a déposé le signalement.

**2026-08-05-1**

Conversion de devises fiat sur les swaps

Les swaps entre paires fiat (`POST /swaps` avec deux devises fiat) prennent désormais en charge la conversion de devises libre, et `amount` suit la même sémantique que les swaps crypto.

* `amount` est le montant de `from_token` à convertir au taux moyen du marché. Aucun solde négatif n'est requis.
* Le dimensionnement d'un remboursement partiel d'un solde `to_token` négatif est déplacé vers le nouveau champ `to_amount` (libellé en `to_token`, plafonné au montant de la dette). `amount` et `to_amount` s'excluent mutuellement.
* Omettre les deux rembourse toujours la totalité du solde `to_token` négatif.
* Les appelants fixés sur des versions antérieures conservent l'ancien comportement : leur `amount` fiat est traité comme le montant de remboursement en `to_token`.

**2026-08-05**

Exigences de vérification à plat

Le `requested_information` d'une vérification est désormais une liste à plat : une exigence par entrée, une écriture par réponse.

* Chaque entrée indique ce qui est requis dans `requirement` : un document comme `bank_statement`, ou une clé de champ comme `ssn`, avec un `label` à afficher à l'utilisateur.
* Répondez aux entrées `file` avec `file` (un ID de téléversement direct). Répondez aux entrées `text`, `date`, `phone` et `select` avec `value`, et aux entrées `address` avec `address`. Rien de la réponse n'est renvoyé à l'identique.
* Une entrée marquée `multiple` accepte plusieurs fichiers dans une seule réponse, dans l'ordre des emplacements, le recto en premier pour un document recto verso.
* Une entrée qui liste des `options` accepte également une `value`. Pour les entrées `select`, les options sont les réponses autorisées. Pour les documents d'identité, les options sont les types de pièces d'identité acceptés.
* Les clés non applicables sont omises, et les soumissions rejetées contiennent des `errors` structurées avec un `code` stable et une `reason`.
* La forme imbriquée `requested_files`/`category` disparaît de cette version. Les appelants fixés sur des versions antérieures la conservent, et leurs réponses sont traduites automatiquement.

**2026-08-03**

Endpoints natifs de codes promo

Les codes promo sont désormais une ressource REST complète de premier niveau et restent servis en parallèle avec l'ancien proxy.

* `GET /promo_codes` liste les codes promo d'un compte et utilise `account_id` au lieu de `company_id`.
* `POST /promo_codes` crée des codes promo. `GET` et `DELETE /promo_codes/{id}` les récupèrent et les archivent.
* `POST /promo_codes/{id}/activate` et `POST /promo_codes/{id}/deactivate` remplacent l'ancienne écriture de statut via `PATCH`.
* Les réponses de liste utilisent une pagination par curseur et prennent en charge les filtres de statut, de produit, de variante, d'horodatage et de tri.
* Les appelants fixés sur des versions antérieures conservent l'ancien contrat du proxy sans changement.

**2026-07-31**

Comptes parents enrichis

Les réponses de compte exposent désormais une relation de compte parent enrichie pour les comptes connectés.

* `parent_account` remplace `parent_account_id`.
* Le compte parent inclut son `id`, son `title`, sa `route` et son `logo_url`.

**2026-07-29-1**

Méthodes de versement prises en charge

Les méthodes de versement prises en charge disposent désormais de leur propre endpoint paginé.

* `GET /payouts/supported_methods` liste les méthodes de versement qu'un compte ou un utilisateur est autorisé à ajouter.
* Les méthodes prises en charge utilisent `object: "supported_payout_method"`, et leurs ID `podst_` sont passés en tant que `supported_payout_method_id`.
* Les méthodes de versement enregistrées exposent `supported_payout_method`. Les versements exposent `payout_method.supported_payout_method`.
* Utilisez `country` pour lister les méthodes prises en charge dans un pays autre que celui du compte de versement.
* `GET /payouts/methods` n'accepte plus `include_available` et ne renvoie plus `available_destinations`.
* Les appelants fixés sur des versions antérieures conservent `destination_id`, `payout_destination` et `payout_token`.

**2026-07-29**

Transactions par carte natives, estimations d'arrivée des méthodes de versement

Les transactions par carte utilisent désormais des endpoints REST natifs et restent servies en parallèle avec l'ancien proxy.

* `GET /card_transactions` liste les transactions par carte d'un compte, et `GET /card_transactions/{id}` en récupère une par son ID `citx_`. La liste accepte également un filtre `transaction_ids` pour récupérer des transactions spécifiques en une seule requête.
* Les transactions par carte sont limitées au compte : le propriétaire est sélectionné avec `account_id`, par défaut le compte auquel appartiennent les identifiants.
* Filtres sur `transaction_ids`, `card_id`, `cardholder_id`, `status`, `created_after` et `created_before`. Les filtres d'horodatage sont au format ISO 8601.
* `cardholder_id` est nouveau dans la réponse : l'utilisateur auquel la carte est attribuée.

Les méthodes de versement portent désormais des conditions de frais et de délai indépendantes du montant, et le devis ne duplique plus les estimations d'arrivée.

* Chaque méthode de versement renvoie `fee_structure` (pourcentage, montant fixe et devise) et `estimated_arrival` (horodatages par vitesse) sans exiger d'`amount`.
* Les objets `standard` et `instant` du devis n'incluent plus `estimated_arrival`. Lisez-le depuis le champ `estimated_arrival` de premier niveau de la méthode.

**2026-07-27**

Endpoints natifs du Resolution Center

Les dossiers du Resolution Center utilisent désormais des endpoints REST natifs et restent servis en parallèle avec l'ancien proxy.

* `status`, `escalated`, `outcome`, `refund`, `reason` et `available_actions` exposent l'état du dossier et les actions autorisées.
* Les événements sont disponibles via `GET /resolution_center_cases/{id}/events`, paginé. Les synthèses sont disponibles via `GET /resolution_center_cases/summary`.
* Les écritures utilisent `message` et `attachments`. `due_date` est renommé `response_due_at`. Le listage n'exige plus `account_id`.

**2026-07-26**

Endpoints natifs d'expéditions

Les expéditions utilisent désormais des endpoints REST natifs et restent servies en parallèle avec l'ancien proxy.

* `GET /shipments` liste les expéditions. `GET /shipments/{id}` récupère une expédition par son ID d'expédition ou de paiement.
* `POST /shipments` crée une expédition, et `PATCH /shipments/{id}` met à jour son numéro de suivi.
* Les réponses utilisent `account_id` et `tracking_number`, ainsi que `carrier`, `tracking_url`, `order_id` et `payment_id`.
* Les appelants fixés avant cette date conservent l'ancien contrat du proxy sans changement.

**2026-07-25**

Endpoints natifs de litiges

Les litiges utilisent désormais des endpoints REST natifs et restent servis en parallèle avec l'ancien proxy.

* `PATCH /disputes/{id}` modifie les preuves, et `POST /disputes/{id}/submit` les soumet. Les preuves sont imbriquées sous `evidence`.
* `GET /disputes/summary` fournit des totaux regroupés par `status` et `currency`. Le listage et la récupération renvoient les mêmes champs.
* Les réponses utilisent `account_id`, `product_id` et `plan_id`, ainsi que `buyer` à côté de `payment`. Le listage n'exige plus `account_id`.
* `status` et `reason` sont des enums normalisés, et `needs_response_by`, `rdr` et `editable` sont remplacés par leurs nouveaux champs.
* Les appelants fixés avant cette date conservent l'ancien contrat du proxy sans changement.

**2026-07-23**

Membres et adhésions

Les membres et les adhésions utilisent désormais des ressources natives avec un modèle d'adhésion orienté compte et des actions de cycle de vie repensées.

* Les réponses d'adhésion renvoient les champs de compatibilité `plan_id` et `product_id` au lieu des objets de compatibilité imbriqués `plan` et `product`.
* Le listage des adhésions renvoie tout ce que l'appelant peut lire (les siennes ainsi que celles de ses comptes gérés), et `account_id`/`user_id` restreignent cette liste au lieu de changer de mode ou de renvoyer une erreur.
* Définissez `cancel_at_period_end` pour programmer une annulation. L'action `cancel` met fin à l'accès immédiatement.
* L'action `extend` remplace `add_free_days`.

**2026-07-22**

Cohérence des réponses REST et des horodatages

La Current API utilise désormais des réponses de suppression, des entrées d'horodatage et une dénomination Account cohérentes.

* Les endpoints de suppression des produits, variantes, configurations de checkout, annonces, groupes d'annonces, campagnes publicitaires, comptes sociaux et soumissions de bounties renvoient `{ id, deleted: true }` au lieu d'un simple booléen.
* Les filtres d'horodatage des produits, variantes, configurations de checkout, transferts et rapports financiers n'acceptent que le format ISO 8601, et plus les secondes epoch.
* Les réponses de produit renvoient `account` au lieu de `company`.

**2026-07-20**

Pourcentages de versement des entreprises partenaires

Les entreprises partenaires exposent désormais des taux de versement distincts pour chaque source de revenus.

* `payout_percentage` est remplacé par `payout_percentages`.
* L'objet imbriqué inclut les taux `sales`, `ad_spend`, `transfer` et `card_interchange`.

**2026-07-18**

Produits et configurations de checkout

Les produits et les configurations de checkout utilisent désormais le modèle Account de manière cohérente.

* Les paramètres de requête des produits utilisent `account_id` au lieu de `company_id`.
* Les requêtes de configuration de checkout utilisent `account_id` au premier niveau et dans les objets variantes en ligne portés par le champ de compatibilité `plan`.
* Les réponses de configuration de checkout renvoient `account_id` au lieu de `company_id`.

**2026-07-08-1**

Horodatages des configurations de checkout

Les horodatages des configurations de checkout utilisent désormais le même format que le reste de l'API.

* `created_at` et `updated_at` sont des chaînes ISO 8601 au lieu d'entiers epoch Unix.

**2026-07-08**

Soldes des utilisateurs

Les soldes des utilisateurs fournissent désormais une synthèse de solde complète et structurée.

* Les champs à plat `total_usd` et `balances` sont remplacés par un objet `balance` imbriqué.
* La synthèse distingue les liquidités, la crypto, les dépôts de trésorerie en cours et les soldes des comptes détenus par l'utilisateur.

**2026-07-01**

Ressources des gains de parrainage d'entreprises

Les gains de parrainage d'entreprises identifient désormais la ressource polymorphe à l'origine du gain.

* `receipt` est remplacé par `resource`.
* `access_pass` est remplacé par `product`.
* Les gains adossés à des reçus renvoient `resource.object: "receipt"` avec les détails de paiement du reçu.
* Le champ `resource` pourra prendre en charge d'autres ressources de gains dans de futures versions sans réutiliser des champs propres aux reçus.

**2026-06-20**

Ressource des parrainages d'entreprises

Le volume et les gains des parrainages d'entreprises sont désormais présentés sous forme de groupes rapprochables.

* `processing_volume`, `total_earnings`, `pending_payout` et `completed_payout` sont remplacés par les objets imbriqués `volume_usd` et `earnings_usd`.
* Les gains renomment `base_amount`/`amount` en `transaction_amount_usd`/`commission_amount_usd` et expriment `payout_percentage` sous forme de fraction.

**2026-06-09**

Ressource Variants (alors nommée Plans)

Les variantes, alors nommées Plans, utilisent désormais le modèle Account de manière cohérente.

* Les paramètres et corps de requête utilisent `account_id` au lieu de `company_id`.
* Les réponses de variante renvoient `account` au lieu de `company`.

**2026-06-08**

Ressource Users

Les requêtes d'accès utilisateur utilisent désormais le modèle Account de manière cohérente.

* Les paramètres et corps de requête utilisent `account_id` au lieu de `company_id`.
* Les formes des réponses sont inchangées.

**2025-01-01**

Version d'origine

Le comportement d'origine de la Current API avant l'existence du versionnement daté.

Les requêtes sans `Api-Version-Date` utilisent cette version afin que les intégrations existantes continuent de fonctionner.


## Related topics

- [API Products](https://docs.whop.com/fr/api-reference/products/product.md)
- [Migrer depuis les versions précédentes](https://docs.whop.com/fr/developer/api/migrate-from-previous-versions.md)
- [API Vérifications](https://docs.whop.com/fr/api-reference/verifications/verification.md)
