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

# TaxIdElement

> Indsamler en virksomheds skatteregistrering, som API'et accepterer. Etiketterne bruger navne, køberen kender. Pladsholderen matcher det valgte format. `country` forudvælger en type. `onChange` udsender bekræftede par. Hosten leverer API-valideringsfejl.

> [!NOTE]
>
> Denne side dokumenterer `@whop/elements@1.10.0` og `@whop/elements-react@1.10.0`.

*Siden `v1.0.0`.*

Monteres inde i [`Payments`](https://docs.whop.com/da/elements/latest/payments/overview). Angiv props og callbacks via create-indstillingerne eller som React-props.

Monteres inde i et `WhopPayments`-scope. En vælger til registreringstype ved siden af værdifeltet, forudvalgt ud fra køberens land.

Montér inde i `<Payments>`, som ejer opkrævningen og bekræftelsestokenet. `<Payments>` monteres selv inde i `<WhopElements>`. En vælger til registreringstype ved siden af et værdiinput, så en køber, der indtaster et moms- eller CUIT-nummer, først vælger den rigtige type.

```tsx React theme={null}
import { WhopElements, Payments, TaxIdElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Payments /* options */>
        <TaxIdElement onChange={(e) => console.log(e)} />
      </Payments>
    </WhopElements>
  );
}
```

```tsx React Native theme={null}
import { Payments, TaxIdElement } from '@whop/elements-react-native';

export function TaxStep({ country }: { country: string }) {
  return (
    <Payments accountId="biz_xxxxxxxx" plan="plan_xxxxxxxx">
      <TaxIdElement country={country} onChange={({ taxId }) => console.log(taxId.type, taxId.value)} />
    </Payments>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const payments = window.WhopElements().payments.create({ /* options */ });
  payments.create('taxId', { onChange: (e) => console.log(e) }).mount('#payments-taxId');
</script>
```

```swift Swift theme={null}
import Elements
import SwiftUI

// .whopElements(environment:) runs once at the app root. See Getting started.
struct CheckoutScreen: View {
    @State private var address = PostalAddress()
    @State private var taxID: WhopTaxID?

    var body: some View {
        WhopPayments(accountID: "biz_xxxx", charge: .plan(id: "plan_xxxx")) { payments in
            ScrollView {
                VStack(alignment: .leading, spacing: 20) {
                WhopAddressElement(address: $address)
                WhopTaxIDElement(taxID: $taxID, country: address.country)
                    WhopBrandingElement()
                }
                .padding()
            }
        }
    }
}
```

Eksempeldata. [Åbn Playground](https://docs.whop.com/da/elements/latest/payments/overview#playground).

[TaxIdElement kørende på Android i React Native-eksempelappen](https://app.revyl.ai/embed/713e08f7-91e6-4449-905b-ceb4c18b83c2?controls=0)

## Props

**disabled** `boolean`

Deaktiverer begge felter, mens hosten gemmer den senest bekræftede registrering. Standard er `false`.

**country** `string`

Køberens land som ISO 3166-1 alpha-2, der bruges til at forudvælge typen. `AR` vælger `ar_cuit`, `LI` vælger `li_uid`. EU samt ikke-tilknyttede eller tomme værdier vælger `eu_vat`. Andre tilknyttede lande vælger deres egen første type. Et manuelt valg bevares på tværs af landeskift. Standard er `""`.

**defaultValue** `object`

Startværdier for `type` og `value` fra en genoptaget session. En ikke-understøttet `type` falder tilbage til landets standard.

**egenskaber**

**type** `string` *required*

**value** `string` *required*

**error** `string`

API-valideringsfejl, der vises under værdiinputtet. Tom (standard) viser intet. Standard er `""`.

## Events

Angiv callbacks i create-indstillingerne eller som React-props.

### `onChange`

Udløses ved blur eller Enter, når værdien ikke er tom, eller når typen ændres, mens der er en værdi. Identiske på hinanden følgende værdier udløses én gang. Rydning af værdien udløser ikke. Hosten skal selv rydde gemte registreringer.

**payload** `object`

**egenskaber**

**taxId** `object` *required*

**egenskaber**

**type** `string` *required*

**værdier**

En af `"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"` eller `"xi_vat"`.

**value** `string` *required*

### `onLoaderStart`

Kører, efter at indlæsningsskelettet først er tegnet, og før `onReady`.

### `onReady`

Kører efter elementets første fuldstændige rendering.

### `onError`

Kører, når elementet ikke kan indlæses eller går ned. Fallback-visningen forbliver synlig. Brug `code` til programmatisk håndtering. `sourceKey` identificerer en host-state-kilde, der fejlede.

**e** `object`

**egenskaber**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Metoder

Kald disse på det handle, som `create` returnerer, eller via en React-`ref`.

### `mount`

Monterer elementet i `target` og begynder indlæsningen. React-komponenter monterer sig selv.

**Parametre**

**target** `string | HTMLElement` *required*

### `destroy`

Fjerner elementet og frigiver dets frame og abonnementer. Du kan kalde den mere end én gang. React fjerner elementet automatisk.

### `update`

Fletter nye props ind i det monterede element. I React ændrer du i stedet komponentens props.

**Parametre**

**options** `Partial\<TaxIdElementProps\>` *required*

## Styling

Style disse dele via `appearance.classes`. Brug camel case eller kebab case til egenskabsnavne, og medtag enheder. Sidens stylesheets kan ikke nå elementets frame. Frameworket validerer hver deklaration, før den indsættes.

| Klasse | Rammer |
| - | - |
| `.whop-TaxId` | Rodelementet for skatteregistreringen |
| `.whop-TaxIdError` | API-valideringsfejl |
| `.whop-TaxIdInput` | Input til registreringsværdi |
| `.whop-TaxIdLabel` | Etiket for registreringsværdi |
| `.whop-TaxIdTypeLabel` | Etiket for registreringstype |
| `.whop-TaxIdTypeSelect` | Vælger til registreringstype |

```ts theme={null}
const payments = whop.payments.create({
  appearance: {
    classes: {
      'whop-TaxId': { borderRadius: '8px', fontWeight: '600' },
      'whop-TaxIdError': { borderRadius: '8px', fontWeight: '600' },
      'whop-TaxIdInput': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

// 6 classes use this shape
payments.update({
  appearance: { classes: { 'whop-TaxId': { fontWeight: '700' } } }
});
```

I React angiver du `appearance` til `<Payments>`. Sæt den globalt med `WhopElements({ appearance })`.

## Parametre

**taxID** `Binding\<WhopTaxID?\>?`

Modtager hver bekræftet registrering.

**country** `String?`

Køberens land som ISO 3166-1 alpha-2, der bruges til at forudvælge typen.

**defaultValue** `WhopTaxID?`

Et startpar fra en genoptaget session. En ikke-understøttet type falder tilbage.

**isDisabled** `Bool`

Deaktiverer begge felter, mens du gemmer den senest bekræftede registrering. Standard er `false`.

**error** `String?`

En API-valideringsfejl, der vises under værdiinputtet.

## `WhopTaxID`

Det, et valg returnerer:

* `type: WhopTaxIDType`: registreringstypen, `eu_vat`, `ar_cuit`, …
* `value: String`: selve registreringen

## Tilstande

Renderes med det samme. En værdi, der ikke matcher den valgte types format, viser sin fejl. `error` renderer en API-valideringsfejl under værdifeltet.

## Godt at vide

* `AR` forudvælger `ar_cuit`; EU-medlemmer og alt, der ikke er tilknyttet, forudvælger `eu_vat`. Et manuelt valg bevares på tværs af landeskift.
* Angiv landet fra adresseelementet, så de to holdes i takt.
* Bindingen udløses ved hver bekræftet registrering, ikke ved hvert tastetryk.

## Installation

```swift theme={null}
dependencies: [
    .package(url: "https://github.com/whopio/elements-swift.git", from: "0.1.0")
]
```

> [!NOTE]
>
> Montér det inde i et `WhopPayments(accountID:charge:)`-scope, som opretter controlleren og giver den videre til sit indhold. `payments.buyer` er den indloggede køber, når en e-mail-login har bekræftet en. `WhopBrandingElement` skal også være på skærmen, fordi Whop er merchant of record på disse salg, og `createConfirmationToken` afviser uden det. Style med `.whopElementsAppearance(_:)`. Modulet er `Elements`, ikke wallet-SDK'ets `WhopElements`. Se [Kom godt i gang](https://docs.whop.com/da/elements/latest/getting-started.md) og [Appearance](https://docs.whop.com/da/elements/latest/appearance.md).

## Props

**country** `string`

Køberens land som ISO 3166-1 alpha-2, der bruges til at forudvælge typen. `AR` vælger `ar_cuit`; EU og ikke-tilknyttede værdier vælger `eu_vat`.

**defaultValue** `\{ type: string; value: string \}`

Startpar fra en genoptaget session. En ikke-understøttet type falder tilbage.

**disabled** `boolean`

Deaktiverer begge felter, mens du gemmer den senest bekræftede registrering.

**error** `string`

En valideringsbesked fra dit API, der vises under værdiinputtet.

**onChange** `(payload: TaxIdChangePayload) =\> void`

Udløses ved hver ændring af type eller værdi.

**style** `StyleProp\<ViewStyle\>`

Anvendes på elementets ydre `View`. Til tematisering bør du foretrække `appearance.parts` på provideren, som dækker alle elementer på denne flade. Bemærk, at React Native-delenes navne i dag er deres eget sæt og ikke webbens `whop-*`-klassenavne, så et web-appearance-objekt kan ikke overføres uændret.

**fallback** `ReactNode`

Renderes i stedet for det indbyggede skelet, mens elementet indlæses.

**onReady** `() =\> void`

Udløses, når elementet er interaktivt. `<Payments>` grupperer disse, så dens egen `onLoadingChange` er normalt den, du har brug for.

**onError** `(error: \{ message: string; code?: string \}) =\> void`

En indlæsnings- eller konfigurationsfejl for dette element. Elementet renderer under alle omstændigheder sin egen fejlvisning.

## `TaxIdChangePayload`

Det, `onChange` returnerer:

* `taxId: { type: TaxIdType; value: string }`: den valgte registreringstype og det, køberen har indtastet

## Tilstande

Renderes med det samme. Typen forudvælges ud fra `country`, og værdiinputtet valideres mod den types format. `onChange` udløses med det aktuelle par.

## Godt at vide

* `country` forudvælger kun. En køber, der vælger en type manuelt, beholder den på tværs af landeskift.
* Angiv `error` for at vise en besked fra din egen API-validering under værdiinputtet.
* Elementet rapporterer parret. Det er op til dig at sende det: knyt det til din egen ordre eller kundepost.

> [!NOTE]
>
> Pak din app ind i `<WhopElements getToken={…}>` én gang, og montér derefter `<Payments>` omkring elementerne. Se [Kom godt i gang](https://docs.whop.com/da/elements/latest/getting-started.md) og [Appearance](https://docs.whop.com/da/elements/latest/appearance.md).
