> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# API-versies

> Zet je verzoeken vast op een gedateerde API-versie, zodat wijzigingen in de API je integratie nooit breken.

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.

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

| Je stuurt | Je krijgt |
| - | - |
| `Api-Version-Date: 2026-07-23` | De API zoals die op die datum werkte |
| Geen header, API-sleutel heeft een pin | De API-versie die op de API-sleutel is opgeslagen |
| Geen header of opgeslagen pin | Het oorspronkelijke gedrag van `2025-01-01` |
| Een onbekende datum | Een `400`-fout met de ondersteunde versies |

> [!NOTE]
>
> **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.

**2026-11-17**

Een level behoudt alleen het level en de punten

`level` op [Retrieve user](https://docs.whop.com/nl/api-reference/users/retrieve-user.md) en [Retrieve account](https://docs.whop.com/nl/api-reference/accounts/retrieve-account.md) 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`.

**2026-11-16-2**

`applied_level` van een level is nu `current`

`level.applied_level` heet nu `level.current` op [Retrieve user](https://docs.whop.com/nl/api-reference/users/retrieve-user.md) en [Retrieve account](https://docs.whop.com/nl/api-reference/accounts/retrieve-account.md). De waarde is ongewijzigd: het level dat van toepassing is, van `0` tot en met `10`.

**2026-11-16-1**

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.

**2026-11-16**

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](https://docs.whop.com/nl/api-reference/partner-referral-requests/create-a-partner-referral-request.md) 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](https://docs.whop.com/nl/api-reference/partner-referral-requests/list-partner-referral-requests.md) retourneert geen verzoeken, en `user` op een verzoek is altijd `null`.

**2026-11-14-1**

Het level van een gebruiker is openbaar

[Retrieve user](https://docs.whop.com/nl/api-reference/users/retrieve-user.md) 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.

**2026-11-14**

Je eigen aankopen weergeven en ophalen

Met gebruikersreferenties retourneert `user_id=me` op [list payments](https://docs.whop.com/nl/api-reference/payments/list-payments.md) 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](https://docs.whop.com/nl/api-reference/payments/retrieve-payment.md) 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.

**2026-11-13-1**

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.

**2026-11-13**

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](https://docs.whop.com/nl/api-reference/members/list-members.md) in plaats van leads weer te geven. Voeg een lid toe op e-mailadres met [Create member](https://docs.whop.com/nl/api-reference/members/create-member.md). Lees of werk er een bij met [Retrieve member](https://docs.whop.com/nl/api-reference/members/retrieve-member.md) en [Update member](https://docs.whop.com/nl/api-reference/members/update-member.md).

**2026-11-12**

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.

**2026-11-11**

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.

**2026-11-10-1**

Het terugkerende Economic Intelligence-aanbod is `3_days`

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

Het terugkerende aanbod in `economic_intelligence_offers` op [Retrieve account preferences](https://docs.whop.com/nl/api-reference/accounts/retrieve-account-preferences.md) 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](https://docs.whop.com/nl/api-reference/accounts/update-account-preferences.md). De sleutel `weekly` wordt geweigerd.

**2026-11-10**

Advertentiestatistieken accepteren geen `clicks` meer

Het veld `clicks` is verwijderd uit [Create ad stats](https://docs.whop.com/nl/api-reference/ads/create-ad-stats.md). 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.

**2026-11-07**

Chat-API: kanalen, leden en berichten

Bouw chat in je app. [Channels](https://docs.whop.com/nl/api-reference/channels/list-channels.md) omvatten directe berichten, groepschats, communitychats en supportchats. Met [Channel members](https://docs.whop.com/nl/api-reference/channel-members/list-channel-members.md) voeg je mensen toe en verwijder je ze. [Messages](https://docs.whop.com/nl/api-reference/messages/list-messages.md) 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](https://docs.whop.com/nl/api-reference/messages/delete-message.md) retourneert `204`. Reageer en stem met `POST /messages/{id}/react`, `/unreact` en `/vote`.

**2026-11-06**

Het ledger-regeltype `bank_transfer` is uitgefaseerd

Iron-bankstortingen zijn regels in de [ledger-activiteit](https://docs.whop.com/nl/api-reference/ledgers/ledger-activity) 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.

**2026-11-05-1**

Uitbetalingslijsten bevatten de Whop Card

[List saved payout methods](https://docs.whop.com/nl/api-reference/payouts/list-saved-payout-methods.md) bevat de Whop Card van het account. [List payouts](https://docs.whop.com/nl/api-reference/payouts/list-payouts.md) bevat de uitbetalingen waarmee geld naar die kaart is verplaatst. Een opgeslagen uitbetalingsmethode, en de `payout_method` van een [payout](https://docs.whop.com/nl/api-reference/payouts/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.

**2026-11-05**

Een lopende indiening voor een geschil rapporteert `generating_response`

Een [geschil](https://docs.whop.com/nl/api-reference/disputes/dispute) 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`.

**2026-11-04-1**

Whop Levels: het toegepaste level is `applied_level`

Op het `level` van een [gebruiker](https://docs.whop.com/nl/api-reference/users/user) en een [account](https://docs.whop.com/nl/api-reference/accounts/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](https://docs.whop.com/nl/api-reference/accounts/retrieve-account-fees.md). Het `level` van een account voegt ook `account_level` toe, het level dat de eigen punten van het account bereiken.

**2026-11-04**

Advertentiecertificeringen zijn verwijderd

Whop biedt geen advertentiecertificeringen meer aan. [Retrieve account preferences](https://docs.whop.com/nl/api-reference/accounts/retrieve-account-preferences.md) en [Update account preferences](https://docs.whop.com/nl/api-reference/accounts/update-account-preferences.md) retourneren `ads_certifications` niet meer, en een update accepteert het niet meer.

**2026-11-03-1**

Gekoppelde accounts zijn nu subaccounts

Onderliggende accounts van een platform heten subaccounts. Op [List payments](https://docs.whop.com/nl/api-reference/payments/list-payments.md) en [List disputes](https://docs.whop.com/nl/api-reference/disputes/list-disputes.md), en op hun samenvattingsendpoints, is `include_connected_accounts` nu `include_subaccounts`. Op [Update account preferences](https://docs.whop.com/nl/api-reference/accounts/update-account-preferences.md) 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`.

**2026-11-03**

Uitbetalingsverzoeken vereisen een offerte

[Create a payout](https://docs.whop.com/nl/api-reference/payouts/create-payout.md) 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.

**2026-11-02-1**

De klant van een factuur kan niet meer veranderen nadat het concept is aangemaakt

Op [Update invoice](https://docs.whop.com/nl/api-reference/invoices/update-invoice.md) 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](https://docs.whop.com/nl/api-reference/invoices/void-invoice.md). [Maak daarna een nieuwe factuur aan](https://docs.whop.com/nl/api-reference/invoices/create-invoice.md). Aan een concept dat zonder klant is opgeslagen, kan nog steeds een klant worden toegevoegd.

**2026-11-02**

Snapchat-koppelingen zijn verwijderd

[Connect an External Account](https://docs.whop.com/nl/api-reference/external-accounts/connect-an-external-account.md) 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`.

**2026-10-30**

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

**2026-10-29-8**

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](https://docs.whop.com/nl/api-reference/external-accounts/connect-an-external-account.md) accepteert `meta_business` niet meer, en `tiktok` accepteert de scope `advertise` niet meer. Het verzenden van een van beide retourneert een `400`.

**2026-10-29-5**

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

**2026-10-29-4**

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](https://docs.whop.com/nl/api-reference/audiences/create-audience.md) 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`.

**2026-10-29-3**

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.

**2026-10-29-2**

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](https://docs.whop.com/nl/api-reference/ad-campaigns/duplicate-an-ad-campaign.md), [Duplicate an Ad Group](https://docs.whop.com/nl/api-reference/ad-groups/duplicate-an-ad-group.md) of [Duplicate an Ad](https://docs.whop.com/nl/api-reference/ads/duplicate-an-ad.md) 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.

**2026-10-29-1**

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.

**2026-10-29**

Advertenties laten netwerkspecifieke velden en de doelstelling awareness vallen

Advertentiecampagnes, advertentiegroepen en advertenties retourneren `platform` niet meer, en [Create an Ad Campaign](https://docs.whop.com/nl/api-reference/ad-campaigns/create-an-ad-campaign.md) 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](https://docs.whop.com/nl/api-reference/ad-campaigns/create-an-ad-campaign.md), [Create ad](https://docs.whop.com/nl/api-reference/ads/create-an-ad.md) of [Update ad](https://docs.whop.com/nl/api-reference/ads/update-an-ad.md) retourneert een `400`.

**2026-10-28-1**

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](https://docs.whop.com/nl/api-reference/ad-groups/create-an-ad-group.md), [Update ad group](https://docs.whop.com/nl/api-reference/ad-groups/update-an-ad-group.md), [Create ad](https://docs.whop.com/nl/api-reference/ads/create-an-ad.md) of [Update ad](https://docs.whop.com/nl/api-reference/ads/update-an-ad.md) retourneert een `400` met de naam van het veld.

**2026-10-28**

Variantlijsten van accounts laten varianten van verouderde facturen weg

[List variants](https://docs.whop.com/nl/api-reference/variants/list-variants.md) 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](https://docs.whop.com/nl/api-reference/variants/retrieve-variant.md) op ID. De verouderde lijst `GET /plans` gedraagt zich op dezelfde manier.

**2026-10-27-3**

Swaps weigeren een bedrag boven het walletsaldo

Op [Create swap](https://docs.whop.com/nl/api-reference/swaps/create-swap.md) 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.

**2026-10-27-2**

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](https://docs.whop.com/nl/api-reference/memberships/invite-to-a-membership.md) en [Create waitlist entry](https://docs.whop.com/nl/api-reference/waitlist-entries/create-waitlist-entry.md) accepteren `variant_id`, en [Approve all waitlist entries](https://docs.whop.com/nl/api-reference/waitlist-entries/approve-all-waitlist-entries.md) accepteert en retourneert `variant_id`. [List memberships](https://docs.whop.com/nl/api-reference/memberships/list-memberships.md) filtert met `variant_id` en `variant_ids`, [List members](https://docs.whop.com/nl/api-reference/members/list-members.md) met `variant_ids` en [List waitlist entries](https://docs.whop.com/nl/api-reference/waitlist-entries/list-waitlist-entries.md) 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](https://docs.whop.com/nl/api-reference/payments/list-payments.md) filtert met `variant_ids` in plaats van `plan_ids`. [Create payment](https://docs.whop.com/nl/api-reference/payments/create-payment.md) en [Create payment quote](https://docs.whop.com/nl/api-reference/payment-quotes/create-payment-quote.md) 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](https://docs.whop.com/nl/api-reference/checkout-configurations/create-a-checkout-configuration.md) accepteert `variant_id` in plaats van `plan_id` en een inline `variant` (met `billing_type`) in plaats van `plan`, en [List checkout configurations](https://docs.whop.com/nl/api-reference/checkout-configurations/list-checkout-configurations.md) filtert met `variant_id`. Verzoeken en responsen voor checkoutsessies gebruiken `items[].variant` in plaats van `items[].plan`.

**Promotiecodes en partners.** [List promo codes](https://docs.whop.com/nl/api-reference/promo-codes/list-promo-codes.md) filtert met `variant_ids` in plaats van `plan_ids`, en [Create promo code](https://docs.whop.com/nl/api-reference/promo-codes/create-promo-code.md) accepteert `variant_ids`.

**2026-10-27-1**

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](https://docs.whop.com/nl/api-reference/variants/create-variant.md) accepteert `billing_type`, en [List variants](https://docs.whop.com/nl/api-reference/variants/list-variants.md) en [List products](https://docs.whop.com/nl/api-reference/products/list-products.md) 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](https://docs.whop.com/nl/api-reference/payment-quotes/create-payment-quote.md) 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.

**2026-10-27**

Uitnodigingen retourneren het teamlid in afwachting

Wanneer [Create team member](https://docs.whop.com/nl/api-reference/team-members/create-team-member.md) 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.

**2026-10-24**

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.

**2026-10-15-1**

Accounts bevatten geen stablecoin\_rails meer

Accounts bevatten `stablecoin_rails` niet meer.

**2026-10-15**

Documenttypen voor verificatie zijn in kleine letters

Op [Create verification](https://docs.whop.com/nl/api-reference/verifications/create-verification.md), en op eigenaren in `owners`, accepteert `document_type` waarden in kleine letters: `passport`, `id_card`, `drivers` of `residence_permit`. De gids over [identiteitsdocumenten](https://docs.whop.com/nl/developer/verification/identity-documents.md) vermeldt welke documenten elk land accepteert.

**2026-10-14-1**

Kaartafschrijving voor stortingen verplaatst naar methods

Op [Create deposit](https://docs.whop.com/nl/api-reference/deposits/create-deposit.md) 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.

**2026-10-14**

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](https://docs.whop.com/nl/api-reference/domains/domain)-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`.

**2026-10-13-1**

Native reviews

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

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

**2026-10-13**

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.

**2026-10-09-2**

Apps vermelden geen eerdere gehoste URL's meer

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

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.

**2026-10-09-1**

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.

**2026-10-09**

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.

**2026-10-08**

Openstaande tegoeden kunnen wachten op een compliancebeoordeling

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

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.

**2026-10-07-2**

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.

**2026-10-07-1**

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.

**2026-10-07**

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.

**2026-10-06-2**

App-builds accepteren geen AI-prompt meer

Het aanmaken van een app-build accepteert `ai_prompt_id` niet meer.

**2026-10-06-1**

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.

**2026-10-06**

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

**2026-10-05-1**

Gebruikers bevatten geen sociale accounts meer

Gebruikers retourneren `social_accounts` niet meer.

**2026-10-05**

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.

**2026-09-29**

Voorkomen geschillen rapporteren prevented

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

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.

**2026-09-28**

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

**2026-09-25**

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

**2026-09-24-1**

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.

**2026-09-24**

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.

**2026-09-23**

Tradingtoegang verschijnt in machtigingscontroles

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

`GET /permissions` bevat `crypto_wallet:trade` en `crypto_wallet:trade:read` bij het weergeven of controleren van machtigingsacties voor een account.

**2026-09-22-4**

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.

**2026-09-22-3**

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.

**2026-09-22-2**

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.

**2026-09-22-1**

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.

**2026-09-22**

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.

**2026-09-15**

Drie afzonderlijke 3D Secure-beleidsregels

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

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

**2026-09-13**

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.

**2026-09-11-1**

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.

**2026-09-11**

Bedrijfscategorieën komen uit één tabel

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

`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](https://docs.whop.com/nl/api-reference/accounts/business-types.md) 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`.

**2026-09-09-1**

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.

**2026-09-09**

Benoemde Whop-opnameblokkades op openstaande tegoeden

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

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

**2026-09-06**

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.

**2026-09-04**

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.

**2026-09-02-2**

Stortingsbestemmingen zijn een account-ID

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

`POST /deposits` 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.

**2026-09-02-1**

Betalingen worden een native resource

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

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

**2026-09-02**

Verouderd endpoint voor advertentierapporten uitgefaseerd

Het verouderde endpoint `GET /ad_reports` is verouderd ten gunste van de native [Stats](https://docs.whop.com/nl/api-reference/stats/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.

**2026-08-31**

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.

**2026-08-25-2**

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.

**2026-08-25-1**

Verouderde endpoints voor opnames uitgefaseerd

De verouderde `/withdrawals`-endpoints zijn verouderd ten gunste van de native [Payouts](https://docs.whop.com/nl/api-reference/payouts/payout)-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.

**2026-08-25**

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.

**2026-08-21-1**

Native Files API

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

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

**2026-08-21**

Uitbetalingsstatus v2

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

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.

**2026-08-14**

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

**2026-08-13**

Uitsplitsingen van saldi onderweg

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

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.

**2026-08-12**

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.

**2026-08-10**

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.

**2026-08-05-1**

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

**2026-08-05**

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.

**2026-08-03**

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.

**2026-07-31**

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

**2026-07-29-1**

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

**2026-07-29**

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.

**2026-07-27**

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.

**2026-07-26**

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.

**2026-07-25**

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.

**2026-07-23**

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

**2026-07-22**

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

**2026-07-20**

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

**2026-07-18**

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

**2026-07-08-1**

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.

**2026-07-08**

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.

**2026-07-01**

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.

**2026-06-20**

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.

**2026-06-09**

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

**2026-06-08**

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.

**2025-01-01**

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.


## Related topics

- [Migreren vanaf eerdere versies](https://docs.whop.com/nl/developer/api/migrate-from-previous-versions.md)
- [Products API](https://docs.whop.com/nl/api-reference/products/product.md)
- [Verifications API](https://docs.whop.com/nl/api-reference/verifications/verification.md)
