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

# 세금 ID

> Whop이 VAT, GST 및 기타 세금 등록 번호를 수락하고 세금에 적용할 수 있도록 형식을 맞추세요.

세금 ID는 세무 당국이 사업체에 발급하는 등록 번호입니다. `eu_vat`나 `gb_vat` 같은 `tax_id_type`과 번호 자체를 함께 보냅니다. 세금 ID는 두 곳에서 보냅니다. 계정에서는 세금 ID가 해당 국가에 사업체가 세금 등록되어 있음을 기록하기도 합니다. 결제 견적에서는 구매자의 세금 ID로 기업 구매 가격을 책정합니다. 이 페이지에서는 각 유형이 요구하는 형식, 보낸 번호에서 Whop이 변경하는 사항, 그리고 거부하는 항목을 다룹니다. Whop 판매에 대해 누가 세금을 징수하고 납부하는지는 [세금](https://docs.whop.com/ko/payments-and-billing/fees/taxes.md)을 참고하세요.

> [!NOTE]
>
> 모든 EU 회원국은 `eu_vat` 유형을 공유합니다. Whop은 번호의 처음 두 글자로 국가를 판단하므로, EU 국가의 VAT 번호는 반드시 해당 국가 코드로 시작해야 합니다.

| | 계정 세금 ID | 구매자 세금 ID |
| - | - | - |
| **필드** | [Update Account](https://docs.whop.com/ko/api-reference/accounts/update-account.md)의 `tax_identifiers` | [Create Payment Quote](https://docs.whop.com/ko/api-reference/payment-quotes/create-payment-quote.md)의 `tax_ids` |
| **역할** | 사업체가 세금 등록된 곳을 기록합니다. 사업체가 직접 세금을 납부하는 경우, Whop은 미국 외 지역에서는 계정에 세금 ID가 있는 국가에서만 세금을 징수합니다. 미국 징수는 `tax_collection_enabled_states`를 따릅니다. | EU 역과세처럼 해당되는 경우 구매를 기업 간 거래로 가격 책정합니다. |
| **개수** | `tax_id_type`당 하나. | 견적당 하나. |
| **형식** | `eu_vat`: 공백, 마침표, 대시가 제거되고, 문자는 대문자로 변환되며, 앞의 `GR`은 `EL`로 변경됩니다. 기타 유형: 보낸 그대로 저장됩니다. | `eu_vat`: 공백, 마침표, 대시가 제거됩니다. Whop은 보낸 대소문자와 접두사를 유지합니다. 기타 유형: 공백이 제거됩니다. |

## 계정에 세금 ID 추가

각 세금 ID를 `tax_id_type`과 `tax_id_value`로 보내세요. Whop은 아래의 `DE 123.456.789`를 `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"}],
)
```

계정은 `tax_id_type`당 하나의 세금 ID를 보유합니다. 계정에 이미 있는 유형을 보내면 두 번째 세금 ID가 추가되는 대신 기존 값이 교체됩니다. 모든 EU 국가는 `eu_vat`를 공유하므로, 계정은 EU 전체에 대해 하나의 VAT 번호를 보유합니다.

## `eu_vat` 유형

`eu_vat` 번호는 이를 발급한 회원국의 두 글자 코드로 시작하고 그 뒤에 국가 번호가 옵니다.

* **그리스는 `GR`이 아닌 `EL`을 사용합니다**: `EL123456789`. 계정에서는 `GR`로 보낸 번호가 `EL`로 저장됩니다. 결제 견적에서는 직접 `EL`을 보내세요.
* **북아일랜드는 `eu_vat` 유형과 함께 `XI`를 사용합니다**: `XI123456789`. 계정에서 `XI` 번호는 영국 내 사업체 등록으로 간주되지만, 체크아웃에서는 영국 세금에 사용하지 않습니다. 이를 위해서는 `gb_vat` 번호를 추가하세요.
* **공백, 마침표, 대시는 제거됩니다.** 계정에서는 문자도 대문자로 변환되므로, `de 123.456.789`와 `DE-123-456-789`는 모두 `DE123456789`가 됩니다.

비EU 원스톱숍(OSS) 제도에 등록된 EU 외 사업체는 OSS 번호를 `eu_oss_vat`로 보냅니다(예: `EU123456789`). 계정에서 하나의 `eu_oss_vat` 번호는 모든 EU 국가에 등록된 것으로 간주됩니다.

계정에서 Whop은 `eu_vat` 번호를 해당 국가의 형식과 대조합니다. 번호는 EU 회원국의 VAT 접두사 또는 `XI`로 시작해야 하며, 나머지는 해당 국가가 발급하는 길이와 문자여야 합니다. 예를 들어 벨기에 번호는 `BE` 뒤에 `0` 또는 `1`로 시작하는 10자리 숫자가 오므로 `BE123456789`는 거부됩니다. `eu_vat` 번호만으로는 어느 국가의 번호인지 알 수 없으므로, Whop은 누락된 접두사를 추가하지 않습니다.

결제 견적에서 Whop은 두 글자 뒤에 최소 두 개의 문자나 숫자가 오지 않는 번호만 거부합니다.

두 엔드포인트 모두 `400`으로 응답합니다. 계정에서는 오류에 일치 여부를 확인할 수 있는 `code`가 포함됩니다:

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

결제 견적에서는 메시지가 `tax_ids.value is not a valid eu_vat registration`입니다.

## 기타 세금 ID 유형

다른 모든 유형은 공개된 형식의 구두점과 대소문자를 유지합니다. 스위스 UID는 `CHE-123.456.789`로, 브라질 CNPJ는 `12.345.678/0001-00`으로 유지됩니다. 세무 당국이 표기하는 방식 그대로 번호를 보내세요. 결제 견적에서는 공백이 여전히 제거되므로 `CHE-123.456.789 MWST`는 `CHE-123.456.789MWST`가 됩니다.

캐나다에서 `ca_gst_hst` 번호는 모든 주에 등록된 것으로 간주됩니다. `ca_qst`나 `ca_pst_bc` 같은 주별 번호는 해당 주에서만 인정되며, `ca_bn` 사업자 번호 단독으로는 어디에서도 인정되지 않습니다.

## 국가별 예시

이 예시는 Whop 대시보드에 표시되는 예시와 일치하며, 대시보드는 폴란드와 북아일랜드에 `eu_vat`를 사용합니다. [Update Account](https://docs.whop.com/ko/api-reference/accounts/update-account.md) 레퍼런스에 허용되는 다른 `tax_id_type` 값이 나열되어 있습니다. 결제 견적은 `pl_nip`와 `xi_vat`도 허용합니다.

| 국가 | `tax_id_type` | 예시 |
| - | - | - |
| 알바니아 | `al_tin` | `J12345678N` |
| 안도라 | `ad_nrt` | `A-123456-B` |
| 앙골라 | `ao_tin` | `1234567890` |
| 아르헨티나 | `ar_cuit` | `20-12345678-9` |
| 아르메니아 | `am_tin` | `12345678` |
| 아루바 | `aw_tin` | `1234567` |
| 호주 | `au_abn` | `12345678901` |
| 호주 | `au_arn` | `12345678901` |
| 오스트리아 | `eu_vat` | `ATU12345678` |
| 아제르바이잔 | `az_tin` | `1234567890` |
| 바하마 | `bs_tin` | `123456789` |
| 바레인 | `bh_vat` | `123456789012345` |
| 방글라데시 | `bd_bin` | `123456789` |
| 바베이도스 | `bb_tin` | `1234567890` |
| 벨라루스 | `by_tin` | `123456789` |
| 벨기에 | `eu_vat` | `BE0123456789` |
| 베냉 | `bj_ifu` | `1234567890123` |
| 볼리비아 | `bo_tin` | `1234567` |
| 보스니아 헤르체고비나 | `ba_tin` | `1234567890123` |
| 브라질 | `br_cnpj` | `12.345.678/0001-00` |
| 브라질 | `br_cpf` | `123.456.789-00` |
| 불가리아 | `bg_uic` | `123456789` |
| 불가리아 | `eu_vat` | `BG123456789` |
| 부르키나파소 | `bf_ifu` | `12345678901234` |
| 캄보디아 | `kh_tin` | `K001-234567890` |
| 카메룬 | `cm_niu` | `M012345678901A` |
| 캐나다 | `ca_bn` | `123456789` |
| 캐나다 | `ca_gst_hst` | `123456789RT0001` |
| 캐나다 | `ca_pst_bc` | `PST-1234-5678` |
| 캐나다 | `ca_pst_mb` | `123456-7` |
| 캐나다 | `ca_pst_sk` | `1234567` |
| 캐나다 | `ca_qst` | `1234567890TQ1234` |
| 카보베르데 | `cv_nif` | `123456789` |
| 칠레 | `cl_tin` | `12.345.678-9` |
| 중국 | `cn_tin` | `123456789012345678` |
| 콜롬비아 | `co_nit` | `123.456.789-0` |
| 코스타리카 | `cr_tin` | `1-234-567890` |
| 크로아티아 | `eu_vat` | `HR12345678901` |
| 크로아티아 | `hr_oib` | `12345678901` |
| 키프로스 | `eu_vat` | `CY12345678A` |
| 체코 | `eu_vat` | `CZ12345678` |
| 콩고민주공화국 | `cd_nif` | `A1234567B` |
| 덴마크 | `eu_vat` | `DK12345678` |
| 도미니카 공화국 | `do_rcn` | `123-4567890-1` |
| 에콰도르 | `ec_ruc` | `1234567890001` |
| 이집트 | `eg_tin` | `123456789` |
| 엘살바도르 | `sv_nit` | `0614-123456-123-4` |
| 에스토니아 | `eu_vat` | `EE123456789` |
| 에티오피아 | `et_tin` | `1234567890` |
| 유럽연합(비EU OSS) | `eu_oss_vat` | `EU123456789` |
| 핀란드 | `eu_vat` | `FI12345678` |
| 프랑스 | `eu_vat` | `FR12345678901` |
| 조지아 | `ge_vat` | `123456789` |
| 독일 | `de_stn` | `12/345/67890` |
| 독일 | `eu_vat` | `DE123456789` |
| 가나 | `gh_tin` | `C0001234567` |
| 그리스 | `eu_vat` | `EL123456789` |
| 기니 | `gn_nif` | `123456789` |
| 홍콩 | `hk_br` | `12345678` |
| 헝가리 | `eu_vat` | `HU12345678` |
| 헝가리 | `hu_tin` | `12345678` |
| 아이슬란드 | `is_vat` | `123456` |
| 인도 | `in_gst` | `22AAAAA0000A1Z5` |
| 인도네시아 | `id_npwp` | `12.345.678.9-012.345` |
| 아일랜드 | `eu_vat` | `IE1234567A` |
| 이스라엘 | `il_vat` | `123456789` |
| 이탈리아 | `eu_vat` | `IT12345678901` |
| 일본 | `jp_cn` | `1234-56-7890` |
| 일본 | `jp_rn` | `12345` |
| 일본 | `jp_trn` | `T1234567890123` |
| 카자흐스탄 | `kz_bin` | `123456789012` |
| 케냐 | `ke_pin` | `P000123456A` |
| 키르기스스탄 | `kg_tin` | `12345678` |
| 라오스 | `la_tin` | `1234567890` |
| 라트비아 | `eu_vat` | `LV12345678901` |
| 리히텐슈타인 | `li_uid` | `CHE-123.456.789` |
| 리히텐슈타인 | `li_vat` | `12345` |
| 리투아니아 | `eu_vat` | `LT123456789012` |
| 룩셈부르크 | `eu_vat` | `LU12345678` |
| 말레이시아 | `my_frp` | `12345678` |
| 말레이시아 | `my_itn` | `C1234567890` |
| 말레이시아 | `my_sst` | `A12-3456-78901234` |
| 몰타 | `eu_vat` | `MT12345678` |
| 모리타니 | `mr_nif` | `12345678` |
| 멕시코 | `mx_rfc` | `XAXX010101000` |
| 몰도바 | `md_vat` | `1234567` |
| 몬테네그로 | `me_pib` | `12345678` |
| 모로코 | `ma_vat` | `12345678` |
| 네팔 | `np_pan` | `123456789` |
| 네덜란드 | `eu_vat` | `NL123456789B01` |
| 뉴질랜드 | `nz_gst` | `123456789` |
| 나이지리아 | `ng_tin` | `12345678-0001` |
| 북마케도니아 | `mk_vat` | `MK1234567890123` |
| 북아일랜드 | `eu_vat` | `XI123456789` |
| 노르웨이 | `no_vat` | `123456789MVA` |
| 노르웨이 | `no_voec` | `1234567` |
| 오만 | `om_vat` | `OM1234567890` |
| 페루 | `pe_ruc` | `12345678901` |
| 필리핀 | `ph_tin` | `123-456-789-000` |
| 폴란드 | `eu_vat` | `PL1234567890` |
| 포르투갈 | `eu_vat` | `PT123456789` |
| 루마니아 | `eu_vat` | `RO1234567890` |
| 루마니아 | `ro_tin` | `1234567890` |
| 러시아 | `ru_inn` | `1234567890` |
| 러시아 | `ru_kpp` | `123456789` |
| 사우디아라비아 | `sa_vat` | `123456789012345` |
| 세네갈 | `sn_ninea` | `12345678901` |
| 세르비아 | `rs_pib` | `123456789` |
| 싱가포르 | `sg_gst` | `M12345678X` |
| 싱가포르 | `sg_uen` | `123456789A` |
| 슬로바키아 | `eu_vat` | `SK1234567890` |
| 슬로베니아 | `eu_vat` | `SI12345678` |
| 슬로베니아 | `si_tin` | `12345678` |
| 남아프리카공화국 | `za_vat` | `4123456789` |
| 대한민국 | `kr_brn` | `123-45-67890` |
| 스페인 | `es_cif` | `A12345678` |
| 스페인 | `eu_vat` | `ESA12345678` |
| 수리남 | `sr_fin` | `12345678` |
| 스웨덴 | `eu_vat` | `SE123456789012` |
| 스위스 | `ch_uid` | `CHE-123.456.789` |
| 스위스 | `ch_vat` | `CHE-123.456.789 MWST` |
| 대만 | `tw_vat` | `12345678` |
| 타지키스탄 | `tj_tin` | `123456789` |
| 탄자니아 | `tz_vat` | `12-345-6789` |
| 태국 | `th_vat` | `1234567890123` |
| 튀르키예 | `tr_tin` | `1234567890` |
| 우간다 | `ug_tin` | `1234567890` |
| 우크라이나 | `ua_vat` | `1234567890` |
| 아랍에미리트 | `ae_trn` | `123456789012345` |
| 영국 | `gb_vat` | `GB123456789` |
| 미국 | `us_ein` | `12-3456789` |
| 우루과이 | `uy_ruc` | `123456789012` |
| 우즈베키스탄 | `uz_tin` | `123456789` |
| 우즈베키스탄 | `uz_vat` | `123456789012` |
| 베네수엘라 | `ve_rif` | `J-12345678-9` |
| 베트남 | `vn_tin` | `1234567890` |
| 잠비아 | `zm_tin` | `1234567890` |
| 짐바브웨 | `zw_tin` | `1234567890` |

## 다음 단계

> [card] [계정 업데이트](https://docs.whop.com/ko/api-reference/accounts/update-account.md)
>
> 계정의 세금 ID와 세금 납부 방식을 설정하세요.

> [card] [기업 구매 견적](https://docs.whop.com/ko/api-reference/payment-quotes/create-payment-quote.md)
>
> 청구하기 전에 구매자의 세금 ID로 구매 가격을 책정하세요.


## Related topics

- [인증 RFI 처리하기](https://docs.whop.com/ko/developer/verification/rfis.md)
- [TaxIdElement](https://docs.whop.com/ko/elements/latest/payments/taxId.md)
- [Variants API](https://docs.whop.com/ko/api-reference/variants/variant.md)
