Skip to main content
De Current API wordt geversioneerd met datums. Brekende wijzigingen worden alleen uitgebracht in een nieuwe gedateerde versie waarvoor je zelf kiest. Pin een versie, en de verzoek- en responsstructuren waarop je hebt gebouwd veranderen nooit. Officiële SDK’s sturen automatisch de versie mee waarmee ze zijn gegenereerd.
Als je geen Api-Version-Date meestuurt en geen opgeslagen pin op je API-sleutel hebt, wordt het stabiele API-model gebruikt. Verzoeken zonder beide worden afgehandeld met het gedrag van vóór het versiebeheer, zodat bestaande integraties ongewijzigd blijven werken. Pin een gedateerde versie om voor de nieuwste API te kiezen.

Versiepins op API-sleutels

API-sleutels hebben een eigen API-versiepin. Verzoeken die zijn geauthenticeerd met een API-sleutel gebruiken die pin wanneer ze Api-Version-Date weglaten. Bestaande sleutels zonder opgeslagen pin gebruiken 2025-01-01. Nieuw aangemaakte sleutels gebruiken de nieuwste uitgebrachte versie. Een expliciete Api-Version-Date-header heeft altijd voorrang op de pin van de API-sleutel, zodat je een upgrade kunt testen voordat je de opgeslagen versie wijzigt. Elke versie krijgt automatisch nieuwe endpoints en optionele velden. Brekende wijzigingen leiden tot een nieuwe gedateerde versie, die in de changelog hieronder wordt vermeld. Bekijk bij het upgraden elke vermelding na je huidige pin tot en met je doelversie, niet alleen de vermeldingen uit de doelmaand. Met name een upgrade van 2026-07-20 naar september gaat over de migratie van leden en lidmaatschappen van 2026-07-23 heen.

Changelog

De TypeScript SDK-releases die hieronder worden vermeld, gebruiken standaard de API-versie uit die vermelding. Het overschrijven van apiVersionDate wijzigt de responsversie, maar niet de SDK-typen.
Latest
Een level behoudt alleen het level en de punten
level op Retrieve user en Retrieve account heeft nu current, points, points_by_source en resets_at, plus account_level op een account.Deze velden zijn verwijderd uit level: levels, points_to_next, monthly_qualifying_spend, monthly_card_spend, monthly_ads_spend en monthly_trading_volume. boosted is verwijderd uit het level van een account. Een account is geboost wanneer het account_level lager is dan current.
`applied_level` van een level is nu `current`
level.applied_level heet nu level.current op Retrieve user en Retrieve account. De waarde is ongewijzigd: het level dat van toepassing is, van 0 tot en met 10.
De lijst met doorverwezen gebruikers reageert na 17 november niet meer
GET /partners/referred_users reageert na 17 november 2026 niet meer. Vanaf 18 november retourneert elke versie een 410. Tot die tijd bevat elke respons Deprecation- en Sunset-headers. De lijst heeft geen vervanger.
Attributieverzoeken aan een gebruiker zijn beëindigd
Partners kunnen geen attributieverzoek meer naar een gebruiker sturen. Dit geldt voor elke API-versie, niet alleen voor deze.Create a partner referral request weigert target_user_id, target_username en target_email met een 400 waarvan de code user_referral_requests_retired is. Stuur account_id of account_url om attributie voor een bedrijf aan te vragen. Verzoeken die naar een gebruiker zijn gestuurd, worden niet meer vermeld of opgehaald, het filter target_user_id op list partner referral requests retourneert geen verzoeken, en user op een verzoek is altijd null.
Het level van een gebruiker is openbaar
Retrieve user retourneert level voor elke gebruiker van wie de accounts in Whop Levels zitten, niet alleen voor jezelf. level.applied_level is het level van de gebruiker, van 0 tot en met 10.De andere velden in level, zoals points, points_by_source, de monthly_*-bedragen en levels, zijn null, tenzij je jezelf ophaalt met de gereserveerde ID me en de scope voor het lezen van saldi hebt. Controleer ze op null voordat je ze leest.
Je eigen aankopen weergeven en ophalen
Met gebruikersreferenties retourneert user_id=me op list payments je eigen betalingen. Dat omvat je aankopen bij elk account en je betalingen op accounts waarvoor je verkoopt. Voeg de account_id toe van een account waar je hebt gekocht om alleen die aankopen weer te geven. Retrieve payment retourneert een betaling die je als koper hebt gedaan.Een aankoop toont wat je als koper kunt zien. Velden aan de kant van het account, zoals amount_after_fees, usd_total, holds en metadata, zijn daarop null of leeg. amount_charged geeft aan wat je in rekening is gebracht, inclusief kosten voor de koper.
Teamleden bevatten hun account als object
Teamleden hebben geen account_id op het hoogste niveau meer. Lees de account-ID uit account.id. Het account-object bevat ook de title, route en logo_url van het account.
De leads-API is uitgefaseerd
De /leads-endpoints zijn verouderd en worden niet meer vermeld in de API-referentie. Vanaf deze versie retourneren ze een 410. Eerdere versies blijven werken tot 20 november 2026, met Deprecation-, Sunset- en successor-Link-headers. Na die datum retourneert elke versie een 410.Elke lead is ook lid van het bijbehorende bedrijf, met de ID van de lead in de metadata van het lid als lead_id. Gebruik List members in plaats van leads weer te geven. Voeg een lid toe op e-mailadres met Create member. Lees of werk er een bij met Retrieve member en Update member.
De lijst met doorverwezen gebruikers is verouderd
GET /partners/referred_users is verouderd en wordt niet meer vermeld in de API-referentie. Het blijft reageren voor bestaande integraties, met een Deprecation-header op elke respons, en heeft geen vervanger.
Terugkerende facturen bevatten de vooruitbetaling
Bij het aanmaken van een factuur of het vervangen van de items ervan worden op de eerste factuur de initial_price plus de renewal_price van een terugkerende variant in rekening gebracht. Verlengingsfacturen brengen alleen renewal_price in rekening. Het bewerken van andere velden behoudt de opgeslagen prijzen van de factuur.Het betalen van de eerste factuur start direct een betaalde factureringsperiode, zonder de proefperiode van de variant. Een eindig aantal betalingen omvat die factuur: een vooruitbetaling van $75 met drie termijnen van $40 factureert $115, dan $40 en dan $40.
Het terugkerende Economic Intelligence-aanbod is `3_days`
TypeScript SDK: @whop/sdk@2.8.0.Het terugkerende aanbod in economic_intelligence_offers op Retrieve account preferences heeft nu de sleutel 3_days. Het wordt elke 3 dagen verlengd. Om het in te schakelen stuur je economic_intelligence_duration_key: "3_days" naar Update account preferences. De sleutel weekly wordt geweigerd.
Advertentiestatistieken accepteren geen `clicks` meer
Het veld clicks is verwijderd uit Create ad stats. De clicks van een uur zijn de paginaweergaven van de advertentie die door de Whop-pixel zijn geregistreerd, en een clicks-waarde die op welke versie dan ook wordt verzonden, wordt genegeerd.
Chat-API: kanalen, leden en berichten
Bouw chat in je app. Channels omvatten directe berichten, groepschats, communitychats en supportchats. Met Channel members voeg je mensen toe en verwijder je ze. Messages kunnen worden verzonden, bewerkt, vastgezet, voorzien van een reactie en gestemd./messages verandert vanaf deze versie van structuur. Een bericht heeft channel_id en author in plaats van user, en edited en pinned in plaats van is_edited en is_pinned. Zet vast met POST /messages/{id}/pin en /unpin in plaats van met een update. Delete message retourneert 204. Reageer en stem met POST /messages/{id}/react, /unreact en /vote.
Het ledger-regeltype `bank_transfer` is uitgefaseerd
Iron-bankstortingen zijn regels in de ledger-activiteit met line_type onchain_deposit, en hun source.sender_address is iron. Het filter line_types op financiële activiteit en financiële rapporten accepteert bank_transfer niet meer.
Uitbetalingslijsten bevatten de Whop Card
List saved payout methods bevat de Whop Card van het account. List payouts bevat de uitbetalingen waarmee geld naar die kaart is verplaatst. Een opgeslagen uitbetalingsmethode, en de payout_method van een payout, heeft een type. external stuurt geld uit Whop. whop_card verplaatst geld naar de eigen Whop Card van het account. Laat whop_card-methoden weg in een lijst waarin een gebruiker kiest waarnaar hij wil opnemen.
Een lopende indiening voor een geschil rapporteert `generating_response`
Een geschil waarvan het bewijs bij de betalingsverwerker ligt en nog niet is geaccepteerd, rapporteert generating_response in plaats van under_review. Wanneer de verwerker het accepteert, gaat het geschil naar under_review. Wanneer de verwerker het weigert, keert het geschil terug naar needs_response en geeft het ophalen ervan submission_failure_reason. Beide overgangen worden verzonden als dispute.updated.
Whop Levels: het toegepaste level is `applied_level`
Op het level van een gebruiker en een account is current nu applied_level, en processing_rate_percentage is verwijderd. Lees het standaardpercentage voor kaartverwerking van een level uit de vermelding ervan in levels, en het eigen tarief van een account uit Retrieve account fees. Het level van een account voegt ook account_level toe, het level dat de eigen punten van het account bereiken.
Advertentiecertificeringen zijn verwijderd
Whop biedt geen advertentiecertificeringen meer aan. Retrieve account preferences en Update account preferences retourneren ads_certifications niet meer, en een update accepteert het niet meer.
Gekoppelde accounts zijn nu subaccounts
Onderliggende accounts van een platform heten subaccounts. Op List payments en List disputes, en op hun samenvattingsendpoints, is include_connected_accounts nu include_subaccounts. Op Update account preferences is covers_connected_account_negative_balances nu covers_subaccount_negative_balances, zowel in de respons als in de body van de update. Rijen in financiële rapporten die de groepering connected_accounts gebruikten, gebruiken nu subaccounts.
Uitbetalingsverzoeken vereisen een offerte
Create a payout vereist nu quote_token. Roep eerst POST /payouts/quotes aan en dien daarna het token in met dezelfde uitbetalingsgegevens voordat de offerte verloopt. Ontbrekende of ongeldige offertes retourneren 400 met invalid_payout_quote. Stuur bij een nieuwe poging voor een onzekere uitbetaling het oorspronkelijke token en de Idempotency-Key opnieuw mee, zodat de bestaande uitbetaling kan worden hersteld, zelfs nadat de offerte is verlopen.
De klant van een factuur kan niet meer veranderen nadat het concept is aangemaakt
Op Update invoice retourneert een member_id die afwijkt van de huidige klant van het concept een 400, ook null. Om iemand anders te factureren, maak je het concept eerst ongeldig. Maak daarna een nieuwe factuur aan. Aan een concept dat zonder klant is opgeslagen, kan nog steeds een klant worden toegevoegd.
Snapchat-koppelingen zijn verwijderd
Connect an External Account accepteert snapchat niet meer, het laatste platform dat de scope advertise gebruikte, dus het veld scopes is ook verdwenen. Het verzenden van snapchat of scopes retourneert een 400.
Advertentiecampagnes laten bid_type vallen
Advertentiecampagnes accepteren of retourneren bid_type niet meer. Elk advertentienetwerk kiest zelf hoe er op campagnes wordt geboden, en desired_cost_per_result is je doel op elk netwerk: het verandert nooit hoe advertenties bieden. Het verzenden van bid_type retourneert een 400.
Advertentiekoppelingen zijn verwijderd
Advertenties worden uitgevoerd onder de eigen pagina’s en profielen van Whop, dus je koppelt geen accounts meer voor advertenties. Connect an External Account accepteert meta_business niet meer, en tiktok accepteert de scope advertise niet meer. Het verzenden van een van beide retourneert een 400.
Regels voor conversiewaarde zijn verwijderd
Regels voor conversiewaarde zijn verwijderd, en advertentienetwerken ontvangen de oorspronkelijke waarde van elke conversie. Het weergeven van regels voor conversiewaarde is verouderd: het retourneert een lege lijst, het wordt niet meer gedocumenteerd en de responsen bevatten een Deprecation-header. Elk ander endpoint voor regels voor conversiewaarde retourneert een 410.
Doelgroepen laten betrokkenheidsregels vallen, en regeldoelen laten platform vallen
Doelgroepen kunnen niet meer worden opgebouwd op basis van sociale betrokkenheid. Bestaande betrokkenheidsdoelgroepen worden nog steeds vermeld met source_type engagement, maar retourneren engagement niet meer. Het verzenden van engagement, of engagement als source_type, naar Create audience retourneert een 400. Doelen van regels voor conversiewaarde accepteren of retourneren platform niet meer. Elk doel geldt voor elk netwerk waarop Whop het uitvoert, en het verzenden van platform op een doel retourneert een 400.
Partners van externe accounts zijn verouderd
Partnership-advertenties zijn niet meer beschikbaar. Het weergeven van de partners van een extern account retourneert een lege lijst. Het toevoegen of verwijderen van een partner retourneert een 400. Deze endpoints worden niet meer gedocumenteerd en hun responsen bevatten een Deprecation-header.
Duplicaten laten preserve_engagement vallen, en lijsten met posts en leadformulieren zijn verouderd
Het dupliceren van een advertentiecampagne, advertentiegroep of advertentie accepteert preserve_engagement niet meer. Het verzenden ervan naar Duplicate an Ad Campaign, Duplicate an Ad Group of Duplicate an Ad retourneert een 400. Het weergeven van de posts of leadformulieren van een extern account is verouderd: beide retourneren een lege lijst, worden niet meer gedocumenteerd en hun responsen bevatten een Deprecation-header.
Advertenties laten post_id vallen, en zoeken naar targeting is verouderd
Advertenties retourneren post_id niet meer. Het zoeken naar targetingopties voor advertentiegroepen en het schatten van het bereik van advertentiegroepen zijn verouderd: beide blijven werken, maar worden niet meer gedocumenteerd en hun responsen bevatten een Deprecation-header. Een doel van een regel voor conversiewaarde kan platform weglaten om elk netwerk te dekken waarop Whop het uitvoert.
Advertenties laten netwerkspecifieke velden en de doelstelling awareness vallen
Advertentiecampagnes, advertentiegroepen en advertenties retourneren platform niet meer, en Create an Ad Campaign accepteert het niet meer. Nieuwe campagnes kunnen de doelstelling awareness niet gebruiken. Bestaande awareness-campagnes retourneren deze nog wel. Advertenties accepteren of retourneren existing_post_id, post_source, external_accounts of translations niet meer, en retourneren post_thumbnail_url niet meer. Het verzenden van een verwijderd veld, of awareness als doelstelling, naar Create an Ad Campaign, Create ad of Update ad retourneert een 400.
Advertenties laten geavanceerde weergave- en creativevelden vallen
Advertentiecampagnes retourneren optimization_goal niet meer. Advertentiegroepen accepteren of retourneren optimization_goal, conversion_location, message_apps, minimum_daily_spend, dynamic_creative, placements, frequency_cap of detailed_targeting niet meer, en Whop stelt de weergave in op basis van de objective van de campagne. Advertenties accepteren of retourneren messaging_config, multi_advertiser_ads, lead_form, lead_form_id of music niet meer. Het verzenden van een van deze velden naar Create ad group, Update ad group, Create ad of Update ad retourneert een 400 met de naam van het veld.
Variantlijsten van accounts laten varianten van verouderde facturen weg
List variants met account_id laat varianten weg die zijn gegenereerd voor een verouderde factuur, inclusief varianten waarvan de factuur inmiddels is verwijderd. Om er een te lezen, haal je de variant op op ID. De verouderde lijst GET /plans gedraagt zich op dezelfde manier.
Swaps weigeren een bedrag boven het walletsaldo
Op Create swap retourneert een decimaal amount boven het from_token-saldo van de wallet een 400. De fout vermeldt het beschikbare saldo. Eerdere versies starten de swap, die daarna on-chain mislukt. De controle wordt overgeslagen wanneer het saldo niet kan worden gelezen. USDT wordt niet gecontroleerd, omdat een USDT-swap ook gebruik kan maken van het kaartsaldo.
Alle andere resources noemen varianten nu varianten
Lidmaatschappen, leden en wachtlijstinschrijvingen. Op lidmaatschappen en wachtlijstinschrijvingen is plan_id nu variant_id, en op de variant die in een wachtlijstinschrijving is opgenomen, is plan_type nu billing_type. Invite to a membership en Create waitlist entry accepteren variant_id, en Approve all waitlist entries accepteert en retourneert variant_id. List memberships filtert met variant_id en variant_ids, List members met variant_ids en List waitlist entries met variant_id, in plaats van plan_id en plan_ids.Betalingen, facturen en geschillen. Op betalingen, geschillen en zaken in het Resolution Center is plan_id nu variant_id, en op hun line_items zijn plan_id en plan_title nu variant_id en variant_title. Op de line_items van betalingsoffertes en facturen is plan_id nu variant_id. List payments filtert met variant_ids in plaats van plan_ids. Create payment en Create payment quote accepteren variant_id en variant in plaats van plan_id en plan, in de body en in elke vermelding van line_items. Het aanmaken en bijwerken van een factuur accepteert variant_id en variant in plaats van plan_id en plan in elke vermelding van items. Een inline variant accepteert billing_type in plaats van plan_type. Op events is related.plan nu related.variant.Checkout. Op checkoutconfiguraties is plan nu variant, en het bijbehorende plan_type is nu billing_type. Create checkout configuration accepteert variant_id in plaats van plan_id en een inline variant (met billing_type) in plaats van plan, en List checkout configurations filtert met variant_id. Verzoeken en responsen voor checkoutsessies gebruiken items[].variant in plaats van items[].plan.Promotiecodes en partners. List promo codes filtert met variant_ids in plaats van plan_ids, en Create promo code accepteert variant_ids.
Producten en varianten noemen varianten nu varianten
Op producten is default_plan nu default_variant. Op varianten, en op de varianten die in een product zijn opgenomen, is plan_type nu billing_type. Create variant accepteert billing_type, en List variants en List products filteren met billing_types in plaats van plan_types.Gebruik /variants en de SDK-namespace variants in plaats van /plans. De /plans-endpoints reageren nog steeds op elke versie, met Deprecation- en successor-Link-headers. Om belasting vooraf te bekijken, maak je een betalingsofferte aan in plaats van POST /variants/{id}/calculate_tax of POST /plans/{id}/calculate_tax aan te roepen, die op dezelfde manier verouderd zijn.Variant-ID’s behouden de prefix plan_, en de machtigingsscopes plan:* en de webhook-eventnamen plan.* zijn ongewijzigd.
Uitnodigingen retourneren het teamlid in afwachting
Wanneer Create team member een uitnodiging verstuurt in plaats van het lid toe te voegen, is de 202-respons nu het teamlid in afwachting. De status ervan is pending en de ID begint met ausri_. De respons bevat geen object of invitation_sent meer.
Facturen op basis van bonnen
De native Invoices API gebruikt pay_-ID’s en items op basis van varianten, inclusief het inline aanmaken van varianten. Aanmaken slaat een concept op. Je kunt concepten bijwerken en een concept dat je niet meer nodig hebt ongeldig maken. De gefactureerde klant is een lid. Een e-mailadres dat niet bij een Whop-gebruiker hoort, maakt er een aan. recipient_emails zijn de eigen bezorgadressen van de factuur, los van het gefactureerde lid. De kosten voor de koper zijn een aanpasbaar percentage.
Accounts bevatten geen stablecoin_rails meer
Accounts bevatten stablecoin_rails niet meer.
Documenttypen voor verificatie zijn in kleine letters
Op Create verification, en op eigenaren in owners, accepteert document_type waarden in kleine letters: passport, id_card, drivers of residence_permit. De gids over identiteitsdocumenten vermeldt welke documenten elk land accepteert.
Kaartafschrijving voor stortingen verplaatst naar methods
Op Create deposit is de afschrijving van een opgeslagen betaalmethode verplaatst van card op het hoogste niveau naar methods.card, naast bank en crypto. De velden zijn ongewijzigd en het is nog steeds null, tenzij payment_method_id is meegegeven. Aanroepers die op een eerdere versie zijn vastgezet, behouden card op het hoogste niveau.
Domeinen voor betaalmethoden zijn verouderd ten gunste van domains
De endpoints voor domeinen van betaalmethoden zijn verouderd en worden niet meer vermeld in de API-referentie. Voeg Apple Pay-domeinen in plaats daarvan toe, controleer en verwijder ze met de apple_pay-functionaliteit van de domains-API:
  • GET /payment_method_domains: GET /domains met apple_pay=any, of apple_pay=ready voor geverifieerde domeinen. Filter op hostnaam met domain in plaats van hostname.
  • GET /payment_method_domains/{id}: GET /domains/{id}.
  • POST /payment_method_domains: POST /domains met domain, account_id en apple_pay: {}. Als het account het domein al heeft, PATCH /domains/{id} met apple_pay: {}.
  • POST /payment_method_domains/{id}/verify: POST /domains/{id}/check.
  • DELETE /payment_method_domains/{id}: PATCH /domains/{id} met apple_pay: null. DELETE /domains/{id} verwijdert het hele domein, inclusief eventuele websites erop.
  • status: verified is apple_pay.state: ready. status: pending is apple_pay.state: pending terwijl Whop het domein registreert, of action_required totdat je het associatiebestand host en het domein controleert.
Registratie gebeurt op de achtergrond, dus het aanmaken of controleren van een domein retourneert pending. Haal het domein op totdat apple_pay.state ready of action_required is.De /payment_method_domains-endpoints reageren nog steeds op elke versie, met Deprecation- en successor-Link-headers. Een domein behoudt de ID, dus /domains/{id} accepteert de ID die een domein voor een betaalmethode retourneerde. De domains-API vereist de machtigingen domain:read en domain:manage in plaats van company:manage_checkout.
Native reviews
TypeScript SDK: @whop/sdk@2.5.0.Reviews gebruiken nu een native resource.
  • Het weergeven en ophalen van reviews retourneert alleen gepubliceerde reviews. Het ophalen van een review die in afwachting is of is verwijderd, retourneert 404.
  • Een opgehaalde review retourneert account in plaats van company.
  • Het weergeven van reviews filtert op account_id of product_id, sorteert met order en direction en retourneert standaard 20 reviews per pagina. Zonder filter geeft een gebruiker de reviews weer die hij heeft geschreven en geeft een account- of app-API-sleutel de reviews van het eigen account weer.
  • company_id wordt niet meer geaccepteerd. Gebruik account_id.
  • DELETE /reviews/{id} verwijdert een review die de aangemelde gebruiker heeft geschreven en vereist de scope review:delete.
Accounts hebben geen branchegroep meer, en de accountclassificatie is alleen-lezen
Accounts bevatten industry_group niet meer, en PATCH /accounts/{id} accepteert het niet meer. business_type en industry_type classificeren een account.De accountclassificatie is alleen-lezen. Whop stelt business_type en industry_type in, en PATCH /accounts/{id} accepteert ze niet meer.
Apps vermelden geen eerdere gehoste URL's meer
TypeScript SDK: @whop/sdk@2.4.0.Apps bevatten previous_hosted_urls niet meer. De adressen van een app zijn de domeinen die de app aanbieden: geef ze weer met GET /domains, of lees domains op de app.
Overboekingsprofielen, bedragen en aanmaaktypen
Overboekingen retourneren origin- en destination-profielen met name en logo_url. De geldobjecten amount en fee bevatten het tegoed voor de ontvanger en alle overboekingskosten. Responsen bevatten ook beschikbare tijdstempels voor mislukkingen en een tracking-URL. Onbekende historische bedragen en overgangstijden zijn null.Zonder accountfilters geeft GET /transfers overboekingen weer voor alle accounts waarvoor de aanroeper toestemming heeft en voor de persoonlijke wallet. Referenties die op een account zijn afgebakend, blijven beperkt tot hun account.POST /transfers vereist type, ofwel balance of claim_link. Verzoeken zonder dit veld retourneren 400. Het type ledger heet nu balance, en wallet_send is verwijderd. Eerdere versies accepteren ledger en wallet_send, en maken een balance-overboeking aan wanneer type wordt weggelaten.
Een bon-pdf voor een betaling genereren
Betalingen bevatten pdf_url niet meer. Om de bon van een betaling als pdf te krijgen, roep je POST /payments/{id}/generate_pdf aan. Dit retourneert een url om het bestand te downloaden en de expires_at waarop die link niet meer werkt.
Openstaande tegoeden kunnen wachten op een compliancebeoordeling
TypeScript SDK: @whop/sdk@2.3.0.De payment_controls.undated_pending_reason van een account kan compliance_review zijn. Dit betekent dat een verificatie die de verkoper al heeft ingediend wordt beoordeeld, zodat openstaande tegoeden in afwachting blijven totdat deze is goedgekeurd. Aanroepers die op een eerdere versie zijn vastgezet, zien null voor deze status.
Economic Intelligence kan elke week worden verlengd
economic_intelligence_offers bevat een weekly-aanbod dat elke week wordt verlengd totdat het wordt uitgeschakeld. Elk aanbod heeft auto_renew, en weekly is het aanbevolen aanbod. Om het in te schakelen, stuur je economic_intelligence_duration_key: "weekly" naar PATCH /accounts/{account_id}/preferences.economic_intelligence_offers vermeldt alleen wat het account nu kan kiezen. Het is niet meer null terwijl Economic Intelligence is ingeschakeld: tijdens een vastgelegde periode vermeldt het alleen weekly, als upgrade, en terwijl weekly wordt verlengd, is het leeg. Eerdere versies houden null terwijl Economic Intelligence is ingeschakeld, laten weekly weg en bevelen 1_day aan.
Betalingen met opgeslagen kaarten gaan standaard uit van een aanwezige koper
Een afschrijving van een opgeslagen betaalmethode (member_id en payment_method_id) met een return_url behandelt de koper nu als aanwezig. Dit geldt wanneer je off_session weglaat. Als de uitgever de koper vraagt zich te authenticeren, is de betaling requires_action met een next_action. Wanneer je de kaart belast zonder de koper, zoals een verlenging volgens je eigen schema, geef dan off_session: true mee.
Ontvangers van bill pay hebben geen Whop-account meer nodig
Het aanmaken van een uitbetalingsmethode met recipient maakt een niet-standaard uitbetalingsaccount voor de ontvanger aan, gekoppeld aan de ledger van de verzender. Er wordt geen Whop-gebruiker, Whop-account of ledger voor de ontvanger aangemaakt. De respons voor de ontvanger bevat first_name, last_name en country. Deze bevat geen user_id meer. Eerdere API-versies laten de gegevens van de ontvanger weg wanneer er geen Whop-gebruiker is. Eerdere versies behouden de gebruikers-ID voor bestaande ontvangers.
App-builds accepteren geen AI-prompt meer
Het aanmaken van een app-build accepteert ai_prompt_id niet meer.
De tijdreeks van een metric heeft een eigen pad
Haal de tijdreeks van een metric op via GET /stats/time_series/{metric}. GET /stats/{metric} levert deze nog steeds en vermeldt de opvolger in een Deprecation-header.
Sociale accounts zijn externe accounts
Sociale accounts heten nu externe accounts. Gebruik /external_accounts en de SDK-namespace externalAccounts. De voormalige /social_accounts-endpoints reageren nog steeds op elke versie, met Deprecation- en successor-Link-headers. ID’s van externe accounts behouden de prefix sacc_, en de machtigingsscopes social_account:* zijn ongewijzigd.Advertenties noemen hun accounts external_accounts in plaats van social_accounts, zowel in verzoeken als in responsen. Betrokkenheidsregels voor doelgroepen noemen hun account external_account_id in plaats van social_account_id. Op /external_accounts is de pagina die eigenaar is van een Instagram-account parent_external_account in plaats van parent_social_account. Advertentiewebhooks zonder vastgezette API-versie ontvangen external_accounts.
Gebruikers bevatten geen sociale accounts meer
Gebruikers retourneren social_accounts niet meer.
Setup intents worden op de achtergrond opgeslagen
Het aanmaken van een setup intent retourneert deze nu als processing en slaat de betaalmethode op de achtergrond op. Het aanmaken van een betaling werkt al zo. Om de uitkomst te weten, poll je de setup intent of geef je de client_secret ervan door aan handleNextAction. Uiteindelijk wordt deze opgeslagen, geweigerd of wacht deze op een stap van de koper. Eerdere versies blijven deze tijdens het verzoek opslaan.
Voorkomen geschillen rapporteren prevented
TypeScript SDK: @whop/sdk@2.1.0, @whop/sdk@2.2.0.Een geschil waarvoor de klant vóór een uitspraak is terugbetaald, heeft nu status: prevented in plaats van closed. De terugbetaling kwam van het kaartnetwerk (Visa RDR) of van een eerdere terugbetaling.
Uitvoeringen van Economic Intelligence hebben eigen statussen
Een aanbeveling die Whop AI uitvoert, heeft status: running. Wanneer de uitvoering eindigt, wordt deze executed, of incomplete als deze eindigde zonder de aanbeveling uit te voeren. Eerdere versies tonen een lopende aanbeveling als ready en een onvolledige als superseded.Aanbevelingen retourneren ook run_started_at, run_ended_at, run_by_user_id, result_url en acknowledged_at. Om een aanbeveling zelf uit te voeren, stuur je status: running naar PATCH /economic_intelligence/{id} en daarna status: executed (met een optionele result_url) of status: incomplete. Stuur status: acknowledged om een uitgevoerde run als gezien te markeren. De aanbeveling blijft executed en registreert acknowledged_at.
Looptijden van Economic Intelligence worden gekozen op sleutel
Om Economic Intelligence in te schakelen, stuur je economic_intelligence_duration_key naar PATCH /accounts/{account_id}/preferences in plaats van economic_intelligence_duration_days. Gebruik de key van een vermelding in economic_intelligence_offers.Elke vermelding in economic_intelligence_offers heeft key, duration en duration_unit in plaats van duration_days. Een looptijd kan worden geteld in hours of days.
Advertentieteksten hebben een taaltag, en Meta-advertenties kunnen in andere talen worden uitgevoerd
De primary_texts, headlines en descriptions van een advertentie zijn arrays van { language, text }-objecten in verzoeken en responsen. Laat language weg bij een advertentie zonder vertalingen. De API weigert gewone strings, dus stuur in plaats daarvan [{ "text": "…" }].Een Meta-advertentie kan ook in andere talen worden uitgevoerd. Stel translations: { source_language, automatic_languages } in op de taal van de eigen tekst van de advertentie en de talen waarin Meta automatisch vertaalt. Elke tekst- en creatives-vermelding op die advertentie vermeldt dan de language. De eigen tekst en creative van de advertentie gebruiken source_language, en elke taal die je zelf schrijft, krijgt een vermelding in primary_texts en headlines, plus optionele vermeldingen in descriptions en creatives. translations: null schakelt de andere talen uit.Eerdere API-versies kunnen een advertentie met vertalingen niet bijwerken. Ze krijgen een 400 die deze versie vermeldt.
Economic Intelligence wordt ingeschakeld voor een gekozen looptijd
Om Economic Intelligence in te schakelen, stuur je economic_intelligence_duration_days naar PATCH /accounts/{account_id}/preferences. Kies een looptijd uit economic_intelligence_offers, dat de kosten van elke looptijd vermeldt. Economic Intelligence kan niet worden gewijzigd of uitgeschakeld tot economic_intelligence_ends_at, en wordt dan automatisch uitgeschakeld.economic_intelligence is alleen-lezen. Het verzenden ervan retourneert een 400-fout.
Tradingtoegang verschijnt in machtigingscontroles
TypeScript SDK: @whop/sdk@2.0.0.GET /permissions bevat crypto_wallet:trade en crypto_wallet:trade:read bij het weergeven of controleren van machtigingsacties voor een account.
Beschrijvingen van Economic Intelligence-bewerkingen
Aanbevelingen van Economic Intelligence retourneren expected_tool_calls als een geordende array van objecten met tool_name en description. Beschrijvingen geven de geplande actie en de betrokken resource aan. Oudere aanbevelingen hebben een null-beschrijving.
Verwijzingslinks voor partners gebruiken één verzoektype
Verwijzingsverzoeken van partners gebruiken request_type: "link" voor links met of zonder beloningen. Gebruik link bij het aanmaken of filteren van links. Alleen geautoriseerde medewerkers kunnen beloningen configureren.
Accountbeloningen tonen de voortgang van partnerbeloningen
Retrieve Account retourneert mijlpalen voor partnerbeloningen in rewards. Elke mijlpaal bevat de kwalificatievoortgang en de uitbetalingsstatus voor dat account. Het veld bevat een lege array wanneer er geen overeenkomende beloningen zijn of de aanroeper geen leestoegang heeft tot saldi of statistieken.Het verouderde formaat voor onboardingbeloningen is uitgefaseerd. Eerdere API-versies laten rewards weg uit accountresponsen.
Setup intents worden een native resource
De native Payments API levert nu POST /setup_intents, GET /setup_intents en GET /setup_intents/{id}. Het Setup Intent-object krijgt dezelfde structuur als elke andere native resource.
  • Gerelateerde records zijn foreign-key-ID’s in plaats van ingesloten objecten: account_id (was company), member_id (was member), payment_method_id (was payment_method) en checkout_configuration_id (was checkout_configuration). De koper is een user-samenvatting (id, username, name, profile_picture).
  • error_message verhuist naar last_setup_error, hetzelfde { code, message }-blok dat Retrieve setup status retourneert. Het blijft null totdat er iets misgaat en verdwijnt zodra de setup slaagt.
  • return_url, payment_method_type en updated_at zijn nieuw. created_at en updated_at zijn ISO 8601-tijdstempels.
  • payment_instrument, de weergavevorm van de methode die het Payment-object al heeft, staat ook op de Setup Intent, zodat een opgeslagen kaart zonder tweede verzoek kan worden weergegeven. De card ervan krijgt exp_month en exp_year op beide resources. card.brand kan null zijn: een opgeslagen kaart waarvan de vault het netwerk niet heeft vastgelegd, behoudt de laatste vier cijfers en de vervaldatum in plaats van het hele card-object te verliezen.
  • Het aanmaken van een setup intent antwoordt met 201 Created (was 200), respecteert Idempotency-Key en vereist precies één van confirmation_token of payment_method_id. Een bevestigingstoken van een ander account geeft een 404.
  • client_secret wordt geretourneerd bij aanmaken en ophalen, en alleen voor setups die via deze API zijn aangemaakt. Het vereist een aanroeper die namens de setup mag handelen: de payment:charge-referentie van het account of het eigen token van de koper. Lijstrijen bevatten altijd null.
  • De webhooks setup_intent.requires_action, setup_intent.succeeded en setup_intent.canceled die op of na deze versie zijn vastgezet, leveren hetzelfde Setup Intent-object als hun data. Webhooks die eerder zijn vastgezet en webhooks zonder pin behouden de vorige payload.
  • GET /setup_intents geeft weer met de standaard { data, page_info }-envelop en cursorpaginering. account_id is optioneel: een account-API-sleutel geeft het eigen account weer, en een gebruikerstoken geeft elk account weer dat het kan lezen. status is een nieuw filter, en een ongeldige waarde geeft een 400. created_before en created_after werken zoals voorheen.
Nieuwe pogingen voor advertentiebetalingen gebruiken het account-endpoint
POST /ad_campaigns/{id}/retry_payment retourneert 410 Gone. Gebruik POST /accounts/{id}/retry_ads_payment met de biz_-ID van het account om één nieuwe betalingspoging voor al zijn campagnes in de wachtrij te zetten. Een geaccepteerde nieuwe poging bevestigt niet dat de betaling is geslaagd. Controleer de delivery_status en issues van de campagne voor de uitkomst.
Drie afzonderlijke 3D Secure-beleidsregels
TypeScript SDK: @whop/sdk@1.1.5.Accounts, varianten, checkoutconfiguraties en checkoutsessies bieden drie 3D Secure-keuzes:
  • mandate_challenge vraagt een challenge aan voordat een ondersteunde on-session kaartbetaling wordt verwerkt.
  • mandate_if_required verplicht een challenge alleen wanneer de betalingsverwerker dat vereist.
  • frictionless_if_required gebruikt de gewone frictionless 3DS-flow.
Betalingen van $1.000 of meer gebruiken ten minste mandate_if_required. Vereisten voor risico en herstel van authenticatie kunnen de voorkeur overschrijven. Expliciete verplichte challenges worden geweigerd totdat ze op het platform zijn ingeschakeld.Oudere API-versies behouden hun bestaande waarden: nieuwe mandate_challenge-selecties blijven voorwaardelijk, bestaande verplichte voorkeuren blijven behouden en frictionless blijft frictionless. Accounts op oudere versies geven frictionless weer als null.
Tradingoverboekingen hebben eigen categorieën in financiële rapporten
Rijen in financiële rapporten onderscheiden trading_account_deposit, trading_account_withdrawal en hun _offset-vermeldingen van andere on-chain overboekingen. Bedragen en saldi zijn ongewijzigd.Eerdere versies behouden de bestaande categorieën: topup voor accountstortingen en onchain_withdrawal voor accountopnames. Globale rapporten gebruiken de bijbehorende categorieën onchain_deposit, onchain_withdrawal en _offset. Overeenkomende rijen worden gecombineerd zonder overgeboekte bedragen weg te laten.
Triple Whale-status hernoemd voor white-label-verkopers
ads_triple_whale_integration.status in de accountvoorkeuren rapporteert requires_shop_domain in plaats van requires_shopify_store. Een shop_domain kan nu expliciet op de integratie worden ingesteld, dus een gekoppelde Shopify-winkel is niet meer de enige manier om er een op te geven.
Bedrijfscategorieën komen uit één tabel
TypeScript SDK: @whop/sdk@1.1.4.business_type, industry_group en industry_type van een account zijn strings uit de tabel met bedrijfscategorieën van Whop in plaats van vaste enums. Nieuwe categorieën verschijnen zonder nieuwe API-versie. De woordenlijst met bedrijfstypen en branches vermeldt de huidige waarden.
  • coaching_and_courses is nu education, physical_product is nu ecommerce en marketplace is nu platform.
  • Branchegroepen en -typen zijn opnieuw ingedeeld onder de acht bedrijfstypen. PATCH /accounts/{id} accepteert alleen slugs uit de woordenlijst. Onbekende waarden retourneren 400.
Aanroepers die op een eerdere versie zijn vastgezet, ontvangen nog steeds de vorige namen van bedrijfstypen, en branchewaarden die vóór deze versie niet bestonden, worden geretourneerd als null.
Experimenten in eigendom van een account
Het aanmaken van een experiment vereist een account_id van de eigenaar, met prefix biz_. Experimenten accepteren ook optionele resourceverwijzingen en flagsleutels die lokaal zijn voor het account. Het weergeven retourneert experimenten voor één account, en het lezen of beheren ervan vereist accountmachtigingen. Accountexperimenten ondersteunen geen teamtags en richten geen rapportageprovider in.Evaluatie identificeert het onderwerp via subject[account_id], subject[anonymous_id] en subject[user_id]. Aanroepers op oudere versies behouden hun bestaande identiteitsparameters voor evaluatie. Geef targeting-properties mee als JSON-querywaarde. Bestaande geneste querysleutels voor eigenschappen blijven ondersteund. Exposure accepteert optionele referenties en registreert hun identiteit op het event.
Benoemde Whop-opnameblokkades op openstaande tegoeden
TypeScript SDK: @whop/sdk@1.1.3.payment_controls.undated_pending_reason van een account kan withdrawals_disabled zijn wanneer Whop opnames heeft geblokkeerd, zodat die openstaande tegoeden niet beschikbaar kunnen worden.kyc_incomplete, pending_information_request en null voor tegoeden die nog worden verwerkt, zijn ongewijzigd.
Bronnen voor betrokkenheidsdoelgroepen
POST /audiences ondersteunt betrokkenheid bij video’s, leadformulieren, Instagram-profielen en Facebook-pagina’s via een getypeerde engagement-definitie.
  • Expliciete source_type-waarden valideren dat de vereiste bronvelden aanwezig zijn en tegenstrijdige bronvelden ontbreken.
  • Doelgroepresponsen bevatten engagement, en source_type kan engagement zijn. Betrokkenheidsdoelgroepen kunnen ook worden gebruikt als bron voor lookalikes.
  • GET /social_accounts/{id}/posts bevat video_id en caption om video’s te helpen selecteren zonder handmatig hun platform-ID’s te zoeken.
Het beëindigen van een experiment vereist bevindingen
POST /experiments/{id}/end vereist findings in de body van het verzoek: een korte uitleg van wat er is geleerd en waarom het experiment op deze manier is geëindigd.Aanroepers die op een eerdere versie zijn vastgezet, mogen het nog steeds weglaten. In plaats van een 400 wordt namens hen een placeholderwaarde voor de bevindingen geregistreerd.
Stortingsbestemmingen zijn een account-ID
TypeScript SDK: @whop/sdk@1.1.1, @whop/sdk@1.1.2.POST /deposits accepteert een account-ID-string als destination (biz_… of user_…) en verder niets.
  • Ruwe walletadressen worden niet meer geaccepteerd. Financier een account en lees de adressen ervan uit methods.crypto.
  • De objectvorm van destination ({ account_id } / { address, network }) is verwijderd. Stuur de account-ID op zichzelf.
  • De network-override op het hoogste niveau is verwijderd. Deze veranderde de respons nooit: elke storting retourneert al een adres voor elk ondersteund netwerk, dus kies het gewenste adres uit methods.crypto.
  • metadata is verwijderd uit zowel het verzoek als de respons. Het werd teruggestuurd en nooit opgeslagen, dus het kon niet worden gebruikt om een latere storting af te stemmen.
  • account_id in de respons is niet meer null, omdat elke bestemming nu een account aanwijst.
Aanroepers die op een eerdere versie zijn vastgezet, blijven de objectvorm en de verwijderde invoer verzenden, en hun responsen bevatten nog steeds metadata, als leeg object in plaats van de waarde die ze hebben verzonden. Een walletadres wordt op elke versie geweigerd: het identificeerde nooit een account, dus er is geen oudere vorm om te blijven leveren. metadata die met een payment_method_id wordt verzonden, blijft op elke versie behouden, omdat deze aan de kaartafschrijving is gekoppeld.
Betalingen worden een native resource
TypeScript SDK: @whop/sdk@1.1.0.POST /payments, GET /payments en GET /payments/{id} worden nu geleverd door de native Payments API, en het Payment-object krijgt dezelfde structuur als elke andere native resource.
  • Gerelateerde records zijn foreign-key-ID’s in plaats van ingesloten objecten: account_id (was company), plan_id, product_id, membership_id, member_id, promo_code_id, shipment_id, payment_method_id. De koper is een user-samenvatting (id, username, name, profile_picture).
  • Bedragen zijn geldobjecten ({ amount, currency, decimals, display_decimals }) in plaats van kale getallen: total, subtotal, tax_amount, refunded_amount, tax_refunded_amount, amount_after_fees, usd_total. settlement_amount, settlement_currency en settlement_exchange_rate zijn opgenomen in total en currency. refunded_amount en tax_refunded_amount worden weergegeven zoals ze zijn verrekend, tegen de koers die gold toen elke terugbetaling werd uitgevoerd, en tax_refunded_amount staat nu zowel in lijstresponsen als bij ophalen.
  • Geschillen, terugbetalingen en zaken in het Resolution Center worden niet meer ingesloten. Geef ze weer via hun eigen endpoints met ?payment_id=. Ingesloten financieringstransacties en de applicatiekosten worden niet overgenomen in de native structuur.
  • last_payment_attempt / next_payment_attempt zijn last_payment_attempt_at / next_payment_attempt_at. Kaartgegevens staan op payment_instrument.
  • Het aanmaken van een betaling accepteert account_id (was company_id), antwoordt met 201 Created, respecteert Idempotency-Key en accepteert capture: false om een autorisatieblokkade te plaatsen.
  • Native leesbewerkingen voor betalingen zijn afgebakend op het account: de referentie moet de betalingen van het account kunnen lezen (het token van een teamlid of de API-sleutel van het account). Het eigen gebruikerstoken van een koper, dat de vastgezette proxyversies accepteren voor het lezen van de eigen betaling, wordt nog niet native ondersteund. Kopers blijven werken op hun vastgezette versie.
  • Rijen van GET /payments/{id}/fees zijn { type, origin, label, description, amount, settlement_amount, collected_at } met geldobjecten (waren name/amount/currency/type).
  • GET /refunds en GET /refunds/{id} retourneren de native Refund: payment_id en account_id in plaats van een ingesloten betaling, amount als geldobject in de verrekeningsvaluta van de betaling, original_amount in de valuta van de verwerker. Het filter company_id is account_id, en het verzenden van company_id geeft een 400.
  • POST /payments/{id}/refund, POST /payments/{id}/retry en POST /payments/{id}/void zijn ook native en retourneren hetzelfde Payment-object. Refund accepteert nog steeds een optioneel partial_amount.
  • GET /payments geeft weer met de standaard { data, page_info }-envelop en cursorpaginering. Filters zijn enkelvoudige gelijkheidsparameters (status, billing_reason, currency, plan_id, product_id, membership_id, member_id, user_id, account_id) in plaats van de meervoudige arrays van de proxy. Net als bij de proxy komt billing_reason=subscription_cycle ook overeen met verlengingen die zijn geregistreerd als subscription_update. Betalingen met een bedrag van nul worden meegenomen, dus include_free van de proxy is verdwenen. Een ongeldige status geeft een 400, net als elk filter dat alleen voor de proxy bestond (substatuses, updated_before/updated_after, checkout_configuration_ids, meervoudige arrays), in plaats van een ongefilterde pagina. De zoekfunctie query voor kopers werkt zoals voorheen. Het venster created_before/created_after omvat alleen het aanmaaktijdstip van de betaling. De proxy filterde op het betaaltijdstip waar dat bestond. Op lijstrijen is settlement_time_at null. Haal de betaling op om deze te krijgen.
Verouderd endpoint voor advertentierapporten uitgefaseerd
Het verouderde endpoint GET /ad_reports is verouderd ten gunste van de native Stats-metrics en de endpoints voor advertentie-entiteiten. Het wordt op deze versie niet meer geleverd.
  • GET /ad_reports retourneert 410 Gone met een error.type van gone. Gebruik GET /stats/time_series/ad_delivery voor spend, impressions en clicks over tijd, afgebakend met een source-pad zoals whop:adcamp_xxx:*. Gebruik GET /stats/time_series/events voor toegeschreven conversies.
  • Prestaties per entiteit voor een periode staan op de entiteitsendpoints. GET /ad_campaigns, GET /ad_groups en GET /ads accepteren stats_from en stats_to en retourneren spend, results en return_on_ad_spend op elke rij.
  • Elke respons van het verouderde endpoint, op elke versie, bevat nu de headers Deprecation en Link: <…/stats/ad_delivery>; rel="successor-version". Verzoeken die op eerdere versies zijn vastgezet en verzoeken zonder versie blijven ongewijzigd werken totdat een Sunset-header de datum aankondigt waarop het voor elke versie niet meer reageert.
Tijdstempelbereiken voor financiële rapporten
GET /financial_reports en GET /financial_reports/breakdown gebruiken nu ISO 8601-tijdstempels from en to voor rapportperiodes.
  • from_date en to_date heten nu from en to.
  • Kale datums worden niet meer geaccepteerd. Neem in beide tijdstempels een tijd en offset op.
Expliciet filteren op appverificatie
GET /apps gebruikt verified nu als optioneel gelijkheidsfilter in plaats van de afwezigheid ervan te behandelen als verified=false voor openbare websitelijsten.
  • Laat verified weg om openbaar vindbare websiteblauwdrukken uit beide verificatiestatussen te retourneren.
  • Stel verified=true in voor door Whop geverifieerde blauwdrukken of verified=false voor communityblauwdrukken.
  • recommended=true filtert aanbevolen apps onafhankelijk van de verificatiestatus.
Verouderde endpoints voor opnames uitgefaseerd
De verouderde /withdrawals-endpoints zijn verouderd ten gunste van de native Payouts-API en worden op deze versie niet meer geleverd.
  • GET /withdrawals en POST /withdrawals retourneren 410 Gone met een error.type van gone. Gebruik in plaats daarvan GET /payouts en POST /payouts. Uitbetalings-ID’s zijn dezelfde wdrl_-ID’s, dus bestaande identificatoren blijven werken.
  • GET /withdrawals/{id} reageert nog steeds op deze versie. Gebruik GET /payouts/{id} voor nieuw werk.
  • Elke respons van de verouderde endpoints, op elke versie, bevat nu de headers Deprecation en Link: <…/payouts>; rel="successor-version". Een Sunset-header kondigt de datum aan waarop ze voor elke versie niet meer reageren. Tot die tijd blijven verzoeken die op eerdere versies zijn vastgezet en verzoeken zonder versie ongewijzigd werken.
Post-ID's van advertenties
De post_id van een advertentie verwijst nu naar de post die het advertentienetwerk weergeeft, ongeacht hoe de advertentie is opgebouwd.
  • post_id retourneert de post van het netwerk voor de advertentie: de post die Meta heeft aangemaakt voor een geüploade creative, of de post die wordt gepromoot. Vroeger was dit null voor elke advertentie die uit geüploade creatives was opgebouwd.
  • De post waarnaar je een advertentie laat verwijzen, is verplaatst naar existing_post_id, zowel in de respons als in de body voor aanmaken/bijwerken. post_source en post_thumbnail_url beschrijven dat veld.
Native Files API
TypeScript SDK: @whop/sdk@1.0.14.POST /files en GET /files/{id} worden native geleverd met een opnieuw ontworpen bestandsobject, en multipart-uploads worden afgerond via het nieuwe POST /files/{id}/complete.
  • Bestandsresponsen bevatten de standaardenvelop: object, visibility en een ISO 8601-created_at. De velden size en url zijn null totdat de upload ready is.
  • GET /files/{id} vindt alleen bestanden die je zelf hebt aangemaakt. Andere aanroepers krijgen een 404.
Uitbetalingsstatus v2
TypeScript SDK: @whop/sdk@1.0.13.De levenscycluswoorden van het uitbetalingsobject zijn opnieuw opgebouwd en de geldvelden worden decimale strings.
  • status kent acht woorden: requested, in_review, processing, completed, reversed, canceled, failed, denied. Een verrekende uitbetaling die de provider terugdraait, geeft reversed, met de retourcode en funds_returned_at in failure.
  • Een nieuw veld status_detail bevat de meest gedetailleerde machinefase onder het statuswoord. De waarden ervan kunnen worden uitgebreid zonder versieverhoging. status is het geversioneerde contract.
  • amount, fee_amount, net_amount, markup_fee en destination_amount zijn decimale strings. exchange_rate blijft een getal.
  • Uitbetalingen worden aangemaakt onder hun wdrl_-ID: de ID die POST /payouts retourneert, is de ID die GET /payouts weergeeft, en het conversieverzoek van een uitbetaling blijft bestaan als payout_request_id. Conversieverzoeken die vóór deze versie zijn aangemaakt, blijven reageren onder hun cofr_-ID.
  • De idempotentiesleutel wordt alleen in de Idempotency-Key-header verzonden, en het bodyveld idempotency_key wordt geweigerd.
Verzoeken die op eerdere versies zijn vastgezet, behouden de vorige woorden, geldbedragen als float en idempotentiesleutels als bodyveld. Webhook-payloads volgen op dezelfde manier de api_version_date van het abonnement: abonnementen die op 2026-08-21 of later zijn vastgezet, ontvangen de nieuwe uitbetalingsstructuur, en eerdere of niet-vastgezette abonnementen behouden de vorige.
account_id in de webhook-envelop
Het veld company_id van de webhook-envelop heet nu account_id.
  • Webhookleveringen die op 2026-08-14 of later zijn vastgezet, bevatten account_id in de envelop.
  • Webhooks die op eerdere versies zijn vastgezet, en webhooks zonder api_version_date-pin, behouden company_id.
Uitsplitsingen van saldi onderweg
TypeScript SDK: @whop/sdk@1.0.11.Uitsplitsingen van account- en persoonlijke saldi tonen nu in_transit naast pending.
  • Tel pending en in_transit op om het totale bedrag weer te geven dat op verrekening wacht.
  • Aanroepers die op eerdere versies zijn vastgezet, blijven het gecombineerde bedrag in pending ontvangen.
Invoer voor de API-versie van webhooks verwijderd
De invoer api_version op POST /webhooks en PATCH /webhooks/{id} is verwijderd.
  • Nieuwe webhooks gebruiken altijd de v1-events en -payloads. Verzoeken die api_version meegeven, worden geweigerd met een 400.
  • Zet de payloadstructuur van een webhook in plaats daarvan vast met api_version_date.
  • Bestaande v2- en v5-webhooks blijven leveren. Je kunt geen webhooks meer aanmaken op of overzetten naar deze versies.
Native endpoints voor geschilwaarschuwingen
Geschilwaarschuwingen zijn nu een native REST-resource en worden daarnaast nog via de verouderde proxy geleverd.
  • GET /dispute_alerts geeft de waarschuwingen van een account weer met cursorpaginering en filtert op account_id, payment_id, type en een aanmaakperiode.
  • type vervangt alert_type en benoemt de twee soorten die een uitgever stuurt: early_fraud_warning (fraudemeldingen van Visa TC40 / Mastercard SAFE) en dispute_alert (meldingen vóór een geschil).
  • fee_charged vervangt charge_for_alert en geeft aan of Whop het account daadwerkelijk heeft gefactureerd. Vroege fraudewaarschuwingen worden nooit gefactureerd.
  • actionable geeft aan of het terugbetalen van de betaling een chargeback nog kan voorkomen.
  • De objecten payment en dispute zijn vervangen door de tags payment_id en account_id. Tijdstempels zijn ISO 8601, met reported_at voor het moment waarop de uitgever de melding heeft ingediend.
Omrekening van fiatvaluta bij swaps
Swaps tussen fiatparen (POST /swaps met twee fiatvaluta) ondersteunen nu vrije valutaomrekening, en amount komt overeen met de semantiek van cryptoswaps.
  • amount is het bedrag van from_token dat tegen de middenkoers wordt omgerekend. Er is geen negatief saldo vereist.
  • Het bepalen van de omvang van een gedeeltelijke aflossing van een negatief to_token-saldo is verplaatst naar het nieuwe veld to_amount (uitgedrukt in to_token, begrensd tot de schuld). amount en to_amount sluiten elkaar uit.
  • Als je beide weglaat, wordt nog steeds het volledige negatieve to_token-saldo afgelost.
  • Aanroepers die op eerdere versies zijn vastgezet, behouden het vorige gedrag: hun fiat-amount wordt behandeld als het aflossingsbedrag in to_token.
Platte verificatievereisten
De requested_information van een verificatie is nu een platte lijst: één vereiste per vermelding, één schrijfactie per antwoord.
  • Elke vermelding geeft in requirement aan wat er nodig is: een document zoals bank_statement, of een veldsleutel zoals ssn, met een label om aan de gebruiker te tonen.
  • Beantwoord file-vermeldingen met file (een ID van een directe upload). Beantwoord text-, date-, phone- en select-vermeldingen met value, en address-vermeldingen met address. Niets uit de respons wordt teruggestuurd.
  • Een vermelding die als multiple is gemarkeerd, accepteert meerdere bestanden in één antwoord, in volgorde van de vakken, met de voorkant eerst bij een dubbelzijdig document.
  • Een vermelding die options vermeldt, accepteert ook een value. Bij select-vermeldingen zijn de opties de toegestane antwoorden. Bij identiteitsdocumenten zijn de opties de geaccepteerde ID-typen.
  • Sleutels die niet van toepassing zijn, worden weggelaten, en geweigerde inzendingen bevatten gestructureerde errors met een stabiele code en een reason.
  • De geneste formulierstructuur requested_files/category is in deze versie verdwenen. Aanroepers die op eerdere versies zijn vastgezet, behouden deze, en hun antwoorden worden automatisch omgezet.
Native endpoints voor promotiecodes
Promotiecodes zijn nu een volledige REST-resource op het hoogste niveau en worden daarnaast nog via de verouderde proxy geleverd.
  • GET /promo_codes geeft de promotiecodes van een account weer en gebruikt account_id in plaats van company_id.
  • POST /promo_codes maakt promotiecodes aan. GET en DELETE /promo_codes/{id} halen ze op en archiveren ze.
  • POST /promo_codes/{id}/activate en POST /promo_codes/{id}/deactivate vervangen de verouderde PATCH-schrijfactie voor de status.
  • Lijstresponsen gebruiken cursorpaginering en ondersteunen filters op status, product, variant, tijdstempel en sortering.
  • Aanroepers die op eerdere versies zijn vastgezet, behouden het contract van de verouderde proxy ongewijzigd.
Uitgebreidere bovenliggende accounts
Accountresponsen tonen nu een uitgebreidere relatie met het bovenliggende account voor gekoppelde accounts.
  • parent_account vervangt parent_account_id.
  • Het bovenliggende account bevat de id, title, route en logo_url.
Ondersteunde uitbetalingsmethoden
Ondersteunde uitbetalingsmethoden hebben nu een eigen gepagineerd endpoint.
  • GET /payouts/supported_methods geeft de uitbetalingsmethoden weer die een account of gebruiker mag toevoegen.
  • Ondersteunde methoden gebruiken object: "supported_payout_method", en hun podst_-ID’s worden meegegeven als supported_payout_method_id.
  • Opgeslagen uitbetalingsmethoden tonen supported_payout_method. Uitbetalingen tonen payout_method.supported_payout_method.
  • Gebruik country om ondersteunde methoden weer te geven voor een ander land dan het land van het uitbetalingsaccount.
  • GET /payouts/methods accepteert include_available niet meer en retourneert available_destinations niet meer.
  • Aanroepers die op eerdere versies zijn vastgezet, behouden destination_id, payout_destination en payout_token.
Native kaarttransacties, geschatte aankomsttijden voor uitbetalingsmethoden
Kaarttransacties gebruiken nu native REST-endpoints en worden daarnaast nog via de verouderde proxy geleverd.
  • GET /card_transactions geeft de kaarttransacties van een account weer, en GET /card_transactions/{id} haalt er een op aan de hand van de citx_-ID. De lijst accepteert ook een filter transaction_ids om specifieke transacties in één verzoek op te halen.
  • Kaarttransacties zijn afgebakend op het account: de eigenaar wordt geselecteerd met account_id, met als standaard het account waartoe de referentie behoort.
  • Filters op transaction_ids, card_id, cardholder_id, status, created_after en created_before. Tijdstempelfilters zijn ISO 8601.
  • cardholder_id is nieuw in de respons: de gebruiker aan wie de kaart is toegewezen.
Uitbetalingsmethoden bevatten nu kosten- en leveringsvoorwaarden die onafhankelijk zijn van het bedrag, en de offerte dupliceert geen geschatte aankomsttijden meer.
  • Elke uitbetalingsmethode retourneert fee_structure (percentage, vast bedrag en valuta) en estimated_arrival (tijdstempels per snelheid) zonder dat er een amount nodig is.
  • De objecten standard en instant van de offerte bevatten geen estimated_arrival meer. Lees het uit het veld estimated_arrival op het hoogste niveau van de methode.
Native endpoints voor het Resolution Center
Zaken in het Resolution Center gebruiken nu native REST-endpoints en worden daarnaast nog via de verouderde proxy geleverd.
  • status, escalated, outcome, refund, reason en available_actions tonen de status van de zaak en de toegestane acties.
  • Events zijn beschikbaar via het gepagineerde GET /resolution_center_cases/{id}/events. Samenvattingen zijn beschikbaar via GET /resolution_center_cases/summary.
  • Schrijfacties gebruiken message en attachments. due_date heet nu response_due_at. Voor het weergeven is account_id niet meer vereist.
Native endpoints voor zendingen
Zendingen gebruiken nu native REST-endpoints en worden daarnaast nog via de verouderde proxy geleverd.
  • GET /shipments geeft zendingen weer. GET /shipments/{id} haalt op aan de hand van de zendings-ID of betalings-ID.
  • POST /shipments maakt een zending aan, en PATCH /shipments/{id} werkt het trackingnummer ervan bij.
  • Responsen gebruiken account_id en tracking_number, naast carrier, tracking_url, order_id en payment_id.
  • Aanroepers die vóór deze datum zijn vastgezet, behouden het contract van de verouderde proxy ongewijzigd.
Native endpoints voor geschillen
Geschillen gebruiken nu native REST-endpoints en worden daarnaast nog via de verouderde proxy geleverd.
  • PATCH /disputes/{id} bewerkt bewijs, en POST /disputes/{id}/submit dient het in. Bewijs is genest onder evidence.
  • GET /disputes/summary biedt totalen gegroepeerd op status en currency. Weergeven en ophalen retourneren dezelfde velden.
  • Responsen gebruiken account_id, product_id en plan_id, plus buyer naast payment. Voor het weergeven is account_id niet meer vereist.
  • status en reason zijn genormaliseerde enums, en needs_response_by, rdr en editable zijn vervangen door hun nieuwe velden.
  • Aanroepers die vóór deze datum zijn vastgezet, behouden het contract van de verouderde proxy ongewijzigd.
Leden en lidmaatschappen
Leden en lidmaatschappen gebruiken nu native resources met een accountgericht lidmaatschapsmodel en opnieuw ontworpen levenscyclusacties.
  • Lidmaatschapsresponsen retourneren de compatibiliteitsvelden plan_id en product_id in plaats van geneste compatibiliteitsobjecten plan en product.
  • Het weergeven van lidmaatschappen retourneert alles wat de aanroeper kan lezen (de eigen lidmaatschappen plus die van de beheerde accounts), en account_id/user_id beperken die lijst in plaats van van modus te wisselen of een fout te geven.
  • Stel cancel_at_period_end in om een annulering in te plannen. De actie cancel beëindigt de toegang direct.
  • De actie extend vervangt add_free_days.
Consistentie van REST-responsen en tijdstempels
De Current API gebruikt nu consistente verwijderresponsen, tijdstempelinvoer en Account-naamgeving.
  • Verwijderendpoints voor producten, varianten, checkoutconfiguraties, advertenties, advertentiegroepen, advertentiecampagnes, sociale accounts en bounty-inzendingen retourneren { id, deleted: true } in plaats van een kale boolean.
  • Tijdstempelfilters op producten, varianten, checkoutconfiguraties, overboekingen en financiële rapporten accepteren alleen ISO 8601 in plaats van ook epoch-seconden.
  • Productresponsen retourneren account in plaats van company.
Uitbetalingspercentages voor partnerbedrijven
Partnerbedrijven tonen nu afzonderlijke uitbetalingstarieven voor elke inkomstenbron.
  • payout_percentage is vervangen door payout_percentages.
  • Het geneste object bevat tarieven voor sales, ad_spend, transfer en card_interchange.
Producten en checkoutconfiguraties
Producten en checkoutconfiguraties gebruiken nu consistent het Account-model.
  • Verzoekparameters voor producten gebruiken account_id in plaats van company_id.
  • Verzoeken voor checkoutconfiguraties gebruiken account_id op het hoogste niveau en binnen inline variantobjecten die in het compatibiliteitsveld plan worden meegegeven.
  • Responsen voor checkoutconfiguraties retourneren account_id in plaats van company_id.
Tijdstempels van checkoutconfiguraties
Tijdstempels van checkoutconfiguraties gebruiken nu hetzelfde formaat als de rest van de API.
  • created_at en updated_at zijn ISO 8601-strings in plaats van Unix-epoch-integers.
Gebruikerssaldi
Gebruikerssaldi bieden nu een volledig, gestructureerd saldo-overzicht.
  • De platte velden total_usd en balances zijn vervangen door een genest balance-object.
  • Het overzicht scheidt contant geld, crypto, lopende treasury-stortingen en saldi van accounts waarvan de gebruiker eigenaar is.
Resources voor verdiensten uit bedrijfsverwijzingen
Verdiensten uit bedrijfsverwijzingen identificeren nu de polymorfe resource die de verdienste heeft gegenereerd.
  • receipt is vervangen door resource.
  • access_pass is vervangen door product.
  • Verdiensten op basis van bonnen retourneren resource.object: "receipt" met de betalingsgegevens van de bon.
  • Het veld resource kan in toekomstige versies extra verdienstenresources ondersteunen zonder bonspecifieke velden te hergebruiken.
Resource voor bedrijfsverwijzingen
Volume en verdiensten uit bedrijfsverwijzingen worden nu gerapporteerd als sluitende groepen.
  • processing_volume, total_earnings, pending_payout en completed_payout zijn vervangen door geneste objecten volume_usd en earnings_usd.
  • Verdiensten hernoemen base_amount/amount naar transaction_amount_usd/commission_amount_usd en drukken payout_percentage uit als breuk.
Resource voor varianten (toen Plans genoemd)
Varianten, die toen Plans heetten, gebruiken nu consistent het Account-model.
  • Verzoekparameters en verzoekbodies gebruiken account_id in plaats van company_id.
  • Variantresponsen retourneren account in plaats van company.
Resource voor gebruikers
Toegangsverzoeken voor gebruikers gebruiken nu consistent het Account-model.
  • Verzoekparameters en verzoekbodies gebruiken account_id in plaats van company_id.
  • Responsstructuren zijn ongewijzigd.
Oorspronkelijke versie
Het oorspronkelijke gedrag van de Current API voordat gedateerd versiebeheer bestond.Verzoeken zonder Api-Version-Date gebruiken deze versie, zodat bestaande integraties blijven werken.