Skip to main content
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.
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.
Latest
Un niveau ne conserve que son niveau et ses points
level sur Retrieve user et Retrieve account 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.
Le `applied_level` d'un niveau devient `current`
level.applied_level est renommé en level.current sur Retrieve user et Retrieve account. La valeur est inchangée : le niveau qui s’applique, de 0 à 10.
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.
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 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 ne renvoie aucune demande, et le user d’une demande vaut toujours null.
Le niveau d'un utilisateur est public
Retrieve user 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.
Lister et récupérer vos propres achats
Avec des identifiants utilisateur, user_id=me sur list payments 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 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.
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.
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 au lieu de lister les prospects. Ajoutez un membre par e-mail avec Create member. Lisez-en un ou mettez-le à jour avec Retrieve member et Update member.
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.
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 avectroisversementsde40avec trois versements de 40 facturent 115 ,puis40, puis 40 , puis 40 $.
L'offre Economic Intelligence renouvelable est `3_days`
SDK TypeScript : @whop/sdk@2.8.0.L’offre renouvelable dans economic_intelligence_offers sur Retrieve account preferences 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. La clé weekly est rejetée.
Les statistiques d'annonces n'acceptent plus `clicks`
Le champ clicks est retiré de Create ad stats. 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.
API de chat : canaux, membres et messages
Intégrez le chat à votre application. Les canaux couvrent les messages directs, les discussions de groupe, les chats de communauté et les chats de support. Les membres de canal permettent d’ajouter et de retirer des personnes. Les messages 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 renvoie 204. Réagissez et votez avec POST /messages/{id}/react, /unreact et /vote.
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 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.
Les listes de versements incluent la Whop Card
List saved payout methods inclut la Whop Card du compte. List payouts 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, 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.
Un dossier de litige en cours de dépôt indique `generating_response`
Un litige 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.
Whop Levels : le niveau appliqué est `applied_level`
Sur le level d’un utilisateur et d’un compte, 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. Le level d’un compte ajoute également account_level, le niveau atteint par ses propres points.
Les certifications publicitaires sont supprimées
Whop ne propose plus de certifications publicitaires. Retrieve account preferences et Update account preferences ne renvoient plus ads_certifications, et une mise à jour ne l’accepte plus.
Les comptes connectés deviennent des sous-comptes
Les comptes enfants de plateforme s’appellent désormais des sous-comptes. Sur List payments et List disputes, ainsi que sur leurs endpoints de synthèse, include_connected_accounts devient include_subaccounts. Sur Update account preferences, 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.
Les demandes de versement nécessitent un devis
Create a payout 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.
Le client d'une facture ne peut plus changer après la création du brouillon
Sur Update invoice, 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. Puis créez une nouvelle facture. Un brouillon enregistré sans client peut toujours en recevoir un.
Les connexions Snapchat sont supprimées
Connect an External Account 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.
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.
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 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.
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.
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 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.
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.
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, Duplicate an Ad Group ou Duplicate an Ad 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.
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.
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 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, Create ad ou Update ad renvoie une erreur 400.
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, Update ad group, Create ad ou Update ad renvoie une erreur 400 qui nomme le champ.
Les listes de variantes d'un compte excluent les variantes de factures héritées
List variants 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 par son ID. La liste dépréciée GET /plans se comporte de la même manière.
Les swaps rejettent un montant supérieur au solde du portefeuille
Sur Create swap, 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.
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 et Create waitlist entry acceptent variant_id, et Approve all waitlist entries accepte et renvoie variant_id. List memberships filtre avec variant_id et variant_ids, List members avec variant_ids, et List waitlist entries 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 filtre avec variant_ids au lieu de plan_ids. Create payment et Create payment quote 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 accepte variant_id au lieu de plan_id et une variant en ligne (avec billing_type) au lieu de plan, et List checkout configurations 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 filtre avec variant_ids au lieu de plan_ids, et Create promo code accepte variant_ids.
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 accepte billing_type, et List variants et List products 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 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.
Les invitations renvoient le membre de l'équipe en attente
Lorsque Create team member 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.
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.
Les comptes n'incluent plus stablecoin_rails
Les comptes n’incluent plus stablecoin_rails.
Les types de documents de vérification sont en minuscules
Sur Create verification, 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é indique ceux qu’accepte chaque pays.
Le prélèvement par carte d'un dépôt est déplacé sous methods
Sur Create deposit, 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.
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 :
  • 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.
Avis natifs
SDK TypeScript : @whop/sdk@2.5.0.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.
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.
Les applications ne listent plus les anciennes URL hébergées
SDK TypeScript : @whop/sdk@2.4.0.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.
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.
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.
Les fonds en attente peuvent attendre une vérification de conformité
SDK TypeScript : @whop/sdk@2.3.0.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.
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.
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.
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.
Les builds d'applications n'acceptent plus de prompt IA
La création d’un build d’application n’accepte plus ai_prompt_id.
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.
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.
Les utilisateurs n'incluent plus les comptes sociaux
Les utilisateurs ne renvoient plus social_accounts.
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.
Les litiges évités indiquent prevented
SDK TypeScript : @whop/sdk@2.1.0, @whop/sdk@2.2.0.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.
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.
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.
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.
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.
L'accès au trading apparaît dans les vérifications de permissions
SDK TypeScript : @whop/sdk@2.0.0.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.
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.
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.
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.
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.
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.
Trois politiques 3D Secure distinctes
SDK TypeScript : @whop/sdk@1.1.5.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.
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.
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.
Les catégories d'entreprise proviennent d'une seule table
SDK TypeScript : @whop/sdk@1.1.4.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 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.
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.
Blocages de retrait Whop nommés sur les fonds en attente
SDK TypeScript : @whop/sdk@1.1.3.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.
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.
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.
Les destinations de dépôt sont un ID de compte
SDK TypeScript : @whop/sdk@1.1.1, @whop/sdk@1.1.2.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.
Les paiements deviennent une ressource native
SDK TypeScript : @whop/sdk@1.1.0.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.
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 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.
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.
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.
Les anciens endpoints de retraits sont retirés
Les anciens endpoints /withdrawals sont dépréciés au profit de l’API native Payouts 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.
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.
API native Files
SDK TypeScript : @whop/sdk@1.0.14.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.
Statut des versements v2
SDK TypeScript : @whop/sdk@1.0.13.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.
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.
Détail des soldes en transit
SDK TypeScript : @whop/sdk@1.0.11.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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.