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

> API tarafından kabul edilen bir işletme vergi kaydını toplar. Etiketler alıcıya yönelik adları kullanır. Yer tutucu seçilen biçimle eşleşir. `country` bir türü önceden seçer. `onChange` kesinleşmiş çiftleri yayınlar. API doğrulama hatalarını host sağlar.

> [!NOTE]
>
> Bu sayfa `@whop/elements@1.10.0` ve `@whop/elements-react@1.10.0` sürümlerini belgeler.

*`v1.0.0` sürümünden beri.*

[`Payments`](https://docs.whop.com/tr/elements/latest/payments/overview) içine bağlanır. Prop'ları ve geri çağırmaları oluşturma seçenekleri veya React prop'ları aracılığıyla iletin.

Bir `WhopPayments` kapsamı içine bağlanır. Değer alanının yanında, alıcının ülkesine göre önceden seçilmiş bir kayıt türü seçici bulunur.

Ücretin ve onay token'ının sahibi olan `<Payments>` içine bağlayın. `<Payments>` ise `<WhopElements>` içine bağlanır. Bir değer girişinin yanında bir kayıt türü seçici bulunur; böylece KDV (VAT) veya CUIT numarası giren bir alıcı önce doğru türü seçer.

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

Örnek veriler. [Deneme alanını açın](https://docs.whop.com/tr/elements/latest/payments/overview#playground).

[React Native örnek uygulamasında Android üzerinde çalışan TaxIdElement](https://app.revyl.ai/embed/713e08f7-91e6-4449-905b-ceb4c18b83c2?controls=0)

## Prop'lar

**disabled** `boolean`

Host son kesinleşmiş kaydı kaydederken her iki alanı da devre dışı bırakır. Varsayılan değer `false`.

**country** `string`

Türü önceden seçmek için kullanılan, ISO 3166-1 alpha-2 biçimindeki alıcı ülkesi. `AR`, `ar_cuit` seçer; `LI`, `li_uid` seçer. AB ve eşlenmemiş ya da boş değerler `eu_vat` seçer. Eşlenmiş diğer ülkeler kendi ilk türlerini seçer. Elle yapılan bir seçim ülke değişikliklerinde korunur. Varsayılan değer `""`.

**defaultValue** `object`

Devam ettirilen bir oturumdan gelen başlangıç `type` ve `value` değerleri. Desteklenmeyen bir `type`, ülke varsayılanına geri döner.

**özellikler**

**type** `string` *required*

**value** `string` *required*

**error** `string`

Değer girişinin altında gösterilen API doğrulama hatası. Boş (varsayılan) hiçbir şey göstermez. Varsayılan değer `""`.

## Olaylar

Geri çağırmaları oluşturma seçeneklerinde veya React prop'larında iletin.

### `onChange`

Değer boş değilken odak kaybında veya Enter tuşunda ya da bir değer mevcutken tür değiştiğinde tetiklenir. Art arda gelen aynı değerler bir kez tetiklenir. Değeri temizlemek tetiklemez. Saklanan kayıtları host temizlemelidir.

**payload** `object`

**özellikler**

**taxId** `object` *required*

**özellikler**

**type** `string` *required*

**değerler**

Şu değerlerden biri: `"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"` veya `"xi_vat"`.

**value** `string` *required*

### `onLoaderStart`

Yükleme iskeleti ilk kez çizildikten sonra ve `onReady` öncesinde çalışır.

### `onReady`

Elementin ilk eksiksiz çiziminden sonra çalışır.

### `onError`

Element yüklenemediğinde veya çöktüğünde çalışır. Yedek görünüm görünür kalır. Programatik işleme için `code` kullanın. `sourceKey`, başarısız olan host-state kaynağını tanımlar.

**e** `object`

**özellikler**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Metotlar

Bunları `create` tarafından döndürülen tanıtıcı (handle) üzerinde veya bir React `ref` aracılığıyla çağırın.

### `mount`

Elementi `target` içine bağlar ve yüklemeyi başlatır. React bileşenleri kendilerini bağlar.

**Parametreler**

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

### `destroy`

Elementi kaldırır ve çerçevesini ile aboneliklerini serbest bırakır. Birden fazla kez çağırabilirsiniz. React elementi otomatik olarak kaldırır.

### `update`

Yeni prop'ları bağlı elementle birleştirir. React'te bunun yerine bileşen prop'larını değiştirin.

**Parametreler**

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

## Stil verme

Bu parçalara `appearance.classes` aracılığıyla stil verin. Özellik adları için camel case veya kebab case kullanın ve birimleri ekleyin. Sayfa stil sayfaları elementin çerçevesine ulaşamaz. Framework her bildirimi eklemeden önce doğrular.

| Sınıf | Hedef |
| - | - |
| `.whop-TaxId` | Vergi kaydı kökü |
| `.whop-TaxIdError` | API doğrulama hatası |
| `.whop-TaxIdInput` | Kayıt değeri girişi |
| `.whop-TaxIdLabel` | Kayıt değeri etiketi |
| `.whop-TaxIdTypeLabel` | Kayıt türü etiketi |
| `.whop-TaxIdTypeSelect` | Kayıt türü seçicisi |

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

React'te `appearance` değerini `<Payments>` bileşenine iletin. Genel olarak `WhopElements({ appearance })` ile ayarlayın.

## Parametreler

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

Her kesinleşmiş kaydı alır.

**country** `String?`

Türü önceden seçmek için kullanılan, ISO 3166-1 alpha-2 biçimindeki alıcı ülkesi.

**defaultValue** `WhopTaxID?`

Devam ettirilen bir oturumdan gelen başlangıç çifti. Desteklenmeyen bir tür varsayılana geri döner.

**isDisabled** `Bool`

Son kesinleşmiş kaydı kaydederken her iki alanı da devre dışı bırakır. Varsayılan değer `false`.

**error** `String?`

Değer girişinin altında gösterilen bir API doğrulama hatası.

## `WhopTaxID`

Bir seçimin döndürdüğü değerler:

* `type: WhopTaxIDType`: kayıt türü; `eu_vat`, `ar_cuit`, …
* `value: String`: kaydın kendisi

## Durumlar

Hemen görüntülenir. Seçilen türün biçimiyle eşleşmeyen bir değer kendi hatasını gösterir. `error`, bir API doğrulama hatasını değer alanının altında gösterir.

## Bilmekte fayda var

* `AR`, `ar_cuit` değerini önceden seçer; AB üyeleri ve eşlenmemiş her şey `eu_vat` değerini önceden seçer. Elle yapılan bir seçim ülke değişikliklerinde korunur.
* İkisinin uyumlu kalması için ülkeyi adres elementinden iletin.
* Binding her tuş vuruşunda değil, her kesinleşmiş kayıtta tetiklenir.

## Kurulum

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

> [!NOTE]
>
> Onu, denetleyiciyi oluşturan ve içeriğine aktaran bir `WhopPayments(accountID:charge:)` kapsamı içine bağlayın. Bir e-posta ile oturum açma bir alıcıyı doğruladığında `payments.buyer` oturum açmış alıcıdır. Whop bu satışlarda kayıtlı satıcı (merchant of record) olduğundan `WhopBrandingElement` de ekranda olmalıdır; `createConfirmationToken` o olmadan reddeder. `.whopElementsAppearance(_:)` ile stil verin. Modül, cüzdan SDK'sının `WhopElements` modülü değil, `Elements` modülüdür. Bkz. [Başlarken](https://docs.whop.com/tr/elements/latest/getting-started.md) ve [Görünüm](https://docs.whop.com/tr/elements/latest/appearance.md).

## Prop'lar

**country** `string`

Türü önceden seçmek için kullanılan, ISO 3166-1 alpha-2 biçimindeki alıcı ülkesi. `AR`, `ar_cuit` seçer; AB ve eşlenmemiş değerler `eu_vat` seçer.

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

Devam ettirilen bir oturumdan gelen başlangıç çifti. Desteklenmeyen bir tür varsayılana geri döner.

**disabled** `boolean`

Son kesinleşmiş kaydı kaydederken kullanmak için her iki alanı da devre dışı bırakır.

**error** `string`

Değer girişinin altında gösterilen, API'nizden gelen bir doğrulama mesajı.

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

Her tür veya değer değişikliğinde tetiklenir.

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

Elementin dış `View` bileşenine uygulanır. Tema için, bu yüzeydeki her elementi kapsayan sağlayıcı üzerindeki `appearance.parts` seçeneğini tercih edin. React Native parça adlarının bugün web'in `whop-*` sınıf adlarından farklı, kendine ait bir küme olduğunu unutmayın; bu nedenle bir web appearance nesnesi değiştirilmeden aktarılamaz.

**fallback** `ReactNode`

Element yüklenirken yerleşik iskelet yerine gösterilir.

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

Element etkileşimli hâle geldiğinde bir kez tetiklenir. `<Payments>` bunları gruplar, bu nedenle genellikle istediğiniz şey onun kendi `onLoadingChange` geri çağırmasıdır.

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

Bu element için bir yükleme veya yapılandırma hatası. Element her iki durumda da kendi hata ekranını gösterir.

## `TaxIdChangePayload`

`onChange` geri çağırmasının döndürdüğü değerler:

* `taxId: { type: TaxIdType; value: string }`: seçilen kayıt türü ve alıcının yazdığı değer

## Durumlar

Hemen görüntülenir. Tür `country` değerinden önceden seçilir ve değer girişi o türün biçimine göre doğrulanır. `onChange` geçerli çiftle tetiklenir.

## Bilmekte fayda var

* `country` yalnızca önceden seçim yapar. Bir türü elle seçen alıcı, ülke değişikliklerinde bu seçimi korur.
* Kendi API doğrulamanızdan gelen bir mesajı değer girişinin altında göstermek için `error` iletin.
* Element çifti bildirir. Onu göndermek size kalmıştır: kendi sipariş veya müşteri kaydınıza ekleyin.

> [!NOTE]
>
> Uygulamanızı bir kez `<WhopElements getToken={…}>` ile sarın, ardından elementlerin etrafına `<Payments>` bağlayın. Bkz. [Başlarken](https://docs.whop.com/tr/elements/latest/getting-started.md) ve [Görünüm](https://docs.whop.com/tr/elements/latest/appearance.md).


## Related topics

- [Elements ile başlarken](https://docs.whop.com/tr/elements/latest/getting-started.md)
- [BrandingElement](https://docs.whop.com/tr/elements/latest/payments/branding.md)
- [Payments](https://docs.whop.com/tr/elements/latest/payments/overview.md)
