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 omettentApi-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. RemplacerapiVersionDate modifie la version de la réponse, mais pas les types du SDK.
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.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.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 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.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.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 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.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.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.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 facturent 115 , puis 40 $.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.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.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.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.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 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.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.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 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.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.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.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 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 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, 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 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 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 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 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 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.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.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.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.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.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.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.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.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 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 /domainsavecapple_pay=any, ouapple_pay=readypour les domaines vérifiés. Filtrez par nom d’hôte avecdomainau lieu dehostname.GET /payment_method_domains/{id}:GET /domains/{id}.POST /payment_method_domains:POST /domainsavecdomain,account_idetapple_pay: {}. Si le compte possède déjà le domaine,PATCH /domains/{id}avecapple_pay: {}.POST /payment_method_domains/{id}/verify:POST /domains/{id}/check.DELETE /payment_method_domains/{id}:PATCH /domains/{id}avecapple_pay: null.DELETE /domains/{id}supprime le domaine entier, y compris tout site web hébergé dessus.status: verifiedcorrespond àapple_pay.state: ready.status: pendingcorrespond àapple_pay.state: pendingpendant que Whop enregistre le domaine, ou àaction_requiredjusqu’à ce que vous hébergiez le fichier d’association et vérifiiez le domaine.
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.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
accountau lieu decompany. - Le listage des avis filtre par
account_idouproduct_id, trie avecorderetdirection, 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_idn’est plus accepté. Utilisezaccount_id.DELETE /reviews/{id}supprime un avis rédigé par l’utilisateur connecté et nécessite le scopereview:delete.
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.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.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.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.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_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.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.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.La création d’un build d’application n’accepte plus
ai_prompt_id.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 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 ne renvoient plus
social_accounts.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.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.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.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.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.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.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 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.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.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(anciennementcompany),member_id(anciennementmember),payment_method_id(anciennementpayment_method) etcheckout_configuration_id(anciennementcheckout_configuration). L’acheteur est un résuméuser(id,username,name,profile_picture). error_messageest déplacé danslast_setup_error, le même bloc{ code, message }que renvoie Retrieve setup status. Il restenulljusqu’à ce qu’un échec survienne, et disparaît une fois la configuration réussie.return_url,payment_method_typeetupdated_atsont nouveaux.created_atetupdated_atsont 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. Soncardgagneexp_monthetexp_yearsur les deux ressources.card.brandpeut valoirnull: 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’objetcardentier.- La création d’un setup intent répond
201 Created(anciennement200), respecteIdempotency-Keyet exige exactement l’un des champsconfirmation_tokenoupayment_method_id. Un jeton de confirmation provenant d’un autre compte renvoie404. client_secretest 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 identifiantspayment:chargedu compte ou le propre jeton de l’acheteur. Les lignes de liste contiennent toujoursnull.- Les webhooks
setup_intent.requires_action,setup_intent.succeededetsetup_intent.canceledfixés sur cette version ou une version ultérieure livrent ce même objet Setup Intent commedata. Les webhooks fixés sur une version antérieure, et les webhooks sans version fixée, conservent le payload précédent. GET /setup_intentsliste avec l’enveloppe standard{ data, page_info }et une pagination par curseur.account_idest facultatif : une clé API de compte liste son propre compte, et un jeton utilisateur liste tous les comptes qu’il peut lire.statusest un nouveau filtre, et une valeur invalide renvoie400.created_beforeetcreated_afterfonctionnent comme avant.
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.SDK TypeScript :
@whop/sdk@1.1.5.Les comptes, variantes, configurations de checkout et sessions de checkout exposent trois choix 3D Secure :mandate_challengedemande une authentification forte avant le traitement d’un paiement par carte pris en charge avec l’acheteur présent.mandate_if_requiredimpose une authentification forte uniquement lorsque le processeur de paiement l’exige.frictionless_if_requiredutilise le parcours 3DS sans friction habituel.
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 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.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.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_coursesdevienteducation,physical_productdevientecommerce, etmarketplacedevientplatform.- 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 renvoient400.
null.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.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.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_typeexplicites 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, etsource_typepeut valoirengagement. Les audiences d’engagement peuvent également servir de sources pour des audiences similaires. GET /social_accounts/{id}/postsinclutvideo_idetcaptionpour aider à sélectionner des vidéos sans avoir à retrouver manuellement leurs identifiants de plateforme.
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.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
networkde 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 dansmethods.crypto. metadataest 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_iddans la réponse n’est plus nul, car chaque destination désigne désormais un compte.
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.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(anciennementcompany),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_currencyetsettlement_exchange_ratesont intégrés àtotaletcurrency.refunded_amountettax_refunded_amountsont exprimés tels qu’ils ont été réglés, au taux en vigueur lors de l’émission de chaque remboursement, ettax_refunded_amountfigure 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_attemptdeviennentlast_payment_attempt_at/next_payment_attempt_at. Les informations sur la carte se trouvent danspayment_instrument.- La création d’un paiement accepte
account_id(anciennementcompany_id), répond201 Created, respecteIdempotency-Keyet acceptecapture: falsepour 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}/feessont{ type, origin, label, description, amount, settlement_amount, collected_at }avec des objets monétaires (anciennementname/amount/currency/type). GET /refundsetGET /refunds/{id}renvoient le Refund natif :payment_idetaccount_idau lieu d’un paiement intégré,amountsous forme d’objet monétaire dans la devise de règlement du paiement,original_amountdans la devise du processeur. Le filtrecompany_iddevientaccount_id, et l’envoi decompany_idrenvoie une erreur 400.POST /payments/{id}/refund,POST /payments/{id}/retryetPOST /payments/{id}/voidsont également natifs et renvoient le même objet Payment. Le remboursement accepte toujours unpartial_amountfacultatif.GET /paymentsliste 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_cyclecorrespond également aux renouvellements enregistrés commesubscription_update. Les paiements d’un montant nul sont inclus, donc leinclude_freedu proxy disparaît. Unstatusinvalide renvoie une erreur400, 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’acheteurqueryfonctionne comme avant. La fenêtrecreated_before/created_afterne 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_atest nul — récupérez le paiement pour l’obtenir.
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_reportsrenvoie410 Goneavec unerror.typevalantgone. UtilisezGET /stats/time_series/ad_deliverypourspend,impressionsetclicksdans le temps, limités avec un cheminsourcecommewhop:adcamp_xxx:*. UtilisezGET /stats/time_series/eventspour 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_groupsetGET /adsacceptentstats_frometstats_toet renvoientspend,resultsetreturn_on_ad_spendsur chaque ligne. - Chaque réponse de l’ancien endpoint, dans toutes les versions, comporte désormais les en-têtes
DeprecationetLink: <…/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êteSunsetannonce la date à laquelle il cessera de répondre pour toutes les versions.
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_dateetto_datesont renommés enfrometto.- Les dates seules ne sont plus acceptées. Incluez une heure et un décalage dans les deux horodatages.
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
verifiedpour renvoyer les modèles de sites web publiquement découvrables des deux états de vérification. - Définissez
verified=truepour les modèles vérifiés par Whop ouverified=falsepour les modèles de la communauté. recommended=truefiltre les applications recommandées indépendamment du statut de vérification.
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 /withdrawalsetPOST /withdrawalsrenvoient410 Goneavec unerror.typevalantgone. Utilisez plutôtGET /payoutsetPOST /payouts. Les ID de versements sont les mêmes IDwdrl_, donc les identifiants existants continuent d’être résolus.GET /withdrawals/{id}répond toujours dans cette version. UtilisezGET /payouts/{id}pour les nouveaux développements.- Chaque réponse des anciens endpoints, dans toutes les versions, comporte désormais les en-têtes
DeprecationetLink: <…/payouts>; rel="successor-version". Un en-têteSunsetannoncera 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.
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_idrenvoie 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 auparavantnullpour 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_sourceetpost_thumbnail_urldécrivent ce champ.
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,visibilityet uncreated_atISO 8601. Les champssizeeturlvalentnulljusqu’à ce que le téléversement soitready. GET /files/{id}ne résout que les fichiers que vous avez créés — les autres appelants reçoivent une erreur 404.
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.statuscomprend huit valeurs :requested,in_review,processing,completed,reversed,canceled,failed,denied. Un versement réglé que le fournisseur annule indiquereversed, avec le code de retour etfunds_returned_atdansfailure.- Un nouveau champ
status_detailcontient la phase machine la plus fine sous la valeur de statut. Ses valeurs peuvent s’étendre sans changement de version —statusconstitue le contrat versionné. amount,fee_amount,net_amount,markup_feeetdestination_amountsont des chaînes décimales.exchange_ratereste un nombre.- Les versements sont créés sous leur ID
wdrl_: l’ID renvoyé parPOST /payoutsest l’ID listé parGET /payouts, et la demande de conversion d’un versement est conservée souspayout_request_id. Les demandes de conversion créées avant cette version continuent de répondre sous leur IDcofr_. - La clé d’idempotence n’est envoyée que dans l’en-tête
Idempotency-Key, et le champ de corpsidempotency_keyest rejeté.
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.Le champ
company_id de l’enveloppe des webhooks est renommé en account_id.- Les livraisons de webhooks fixées sur
2026-08-14ou une version ultérieure contiennentaccount_iddans l’enveloppe. - Les webhooks fixés sur des versions antérieures — et les webhooks sans
api_version_datefixée — conserventcompany_id.
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
pendingetin_transitpour 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
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 passentapi_versionsont rejetées avec une erreur400. - Fixez plutôt la forme du payload d’un webhook avec
api_version_date. - Les webhooks
v2etv5existants continuent d’être livrés. Vous ne pouvez plus créer de webhooks dans ces versions ni y basculer.
Les alertes de litige sont désormais une ressource REST native et restent servies en parallèle avec l’ancien proxy.
GET /dispute_alertsliste les alertes d’un compte avec une pagination par curseur, et filtre paraccount_id,payment_id,typeet une fenêtre de création.typeremplacealert_typeet désigne les deux types qu’un émetteur envoie :early_fraud_warning(signalements de fraude Visa TC40 / Mastercard SAFE) etdispute_alert(avis de pré-litige).fee_chargedremplacecharge_for_alertet indique si Whop a réellement facturé le compte. Les alertes précoces de fraude ne sont jamais facturées.actionableindique si le remboursement du paiement peut encore éviter une rétrofacturation.- Les objets
paymentetdisputesont remplacés par les tagspayment_idetaccount_id. Les horodatages sont au format ISO 8601, avecreported_atpour la date à laquelle l’émetteur a déposé le signalement.
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.amountest le montant defrom_tokenà convertir au taux moyen du marché. Aucun solde négatif n’est requis.- Le dimensionnement d’un remboursement partiel d’un solde
to_tokennégatif est déplacé vers le nouveau champto_amount(libellé ento_token, plafonné au montant de la dette).amountetto_amounts’excluent mutuellement. - Omettre les deux rembourse toujours la totalité du solde
to_tokennégatif. - Les appelants fixés sur des versions antérieures conservent l’ancien comportement : leur
amountfiat est traité comme le montant de remboursement ento_token.
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 commebank_statement, ou une clé de champ commessn, avec unlabelà afficher à l’utilisateur. - Répondez aux entrées
fileavecfile(un ID de téléversement direct). Répondez aux entréestext,date,phoneetselectavecvalue, et aux entréesaddressavecaddress. Rien de la réponse n’est renvoyé à l’identique. - Une entrée marquée
multipleaccepte 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
optionsaccepte également unevalue. Pour les entréesselect, 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
errorsstructurées avec uncodestable et unereason. - La forme imbriquée
requested_files/categorydisparaît de cette version. Les appelants fixés sur des versions antérieures la conservent, et leurs réponses sont traduites automatiquement.
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_codesliste les codes promo d’un compte et utiliseaccount_idau lieu decompany_id.POST /promo_codescrée des codes promo.GETetDELETE /promo_codes/{id}les récupèrent et les archivent.POST /promo_codes/{id}/activateetPOST /promo_codes/{id}/deactivateremplacent l’ancienne écriture de statut viaPATCH.- 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.
Les réponses de compte exposent désormais une relation de compte parent enrichie pour les comptes connectés.
parent_accountremplaceparent_account_id.- Le compte parent inclut son
id, sontitle, sarouteet sonlogo_url.
Les méthodes de versement prises en charge disposent désormais de leur propre endpoint paginé.
GET /payouts/supported_methodsliste 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 IDpodst_sont passés en tant quesupported_payout_method_id. - Les méthodes de versement enregistrées exposent
supported_payout_method. Les versements exposentpayout_method.supported_payout_method. - Utilisez
countrypour lister les méthodes prises en charge dans un pays autre que celui du compte de versement. GET /payouts/methodsn’accepte plusinclude_availableet ne renvoie plusavailable_destinations.- Les appelants fixés sur des versions antérieures conservent
destination_id,payout_destinationetpayout_token.
Les transactions par carte utilisent désormais des endpoints REST natifs et restent servies en parallèle avec l’ancien proxy.
GET /card_transactionsliste les transactions par carte d’un compte, etGET /card_transactions/{id}en récupère une par son IDcitx_. La liste accepte également un filtretransaction_idspour 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_afteretcreated_before. Les filtres d’horodatage sont au format ISO 8601. cardholder_idest nouveau dans la réponse : l’utilisateur auquel la carte est attribuée.
- Chaque méthode de versement renvoie
fee_structure(pourcentage, montant fixe et devise) etestimated_arrival(horodatages par vitesse) sans exiger d’amount. - Les objets
standardetinstantdu devis n’incluent plusestimated_arrival. Lisez-le depuis le champestimated_arrivalde premier niveau de la méthode.
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,reasonetavailable_actionsexposent 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 viaGET /resolution_center_cases/summary. - Les écritures utilisent
messageetattachments.due_dateest renomméresponse_due_at. Le listage n’exige plusaccount_id.
Les expéditions utilisent désormais des endpoints REST natifs et restent servies en parallèle avec l’ancien proxy.
GET /shipmentsliste les expéditions.GET /shipments/{id}récupère une expédition par son ID d’expédition ou de paiement.POST /shipmentscrée une expédition, etPATCH /shipments/{id}met à jour son numéro de suivi.- Les réponses utilisent
account_idettracking_number, ainsi quecarrier,tracking_url,order_idetpayment_id. - Les appelants fixés avant cette date conservent l’ancien contrat du proxy sans changement.
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, etPOST /disputes/{id}/submitles soumet. Les preuves sont imbriquées sousevidence.GET /disputes/summaryfournit des totaux regroupés parstatusetcurrency. Le listage et la récupération renvoient les mêmes champs.- Les réponses utilisent
account_id,product_idetplan_id, ainsi quebuyerà côté depayment. Le listage n’exige plusaccount_id. statusetreasonsont des enums normalisés, etneeds_response_by,rdreteditablesont remplacés par leurs nouveaux champs.- Les appelants fixés avant cette date conservent l’ancien contrat du proxy sans changement.
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_idetproduct_idau lieu des objets de compatibilité imbriquésplanetproduct. - 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_idrestreignent cette liste au lieu de changer de mode ou de renvoyer une erreur. - Définissez
cancel_at_period_endpour programmer une annulation. L’actioncancelmet fin à l’accès immédiatement. - L’action
extendremplaceadd_free_days.
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
accountau lieu decompany.
Les entreprises partenaires exposent désormais des taux de versement distincts pour chaque source de revenus.
payout_percentageest remplacé parpayout_percentages.- L’objet imbriqué inclut les taux
sales,ad_spend,transferetcard_interchange.
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_idau lieu decompany_id. - Les requêtes de configuration de checkout utilisent
account_idau 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_idau lieu decompany_id.
Les horodatages des configurations de checkout utilisent désormais le même format que le reste de l’API.
created_atetupdated_atsont des chaînes ISO 8601 au lieu d’entiers epoch Unix.
Les soldes des utilisateurs fournissent désormais une synthèse de solde complète et structurée.
- Les champs à plat
total_usdetbalancessont remplacés par un objetbalanceimbriqué. - 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.
Les gains de parrainage d’entreprises identifient désormais la ressource polymorphe à l’origine du gain.
receiptest remplacé parresource.access_passest remplacé parproduct.- Les gains adossés à des reçus renvoient
resource.object: "receipt"avec les détails de paiement du reçu. - Le champ
resourcepourra prendre en charge d’autres ressources de gains dans de futures versions sans réutiliser des champs propres aux reçus.
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_payoutetcompleted_payoutsont remplacés par les objets imbriquésvolume_usdetearnings_usd.- Les gains renomment
base_amount/amountentransaction_amount_usd/commission_amount_usdet exprimentpayout_percentagesous forme de fraction.
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_idau lieu decompany_id. - Les réponses de variante renvoient
accountau lieu decompany.
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_idau lieu decompany_id. - Les formes des réponses sont inchangées.

