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

# Vergi Kimlik Numaraları

> KDV, GST ve diğer vergi kayıt numaralarını Whop'un kabul edip vergiye uygulayacağı şekilde biçimlendirin.

Vergi kimlik numarası, bir vergi dairesinin bir işletmeye verdiği kayıt numarasıdır. Bunu `eu_vat` veya `gb_vat` gibi bir `tax_id_type` ve numaranın kendisi olarak gönderirsiniz. Vergi kimlik numaralarını iki yerde gönderirsiniz. Bir hesapta vergi kimlik numarası, işletmenin o ülkede vergi mükellefi olarak kayıtlı olduğunu da kaydeder. Bir ödeme teklifinde ise alıcının vergi kimlik numarası, işletmeler arası bir satın almayı fiyatlandırır. Bu sayfa her türün beklediği biçimi, Whop'un gönderdiğiniz numarada neyi değiştirdiğini ve neyi reddettiğini ele alır. Whop satışlarında vergiyi kimin tahsil edip beyan ettiği için [Vergiler](https://docs.whop.com/tr/payments-and-billing/fees/taxes.md) sayfasına bakın.

> [!NOTE]
>
> Tüm AB üye devletleri `eu_vat` türünü paylaşır. Whop ülkeyi numaranın ilk iki harfinden belirler; bu nedenle bir AB ülkesine ait KDV numarası o ülkenin koduyla başlamalıdır.

| | Hesap vergi kimlik numaraları | Alıcı vergi kimlik numarası |
| - | - | - |
| **Alan** | [Hesabı Güncelle](https://docs.whop.com/tr/api-reference/accounts/update-account.md) üzerinde `tax_identifiers` | [Ödeme Teklifi Oluştur](https://docs.whop.com/tr/api-reference/payment-quotes/create-payment-quote.md) üzerinde `tax_ids` |
| **Ne yapar** | İşletmenin nerede vergi mükellefi olarak kayıtlı olduğunu kaydeder. İşletme kendi vergisini beyan ettiğinde Whop, ABD dışında yalnızca hesabın vergi kimlik numarasına sahip olduğu ülkelerde vergi tahsil eder. ABD'deki tahsilat `tax_collection_enabled_states` değerini izler. | Uygun olduğu durumlarda, örneğin AB tersine vergilendirme (reverse charge) mekanizmasında, satın almayı işletmeler arası olarak fiyatlandırır. |
| **Kaç tane** | Her `tax_id_type` için bir tane. | Her teklif için bir tane. |
| **Biçimlendirme** | `eu_vat`: boşluklar, noktalar ve tireler kaldırılır, harfler büyük harfe çevrilir ve baştaki `GR`, `EL` olarak değiştirilir. Diğer türler: gönderdiğiniz gibi saklanır. | `eu_vat`: boşluklar, noktalar ve tireler kaldırılır. Whop gönderdiğiniz harf büyüklüğünü ve öneki korur. Diğer türler: boşluklar kaldırılır. |

## Bir hesaba vergi kimlik numarası ekleyin

Her vergi kimlik numarasını bir `tax_id_type` ve `tax_id_value` olarak gönderin. Whop aşağıdaki `DE 123.456.789` değerini `DE123456789` olarak saklar.

```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"}],
)
```

Bir hesap her `tax_id_type` için bir vergi kimlik numarası tutar. Hesabın zaten sahip olduğu bir türü göndermek, ikinci bir vergi kimlik numarası eklemek yerine mevcut değeri değiştirir. Tüm AB ülkeleri `eu_vat` türünü paylaştığından, bir hesap tüm AB için tek bir KDV numarası tutar.

## `eu_vat` türü

Bir `eu_vat` numarası, onu veren üye devletin iki harfli koduyla başlar ve ardından ulusal numara gelir.

* **Yunanistan `GR` değil, `EL` kullanır**: `EL123456789`. Bir hesapta `GR` ile gönderilen numara `EL` ile saklanır. Bir ödeme teklifinde `EL` önekini kendiniz gönderin.
* **Kuzey İrlanda**, `eu_vat` türüyle **`XI` kullanır**: `XI123456789`. Bir hesapta `XI` numarası işletmenin Birleşik Krallık'taki kaydı sayılır, ancak ödeme sayfası bunu Birleşik Krallık vergisi için kullanmaz. Bunun için bir `gb_vat` numarası ekleyin.
* **Boşluklar, noktalar ve tireler kaldırılır.** Bir hesapta harfler ayrıca büyük harfe çevrilir; böylece `de 123.456.789` ve `DE-123-456-789` değerlerinin ikisi de `DE123456789` olur.

Birlik dışı One Stop Shop (OSS) programı kapsamında kayıtlı olan AB dışındaki bir işletme, OSS numarasını `eu_oss_vat` olarak gönderir; örneğin `EU123456789`. Bir hesapta tek bir `eu_oss_vat` numarası, her AB ülkesinde kayıtlı olarak sayılır.

Bir hesapta Whop, bir `eu_vat` numarasını ülkesinin biçimine göre kontrol eder. Numara bir AB üye devletinin KDV önekiyle veya `XI` ile başlamalı, geri kalanı da o ülkenin verdiği uzunlukta ve karakterlerde olmalıdır. Örneğin bir Belçika numarası `BE` ve ardından `0` veya `1` ile başlayan 10 rakamdan oluşur; bu nedenle `BE123456789` reddedilir. Bir `eu_vat` numarası hangi ülkeye ait olduğunu belirtmediği için Whop eksik bir öneki eklemez.

Bir ödeme teklifinde Whop yalnızca iki harfle başlamayan ve ardından en az iki harf veya rakam gelmeyen bir numarayı reddeder.

Her iki uç nokta da `400` ile yanıt verir. Bir hesapta hata, eşleştirme yapabileceğiniz bir `code` içerir:

```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"
  }
}
```

Bir ödeme teklifinde mesaj `tax_ids.value is not a valid eu_vat registration` şeklindedir.

## Diğer vergi kimlik numarası türleri

Diğer tüm türler, yayımlanmış biçimlerindeki noktalama işaretlerini ve harf büyüklüğünü korur. Bir İsviçre UID'si `CHE-123.456.789` olarak, bir Brezilya CNPJ'si de `12.345.678/0001-00` olarak kalır. Numarayı vergi dairesinin yazdığı şekilde gönderin. Bir ödeme teklifinde boşluklar yine de kaldırılır; böylece `CHE-123.456.789 MWST`, `CHE-123.456.789MWST` olur.

Kanada'da bir `ca_gst_hst` numarası her eyalette kayıtlı olarak sayılır. `ca_qst` veya `ca_pst_bc` gibi eyalete özgü bir numara yalnızca kendi eyaletinde sayılır; tek başına bir `ca_bn` işletme numarası ise hiçbir yerde sayılmaz.

## Ülkelere göre örnekler

Bunlar, Polonya ve Kuzey İrlanda için `eu_vat` kullanan Whop kontrol panelinde gösterilen örneklerle eşleşir. [Hesabı Güncelle](https://docs.whop.com/tr/api-reference/accounts/update-account.md) referansı, kabul edilen diğer `tax_id_type` değerlerini listeler. Bir ödeme teklifi ayrıca `pl_nip` ve `xi_vat` değerlerini de kabul eder.

| Ülke | `tax_id_type` | Örnek |
| - | - | - |
| Arnavutluk | `al_tin` | `J12345678N` |
| Andorra | `ad_nrt` | `A-123456-B` |
| Angola | `ao_tin` | `1234567890` |
| Arjantin | `ar_cuit` | `20-12345678-9` |
| Ermenistan | `am_tin` | `12345678` |
| Aruba | `aw_tin` | `1234567` |
| Avustralya | `au_abn` | `12345678901` |
| Avustralya | `au_arn` | `12345678901` |
| Avusturya | `eu_vat` | `ATU12345678` |
| Azerbaycan | `az_tin` | `1234567890` |
| Bahamalar | `bs_tin` | `123456789` |
| Bahreyn | `bh_vat` | `123456789012345` |
| Bangladeş | `bd_bin` | `123456789` |
| Barbados | `bb_tin` | `1234567890` |
| Belarus | `by_tin` | `123456789` |
| Belçika | `eu_vat` | `BE0123456789` |
| Benin | `bj_ifu` | `1234567890123` |
| Bolivya | `bo_tin` | `1234567` |
| Bosna-Hersek | `ba_tin` | `1234567890123` |
| Brezilya | `br_cnpj` | `12.345.678/0001-00` |
| Brezilya | `br_cpf` | `123.456.789-00` |
| Bulgaristan | `bg_uic` | `123456789` |
| Bulgaristan | `eu_vat` | `BG123456789` |
| Burkina Faso | `bf_ifu` | `12345678901234` |
| Kamboçya | `kh_tin` | `K001-234567890` |
| Kamerun | `cm_niu` | `M012345678901A` |
| Kanada | `ca_bn` | `123456789` |
| Kanada | `ca_gst_hst` | `123456789RT0001` |
| Kanada | `ca_pst_bc` | `PST-1234-5678` |
| Kanada | `ca_pst_mb` | `123456-7` |
| Kanada | `ca_pst_sk` | `1234567` |
| Kanada | `ca_qst` | `1234567890TQ1234` |
| Yeşil Burun Adaları | `cv_nif` | `123456789` |
| Şili | `cl_tin` | `12.345.678-9` |
| Çin | `cn_tin` | `123456789012345678` |
| Kolombiya | `co_nit` | `123.456.789-0` |
| Kosta Rika | `cr_tin` | `1-234-567890` |
| Hırvatistan | `eu_vat` | `HR12345678901` |
| Hırvatistan | `hr_oib` | `12345678901` |
| Kıbrıs | `eu_vat` | `CY12345678A` |
| Çekya | `eu_vat` | `CZ12345678` |
| Kongo Demokratik Cumhuriyeti | `cd_nif` | `A1234567B` |
| Danimarka | `eu_vat` | `DK12345678` |
| Dominik Cumhuriyeti | `do_rcn` | `123-4567890-1` |
| Ekvador | `ec_ruc` | `1234567890001` |
| Mısır | `eg_tin` | `123456789` |
| El Salvador | `sv_nit` | `0614-123456-123-4` |
| Estonya | `eu_vat` | `EE123456789` |
| Etiyopya | `et_tin` | `1234567890` |
| Avrupa Birliği (Birlik dışı OSS) | `eu_oss_vat` | `EU123456789` |
| Finlandiya | `eu_vat` | `FI12345678` |
| Fransa | `eu_vat` | `FR12345678901` |
| Gürcistan | `ge_vat` | `123456789` |
| Almanya | `de_stn` | `12/345/67890` |
| Almanya | `eu_vat` | `DE123456789` |
| Gana | `gh_tin` | `C0001234567` |
| Yunanistan | `eu_vat` | `EL123456789` |
| Gine | `gn_nif` | `123456789` |
| Hong Kong | `hk_br` | `12345678` |
| Macaristan | `eu_vat` | `HU12345678` |
| Macaristan | `hu_tin` | `12345678` |
| İzlanda | `is_vat` | `123456` |
| Hindistan | `in_gst` | `22AAAAA0000A1Z5` |
| Endonezya | `id_npwp` | `12.345.678.9-012.345` |
| İrlanda | `eu_vat` | `IE1234567A` |
| İsrail | `il_vat` | `123456789` |
| İtalya | `eu_vat` | `IT12345678901` |
| Japonya | `jp_cn` | `1234-56-7890` |
| Japonya | `jp_rn` | `12345` |
| Japonya | `jp_trn` | `T1234567890123` |
| Kazakistan | `kz_bin` | `123456789012` |
| Kenya | `ke_pin` | `P000123456A` |
| Kırgızistan | `kg_tin` | `12345678` |
| Laos | `la_tin` | `1234567890` |
| Letonya | `eu_vat` | `LV12345678901` |
| Lihtenştayn | `li_uid` | `CHE-123.456.789` |
| Lihtenştayn | `li_vat` | `12345` |
| Litvanya | `eu_vat` | `LT123456789012` |
| Lüksemburg | `eu_vat` | `LU12345678` |
| Malezya | `my_frp` | `12345678` |
| Malezya | `my_itn` | `C1234567890` |
| Malezya | `my_sst` | `A12-3456-78901234` |
| Malta | `eu_vat` | `MT12345678` |
| Moritanya | `mr_nif` | `12345678` |
| Meksika | `mx_rfc` | `XAXX010101000` |
| Moldova | `md_vat` | `1234567` |
| Karadağ | `me_pib` | `12345678` |
| Fas | `ma_vat` | `12345678` |
| Nepal | `np_pan` | `123456789` |
| Hollanda | `eu_vat` | `NL123456789B01` |
| Yeni Zelanda | `nz_gst` | `123456789` |
| Nijerya | `ng_tin` | `12345678-0001` |
| Kuzey Makedonya | `mk_vat` | `MK1234567890123` |
| Kuzey İrlanda | `eu_vat` | `XI123456789` |
| Norveç | `no_vat` | `123456789MVA` |
| Norveç | `no_voec` | `1234567` |
| Umman | `om_vat` | `OM1234567890` |
| Peru | `pe_ruc` | `12345678901` |
| Filipinler | `ph_tin` | `123-456-789-000` |
| Polonya | `eu_vat` | `PL1234567890` |
| Portekiz | `eu_vat` | `PT123456789` |
| Romanya | `eu_vat` | `RO1234567890` |
| Romanya | `ro_tin` | `1234567890` |
| Rusya | `ru_inn` | `1234567890` |
| Rusya | `ru_kpp` | `123456789` |
| Suudi Arabistan | `sa_vat` | `123456789012345` |
| Senegal | `sn_ninea` | `12345678901` |
| Sırbistan | `rs_pib` | `123456789` |
| Singapur | `sg_gst` | `M12345678X` |
| Singapur | `sg_uen` | `123456789A` |
| Slovakya | `eu_vat` | `SK1234567890` |
| Slovenya | `eu_vat` | `SI12345678` |
| Slovenya | `si_tin` | `12345678` |
| Güney Afrika | `za_vat` | `4123456789` |
| Güney Kore | `kr_brn` | `123-45-67890` |
| İspanya | `es_cif` | `A12345678` |
| İspanya | `eu_vat` | `ESA12345678` |
| Surinam | `sr_fin` | `12345678` |
| İsveç | `eu_vat` | `SE123456789012` |
| İsviçre | `ch_uid` | `CHE-123.456.789` |
| İsviçre | `ch_vat` | `CHE-123.456.789 MWST` |
| Tayvan | `tw_vat` | `12345678` |
| Tacikistan | `tj_tin` | `123456789` |
| Tanzanya | `tz_vat` | `12-345-6789` |
| Tayland | `th_vat` | `1234567890123` |
| Türkiye | `tr_tin` | `1234567890` |
| Uganda | `ug_tin` | `1234567890` |
| Ukrayna | `ua_vat` | `1234567890` |
| Birleşik Arap Emirlikleri | `ae_trn` | `123456789012345` |
| Birleşik Krallık | `gb_vat` | `GB123456789` |
| Amerika Birleşik Devletleri | `us_ein` | `12-3456789` |
| Uruguay | `uy_ruc` | `123456789012` |
| Özbekistan | `uz_tin` | `123456789` |
| Özbekistan | `uz_vat` | `123456789012` |
| Venezuela | `ve_rif` | `J-12345678-9` |
| Vietnam | `vn_tin` | `1234567890` |
| Zambiya | `zm_tin` | `1234567890` |
| Zimbabve | `zw_tin` | `1234567890` |

## Sonraki adımlar

> [card] [Bir hesabı güncelleyin](https://docs.whop.com/tr/api-reference/accounts/update-account.md)
>
> Bir hesabın vergi kimlik numaralarını ve vergiyi nasıl beyan ettiğini ayarlayın.

> [card] [İşletmeler arası bir satın alma için teklif alın](https://docs.whop.com/tr/api-reference/payment-quotes/create-payment-quote.md)
>
> Bir satın almayı ücretlendirmeden önce alıcının vergi kimlik numarasıyla fiyatlandırın.


## Related topics

- [Doğrulama RFI'lerini Yönetme](https://docs.whop.com/tr/developer/verification/rfis.md)
- [Kullanıcı Kimliklerini KYC ile Doğrulayın](https://docs.whop.com/tr/developer/verification/overview.md)
- [Kimlik Profili](https://docs.whop.com/tr/api-reference/legacy/identity-profiles/identity-profile.md)
