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

# Verouderde factuur

> Een factuur is een gespecificeerde rekening die een bedrijf naar een klant stuurt voor een specifiek product en plan, met het verschuldigde bedrag, de vervaldatum en de betaalstatus.

> [!NOTE]
>
> Deze resource heeft een opvolger in de [Whop API](https://docs.whop.com/nl/api-reference/legacy/invoices/list-invoices.md): verzoeken naar `/invoices` met `Api-Version-Date: 2026-10-24` of later bereiken native facturen, die in de [handleiding Facturen](https://docs.whop.com/nl/developer/guides/invoices.md) worden behandeld. Deze pagina blijft volledig ondersteund.

```json Example theme={null}
{
	"automatically_finalizes_at": "2023-12-01T05:00:00.401Z",
	"charge_buyer_fee": true,
	"collection_method": "send_invoice",
	"company": {
		"id": "biz_xxxxxxxxxxxxxx",
		"logo": {
			"url": "https://media.whop.com/abc123/optimized.jpg"
		},
		"title": "Pickaxe"
	},
	"created_at": "2023-12-01T05:00:00.401Z",
	"current_plan": {
		"billing_period": 42,
		"currency": "usd",
		"description": "Monthly access to all premium analytics dashboards and data exports.",
		"formatted_price": "$10.00",
		"id": "plan_xxxxxxxxxxxxx",
		"initial_price": 6.9,
		"plan_type": "renewal",
		"renewal_price": 6.9,
		"trial_period_days": 42
	},
	"customer_name": "Jane Doe",
	"due_date": "2023-12-01T05:00:00.401Z",
	"email_address": "customer@example.com",
	"fetch_invoice_token": "eyJhbGciOiJIUzI1NiJ9...",
	"id": "inv_xxxxxxxxxxxxxx",
	"line_items": [
		{
			"label": "Platform subscription",
			"position": 42,
			"quantity": 6.9,
			"total": 6.9,
			"unit_price": 6.9
		}
	],
	"mailing_address": {
		"city": "<string>",
		"country": "<string>",
		"line1": "<string>",
		"line2": "<string>",
		"name": "<string>",
		"phone": "<string>",
		"postal_code": "<string>",
		"state": "<string>"
	},
	"member": {
		"id": "<string>"
	},
	"number": "#0001",
	"pay_online_url": "<string>",
	"payment": {
		"id": "pay_xxxxxxxxxxxxxx"
	},
	"payment_processing": true,
	"product": {
		"id": "prod_xxxxxxxxxxxxx",
		"title": "Pickaxe Analytics"
	},
	"status": "draft",
	"subscription_billing_anchor_at": "2023-12-01T05:00:00.401Z",
	"updated_at": "2023-12-01T05:00:00.401Z",
	"user": {
		"email": "john.doe@example.com",
		"id": "user_xxxxxxxxxxxxx",
		"name": "John Doe",
		"username": "johndoe42"
	}
}
```

**automatically\_finalizes\_at** `string\<date-time\> | null` *required*

De datum en tijd waarop de factuur automatisch wordt gefinaliseerd. Bij charge\_automatically wordt er dan automatisch afgeschreven. Bij send\_invoice wordt de factuur-e-mail op het opgegeven tijdstip verzonden.

Voorbeeld: `2023-12-01T05:00:00.401Z`

**charge\_buyer\_fee** `boolean` *required*

Of de factuur een verwerkingsvergoeding voor de koper bevat bovenop de planprijs.

**collection\_method** `InvoiceCollectionMethods` *required*

De methode waarmee de betaling voor deze factuur wordt geïnd, zoals automatisch afschrijven of handmatige betaling.

Beschikbare opties: `send_invoice`, `charge_automatically`

**company** `object` *required*

Het bedrijf dat deze factuur heeft uitgegeven.

**onderliggende attributen**

**id** `string` *required*

De unieke identificatie van het bedrijf.

Voorbeeld: `biz_xxxxxxxxxxxxxx`

**logo** `object | null` *required*

Het logo van het bedrijf.

**onderliggende attributen**

**url** `string | null` *required*

Een vooraf geoptimaliseerde URL om deze bijlage op de client weer te geven. Gebruik deze om bijlagen in apps te tonen.

Voorbeeld: `https://media.whop.com/abc123/optimized.jpg`

**title** `string` *required*

De weergavenaam van het bedrijf die aan klanten wordt getoond.

Voorbeeld: `Pickaxe`

**created\_at** `string\<date-time\>` *required*

De datum en tijd waarop de factuur is aangemaakt.

Voorbeeld: `2023-12-01T05:00:00.401Z`

**current\_plan** `object` *required*

Het plan waarvoor deze factuur in rekening brengt.

**onderliggende attributen**

**billing\_period** `integer | null` *required*

Aantal dagen tussen terugkerende afschrijvingen, zoals 30 voor maandelijks of 365 voor jaarlijks. `null` voor eenmalige plannen.

Voorbeeld: `42`

**currency** `Currencies` *required*

De valuta die voor alle prijzen in dit plan wordt gebruikt (bijv. 'usd', 'eur'). Alle geldbedragen in het plan luiden in deze valuta.

Beschikbare opties: `usd`, `sgd`, `inr`, `aud`, `brl`, `cad`, `dkk`, `eur`, `nok`, `gbp`, `sek`, `chf`, `hkd`, `huf`, `jpy`, `mxn`, `myr`, `pln`, `czk`, `nzd`, `aed`, `eth`, `ape`, `cop`, `ron`, `thb`, `bgn`, `idr`, `dop`, `php`, `try`, `krw`, `twd`, `vnd`, `pkr`, `clp`, `uyu`, `ars`, `zar`, `dzd`, `tnd`, `mad`, `kes`, `kwd`, `jod`, `all`, `xcd`, `amd`, `bsd`, `bhd`, `bob`, `bam`, `khr`, `crc`, `xof`, `egp`, `etb`, `gmd`, `ghs`, `gtq`, `gyd`, `ils`, `jmd`, `mop`, `mga`, `mur`, `mdl`, `mnt`, `nad`, `ngn`, `mkd`, `omr`, `pyg`, `pen`, `qar`, `rwf`, `sar`, `rsd`, `lkr`, `tzs`, `ttd`, `uzs`, `rub`, `btc`, `cny`, `usdt`, `kzt`, `awg`, `whop_usd`, `xau`, `hnl`

**description** `string | null` *required*

Een tekstuele beschrijving van het plan die zichtbaar is voor klanten. Maximaal 1000 tekens. Null als er geen beschrijving is ingesteld.

Voorbeeld: `Monthly access to all premium analytics dashboards and da…`

**formatted\_price** `string` *required*

De opgemaakte prijs (inclusief valuta) van het plan.

Voorbeeld: `$10.00`

**id** `string` *required*

De unieke identificatie van het plan.

Voorbeeld: `plan_xxxxxxxxxxxxx`

**initial\_price** `number` *required*

De initiële aankoopprijs in de base\_currency van het plan (bijv. 49.99 voor \$49.99). Voor eenmalige plannen is dit de volledige prijs. Voor verlengingsplannen wordt dit bovenop de eerste renewal\_price in rekening gebracht.

Voorbeeld: `6.9`

**plan\_type** `PlanTypes` *required*

Het factureringsmodel voor dit plan: 'renewal' voor terugkerende abonnementen of 'one\_time' voor eenmalige betalingen.

Beschikbare opties: `renewal`, `one_time`

**renewal\_price** `number` *required*

De terugkerende prijs die elke billing\_period in rekening wordt gebracht in de base\_currency van het plan (bijv. 9.99 voor \$9.99/periode). Nul voor eenmalige plannen.

Voorbeeld: `6.9`

**trial\_period\_days** `integer | null` *required*

Aantal dagen gratis proefperiode vóór de eerste verlengingsafschrijving. `null` als er geen proefperiode is ingesteld of de gebruiker al een proefperiode voor dit plan heeft gebruikt.

Voorbeeld: `42`

**customer\_name** `string | null` *required*

De volledige naam van de klant aan wie deze factuur is gericht. Null als er geen naam bekend is.

Voorbeeld: `Jane Doe`

**due\_date** `string\<date-time\> | null` *required*

De deadline waarvoor de betaling wordt verwacht. Null als de factuur automatisch wordt geïnd.

Voorbeeld: `2023-12-01T05:00:00.401Z`

**email\_address** `string | null` *required*

Het e-mailadres van de klant aan wie deze factuur is gericht. Null als er geen e-mailadres bekend is.

Voorbeeld: `customer@example.com`

**fetch\_invoice\_token** `string` *required*

Een ondertekend token waarmee factuurgegevens openbaar kunnen worden opgehaald zonder authenticatie.

Voorbeeld: `eyJhbGciOiJIUzI1NiJ9...`

**id** `string` *required*

De unieke identificatie van de factuur.

Voorbeeld: `inv_xxxxxxxxxxxxxx`

**line\_items** `array\<object\>` *required*

Optionele factuurregels die het factuurtotaal opsplitsen in afzonderlijke kosten.

**onderliggende attributen**

**label** `string` *required*

Het label of de omschrijving van deze factuurregel.

Voorbeeld: `Platform subscription`

**position** `integer` *required*

De weergavevolgorde van deze factuurregel binnen de factuur.

Voorbeeld: `42`

**quantity** `number` *required*

De hoeveelheid van deze factuurregel.

Voorbeeld: `6.9`

**total** `number` *required*

Het berekende totaal van deze factuurregel (quantity \* unit\_price).

Voorbeeld: `6.9`

**unit\_price** `number` *required*

De eenheidsprijs van deze factuurregel. Negatief voor een tegoed of aftrek.

Voorbeeld: `6.9`

**mailing\_address** `object | null` *required*

Het factuur-/postadres dat bij deze factuur hoort, als dat bij het aanmaken is opgegeven.

**onderliggende attributen**

**city** `string | null` *required*

De plaats van het adres.

**country** `string | null` *required*

Het land van het adres.

**line1** `string | null` *required*

Regel 1 van het adres.

**line2** `string | null` *required*

Regel 2 van het adres.

**name** `string | null` *required*

De naam van de klant.

**phone** `string | null` *required*

Het telefoonnummer van de klant.

**postal\_code** `string | null` *required*

De postcode van het adres.

**state** `string | null` *required*

De staat of provincie van het adres.

**member** `object | null` *required*

Het lid voor wie de factuur is aangemaakt. Null wanneer de factuur is gericht aan een e-mailadres zonder bijbehorend lidrecord.

**onderliggende attributen**

**id** `string` *required*

De unieke identificatie van het lid van het bedrijf.

**number** `string` *required*

Het opeenvolgende factuurnummer voor weergavedoeleinden.

Voorbeeld: `#0001`

**pay\_online\_url** `string | null` *required*

De checkout-URL waar de klant deze factuur online kan betalen, met diens e-mailadres vooraf ingevuld en vergrendeld.

**payment** `object | null` *required*

De betaling waarmee deze factuur is voldaan. Null zolang de factuur onbetaald is, wanneer de factuur handmatig als betaald is gemarkeerd, en bij een verlengingsfactuur van een abonnement, waarbij de voldane betaling nog niet kan worden vastgesteld.

**onderliggende attributen**

**id** `string` *required*

De unieke identificatie van de betaling.

Voorbeeld: `pay_xxxxxxxxxxxxxx`

**payment\_processing** `boolean` *required*

Of een betaling op deze factuur nog wordt verwerkt. True zolang een vertraagde betaalmethode zoals ACH of SEPA wordt verwerkt; in die tijd blijft de factuur open en wordt deze niet als achterstallig gemarkeerd.

**product** `object` *required*

Het product waarvoor deze factuur is gegenereerd.

**onderliggende attributen**

**id** `string` *required*

De unieke identificatie van het product.

Voorbeeld: `prod_xxxxxxxxxxxxx`

**title** `string` *required*

De weergavenaam van het product die aan klanten wordt getoond op de productpagina en in zoekresultaten.

Voorbeeld: `Pickaxe Analytics`

**status** `InvoiceStatuses` *required*

De huidige betaalstatus van de factuur, zoals draft, open, paid of void.

Beschikbare opties: `draft`, `open`, `paid`, `past_due`, `uncollectible`, `void`

**subscription\_billing\_anchor\_at** `string\<date-time\> | null` *required*

De datum die bepaalt wanneer de factureringscyclus van het abonnement begint. Wanneer dit is ingesteld op een factuur voor een verlengingsplan, worden alle toekomstige factureringsperiodes aan deze datum verankerd.

Voorbeeld: `2023-12-01T05:00:00.401Z`

**updated\_at** `string\<date-time\>` *required*

De datum en tijd waarop de factuur voor het laatst is bijgewerkt.

Voorbeeld: `2023-12-01T05:00:00.401Z`

**user** `object | null` *required*

De gebruiker aan wie deze factuur is gericht. Null als het gebruikersaccount is verwijderd.

**onderliggende attributen**

**email** `string | null` *required*

Het e-mailadres van de gebruiker. Vereist de machtiging member:email:read. Null als er geen toestemming is.

Voorbeeld: `john.doe@example.com`

**id** `string` *required*

De unieke identificatie van de gebruiker.

Voorbeeld: `user_xxxxxxxxxxxxx`

**name** `string | null` *required*

De weergavenaam van de gebruiker die op diens openbare profiel wordt getoond.

Voorbeeld: `John Doe`

**username** `string` *required*

De unieke gebruikersnaam van de gebruiker die op diens openbare profiel wordt getoond.

Voorbeeld: `johndoe42`


## Related topics

- [API-versies](https://docs.whop.com/nl/developer/api/versioning.md)
- [Invoices API](https://docs.whop.com/nl/api-reference/invoices/invoice.md)
- [Facturen](https://docs.whop.com/nl/developer/guides/invoices.md)
