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

# Migrer fra ældre fakturaer

> Gå fra det ældre faktura-API til native fakturaer: skift API-version, genopbyg requests omkring items, og kortlæg felter, statusser og webhooks.

Native fakturaer bruger de samme `/invoices`-stier som ældre fakturaer, men har et andet request-format og en anden livscyklus. Denne guide kortlægger de felter og handlinger, du skal ændre, når du migrerer en integration.

> [!NOTE]
>
> De fælles stier peger på native fakturaer fra og med `Api-Version-Date: 2026-10-24`.
> De native eksempler nedenfor bruger `Api-Version-Date: 2026-11-02-1` med de
> nuværende feltnavne for varianter og reglerne for låsning af kunder. Send den header med
> hver native request. Hold ældre kald på en tidligere udgivet version, f.eks.
> `2026-10-15-1`. [API-versioner](https://docs.whop.com/da/developer/api/versioning.md) forklarer, hvordan headers
> tilsidesætter versionsfastlåsninger på legitimationsoplysninger.

## Hvad der ændrer sig

| | Ældre fakturaer | Native fakturaer |
| - | - | - |
| **ID** | `inv_` | `pay_`, det samme som fakturaens betaling |
| **Hvad du fakturerer** | Én plan med valgfrie labels, der summerer til dens pris | 1 til 50 items, hver især en eksisterende variant eller en, der findes eller oprettes inline |
| **Oprettelse** | Færdiggøres i ét kald, medmindre `save_as_draft` eller `automatically_finalizes_at` er angivet | Gemmer altid en kladde. Du udsteder eller sender den derefter. |
| **Beløb** | Planens pris | `subtotal`, `buyer_fee_amount`, `tax_amount`, `total`, `amount_due` |
| **Betalingsside** | `pay_online_url`, en URL | `checkout_link`, et signeret token, der bruges til at åbne checkout |
| **Forfalden** | `status: past_due` | `overdue: true` på en `open`- eller `uncollectible`-faktura |
| **Webhooks** | `invoice.*` | Betalings-events for fakturaens `pay_`-ID |

Det native API lister eller henter ikke ældre `inv_`-fakturaer. Fortsæt med at læse eksisterende ældre fakturaer med den tidligere API-version. Når du opretter en native faktura, oprettes en separat regning. Den konverterer eller udligner ikke en ældre faktura.

## Før du migrerer

Tjek disse forskelle, før du flytter et forløb. Behold det på det ældre API, hvis det har brug for en funktion, som det native API ikke tilbyder.

| Ældre funktion | Native adfærd |
| - | - |
| `invoice.*`-webhooks | Native fakturaer bruger betalings-events. Nogle ældre events har ingen direkte modpart. Se [Kortlæg webhooks](#map-webhooks). |
| Markér en faktura som betalt efter at have indkasseret penge uden for Whop | Der findes intet native `mark_paid`-endpoint. |
| Slet en kladde | Der findes ingen native `DELETE /invoices/{id}`. Annullering bevarer fakturaposten og -nummeret. |
| `plan.payment_method_configuration` | Faktura-requesten accepterer ikke dette felt. Konfigurer i stedet den eksisterende variants eller kontoens betalingsmetoder. |
| Gratis prøveperioder og startgebyrer på tilbagevendende planer | Fra og med `2026-11-11` tilføjer fakturaen startgebyret. Tidligere versioner fakturerer fornyelsesprisen, så tilføj gebyret som et engangs-item. Variantens prøveperiode gælder. |
| `subscription_billing_anchor_at` | Send `subscription_starts_at` på fakturaen. Et tidspunkt, der er passeret, når fakturaen betales, starter perioden ved betalingen. Som før springer det den gratis prøveperiode over. |
| Vilkårlige `line_items`-labels, brøkantal eller negative kreditter | Native linjer fakturerer varianter. Antal skal være positive heltal, og labels kommer fra produkt- eller varianttitler. Genopbyg opkrævningerne i stedet for at kopiere opdelingen. |
| Genbrug af den ældre fakturas `current_plan.id` | Native fakturaer afviser varianter, der er knyttet til ældre fakturaer. Brug en separat variant, eller opret en inline. |

## Kortlæg create-requesten

En ældre oprettelse sender én plan og eventuelt labels, der opdeler dens pris. En native oprettelse sender et item for hver fakturerede variant.

Disse eksempler angiver en samlet item-pris på 19,99 USD. Den eksisterende native variant repræsenterer opsætningsgebyret på 15 USD. Servicegebyret på 4,99 USD er en brugerdefineret engangsopkrævning uden et produkt. Begge API'er accepterer priser i valutaenheder. Brug `4.99` for 4,99 USD. Sender du `499`, faktureres 499 USD.

```json Legacy theme={null}
{
	"account_id": "biz_xxxxxxxxxxxxxx",
	"product_id": "prod_xxxxxxxxxxxxx",
	"member_id": "mber_xxxxxxxxxxxxx",
	"collection_method": "send_invoice",
	"due_date": "2026-12-01T00:00:00Z",
	"plan": {
		"plan_type": "one_time",
		"initial_price": 19.99,
		"currency": "usd"
	},
	"line_items": [
		{ "label": "Setup", "quantity": 1, "unit_price": 15 },
		{ "label": "Service fee", "quantity": 1, "unit_price": 4.99 }
	]
}
```

```json Native theme={null}
{
	"account_id": "biz_xxxxxxxxxxxxxx",
	"member_id": "mber_xxxxxxxxxxxxx",
	"due_at": "2026-12-01T00:00:00Z",
	"items": [
		{ "variant_id": "plan_xxxxxxxxxxxxx", "quantity": 1 },
		{
			"variant": {
				"title": "Service fee",
				"billing_type": "one_time",
				"initial_price": 4.99,
				"currency": "usd"
			}
		}
	]
}
```

Den native request opretter en kladde. Send den med `POST /invoices/{id}/send` for at udstede og e-maile den. `member_id` identificerer en kunde (`mber_`), ikke et abonnement (`mem_`).

| Ældre felt | Native felt | Noter |
| - | - | - |
| `account_id` | `account_id` | Den konto, der udsteder fakturaen. |
| `plan` | `items` | Hvert item tager `variant_id` eller inline `variant` plus et valgfrit `quantity`. Alle items bruger samme valuta. |
| `product`, `product_id` | `items[].variant.product`, `items[].variant.product_id` | Brug en af de to. Inline `product` kræver `external_identifier` og `title`. En tilbagevendende variant kræver et produkt. En brugerdefineret engangsopkrævning kan udelade det. |
| `line_items` | `items` | Genopbyg fakturerede linjer som varianter. `quantity` er som standard 1. Værdier over 1 kræver en variant, der tillader flere styk. |
| `collection_method` | `payment_method_id`, derefter udsted eller send | Angiv en gemt metode for automatisk opkrævning, eller udelad den for betaling via checkout. Se [Udsted, send og opkræv](#issue-send-and-charge). |
| `save_as_draft` | Ingen | Oprettelse gemmer altid en kladde. |
| `automatically_finalizes_at` | `send_at` på Send Invoice | Udsætter udstedelsen til den planlagte afsendelse. `charge_at` udsætter en opkrævning af en gemt metode, ikke udstedelsen. |
| `due_date` | `due_at` | Send et ISO 8601-tidsstempel. |
| `charge_buyer_fee` | `buyer_fee_percentage` | Kortlæg `false` til `0` og det ældre `true`-gebyr til `5`. Andre procentsatser end nul skal ligge mellem 5 og 100 med højst to decimaler. |
| `payment_method_id`, `payment_token_id` | `payment_method_id` | En af kundens gemte betalingsmetoder med præfikset `payt_`. Kræver `payment:charge` at angive. |
| `member_id`, `email_address`, `customer_name` | Samme ved oprettelse | Vælg `member_id` eller `email_address`, ikke begge. Native fakturaer tager også `recipient_emails`, uafhængigt af den fakturerede kunde. |
| `mailing_address_id`, `billing_address` | Samme navne, snævrere adresseinput | Vælg én. En inline adresse kræver `line1`, `city`, `postal_code` og `country`. Den accepterer også `name`, `line2`, `state` og `phone`. Den accepterer ikke de ældre felter `tax_id_type` eller `tax_id_value`. |
| `subscription_billing_anchor_at` | `subscription_starts_at` | Hvornår den første faktureringsperiode starter. Skal ligge i fremtiden og kræver et tilbagevendende item. |
| Ingen | `memo`, `metadata` | `memo` vises på e-mailen, PDF'en og i checkout. `metadata` gemmer nøgle-værdi-par som strenge. |

For native versioner før `2026-10-27-2` skal du bruge `plan_id`, `plan` og `plan_type` i stedet for `variant_id`, `variant` og `billing_type`. Svarets linjeposter bruger også `plan_id` på de ældre versioner.

### Hold udstedte beløb låst

`PATCH /invoices/{id}` redigerer en kladdes items og faktureringsoplysninger. Sender du `items`, erstattes hele listen med varianternes aktuelle priser. Udelader du det, bevares de gemte items og priser.

* Annuller en planlagt afsendelse, før du redigerer items eller faktureringsoplysninger.
* Fra og med `2026-11-02-1` kan du ikke erstatte eller rydde en kladdes tildelte kunde. En kladde uden kunde kan stadig få en. Annuller kladden, før du opretter en ny faktura til en anden.
* `email_address` og `customer_name` er input, der kun bruges ved oprettelse.
* Udstedte beløb og items er låst. En opdatering, der kun indeholder `memo` og/eller `recipient_emails`, er tilladt på `draft`-, `open`- og `uncollectible`-fakturaer, herunder en planlagt kladde.

## Udsted, send og opkræv

En ældre oprettelse vælger indkrævningsadfærd med `collection_method`. Native fakturaer bruger separate kald efter oprettelsen af kladden:

1. **Udsted den** med `POST /invoices/{id}/issue` for at beregne endelig moms og åbne den for betaling uden at sende den første faktura-e-mail.
2. **Eller send den** med `POST /invoices/{id}/send`. Det udsteder kladden. Den e-mailer modtagerne, medmindre den opkræver en gemt metode med det samme. Sender du en `open`-faktura, e-mailes den igen. `send_at` planlægger en kladdes afsendelse. `POST /invoices/{id}/unschedule` annullerer den plan.
3. **Opkræv en gemt metode** ved at angive `payment_method_id` på kladden. For en positiv total opkræver udstedelse eller afsendelse på et fremtidigt `charge_at`, ellers et fremtidigt `due_at`, ellers med det samme. `charge_at` skal ligge i fremtiden og kan ikke ligge før `send_at`.

Sender du en kladde, der opkræver med det samme, springes den første faktura-e-mail over. Sender du med en senere opkrævning, e-mailes den nu. En mislykket automatisk opkrævning kan udløse en e-mail med betalingslink, selv når du brugte Issue Invoice. [Opkræv en gemt betalingsmetode](https://docs.whop.com/da/developer/guides/invoices.md#charge-a-saved-payment-method) forklarer forløbet.

Et `open`-svar bekræfter ikke betaling. Vent på `payment.succeeded`, før du leverer. Brug [Charge Invoice](https://docs.whop.com/da/api-reference/invoices/charge-invoice.md) til at opkræve eller prøve en åben faktura igen. At udstede eller sende den igen starter ikke en ny opkrævning.

For en tilbagevendende variant styrer `collection_method` på Issue Invoice eller Send Invoice **fornyelser**. `charge_automatically` indkræver fremtidige betalinger automatisk. `send_invoice` opretter og e-mailer en ny faktura hver periode. Det erstatter ikke `payment_method_id` til indkrævning af den første faktura. Se [Fakturer et abonnement](https://docs.whop.com/da/developer/guides/invoices.md#invoice-a-subscription).

## Kortlæg svaret

| Ældre felt | Native felt | Noter |
| - | - | - |
| `id` (`inv_`) | `id` (`pay_`) | `object` er `invoice`. Det samme ID identificerer betalingen. |
| `current_plan`-pris | `subtotal`, `buyer_fee_amount`, `tax_amount`, `total`, `amount_due` | Pengeobjekter indeholder et `amount` som decimalstreng, `currency`, `decimals` og `display_decimals`. `totals_status` er `estimated` på en kladde og ellers `final`. |
| `company.id` | `account_id` | Hent kontoen via ID. |
| `product.id`, `current_plan.id` | `line_items[].product_id`, `line_items[].variant_id` | Hver faktureret linje identificerer sit produkt og sin variant. En brugerdefineret opkrævning kan være uden produkt. |
| `member.id` | `member_id` | Kunde-ID med præfikset `mber_`. Kræver `member:basic:read`. |
| `user` | Intet brugerfelt på øverste niveau | Hent medlemmet for at finde dets bruger. `membership_id` (`mem_`) identificerer et medlemskab, ikke kunden. |
| `mailing_address` | `billing_address`, `mailing_address_id` | Den inline adresse forbliver et objekt. |
| `payment.id` | Fakturaens eget `id` | Hent betalingsoplysninger med `GET /payments/{id}` med det samme `pay_`-ID. |
| `number` | `number`, `invoice_prefix` | Det formaterede nummer og kontoens præfiks. |
| `due_date` | `due_at` | ISO 8601-tidsstempel eller `null`. |
| `automatically_finalizes_at` | `scheduled_send_at` | `scheduled_charge_at` viser en planlagt opkrævning af en gemt metode. `scheduled_collection_method` viser valget af indkrævning for fornyelser ved en planlagt afsendelse. |
| `charge_buyer_fee` | `buyer_fee_percentage`, `buyer_fee_amount` | Procentsatsen og det beregnede beløb. |
| `customer_name`, `email_address` | Samme | Plus `recipient_emails`. Disse felter kræver tilladelser. |
| `pay_online_url` | `checkout_link` | Et signeret token, ikke en URL. Se [Åbn fakturaens checkout](#open-the-invoice-checkout). |
| `line_items` | `line_items` | Linjer har `variant_id`, `product_id`, `label`, `description`, `quantity`, `unit_amount`, `subtotal`, `discount_amount` og `tax_amount`. |
| `status` | `status`, `overdue` | Se [Kortlæg statusser](#map-statuses). |
| `payment_processing` | `status` plus betalingsoplysningerne | Håndter `pending`, mens betalingen afvikles. `paid_at` registrerer, hvornår betalingen blev gennemført. Det er ikke et behandlingsflag. |
| `fetch_invoice_token` | Ingen direkte ækvivalent | Brug godkendte fakturalæsninger, `checkout_link` til checkout og Generate Invoice PDF til PDF'en. |
| Ingen | `paid_at`, `memo`, `metadata` | Tidspunktet for betalingens gennemførelse, kundenoten og dine metadata. |

For at downloade en PDF skal du kalde `POST /invoices/{id}/generate_pdf` for at få et kortlivet link.

### Åbn fakturaens checkout

`checkout_link` indeholder faktura-ID'et og et signeret token adskilt af et `.`. Send hele værdien som `link` til `POST /checkout_sessions` for at åbne en session for denne faktura. For en URL, der vises for kunden, skal du følge [Byg den hostede checkout-URL](https://docs.whop.com/da/developer/guides/invoices.md#get-the-checkout-link).

Feltet er kun til stede, mens checkout er tilgængelig: fakturaen skal være `open`. Erhvervskøbere og annullerede medlemskaber kan ikke bruge denne checkout. Din nøgle skal have `payment:charge` eller `invoice:create`/`invoice:update`, når fakturaen ikke har en gemt betalingsmetode. Den er `null` på en kladde, betalt, annulleret eller uerholdelig faktura samt for erhvervskøbere.

## Kortlæg statusser

| Ældre `status` | Native |
| - | - |
| `draft` | `draft` |
| `open` | `open` |
| `past_due` | `open` eller `uncollectible` med `overdue: true` |
| `paid` | `paid` |
| `uncollectible` | `uncollectible` |
| `void` | `void` |

Native fakturaer kan også returnere `authorized`, `pending` eller `unresolved`. Behandl ikke alle statusser uden for den ældre enum som betalt eller mislykket. [Statusser og livscyklus](https://docs.whop.com/da/developer/guides/invoices.md#statuses-and-lifecycle) forklarer dem.

## Kortlæg endpoints

| Ældre | Native |
| - | - |
| `GET /invoices` | [List Invoices](https://docs.whop.com/da/api-reference/invoices/list-invoices.md) med et `overdue`-filter |
| `GET /invoices/{id}` | [Retrieve Invoice](https://docs.whop.com/da/api-reference/invoices/retrieve-invoice.md) |
| `POST /invoices` | [Create Invoice](https://docs.whop.com/da/api-reference/invoices/create-invoice.md), som gemmer en kladde |
| `PATCH /invoices/{id}` | [Update Invoice](https://docs.whop.com/da/api-reference/invoices/update-invoice.md), underlagt reglerne for kladder og udstedte fakturaer ovenfor |
| `POST /invoices/{id}/resend` | [Send Invoice](https://docs.whop.com/da/api-reference/invoices/send-invoice.md) |
| `POST /invoices/{id}/void` | [Void Invoice](https://docs.whop.com/da/api-reference/invoices/void-invoice.md) |
| `POST /invoices/{id}/mark_uncollectible` | [Markér en faktura som uerholdelig](https://docs.whop.com/da/api-reference/invoices/mark-invoice-uncollectible.md) |
| `DELETE /invoices/{id}` | Ingen ækvivalent. Annuller kladden for at annullere den og samtidig bevare posten. |
| `POST /invoices/{id}/mark_paid` | Ingen ækvivalent |
| Ingen | [Issue Invoice](https://docs.whop.com/da/api-reference/invoices/issue-invoice.md), [Cancel Scheduled Send](https://docs.whop.com/da/api-reference/invoices/cancel-scheduled-send.md), [Charge Invoice](https://docs.whop.com/da/api-reference/invoices/charge-invoice.md), [List Invoice Sends](https://docs.whop.com/da/api-reference/invoices/list-invoice-sends.md), [Generate Invoice PDF](https://docs.whop.com/da/api-reference/invoices/generate-invoice-pdf.md) |

## Kortlæg webhooks

Native fakturaer sender betalings-events for deres `pay_`-ID. `invoice.*`-events beskriver ældre fakturaer.

| Ældre event | Native adfærd |
| - | - |
| `invoice.created` | `payment.created`, når en kladde udstedes, ikke når den oprettes |
| `invoice.paid` | `payment.succeeded` |
| `invoice.past_due` | Læs eller filtrer på `overdue`. Der findes ingen tilsvarende betalings-event for forfaldne betalinger. |
| `invoice.voided`, `invoice.marked_uncollectible` | Læs fakturaens `status`. Der findes ingen direkte erstatning i form af betalings-events for disse overgange. |

Betalings-events dækker også betalinger, der ikke har noget med fakturaer at gøre. Match eventens betalings-ID med de native faktura-ID'er, du gemmer. [Webhooks](https://docs.whop.com/da/developer/guides/invoices.md#webhooks) viser, hvordan du leverer ud fra `payment.succeeded`.

## Tilladelser

| Operation | Påkrævet tilladelse |
| - | - |
| Opret en kladde uden en gemt betalingsmetode | `invoice:create` eller `payment:charge` |
| Opdater en kladde uden en gemt betalingsmetode eller planlagt afsendelse | `invoice:update`, `invoice:create` eller `payment:charge` |
| Send eller planlæg en kladde uden en gemt betalingsmetode, eller annuller dens planlagte afsendelse | `invoice:update`, `invoice:create` eller `payment:charge` |
| Angiv en gemt betalingsmetode, skriv en faktura, der har en, udsted, opkræv, annuller eller markér som uerholdelig | `payment:charge` |
| Opdater en planlagt kladde, eller opdater eller gensend en udstedt faktura | `payment:charge` |
| List, hent, generer en PDF, eller list e-mailafsendelser | `payment:basic:read` |
| Angiv en inline `variant` | Også `plan:create` |
| Opret eller opdater et inline `product` | Også henholdsvis `access_pass:create` eller `access_pass:update` |

`member:basic:read` eksponerer kundenavne og medlems-/medlemskabs-ID'er. `member:email:read` eksponerer `email_address` og `recipient_emails`. Felter for betalingsmetode og adresse kræver `payment:basic:read`.

## Tjekliste til migrering

1. Tjek [Før du migrerer](#before-you-migrate) for arbejdsgange, der skal blive på det ældre API.
2. Fastlås native kald til en udgivet version, der matcher deres feltnavne, f.eks. `2026-11-02-1` for disse eksempler.
3. Byg `items` ud fra kvalificerede varianter, og tjek antal, priser, valuta og produktkrav.
4. Erstat den ældre oprettelse i ét kald med oprettelse efterfulgt af udstedelse eller afsendelse. Vælg opkrævning af gemte metoder for den første faktura og en indkrævningsmetode for fornyelser.
5. Kortlæg forfaldsdatoer, planlagte afsendelser og købergebyrer efter deres adfærd, ikke kun efter deres feltnavne.
6. Hold native `pay_`- og ældre `inv_`-ID'er adskilt. Hold ældre læsninger på den tidligere version.
7. Læs beløb fra pengeobjekter, og åbn checkout med det signerede `checkout_link`.
8. Håndter `overdue` og de ekstra betalingsstatusser.
9. Lever ud fra `payment.succeeded` for fakturaens betalings-ID.
10. Giv de tilladelser, dit forløb bruger, herunder tilladelser til inline varianter/produkter og læsning af kunder.

## Næste trin

> [card] [Guide til fakturaer](https://docs.whop.com/da/developer/guides/invoices.md)
>
> Opret, udsted, send og indkræv native fakturaer.

> [card] [API-reference for fakturaer](https://docs.whop.com/da/api-reference/invoices/create-invoice.md)
>
> Alle native faktura-endpoints og -felter.

> [card] [Ældre faktura-API](https://docs.whop.com/da/api-reference/legacy/invoices/legacy-invoice.md)
>
> De endpoints, din nuværende integration kalder.

> [card] [API-versioner](https://docs.whop.com/da/developer/api/versioning.md)
>
> Sådan fungerer `Api-Version-Date` og versionsfastlåsninger.


## Related topics

- [Fakturaer](https://docs.whop.com/da/developer/guides/invoices.md)
- [Migrér fra tidligere versioner](https://docs.whop.com/da/developer/api/migrate-from-previous-versions.md)
- [API-versioner](https://docs.whop.com/da/developer/api/versioning.md)
