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 zeApi-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 vanapiVersionDate wijzigt de responsversie, maar niet de SDK-typen.
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.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.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.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.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.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 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-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.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.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.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.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.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.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.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 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.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.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.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.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.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.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 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.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, 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 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.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.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 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.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.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.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.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.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.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.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.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.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.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.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 /domainsmetapple_pay=any, ofapple_pay=readyvoor geverifieerde domeinen. Filter op hostnaam metdomainin plaats vanhostname.GET /payment_method_domains/{id}:GET /domains/{id}.POST /payment_method_domains:POST /domainsmetdomain,account_idenapple_pay: {}. Als het account het domein al heeft,PATCH /domains/{id}metapple_pay: {}.POST /payment_method_domains/{id}/verify:POST /domains/{id}/check.DELETE /payment_method_domains/{id}:PATCH /domains/{id}metapple_pay: null.DELETE /domains/{id}verwijdert het hele domein, inclusief eventuele websites erop.status: verifiedisapple_pay.state: ready.status: pendingisapple_pay.state: pendingterwijl Whop het domein registreert, ofaction_requiredtotdat je het associatiebestand host en het domein controleert.
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.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
accountin plaats vancompany. - Het weergeven van reviews filtert op
account_idofproduct_id, sorteert metorderendirectionen 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_idwordt niet meer geaccepteerd. Gebruikaccount_id.DELETE /reviews/{id}verwijdert een review die de aangemelde gebruiker heeft geschreven en vereist de scopereview:delete.
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.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.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.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.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_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.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.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.Het aanmaken van een app-build accepteert
ai_prompt_id niet meer.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 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.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.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.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.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.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.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.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.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.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.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(wascompany),member_id(wasmember),payment_method_id(waspayment_method) encheckout_configuration_id(wascheckout_configuration). De koper is eenuser-samenvatting (id,username,name,profile_picture). error_messageverhuist naarlast_setup_error, hetzelfde{ code, message }-blok dat Retrieve setup status retourneert. Het blijftnulltotdat er iets misgaat en verdwijnt zodra de setup slaagt.return_url,payment_method_typeenupdated_atzijn nieuw.created_atenupdated_atzijn 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. Decardervan krijgtexp_monthenexp_yearop beide resources.card.brandkannullzijn: een opgeslagen kaart waarvan de vault het netwerk niet heeft vastgelegd, behoudt de laatste vier cijfers en de vervaldatum in plaats van het helecard-object te verliezen.- Het aanmaken van een setup intent antwoordt met
201 Created(was200), respecteertIdempotency-Keyen vereist precies één vanconfirmation_tokenofpayment_method_id. Een bevestigingstoken van een ander account geeft een404. client_secretwordt 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: depayment:charge-referentie van het account of het eigen token van de koper. Lijstrijen bevatten altijdnull.- De webhooks
setup_intent.requires_action,setup_intent.succeededensetup_intent.canceleddie op of na deze versie zijn vastgezet, leveren hetzelfde Setup Intent-object als hundata. Webhooks die eerder zijn vastgezet en webhooks zonder pin behouden de vorige payload. GET /setup_intentsgeeft weer met de standaard{ data, page_info }-envelop en cursorpaginering.account_idis optioneel: een account-API-sleutel geeft het eigen account weer, en een gebruikerstoken geeft elk account weer dat het kan lezen.statusis een nieuw filter, en een ongeldige waarde geeft een400.created_beforeencreated_afterwerken zoals voorheen.
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.TypeScript SDK:
@whop/sdk@1.1.5.Accounts, varianten, checkoutconfiguraties en checkoutsessies bieden drie 3D Secure-keuzes:mandate_challengevraagt een challenge aan voordat een ondersteunde on-session kaartbetaling wordt verwerkt.mandate_if_requiredverplicht een challenge alleen wanneer de betalingsverwerker dat vereist.frictionless_if_requiredgebruikt de gewone frictionless 3DS-flow.
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.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.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.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_coursesis nueducation,physical_productis nuecommerceenmarketplaceis nuplatform.- Branchegroepen en -typen zijn opnieuw ingedeeld onder de acht bedrijfstypen.
PATCH /accounts/{id}accepteert alleen slugs uit de woordenlijst. Onbekende waarden retourneren400.
null.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.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.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, ensource_typekanengagementzijn. Betrokkenheidsdoelgroepen kunnen ook worden gebruikt als bron voor lookalikes. GET /social_accounts/{id}/postsbevatvideo_idencaptionom video’s te helpen selecteren zonder handmatig hun platform-ID’s te zoeken.
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.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 uitmethods.crypto. metadatais 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_idin de respons is niet meer null, omdat elke bestemming nu een account aanwijst.
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.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(wascompany),plan_id,product_id,membership_id,member_id,promo_code_id,shipment_id,payment_method_id. De koper is eenuser-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_currencyensettlement_exchange_ratezijn opgenomen intotalencurrency.refunded_amountentax_refunded_amountworden weergegeven zoals ze zijn verrekend, tegen de koers die gold toen elke terugbetaling werd uitgevoerd, entax_refunded_amountstaat 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_attemptzijnlast_payment_attempt_at/next_payment_attempt_at. Kaartgegevens staan oppayment_instrument.- Het aanmaken van een betaling accepteert
account_id(wascompany_id), antwoordt met201 Created, respecteertIdempotency-Keyen accepteertcapture: falseom 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}/feeszijn{ type, origin, label, description, amount, settlement_amount, collected_at }met geldobjecten (warenname/amount/currency/type). GET /refundsenGET /refunds/{id}retourneren de native Refund:payment_idenaccount_idin plaats van een ingesloten betaling,amountals geldobject in de verrekeningsvaluta van de betaling,original_amountin de valuta van de verwerker. Het filtercompany_idisaccount_id, en het verzenden vancompany_idgeeft een 400.POST /payments/{id}/refund,POST /payments/{id}/retryenPOST /payments/{id}/voidzijn ook native en retourneren hetzelfde Payment-object. Refund accepteert nog steeds een optioneelpartial_amount.GET /paymentsgeeft 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 komtbilling_reason=subscription_cycleook overeen met verlengingen die zijn geregistreerd alssubscription_update. Betalingen met een bedrag van nul worden meegenomen, dusinclude_freevan de proxy is verdwenen. Een ongeldigestatusgeeft een400, 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 zoekfunctiequeryvoor kopers werkt zoals voorheen. Het venstercreated_before/created_afteromvat alleen het aanmaaktijdstip van de betaling. De proxy filterde op het betaaltijdstip waar dat bestond. Op lijstrijen issettlement_time_atnull. Haal de betaling op om deze te krijgen.
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_reportsretourneert410 Gonemet eenerror.typevangone. GebruikGET /stats/time_series/ad_deliveryvoorspend,impressionsenclicksover tijd, afgebakend met eensource-pad zoalswhop:adcamp_xxx:*. GebruikGET /stats/time_series/eventsvoor toegeschreven conversies.- Prestaties per entiteit voor een periode staan op de entiteitsendpoints.
GET /ad_campaigns,GET /ad_groupsenGET /adsaccepterenstats_fromenstats_toen retournerenspend,resultsenreturn_on_ad_spendop elke rij. - Elke respons van het verouderde endpoint, op elke versie, bevat nu de headers
DeprecationenLink: <…/stats/ad_delivery>; rel="successor-version". Verzoeken die op eerdere versies zijn vastgezet en verzoeken zonder versie blijven ongewijzigd werken totdat eenSunset-header de datum aankondigt waarop het voor elke versie niet meer reageert.
GET /financial_reports en GET /financial_reports/breakdown gebruiken nu ISO 8601-tijdstempels from en to voor rapportperiodes.from_dateento_dateheten nufromento.- Kale datums worden niet meer geaccepteerd. Neem in beide tijdstempels een tijd en offset op.
GET /apps gebruikt verified nu als optioneel gelijkheidsfilter in plaats van de afwezigheid ervan te behandelen als verified=false voor openbare websitelijsten.- Laat
verifiedweg om openbaar vindbare websiteblauwdrukken uit beide verificatiestatussen te retourneren. - Stel
verified=truein voor door Whop geverifieerde blauwdrukken ofverified=falsevoor communityblauwdrukken. recommended=truefiltert aanbevolen apps onafhankelijk van de verificatiestatus.
De verouderde
/withdrawals-endpoints zijn verouderd ten gunste van de native Payouts-API en worden op deze versie niet meer geleverd.GET /withdrawalsenPOST /withdrawalsretourneren410 Gonemet eenerror.typevangone. Gebruik in plaats daarvanGET /payoutsenPOST /payouts. Uitbetalings-ID’s zijn dezelfdewdrl_-ID’s, dus bestaande identificatoren blijven werken.GET /withdrawals/{id}reageert nog steeds op deze versie. GebruikGET /payouts/{id}voor nieuw werk.- Elke respons van de verouderde endpoints, op elke versie, bevat nu de headers
DeprecationenLink: <…/payouts>; rel="successor-version". EenSunset-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.
De
post_id van een advertentie verwijst nu naar de post die het advertentienetwerk weergeeft, ongeacht hoe de advertentie is opgebouwd.post_idretourneert 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 ditnullvoor 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_sourceenpost_thumbnail_urlbeschrijven dat veld.
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,visibilityen een ISO 8601-created_at. De veldensizeenurlzijnnulltotdat de uploadreadyis. GET /files/{id}vindt alleen bestanden die je zelf hebt aangemaakt. Andere aanroepers krijgen een 404.
TypeScript SDK:
@whop/sdk@1.0.13.De levenscycluswoorden van het uitbetalingsobject zijn opnieuw opgebouwd en de geldvelden worden decimale strings.statuskent acht woorden:requested,in_review,processing,completed,reversed,canceled,failed,denied. Een verrekende uitbetaling die de provider terugdraait, geeftreversed, met de retourcode enfunds_returned_atinfailure.- Een nieuw veld
status_detailbevat de meest gedetailleerde machinefase onder het statuswoord. De waarden ervan kunnen worden uitgebreid zonder versieverhoging.statusis het geversioneerde contract. amount,fee_amount,net_amount,markup_feeendestination_amountzijn decimale strings.exchange_rateblijft een getal.- Uitbetalingen worden aangemaakt onder hun
wdrl_-ID: de ID diePOST /payoutsretourneert, is de ID dieGET /payoutsweergeeft, en het conversieverzoek van een uitbetaling blijft bestaan alspayout_request_id. Conversieverzoeken die vóór deze versie zijn aangemaakt, blijven reageren onder huncofr_-ID. - De idempotentiesleutel wordt alleen in de
Idempotency-Key-header verzonden, en het bodyveldidempotency_keywordt geweigerd.
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.Het veld
company_id van de webhook-envelop heet nu account_id.- Webhookleveringen die op
2026-08-14of later zijn vastgezet, bevattenaccount_idin de envelop. - Webhooks die op eerdere versies zijn vastgezet, en webhooks zonder
api_version_date-pin, behoudencompany_id.
TypeScript SDK:
@whop/sdk@1.0.11.Uitsplitsingen van account- en persoonlijke saldi tonen nu in_transit naast pending.- Tel
pendingenin_transitop om het totale bedrag weer te geven dat op verrekening wacht. - Aanroepers die op eerdere versies zijn vastgezet, blijven het gecombineerde bedrag in
pendingontvangen.
De invoer
api_version op POST /webhooks en PATCH /webhooks/{id} is verwijderd.- Nieuwe webhooks gebruiken altijd de
v1-events en -payloads. Verzoeken dieapi_versionmeegeven, worden geweigerd met een400. - Zet de payloadstructuur van een webhook in plaats daarvan vast met
api_version_date. - Bestaande
v2- env5-webhooks blijven leveren. Je kunt geen webhooks meer aanmaken op of overzetten naar deze versies.
Geschilwaarschuwingen zijn nu een native REST-resource en worden daarnaast nog via de verouderde proxy geleverd.
GET /dispute_alertsgeeft de waarschuwingen van een account weer met cursorpaginering en filtert opaccount_id,payment_id,typeen een aanmaakperiode.typevervangtalert_typeen benoemt de twee soorten die een uitgever stuurt:early_fraud_warning(fraudemeldingen van Visa TC40 / Mastercard SAFE) endispute_alert(meldingen vóór een geschil).fee_chargedvervangtcharge_for_alerten geeft aan of Whop het account daadwerkelijk heeft gefactureerd. Vroege fraudewaarschuwingen worden nooit gefactureerd.actionablegeeft aan of het terugbetalen van de betaling een chargeback nog kan voorkomen.- De objecten
paymentendisputezijn vervangen door de tagspayment_idenaccount_id. Tijdstempels zijn ISO 8601, metreported_atvoor het moment waarop de uitgever de melding heeft ingediend.
Swaps tussen fiatparen (
POST /swaps met twee fiatvaluta) ondersteunen nu vrije valutaomrekening, en amount komt overeen met de semantiek van cryptoswaps.amountis het bedrag vanfrom_tokendat 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 veldto_amount(uitgedrukt into_token, begrensd tot de schuld).amountento_amountsluiten 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-
amountwordt behandeld als het aflossingsbedrag into_token.
De
requested_information van een verificatie is nu een platte lijst: één vereiste per vermelding, één schrijfactie per antwoord.- Elke vermelding geeft in
requirementaan wat er nodig is: een document zoalsbank_statement, of een veldsleutel zoalsssn, met eenlabelom aan de gebruiker te tonen. - Beantwoord
file-vermeldingen metfile(een ID van een directe upload). Beantwoordtext-,date-,phone- enselect-vermeldingen metvalue, enaddress-vermeldingen metaddress. Niets uit de respons wordt teruggestuurd. - Een vermelding die als
multipleis gemarkeerd, accepteert meerdere bestanden in één antwoord, in volgorde van de vakken, met de voorkant eerst bij een dubbelzijdig document. - Een vermelding die
optionsvermeldt, accepteert ook eenvalue. Bijselect-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
errorsmet een stabielecodeen eenreason. - De geneste formulierstructuur
requested_files/categoryis in deze versie verdwenen. Aanroepers die op eerdere versies zijn vastgezet, behouden deze, en hun antwoorden worden automatisch omgezet.
Promotiecodes zijn nu een volledige REST-resource op het hoogste niveau en worden daarnaast nog via de verouderde proxy geleverd.
GET /promo_codesgeeft de promotiecodes van een account weer en gebruiktaccount_idin plaats vancompany_id.POST /promo_codesmaakt promotiecodes aan.GETenDELETE /promo_codes/{id}halen ze op en archiveren ze.POST /promo_codes/{id}/activateenPOST /promo_codes/{id}/deactivatevervangen de verouderdePATCH-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.
Accountresponsen tonen nu een uitgebreidere relatie met het bovenliggende account voor gekoppelde accounts.
parent_accountvervangtparent_account_id.- Het bovenliggende account bevat de
id,title,routeenlogo_url.
Ondersteunde uitbetalingsmethoden hebben nu een eigen gepagineerd endpoint.
GET /payouts/supported_methodsgeeft de uitbetalingsmethoden weer die een account of gebruiker mag toevoegen.- Ondersteunde methoden gebruiken
object: "supported_payout_method", en hunpodst_-ID’s worden meegegeven alssupported_payout_method_id. - Opgeslagen uitbetalingsmethoden tonen
supported_payout_method. Uitbetalingen tonenpayout_method.supported_payout_method. - Gebruik
countryom ondersteunde methoden weer te geven voor een ander land dan het land van het uitbetalingsaccount. GET /payouts/methodsaccepteertinclude_availableniet meer en retourneertavailable_destinationsniet meer.- Aanroepers die op eerdere versies zijn vastgezet, behouden
destination_id,payout_destinationenpayout_token.
Kaarttransacties gebruiken nu native REST-endpoints en worden daarnaast nog via de verouderde proxy geleverd.
GET /card_transactionsgeeft de kaarttransacties van een account weer, enGET /card_transactions/{id}haalt er een op aan de hand van decitx_-ID. De lijst accepteert ook een filtertransaction_idsom 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_afterencreated_before. Tijdstempelfilters zijn ISO 8601. cardholder_idis nieuw in de respons: de gebruiker aan wie de kaart is toegewezen.
- Elke uitbetalingsmethode retourneert
fee_structure(percentage, vast bedrag en valuta) enestimated_arrival(tijdstempels per snelheid) zonder dat er eenamountnodig is. - De objecten
standardeninstantvan de offerte bevatten geenestimated_arrivalmeer. Lees het uit het veldestimated_arrivalop het hoogste niveau van de methode.
Zaken in het Resolution Center gebruiken nu native REST-endpoints en worden daarnaast nog via de verouderde proxy geleverd.
status,escalated,outcome,refund,reasonenavailable_actionstonen de status van de zaak en de toegestane acties.- Events zijn beschikbaar via het gepagineerde
GET /resolution_center_cases/{id}/events. Samenvattingen zijn beschikbaar viaGET /resolution_center_cases/summary. - Schrijfacties gebruiken
messageenattachments.due_dateheet nuresponse_due_at. Voor het weergeven isaccount_idniet meer vereist.
Zendingen gebruiken nu native REST-endpoints en worden daarnaast nog via de verouderde proxy geleverd.
GET /shipmentsgeeft zendingen weer.GET /shipments/{id}haalt op aan de hand van de zendings-ID of betalings-ID.POST /shipmentsmaakt een zending aan, enPATCH /shipments/{id}werkt het trackingnummer ervan bij.- Responsen gebruiken
account_identracking_number, naastcarrier,tracking_url,order_idenpayment_id. - Aanroepers die vóór deze datum zijn vastgezet, behouden het contract van de verouderde proxy ongewijzigd.
Geschillen gebruiken nu native REST-endpoints en worden daarnaast nog via de verouderde proxy geleverd.
PATCH /disputes/{id}bewerkt bewijs, enPOST /disputes/{id}/submitdient het in. Bewijs is genest onderevidence.GET /disputes/summarybiedt totalen gegroepeerd opstatusencurrency. Weergeven en ophalen retourneren dezelfde velden.- Responsen gebruiken
account_id,product_idenplan_id, plusbuyernaastpayment. Voor het weergeven isaccount_idniet meer vereist. statusenreasonzijn genormaliseerde enums, enneeds_response_by,rdreneditablezijn vervangen door hun nieuwe velden.- Aanroepers die vóór deze datum zijn vastgezet, behouden het contract van de verouderde proxy ongewijzigd.
Leden en lidmaatschappen gebruiken nu native resources met een accountgericht lidmaatschapsmodel en opnieuw ontworpen levenscyclusacties.
- Lidmaatschapsresponsen retourneren de compatibiliteitsvelden
plan_idenproduct_idin plaats van geneste compatibiliteitsobjectenplanenproduct. - Het weergeven van lidmaatschappen retourneert alles wat de aanroeper kan lezen (de eigen lidmaatschappen plus die van de beheerde accounts), en
account_id/user_idbeperken die lijst in plaats van van modus te wisselen of een fout te geven. - Stel
cancel_at_period_endin om een annulering in te plannen. De actiecancelbeëindigt de toegang direct. - De actie
extendvervangtadd_free_days.
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
accountin plaats vancompany.
Partnerbedrijven tonen nu afzonderlijke uitbetalingstarieven voor elke inkomstenbron.
payout_percentageis vervangen doorpayout_percentages.- Het geneste object bevat tarieven voor
sales,ad_spend,transferencard_interchange.
Producten en checkoutconfiguraties gebruiken nu consistent het Account-model.
- Verzoekparameters voor producten gebruiken
account_idin plaats vancompany_id. - Verzoeken voor checkoutconfiguraties gebruiken
account_idop het hoogste niveau en binnen inline variantobjecten die in het compatibiliteitsveldplanworden meegegeven. - Responsen voor checkoutconfiguraties retourneren
account_idin plaats vancompany_id.
Tijdstempels van checkoutconfiguraties gebruiken nu hetzelfde formaat als de rest van de API.
created_atenupdated_atzijn ISO 8601-strings in plaats van Unix-epoch-integers.
Gebruikerssaldi bieden nu een volledig, gestructureerd saldo-overzicht.
- De platte velden
total_usdenbalanceszijn vervangen door een genestbalance-object. - Het overzicht scheidt contant geld, crypto, lopende treasury-stortingen en saldi van accounts waarvan de gebruiker eigenaar is.
Verdiensten uit bedrijfsverwijzingen identificeren nu de polymorfe resource die de verdienste heeft gegenereerd.
receiptis vervangen doorresource.access_passis vervangen doorproduct.- Verdiensten op basis van bonnen retourneren
resource.object: "receipt"met de betalingsgegevens van de bon. - Het veld
resourcekan in toekomstige versies extra verdienstenresources ondersteunen zonder bonspecifieke velden te hergebruiken.
Volume en verdiensten uit bedrijfsverwijzingen worden nu gerapporteerd als sluitende groepen.
processing_volume,total_earnings,pending_payoutencompleted_payoutzijn vervangen door geneste objectenvolume_usdenearnings_usd.- Verdiensten hernoemen
base_amount/amountnaartransaction_amount_usd/commission_amount_usden drukkenpayout_percentageuit als breuk.
Varianten, die toen Plans heetten, gebruiken nu consistent het Account-model.
- Verzoekparameters en verzoekbodies gebruiken
account_idin plaats vancompany_id. - Variantresponsen retourneren
accountin plaats vancompany.
Toegangsverzoeken voor gebruikers gebruiken nu consistent het Account-model.
- Verzoekparameters en verzoekbodies gebruiken
account_idin plaats vancompany_id. - Responsstructuren zijn ongewijzigd.

