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

# Adverteren met Whop Ads

> Koop advertenties op externe advertentienetwerken via je Whop-account, met facturering op accountniveau.

Met Advertising koop je vanuit je Whop-account advertenties op externe advertentienetwerken. Whop is eigenaar van het advertentieaccount, het beoordelings- en lanceringstraject en de factureringsrelatie. Je maakt een campagne aan via de API in plaats van een advertentieaccount te koppelen dat je zelf beheert.

## Wat je kunt bouwen

* **Campagnes uitvoeren** met een doelstelling, een budget en een planning.
* **Een doelgroep targeten** op locatie, demografie, interesses, apparaten en talen, of upload een klantenlijst als [doelgroep](https://docs.whop.com/nl/api-reference/audiences/audience).
* **Creatives genereren** als AI-afbeeldingen of -video op basis van een prompt, je eigen assets aanleveren, of een post promoten die al bestaat op een gekoppeld extern account.
* **Toegeschreven prestaties uitlezen**: uitgaven, resultaten, kosten per resultaat en rendement op advertentie-uitgaven, allemaal op het campagneobject zelf.

## Landen die je niet kunt targeten

Whop staat niet toe dat campagnes deze landen targeten:

| Land | Landcode |
| - | - |
| Soedan | `SD` |
| Rusland | `RU` |
| Cuba | `CU` |
| Iran | `IR` |
| Noord-Korea | `KP` |

Verzoeken om een advertentiegroep aan te maken of de getargete landen ervan bij te werken, worden geweigerd als ze een van deze codes bevatten. Verwijder ze uit je getargete locaties voordat je het verzoek indient.

## Voordat je geld uitgeeft

Twee dingen zijn vereist voor een live advertentie, en beide stel je eenmalig in:

* **Een betaalmethode** die in het dashboard is gekoppeld, ofwel je Whop-saldo of een kaart. Concepten werken ook zonder.
* **De Whop-pixel** op je bestemming, tenzij je verkeer naar een whop.com-winkelpagina stuurt. Elke externe landingspagina heeft eerst [de pixel](https://docs.whop.com/nl/developer/ads/pixel.md) nodig.

Het [overzicht van de Ads API](https://docs.whop.com/nl/api-reference/ads/overview.md) behandelt elk van deze punten met de exacte aanroepen, de vereiste scopes en de foutmeldingen die je krijgt wanneer er een ontbreekt.

## Kernobjecten

Advertentiecampagne, advertentiegroep, advertentie, doelgroep. Elk ervan wordt gedefinieerd in [Kernconcepten](https://docs.whop.com/nl/developer/concepts.md).

Advertising heeft één hiërarchie, en elk object hoort bij het niveau erboven.

**ad campaign** `adcamp_`

Bevat de doelstelling en de budgetstrategie. Zie [Ad Campaigns](https://docs.whop.com/nl/api-reference/ad-campaigns/ad-campaign).

**ad group** `adgrp_`

Bevat de targeting, het optimalisatiedoel, de planning en standaard een eigen budget. Zie [Ad Groups](https://docs.whop.com/nl/api-reference/ad-groups/ad-group).

**ad** `ad_`

Bevat de creatives, de tekstvarianten, de call-to-action en de bestemmings-URL. Zie [Ads](https://docs.whop.com/nl/api-reference/ads/ad).

[`POST /ads`](https://docs.whop.com/nl/api-reference/ads/create-an-ad) accepteert een inline `ad_group`, die op zijn beurt een inline `ad_campaign` accepteert, zodat één verzoek de hele boom in één transactie aanmaakt. Geef in plaats daarvan `ad_group_id` mee om de advertentie aan een bestaande advertentiegroep te koppelen.

Wil je later lanceren in plaats van nu, stel dan `status` in op `draft` op de inline `ad_campaign` en activeer de campagne daarna met [`PATCH /ad_campaigns/{id}`](https://docs.whop.com/nl/api-reference/ad-campaigns/update-an-ad-campaign).

Het budget staat op precies één niveau, nooit op beide: standaard op de advertentiegroep, of op de campagne wanneer je `budget_optimization` instelt op `ad_campaign`.

## Hoe resultaten worden geteld

Elk prestatiecijfer dat Whop rapporteert, wordt toegeschreven door de **Whop-pixel**, niet door het advertentienetwerk.

`result_event` geeft het conversie-event aan waarop een campagne wordt beoordeeld, en `results` is het door de pixel toegeschreven aantal daarvan. `cost_per_result` deelt de uitgaven door dat aantal. Wanneer de advertentiegroepen van een campagne op verschillende doelen optimaliseren, is er geen enkel `result_event`, dus is het `null` en wordt `results` de som van de eigen toegeschreven resultaten van elke advertentiegroep. Wanneer er niet wordt geoptimaliseerd op iets wat Whop kan toeschrijven, zijn beide `null` in plaats van nul.

## Gewenste kosten per resultaat

De `desired_cost_per_result` van een campagne is de kosten per resultaat, in USD, die je wilt bereiken. Het is alleen een streefwaarde: het is geen kostenplafond of biedplafond en het verandert niets aan hoe de advertenties van de campagne bieden. Affiliates die de campagne uitvoeren, zien het als de kosten per resultaat waarop ze moeten mikken. De eigen `desired_cost_per_result` van een advertentiegroep is een andere instelling: dat is het kostenplafond of biedplafond ervan. Stel de `desired_cost_per_result` van de campagne in op `null` om de streefwaarde te wissen.

## Betalen voor advertenties

Uitgaven lopen op naarmate advertenties worden weergegeven en worden achteraf in rekening gebracht. **Facturering hoort bij het account, over alle campagnes heen.** Elke incasso combineert in aanmerking komende onbetaalde campagne-uitgaven tot één betaling met de geconfigureerde betaalmethoden voor advertenties van het account. Je configureert geen aparte betaalmethode en vraagt geen aparte nieuwe poging aan per campagne. Het veld `spend` op een campagne is het bedrag dat bij je in rekening wordt gebracht, in `spend_currency`.

Het moment van incasso hangt af van de opgebouwde uitgaven en factureringsdrempels. Consolidatie betekent niet één betaling per dag. Het genereren van AI-creatives gebruikt een eigen betaling vanuit het saldo. Bij te weinig saldo wordt een `402` geretourneerd met een `deposit_url`.

### Wanneer een betaling mislukt

Een mislukte betaling op accountniveau blokkeert de weergave voor alle factureerbare campagnes. Elke getroffen campagne rapporteert `delivery_status: "payment_failed"`, terwijl de geconfigureerde `status` `active` of `paused` blijft. Lees `delivery_status` om te bepalen of een campagne kan worden weergegeven, en `issues` voor de reden van de mislukking.

Het account kan geen campagnes activeren zolang er onopgeloste mislukte betalingen zijn. Je kunt een campagne nog wel pauzeren zodat deze uit blijft na herstel van de betaling. Whop plant ook automatische nieuwe pogingen. Je kunt een nieuwe poging aanvragen nadat je de betaalmethode hebt hersteld.

### Een betaling opnieuw proberen

1. Selecteer in het Ads-dashboard van je account **Update payment method** in de banner over de mislukte betaling, of open de Ads-instellingen en selecteer **Billing**. Werk de kaart van het account bij of vul het saldo aan dat het gebruikt.
2. Selecteer één keer **Retry payment** voor het account. API-integraties moeten [Retry Failed Ads Payments](https://docs.whop.com/nl/api-reference/accounts/retry-failed-ads-payments.md) aanroepen met de `biz_`-ID van het account en de machtiging `ad_campaign:update`.
3. Wacht op de poging op de achtergrond. Een `202`-respons met `queued: true` bevestigt dat de taak is geaccepteerd, **niet dat de betaling is geslaagd**. Lees de [advertentiecampagnes](https://docs.whop.com/nl/api-reference/ad-campaigns/list-ad-campaigns.md) van het account voor de uitkomst.
4. Na een geslaagde afrekening wordt de betalingsblokkade opgeheven. De weergave kan `processing` tonen terwijl deze opnieuw wordt berekend en gesynchroniseerd. Campagnes die als actief zijn geconfigureerd, kunnen worden hervat als aan hun andere weergavevereisten is voldaan. Campagnes die als gepauzeerd zijn geconfigureerd, blijven gepauzeerd.

```bash theme={null}
curl -X POST "https://api.whop.com/api/v1/accounts/biz_YOUR_ACCOUNT/retry_ads_payment" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-09-22"
```

```json theme={null}
{ "account_id": "biz_YOUR_ACCOUNT", "queued": true }
```

Herhaalde verzoeken terwijl een nieuwe poging voor het account in de wachtrij staat of wordt uitgevoerd, retourneren een fout met het verzoek om te wachten. Als de betaling opnieuw mislukt, blijft de weergave geblokkeerd: controleer de reden van de mislukking en herstel de betaalmethode voordat je het opnieuw probeert. Loop niet over campagnes heen om elke campagne afzonderlijk opnieuw te proberen. Het oudere [endpoint voor een nieuwe poging per campagne](https://docs.whop.com/nl/api-reference/ad-campaigns/retry-a-failed-ad-campaign-payment.md) zet op API-versies vóór `2026-09-22` nog steeds een nieuwe poging voor het account in de wachtrij. Vanaf `2026-09-22` retourneert het `410 Gone`. Gebruik het account-endpoint hierboven.

Oudere campagnes waarvan de geconfigureerde `status` al `payment_failed` was, keren na een geslaagde nieuwe poging terug naar `paused`, omdat hun vorige actief/gepauzeerd-instelling niet is bewaard.

## Waarom een campagne niet wordt weergegeven

`delivery_status` geeft hier direct antwoord op. Het is het eerste veld om te lezen wanneer een campagne bestaat maar er niets gebeurt. Meerdere statussen kunnen tegelijk waar zijn, dus de waarde is de hoogste op deze ladder:

| `delivery_status` | Wat het betekent |
| - | - |
| `payment_failed` | De facturering van het account is mislukt. De weergave is geblokkeerd zonder dat de geconfigureerde actief/gepauzeerd-instelling verandert |
| `all_ads_rejected` | Elke advertentie in de campagne is afgewezen |
| `draft` | Niet ingediend voor weergave |
| `paused` | Je hebt de campagne of elke advertentiegroep erin gepauzeerd, of er zijn geen advertenties meer over. Het verwijderen van de laatste advertentie of advertentiegroep van een campagne pauzeert de campagne |
| `in_review` | Een advertentie wordt nog inhoudelijk beoordeeld en er wordt nog niets weergegeven |
| `learning` | Wordt weergegeven en bevindt zich nog in de leerperiode |
| `processing` | De campagne heeft het advertentienetwerk nog niet bereikt, of elke advertentiegroep wordt nog verwerkt |
| `revise_content` | De campagne wacht om te worden uitgevoerd en de inhoudsbeoordeling houdt elke wachtende advertentie van ten minste één advertentienetwerk af. Lees de `content_review` van elke advertentie |
| `issues` | De campagne heeft openstaande problemen, of elke advertentie heeft er een. Lees de array `issues` |
| `scheduled` | De start van de campagne ligt in de toekomst, of elke advertentiegroep wacht op de eigen start |
| `completed` | De eindtijd van de campagne is verstreken. Een campagne zonder einde wordt nooit voltooid |
| `active` | Wordt weergegeven |

Advertenties en advertentiegroepen hebben hun eigen `delivery_status` met andere waarden. Een nieuwe advertentie doorloopt `in_review` voordat deze wordt weergegeven.

## Volgende stappen

> [card] [Een advertentie maken en lanceren](https://docs.whop.com/nl/api-reference/ads/overview.md)
>
> De volledige flow, van creative tot live advertentie, in twee aanroepen.

> [card] [De pixel installeren](https://docs.whop.com/nl/developer/ads/pixel.md)
>
> Vereist voordat resultaten kunnen worden toegeschreven.

> [card] [Een doelgroep opbouwen](https://docs.whop.com/nl/api-reference/audiences/create-audience.md)
>
> Upload een klantenlijst om te targeten of uit te sluiten.

> [card] [Ads-referentie](https://docs.whop.com/nl/api-reference/ad-campaigns/ad-campaign)
>
> Elk advertentie-endpoint, met een playground.


## Related topics

- [Ads](https://docs.whop.com/nl/elements/latest/ads/overview.md)
- [AdsAgreementElement](https://docs.whop.com/nl/elements/latest/ads/ads-agreement.md)
- [Aan de slag met Elements](https://docs.whop.com/nl/elements/latest/getting-started.md)
