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

# Payment Quotes API

> En Payment Quote prissætter et køb præcis, som en betaling for det vil blive opkrævet: samme linjeprissætning, rabatkode og moms, for en køber, der er lokaliseret ud fra den adresse, det land eller den IP-adresse, du sender.

Et tilbud prissættes én gang, kan forbruges af én betaling og udløber.

Brug Payment Quotes API'et til at vise en køber totalbeløb, moms og valuta, før de betaler, og send derefter tilbuddets `id` som `quote_id`, når du opretter betalingen, for at opkræve præcis det tilbud. Opret et nyt tilbud, hver gang kurven, rabatkoden eller adressen ændres.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [Hent betalingstilbud](https://docs.whop.com/da/api-reference/payment-quotes/retrieve-payment-quote.md) | GET `/payment_quotes/{id}` |
| [Opret betalingstilbud](https://docs.whop.com/da/api-reference/payment-quotes/create-payment-quote.md) | POST `/payment_quotes` |

## Attributter

**id** `string` *required*

Betalingstilbuds-ID med præfikset `pq_`.

**account\_id** `string` *required*

Den konto, købet prissættes for, med præfikset `biz_`.

**address** `object | null` *required*

Den faktureringsadresse, købet blev prissat med, eller null. Det sted, hvor momsen blev beregnet, når der ikke blev angivet en leveringsadresse, og den adresse, registreringen tilhører.

> [accordion] Egenskaber
>
> **city** `string | null` *required*
>
> Byen.
>
> **country** `string | null` *required*
>
> ISO 3166-1 alpha-2-landekoden.
>
> **line1** `string | null` *required*
>
> Den første adresselinje.
>
> **line2** `string | null` *required*
>
> Den anden adresselinje.
>
> **name** `string | null` *required*
>
> Navnet på adressen.
>
> **postal\_code** `string | null` *required*
>
> Postnummeret eller ZIP-koden.
>
> **state** `string | null` *required*
>
> Staten, provinsen eller regionen.

**base\_currency** `string` *required*

Trebogstavs ISO 4217-kode for varianternes egen valuta med små bogstaver. Lig med `currency`, når intet blev konverteret.

**base\_total** `object` *required*

`total` i `base_currency` ved `exchange_rate`: varianternes egne priser efter rabatkoden plus `tax_amount` konverteret ved `exchange_rate`, når momsen lægges oveni. Lig med `total`, når intet blev konverteret. Betalingen opkræver `total` i `currency`.

> [accordion] Egenskaber
>
> **amount** `string` *required*
>
> Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det undervejs.
>
> **currency** `string` *required*
>
> Trebogstavs ISO 4217-valutakode med små bogstaver.
>
> **decimals** `integer` *required*
>
> Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
>
> **display\_decimals** `integer` *required*
>
> Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen lokalitet ved hjælp af dette.

**created\_at** `string` *required*

Hvornår tilbuddet blev prissat, som et ISO 8601-tidsstempel.

**currency** `string` *required*

Trebogstavs ISO 4217-valutakode, som købet prissættes og opkræves i, med små bogstaver: varianternes egen valuta eller den `presentment_currency`, den blev konverteret til.

**discount** `object` *required*

Hvad rabatkoden trækker fra. Nul uden en kode.

> [accordion] Egenskaber
>
> **amount** `string` *required*
>
> Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det undervejs.
>
> **currency** `string` *required*
>
> Trebogstavs ISO 4217-valutakode med små bogstaver.
>
> **decimals** `integer` *required*
>
> Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
>
> **display\_decimals** `integer` *required*
>
> Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen lokalitet ved hjælp af dette.

**exchange\_rate** `string | null` *required*

Hvor mange enheder af `currency` én enhed af `base_currency` køber, som en decimalstreng såsom `"5.4321"`: den kurs, varianternes priser blev konverteret til, fastlåst indtil `expires_at`, og den kurs, en betaling, der forbruger tilbuddet, opkræves til. En streng, ligesom pengebeløb, så ingen float afrunder den undervejs. Null, når intet blev konverteret.

**expires\_at** `string` *required*

Hvornår tilbuddet ikke længere kan opkræves, som et ISO 8601-tidsstempel. Opret et nyt tilbud derefter.

**line\_items** `object[]` *required*

Én post pr. variant i den angivne rækkefølge, hver med sin egen moms.

> [accordion] Egenskaber
>
> **discount** `object` *required*
>
> Rabatkodens andel på denne linje. Nul uden en kode.
>
> > [accordion] Egenskaber
> >
> > **amount** `string` *required*
> >
> > Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det undervejs.
> >
> > **currency** `string` *required*
> >
> > Trebogstavs ISO 4217-valutakode med små bogstaver.
> >
> > **decimals** `integer` *required*
> >
> > Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen lokalitet ved hjælp af dette.
>
> **quantity** `integer` *required*
>
> Hvor mange enheder af varianten linjen dækker.
>
> **subtotal** `object` *required*
>
> Linjens pris før rabatkodens andel og moms; `subtotal` minus `discount` er, hvad linjen beløber sig til efter rabatten. Linjernes subtotaler summeres til tilbuddets `subtotal`.
>
> > [accordion] Egenskaber
> >
> > **amount** `string` *required*
> >
> > Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det undervejs.
> >
> > **currency** `string` *required*
> >
> > Trebogstavs ISO 4217-valutakode med små bogstaver.
> >
> > **decimals** `integer` *required*
> >
> > Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen lokalitet ved hjælp af dette.
>
> **tax\_amount** `object` *required*
>
> Momsen på denne linje. Nul, når `tax_status` ikke er `calculated`.
>
> > [accordion] Egenskaber
> >
> > **amount** `string` *required*
> >
> > Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det undervejs.
> >
> > **currency** `string` *required*
> >
> > Trebogstavs ISO 4217-valutakode med små bogstaver.
> >
> > **decimals** `integer` *required*
> >
> > Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen lokalitet ved hjælp af dette.
>
> **total** `object` *required*
>
> `subtotal` minus `discount` plus `tax_amount`, når momsen lægges oveni, eller uden den, når prisen allerede inkluderer den.
>
> > [accordion] Egenskaber
> >
> > **amount** `string` *required*
> >
> > Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det undervejs.
> >
> > **currency** `string` *required*
> >
> > Trebogstavs ISO 4217-valutakode med små bogstaver.
> >
> > **decimals** `integer` *required*
> >
> > Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen lokalitet ved hjælp af dette.
>
> **variant\_id** `string | null` *required*
>
> Den variant, denne linje prissætter, med præfikset `plan_`. Null, når købet beskriver varianten via `variant`, og der endnu ikke findes nogen variant med de attributter: den betaling, der forbruger tilbuddet, opretter den, og linjen henviser til den derefter.

**located\_by** `string | null` *required*

Hvilken placering momsen blev beregnet for: `shipping_address`, når den indeholder et land, ellers fakturerings-`address`, når den gør, ellers den sendte `presentment_country`, ellers køberens `ip_address`. Et tilbud lokaliseret via `presentment_country` eller `ip_address` er en forhåndsvisning, der anslår momsen: en betaling kan ikke bruge det, så opret et nyt tilbud med køberens adresse for at betale. Null, når intet i anmodningen lokaliserede køberen, hvilket kun en sælger, der ikke opkræver moms på dette køb, får tilbud uden; `tax_status` er så `not_applicable`.

Tilgængelige muligheder: `shipping_address`, `address`, `presentment_country`, `ip_address`

**payment\_id** `string | null` *required*

Den betaling, der har dette tilbud, med præfikset `pay_`, eller null, mens det er ubrugt. En afvist betaling beholder sit tilbud og kan forsøges igen; tjek den betalings `status`.

**promo\_code\_id** `string | null` *required*

Den rabatkode, tilbuddet anvendte, med præfikset `promo_`, eller null.

**recommended\_currencies** `string[]` *required*

ISO 4217-koder med små bogstaver, der kan tilbydes køberen i en valutavælger, de mest relevante først: valutaen for den sendte `presentment_country`, ellers for det land, køberens `ip_address` befinder sig i, når dette køb kan konverteres til den, og en betalingsmetode kan opkræve den, og derefter `base_currency`. Opret et nyt tilbud med en af dem som `presentment_currency` for at prissætte i den. Kun `base_currency`, når tilbuddet blev prissat uden `presentment_currency` eller `presentment_country`.

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

Den leveringsadresse, købet blev prissat med, eller null. Når den er til stede, er det her, momsen blev beregnet.

> [accordion] Egenskaber
>
> **city** `string | null` *required*
>
> Byen.
>
> **country** `string | null` *required*
>
> ISO 3166-1 alpha-2-landekoden.
>
> **line1** `string | null` *required*
>
> Den første adresselinje.
>
> **line2** `string | null` *required*
>
> Den anden adresselinje.
>
> **name** `string | null` *required*
>
> Navnet på adressen.
>
> **postal\_code** `string | null` *required*
>
> Postnummeret eller ZIP-koden.
>
> **state** `string | null` *required*
>
> Staten, provinsen eller regionen.

**subtotal** `object` *required*

Prisen for alle linjer før rabatkode, moms og gebyrer.

> [accordion] Egenskaber
>
> **amount** `string` *required*
>
> Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det undervejs.
>
> **currency** `string` *required*
>
> Trebogstavs ISO 4217-valutakode med små bogstaver.
>
> **decimals** `integer` *required*
>
> Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
>
> **display\_decimals** `integer` *required*
>
> Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen lokalitet ved hjælp af dette.

**tax\_amount** `object` *required*

Den moms, en betaling, der forbruger dette tilbud, opkræver. Nul, medmindre `tax_status` er `calculated`.

> [accordion] Egenskaber
>
> **amount** `string` *required*
>
> Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det undervejs.
>
> **currency** `string` *required*
>
> Trebogstavs ISO 4217-valutakode med små bogstaver.
>
> **decimals** `integer` *required*
>
> Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
>
> **display\_decimals** `integer` *required*
>
> Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen lokalitet ved hjælp af dette.

**tax\_behavior** `string | null` *required*

Om momsen lægges oven i prisen (`exclusive`) eller allerede er inkluderet i den (`inclusive`). Null, når der ikke blev beregnet moms.

Tilgængelige muligheder: `inclusive`, `exclusive`

**tax\_ids** `object[]` *required*

Køberens momsregistrering, som tilbuddet prissatte som et erhvervskøb. Tom for et forbrugerkøb.

> [accordion] Egenskaber
>
> **type** `string` *required*
>
> Registreringens type, såsom `eu_vat`.
>
> Tilgængelige muligheder: `ad_nrt`, `ao_tin`, `ar_cuit`, `al_tin`, `am_tin`, `aw_tin`, `au_abn`, `au_arn`, `eu_vat`, `az_tin`, `bs_tin`, `bh_vat`, `bd_bin`, `bb_tin`, `by_tin`, `bj_ifu`, `bo_tin`, `ba_tin`, `br_cnpj`, `br_cpf`, `bg_uic`, `bf_ifu`, `kh_tin`, `cm_niu`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cv_nif`, `cl_tin`, `cn_tin`, `co_nit`, `cd_nif`, `cr_tin`, `hr_oib`, `do_rcn`, `ec_ruc`, `eg_tin`, `sv_nit`, `et_tin`, `eu_oss_vat`, `ge_vat`, `gh_tin`, `de_stn`, `gb_vat`, `gn_nif`, `hk_br`, `hu_tin`, `is_vat`, `in_gst`, `id_npwp`, `il_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `kz_bin`, `ke_pin`, `kg_tin`, `la_tin`, `li_uid`, `li_vat`, `my_frp`, `my_itn`, `my_sst`, `mr_nif`, `mx_rfc`, `md_vat`, `me_pib`, `ma_vat`, `np_pan`, `nz_gst`, `ng_tin`, `mk_vat`, `no_vat`, `no_voec`, `om_vat`, `pe_ruc`, `ph_tin`, `pl_nip`, `ro_tin`, `ru_inn`, `ru_kpp`, `sa_vat`, `sn_ninea`, `rs_pib`, `sg_gst`, `sg_uen`, `si_tin`, `za_vat`, `kr_brn`, `es_cif`, `ch_uid`, `ch_vat`, `tw_vat`, `tj_tin`, `tz_vat`, `th_vat`, `tr_tin`, `ug_tin`, `ua_vat`, `ae_trn`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `zm_tin`, `zw_tin`, `sr_fin`, `xi_vat`
>
> **value** `string` *required*
>
> Registreringsnummeret, som køberen indtastede det, med mellemrum fjernet (`eu_vat`-værdier fjerner også punktummer og bindestreger).

**tax\_status** `string` *required*

`calculated`: hver linje blev prissat, og en betaling kan forbruge tilbuddet. `not_applicable`: denne sælger opkræver ikke moms på dette køb, så tilbuddet skylder ingen og kan stadig forbruges. `unavailable`: momsen kunne ikke prissættes — udbyderen svarede ikke, eller denne sælgers momsopsætning kan ikke prissætte et køb her — så en betaling afviser tilbuddet; opret et nyt tilbud, eller opkræv uden `quote_id` for at få momsen beregnet ved opkrævningen.

Tilgængelige muligheder: `calculated`, `not_applicable`, `unavailable`

**total** `object` *required*

Hvad køberen betaler: subtotalen fratrukket rabatten plus `tax_amount`, når momsen lægges oveni.

> [accordion] Egenskaber
>
> **amount** `string` *required*
>
> Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det undervejs.
>
> **currency** `string` *required*
>
> Trebogstavs ISO 4217-valutakode med små bogstaver.
>
> **decimals** `integer` *required*
>
> Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
>
> **display\_decimals** `integer` *required*
>
> Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen lokalitet ved hjælp af dette.

```json PaymentQuote theme={null}
{
	"id": "pq_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"currency": "usd",
	"base_currency": "usd",
	"exchange_rate": null,
	"recommended_currencies": ["usd"],
	"tax_status": "calculated",
	"tax_behavior": "exclusive",
	"subtotal": {
		"currency": "usd",
		"amount": "27.00",
		"decimals": 2,
		"display_decimals": 2
	},
	"discount": {
		"currency": "usd",
		"amount": "0.00",
		"decimals": 2,
		"display_decimals": 2
	},
	"tax_amount": {
		"currency": "usd",
		"amount": "2.23",
		"decimals": 2,
		"display_decimals": 2
	},
	"total": {
		"currency": "usd",
		"amount": "29.23",
		"decimals": 2,
		"display_decimals": 2
	},
	"base_total": {
		"currency": "usd",
		"amount": "29.23",
		"decimals": 2,
		"display_decimals": 2
	},
	"line_items": [
		{
			"variant_id": "plan_xxxxxxxxxxxxxx",
			"quantity": 1,
			"subtotal": {
				"currency": "usd",
				"amount": "27.00",
				"decimals": 2,
				"display_decimals": 2
			},
			"discount": {
				"currency": "usd",
				"amount": "0.00",
				"decimals": 2,
				"display_decimals": 2
			},
			"tax_amount": {
				"currency": "usd",
				"amount": "2.23",
				"decimals": 2,
				"display_decimals": 2
			},
			"total": {
				"currency": "usd",
				"amount": "29.23",
				"decimals": 2,
				"display_decimals": 2
			}
		}
	],
	"promo_code_id": null,
	"located_by": "address",
	"address": {
		"name": null,
		"line1": "123 Congress Ave",
		"line2": null,
		"city": "Austin",
		"state": "TX",
		"postal_code": "78701",
		"country": "US"
	},
	"shipping_address": null,
	"tax_ids": [
		{
			"type": "us_ein",
			"value": "12-3456789"
		}
	],
	"payment_id": null,
	"expires_at": "2026-10-11T19:32:20.388Z",
	"created_at": "2026-10-11T19:02:20.389Z"
}
```


## Related topics

- [Retrieve Payment Quote](https://docs.whop.com/da/api-reference/payment-quotes/retrieve-payment-quote.md)
- [Create Payment Quote](https://docs.whop.com/da/api-reference/payment-quotes/create-payment-quote.md)
- [Payments API](https://docs.whop.com/da/api-reference/payments/payment.md)
