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

# Btw- en belastingnummers

> Formatteer btw-, GST- en andere belastingregistratienummers zodat Whop ze accepteert en toepast op belastingen.

Een belastingnummer is het registratienummer dat een belastingdienst aan een bedrijf toekent. Je verstuurt het als een `tax_id_type`, zoals `eu_vat` of `gb_vat`, plus het nummer zelf. Je verstuurt belastingnummers op twee plekken. Op een account legt een belastingnummer ook vast dat het bedrijf in dat land voor belastingen is geregistreerd. Op een betalingsofferte bepaalt het belastingnummer van de koper de prijs van een zakelijke aankoop. Deze pagina behandelt het formaat dat elk type verwacht, wat Whop wijzigt in een nummer dat je verstuurt en wat het weigert. Zie [Belastingen](https://docs.whop.com/nl/payments-and-billing/fees/taxes.md) voor wie belasting op Whop-verkopen int en afdraagt.

> [!NOTE]
>
> Alle EU-lidstaten delen het type `eu_vat`. Whop bepaalt het land aan de hand van de eerste twee letters van het nummer, dus een btw-nummer uit een EU-land moet beginnen met de landcode.

| | Belastingnummers van het account | Belastingnummer van de koper |
| - | - | - |
| **Veld** | `tax_identifiers` op [Update Account](https://docs.whop.com/nl/api-reference/accounts/update-account.md) | `tax_ids` op [Create Payment Quote](https://docs.whop.com/nl/api-reference/payment-quotes/create-payment-quote.md) |
| **Wat het doet** | Legt vast waar het bedrijf voor belastingen is geregistreerd. Wanneer het bedrijf zelf belasting afdraagt, int Whop buiten de VS alleen belasting in landen waar het account een belastingnummer heeft. Inning in de VS volgt `tax_collection_enabled_states`. | Prijst de aankoop als business-to-business waar dat van toepassing is, zoals bij de EU-verleggingsregeling. |
| **Hoeveel** | Eén per `tax_id_type`. | Eén per offerte. |
| **Opmaak** | `eu_vat`: spaties, punten en streepjes verwijderd, letters in hoofdletters en een `GR` aan het begin gewijzigd in `EL`. Andere typen: opgeslagen zoals je ze verstuurt. | `eu_vat`: spaties, punten en streepjes verwijderd. Whop behoudt de hoofdletters/kleine letters en het prefix dat je verstuurt. Andere typen: spaties verwijderd. |

## Een belastingnummer aan een account toevoegen

Verstuur elk belastingnummer als een `tax_id_type` en `tax_id_value`. Whop slaat `DE 123.456.789` hieronder op als `DE123456789`.

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: process.env.WHOP_API_KEY });

await client.accounts.update({
  id: "biz_xxxxxxxxxxxxx",
  tax_identifiers: [{ tax_id_type: "eu_vat", tax_id_value: "DE 123.456.789" }],
});
```

```python Python theme={null}
import os
from whop_sdk import Whop

client = Whop(token=os.environ["WHOP_API_KEY"])

client.accounts.update(
    "biz_xxxxxxxxxxxxx",
    tax_identifiers=[{"tax_id_type": "eu_vat", "tax_id_value": "DE 123.456.789"}],
)
```

Een account heeft één belastingnummer per `tax_id_type`. Als je een type verstuurt dat het account al heeft, wordt de waarde vervangen in plaats van dat er een tweede belastingnummer wordt toegevoegd. Alle EU-landen delen `eu_vat`, dus een account heeft één btw-nummer voor de hele EU.

## Het type `eu_vat`

Een `eu_vat`-nummer begint met de tweeletterige code van de lidstaat die het heeft uitgegeven, gevolgd door het nationale nummer.

* **Griekenland gebruikt `EL`**, niet `GR`: `EL123456789`. Op een account wordt een nummer dat met `GR` wordt verstuurd, opgeslagen met `EL`. Verstuur op een betalingsofferte zelf `EL`.
* **Noord-Ierland gebruikt `XI`** met het type `eu_vat`: `XI123456789`. Op een account telt een `XI`-nummer als de registratie van het bedrijf in het VK, maar de checkout gebruikt het niet voor Britse belasting. Voeg daarvoor een `gb_vat`-nummer toe.
* **Spaties, punten en streepjes worden verwijderd.** Op een account worden letters ook in hoofdletters omgezet, dus `de 123.456.789` en `DE-123-456-789` worden allebei `DE123456789`.

Een bedrijf buiten de EU dat is geregistreerd onder de niet-Unieregeling van de One Stop Shop (OSS) verstuurt zijn OSS-nummer als `eu_oss_vat`, bijvoorbeeld `EU123456789`. Op een account telt één `eu_oss_vat`-nummer als registratie in elk EU-land.

Op een account controleert Whop een `eu_vat`-nummer aan de hand van het formaat van het land. Het nummer moet beginnen met het btw-prefix van een EU-lidstaat of `XI`, en de rest moet de lengte en tekens hebben die dat land uitgeeft. Een Belgisch nummer is bijvoorbeeld `BE` gevolgd door 10 cijfers die beginnen met `0` of `1`, dus `BE123456789` wordt geweigerd. Whop voegt geen ontbrekend prefix toe, omdat een `eu_vat`-nummer niet aangeeft uit welk land het komt.

Op een betalingsofferte weigert Whop alleen een nummer dat niet begint met twee letters gevolgd door minstens twee letters of cijfers.

Beide endpoints antwoorden met een `400`. Op een account heeft de fout een `code` waarop je kunt matchen:

```json theme={null}
{
  "error": {
    "type": "bad_request",
    "message": "Enter your EU VAT number with its two-letter country code, for example DE123456789.",
    "code": "eu_vat_number_invalid"
  }
}
```

Op een betalingsofferte is het bericht `tax_ids.value is not a valid eu_vat registration`.

## Andere typen belastingnummers

Elk ander type behoudt de interpunctie en hoofdletters/kleine letters van het gepubliceerde formaat. Een Zwitserse UID blijft `CHE-123.456.789` en een Braziliaans CNPJ blijft `12.345.678/0001-00`. Verstuur het nummer zoals de belastingdienst het afdrukt. Op een betalingsofferte worden spaties nog steeds verwijderd, dus `CHE-123.456.789 MWST` wordt `CHE-123.456.789MWST`.

In Canada telt een `ca_gst_hst`-nummer als registratie in elke provincie. Een provinciaal nummer, zoals `ca_qst` of `ca_pst_bc`, telt alleen in de eigen provincie, en een `ca_bn`-bedrijfsnummer telt op zichzelf nergens.

## Voorbeelden per land

Deze komen overeen met de voorbeelden in het Whop-dashboard, dat `eu_vat` gebruikt voor Polen en Noord-Ierland. De referentie van [Update Account](https://docs.whop.com/nl/api-reference/accounts/update-account.md) vermeldt de andere geaccepteerde waarden voor `tax_id_type`. Een betalingsofferte accepteert ook `pl_nip` en `xi_vat`.

| Land | `tax_id_type` | Voorbeeld |
| - | - | - |
| Albanië | `al_tin` | `J12345678N` |
| Andorra | `ad_nrt` | `A-123456-B` |
| Angola | `ao_tin` | `1234567890` |
| Argentinië | `ar_cuit` | `20-12345678-9` |
| Armenië | `am_tin` | `12345678` |
| Aruba | `aw_tin` | `1234567` |
| Australië | `au_abn` | `12345678901` |
| Australië | `au_arn` | `12345678901` |
| Oostenrijk | `eu_vat` | `ATU12345678` |
| Azerbeidzjan | `az_tin` | `1234567890` |
| Bahama's | `bs_tin` | `123456789` |
| Bahrein | `bh_vat` | `123456789012345` |
| Bangladesh | `bd_bin` | `123456789` |
| Barbados | `bb_tin` | `1234567890` |
| Belarus | `by_tin` | `123456789` |
| België | `eu_vat` | `BE0123456789` |
| Benin | `bj_ifu` | `1234567890123` |
| Bolivia | `bo_tin` | `1234567` |
| Bosnië en Herzegovina | `ba_tin` | `1234567890123` |
| Brazilië | `br_cnpj` | `12.345.678/0001-00` |
| Brazilië | `br_cpf` | `123.456.789-00` |
| Bulgarije | `bg_uic` | `123456789` |
| Bulgarije | `eu_vat` | `BG123456789` |
| Burkina Faso | `bf_ifu` | `12345678901234` |
| Cambodja | `kh_tin` | `K001-234567890` |
| Kameroen | `cm_niu` | `M012345678901A` |
| Canada | `ca_bn` | `123456789` |
| Canada | `ca_gst_hst` | `123456789RT0001` |
| Canada | `ca_pst_bc` | `PST-1234-5678` |
| Canada | `ca_pst_mb` | `123456-7` |
| Canada | `ca_pst_sk` | `1234567` |
| Canada | `ca_qst` | `1234567890TQ1234` |
| Kaapverdië | `cv_nif` | `123456789` |
| Chili | `cl_tin` | `12.345.678-9` |
| China | `cn_tin` | `123456789012345678` |
| Colombia | `co_nit` | `123.456.789-0` |
| Costa Rica | `cr_tin` | `1-234-567890` |
| Kroatië | `eu_vat` | `HR12345678901` |
| Kroatië | `hr_oib` | `12345678901` |
| Cyprus | `eu_vat` | `CY12345678A` |
| Tsjechië | `eu_vat` | `CZ12345678` |
| Democratische Republiek Congo | `cd_nif` | `A1234567B` |
| Denemarken | `eu_vat` | `DK12345678` |
| Dominicaanse Republiek | `do_rcn` | `123-4567890-1` |
| Ecuador | `ec_ruc` | `1234567890001` |
| Egypte | `eg_tin` | `123456789` |
| El Salvador | `sv_nit` | `0614-123456-123-4` |
| Estland | `eu_vat` | `EE123456789` |
| Ethiopië | `et_tin` | `1234567890` |
| Europese Unie (niet-Unie-OSS) | `eu_oss_vat` | `EU123456789` |
| Finland | `eu_vat` | `FI12345678` |
| Frankrijk | `eu_vat` | `FR12345678901` |
| Georgië | `ge_vat` | `123456789` |
| Duitsland | `de_stn` | `12/345/67890` |
| Duitsland | `eu_vat` | `DE123456789` |
| Ghana | `gh_tin` | `C0001234567` |
| Griekenland | `eu_vat` | `EL123456789` |
| Guinee | `gn_nif` | `123456789` |
| Hongkong | `hk_br` | `12345678` |
| Hongarije | `eu_vat` | `HU12345678` |
| Hongarije | `hu_tin` | `12345678` |
| IJsland | `is_vat` | `123456` |
| India | `in_gst` | `22AAAAA0000A1Z5` |
| Indonesië | `id_npwp` | `12.345.678.9-012.345` |
| Ierland | `eu_vat` | `IE1234567A` |
| Israël | `il_vat` | `123456789` |
| Italië | `eu_vat` | `IT12345678901` |
| Japan | `jp_cn` | `1234-56-7890` |
| Japan | `jp_rn` | `12345` |
| Japan | `jp_trn` | `T1234567890123` |
| Kazachstan | `kz_bin` | `123456789012` |
| Kenia | `ke_pin` | `P000123456A` |
| Kirgizië | `kg_tin` | `12345678` |
| Laos | `la_tin` | `1234567890` |
| Letland | `eu_vat` | `LV12345678901` |
| Liechtenstein | `li_uid` | `CHE-123.456.789` |
| Liechtenstein | `li_vat` | `12345` |
| Litouwen | `eu_vat` | `LT123456789012` |
| Luxemburg | `eu_vat` | `LU12345678` |
| Maleisië | `my_frp` | `12345678` |
| Maleisië | `my_itn` | `C1234567890` |
| Maleisië | `my_sst` | `A12-3456-78901234` |
| Malta | `eu_vat` | `MT12345678` |
| Mauritanië | `mr_nif` | `12345678` |
| Mexico | `mx_rfc` | `XAXX010101000` |
| Moldavië | `md_vat` | `1234567` |
| Montenegro | `me_pib` | `12345678` |
| Marokko | `ma_vat` | `12345678` |
| Nepal | `np_pan` | `123456789` |
| Nederland | `eu_vat` | `NL123456789B01` |
| Nieuw-Zeeland | `nz_gst` | `123456789` |
| Nigeria | `ng_tin` | `12345678-0001` |
| Noord-Macedonië | `mk_vat` | `MK1234567890123` |
| Noord-Ierland | `eu_vat` | `XI123456789` |
| Noorwegen | `no_vat` | `123456789MVA` |
| Noorwegen | `no_voec` | `1234567` |
| Oman | `om_vat` | `OM1234567890` |
| Peru | `pe_ruc` | `12345678901` |
| Filipijnen | `ph_tin` | `123-456-789-000` |
| Polen | `eu_vat` | `PL1234567890` |
| Portugal | `eu_vat` | `PT123456789` |
| Roemenië | `eu_vat` | `RO1234567890` |
| Roemenië | `ro_tin` | `1234567890` |
| Rusland | `ru_inn` | `1234567890` |
| Rusland | `ru_kpp` | `123456789` |
| Saoedi-Arabië | `sa_vat` | `123456789012345` |
| Senegal | `sn_ninea` | `12345678901` |
| Servië | `rs_pib` | `123456789` |
| Singapore | `sg_gst` | `M12345678X` |
| Singapore | `sg_uen` | `123456789A` |
| Slowakije | `eu_vat` | `SK1234567890` |
| Slovenië | `eu_vat` | `SI12345678` |
| Slovenië | `si_tin` | `12345678` |
| Zuid-Afrika | `za_vat` | `4123456789` |
| Zuid-Korea | `kr_brn` | `123-45-67890` |
| Spanje | `es_cif` | `A12345678` |
| Spanje | `eu_vat` | `ESA12345678` |
| Suriname | `sr_fin` | `12345678` |
| Zweden | `eu_vat` | `SE123456789012` |
| Zwitserland | `ch_uid` | `CHE-123.456.789` |
| Zwitserland | `ch_vat` | `CHE-123.456.789 MWST` |
| Taiwan | `tw_vat` | `12345678` |
| Tadzjikistan | `tj_tin` | `123456789` |
| Tanzania | `tz_vat` | `12-345-6789` |
| Thailand | `th_vat` | `1234567890123` |
| Turkije | `tr_tin` | `1234567890` |
| Oeganda | `ug_tin` | `1234567890` |
| Oekraïne | `ua_vat` | `1234567890` |
| Verenigde Arabische Emiraten | `ae_trn` | `123456789012345` |
| Verenigd Koninkrijk | `gb_vat` | `GB123456789` |
| Verenigde Staten | `us_ein` | `12-3456789` |
| Uruguay | `uy_ruc` | `123456789012` |
| Oezbekistan | `uz_tin` | `123456789` |
| Oezbekistan | `uz_vat` | `123456789012` |
| Venezuela | `ve_rif` | `J-12345678-9` |
| Vietnam | `vn_tin` | `1234567890` |
| Zambia | `zm_tin` | `1234567890` |
| Zimbabwe | `zw_tin` | `1234567890` |

## Volgende stappen

> [card] [Een account bijwerken](https://docs.whop.com/nl/api-reference/accounts/update-account.md)
>
> Stel de belastingnummers van een account in en bepaal hoe het belasting afdraagt.

> [card] [Een offerte voor een zakelijke aankoop maken](https://docs.whop.com/nl/api-reference/payment-quotes/create-payment-quote.md)
>
> Bepaal de prijs van een aankoop met het belastingnummer van de koper voordat je die in rekening brengt.


## Related topics

- [TaxIdElement](https://docs.whop.com/nl/elements/latest/payments/taxId.md)
- [Community's en chat](https://docs.whop.com/nl/developer/communities/overview.md)
- [AI en MCP](https://docs.whop.com/nl/developer/guides/ai_and_mcp.md)
