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

> Recopila un registro fiscal de empresa aceptado por la API. Las etiquetas usan nombres orientados al comprador. El placeholder coincide con el formato seleccionado. `country` preselecciona un tipo. `onChange` emite pares confirmados. El host proporciona los errores de validación de la API.

> [!NOTE]
>
> Esta página documenta `@whop/elements@1.10.0` y `@whop/elements-react@1.10.0`.

*Desde `v1.0.0`.*

Se monta dentro de [`Payments`](https://docs.whop.com/es/elements/latest/payments/overview). Pasa las props y los callbacks a través de las opciones de creación o de las props de React.

Se monta dentro de un ámbito `WhopPayments`. Un selector del tipo de registro junto a su campo de valor, preseleccionado a partir del país del comprador.

Móntalo dentro de `<Payments>`, que es dueño del cobro y del token de confirmación. `<Payments>` se monta a su vez dentro de `<WhopElements>`. Un selector del tipo de registro junto a un campo de valor, para que un comprador que introduce un número de VAT o de CUIT elija primero el tipo correcto.

```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()
            }
        }
    }
}
```

Datos de ejemplo. [Abre el Playground](https://docs.whop.com/es/elements/latest/payments/overview#playground).

[TaxIdElement ejecutándose en Android, en la app de ejemplo de React Native](https://app.revyl.ai/embed/713e08f7-91e6-4449-905b-ceb4c18b83c2?controls=0)

## Props

**disabled** `boolean`

Deshabilita ambos campos mientras el host guarda el último registro confirmado. Por defecto es `false`.

**country** `string`

País del comprador en ISO 3166-1 alfa-2 que se usa para preseleccionar el tipo. `AR` selecciona `ar_cuit` y `LI` selecciona `li_uid`. Los valores de la UE, los no asignados o los vacíos seleccionan `eu_vat`. Los demás países asignados seleccionan su propio primer tipo. Una selección manual se conserva aunque cambie el país. Por defecto es `""`.

**defaultValue** `object`

`type` y `value` iniciales de una sesión reanudada. Un `type` no compatible recurre al valor predeterminado del país.

**propiedades**

**type** `string` *required*

**value** `string` *required*

**error** `string`

Error de validación de la API que se muestra debajo del campo de valor. Vacío (por defecto) no muestra nada. Por defecto es `""`.

## Eventos

Pasa los callbacks en las opciones de creación o como props de React.

### `onChange`

Se dispara al perder el foco o al pulsar Enter cuando el valor no está vacío, o cuando cambia el tipo con un valor presente. Los valores consecutivos idénticos se disparan una sola vez. Borrar el valor no lo dispara. El host debe borrar los registros almacenados.

**payload** `object`

**propiedades**

**taxId** `object` *required*

**propiedades**

**type** `string` *required*

**valores**

Uno de `"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"` o `"xi_vat"`.

**value** `string` *required*

### `onLoaderStart`

Se ejecuta después de que el esqueleto de carga se pinta por primera vez y antes de `onReady`.

### `onReady`

Se ejecuta después del primer pintado completo del elemento.

### `onError`

Se ejecuta cuando el elemento no se carga o falla. El contenido de respaldo permanece visible. Usa `code` para el manejo programático. `sourceKey` identifica una fuente de estado del host que falló.

**e** `object`

**propiedades**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Métodos

Llámalos en el handle que devuelve `create`, o a través de una `ref` de React.

### `mount`

Monta el elemento en `target` y comienza a cargarlo. Los componentes de React se montan solos.

**Parámetros**

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

### `destroy`

Elimina el elemento y libera su frame y sus suscripciones. Puedes llamarlo más de una vez. React elimina el elemento automáticamente.

### `update`

Combina nuevas props en el elemento montado. En React, cambia las props del componente en su lugar.

**Parámetros**

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

## Estilos

Aplica estilo a estas partes mediante `appearance.classes`. Usa camel case o kebab case para los nombres de las propiedades e incluye las unidades. Las hojas de estilo de la página no pueden llegar al frame del elemento. El framework valida cada declaración antes de inyectarla.

| Clase | Aplica a |
| - | - |
| `.whop-TaxId` | Raíz del registro fiscal |
| `.whop-TaxIdError` | Error de validación de la API |
| `.whop-TaxIdInput` | Campo del valor del registro |
| `.whop-TaxIdLabel` | Etiqueta del valor del registro |
| `.whop-TaxIdTypeLabel` | Etiqueta del tipo de registro |
| `.whop-TaxIdTypeSelect` | Selector del tipo de registro |

```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' } } }
});
```

En React, pasa `appearance` a `<Payments>`. Establécelo globalmente con `WhopElements({ appearance })`.

## Parámetros

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

Recibe cada registro confirmado.

**country** `String?`

País del comprador en ISO 3166-1 alfa-2, que se usa para preseleccionar el tipo.

**defaultValue** `WhopTaxID?`

Un par inicial de una sesión reanudada. Un tipo no compatible recurre al valor alternativo.

**isDisabled** `Bool`

Deshabilita ambos campos mientras guardas el último registro confirmado. Por defecto es `false`.

**error** `String?`

Un error de validación de la API, que se muestra debajo del campo de valor.

## `WhopTaxID`

Lo que devuelve una selección:

* `type: WhopTaxIDType`: el tipo de registro, `eu_vat`, `ar_cuit`, …
* `value: String`: el propio registro

## Estados

Se renderiza inmediatamente. Un valor que no coincide con el formato del tipo seleccionado muestra su error. `error` renderiza un fallo de validación de la API debajo del campo de valor.

## Información útil

* `AR` preselecciona `ar_cuit`; los miembros de la UE y cualquier valor no asignado preseleccionan `eu_vat`. Una selección manual se conserva aunque cambie el país.
* Pasa el país desde el elemento de dirección para que ambos estén sincronizados.
* El binding se dispara con cada registro confirmado, no con cada pulsación de tecla.

## Instalación

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

> [!NOTE]
>
> Móntalo dentro de un ámbito `WhopPayments(accountID:charge:)`, que crea el controlador y se lo pasa a su contenido. `payments.buyer` es el comprador con sesión iniciada una vez que un inicio de sesión por correo electrónico lo ha verificado. `WhopBrandingElement` también tiene que estar en pantalla, porque Whop es el comerciante registrado en estas ventas y `createConfirmationToken` se rechaza sin él. Aplica estilo con `.whopElementsAppearance(_:)`. El módulo es `Elements`, no `WhopElements` del SDK de wallet. Consulta [Primeros pasos](https://docs.whop.com/es/elements/latest/getting-started.md) y [Appearance](https://docs.whop.com/es/elements/latest/appearance.md).

## Props

**country** `string`

País del comprador en ISO 3166-1 alfa-2, que se usa para preseleccionar el tipo. `AR` selecciona `ar_cuit`; los valores de la UE y los no asignados seleccionan `eu_vat`.

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

Par inicial de una sesión reanudada. Un tipo no compatible recurre al valor alternativo.

**disabled** `boolean`

Deshabilita ambos campos mientras guardas el último registro confirmado.

**error** `string`

Un mensaje de validación de tu API, que se muestra debajo del campo de valor.

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

Se dispara con cada cambio de tipo o de valor.

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

Se aplica al `View` exterior del elemento. Para la personalización del tema, es preferible `appearance.parts` en el provider, que cubre todos los elementos de esta superficie. Ten en cuenta que, por ahora, los nombres de las partes de React Native son un conjunto propio, no los nombres de clase `whop-*` de la web, por lo que un objeto de appearance de la web no se puede trasladar sin cambios.

**fallback** `ReactNode`

Se renderiza en lugar del esqueleto integrado mientras el elemento se carga.

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

Se dispara una vez que el elemento es interactivo. `<Payments>` los agrupa, así que normalmente lo que quieres es su propio `onLoadingChange`.

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

Un fallo de carga o de configuración de este elemento. En cualquier caso, el elemento renderiza su propia vista de error.

## `TaxIdChangePayload`

Lo que devuelve `onChange`:

* `taxId: { type: TaxIdType; value: string }`: el tipo de registro seleccionado y lo que escribió el comprador

## Estados

Se renderiza inmediatamente. El tipo se preselecciona a partir de `country` y el campo de valor se valida según el formato de ese tipo. `onChange` se dispara con el par actual.

## Información útil

* `country` solo preselecciona. Un comprador que elige un tipo manualmente lo conserva aunque cambie el país.
* Pasa `error` para mostrar un mensaje de la validación de tu propia API debajo del campo de valor.
* El elemento informa del par. Enviarlo te corresponde a ti: adjúntalo a tu propio pedido o registro de cliente.

> [!NOTE]
>
> Envuelve tu app en `<WhopElements getToken={…}>` una vez y luego monta `<Payments>` alrededor de los elementos. Consulta [Primeros pasos](https://docs.whop.com/es/elements/latest/getting-started.md) y [Appearance](https://docs.whop.com/es/elements/latest/appearance.md).


## Related topics

- [Primeros pasos con Elements](https://docs.whop.com/es/elements/latest/getting-started.md)
- [BrandingElement](https://docs.whop.com/es/elements/latest/payments/branding.md)
- [Payments](https://docs.whop.com/es/elements/latest/payments/overview.md)
