# 納税者番号 Element

請求書と VAT 還付のために事業者納税者番号を収集します。

納税者番号 Element は、顧客の納税者番号情報を収集する埋め込み可能な UI コンポーネントです。納税者番号 Element は、[Checkout Sessions API](https://docs.stripe.com/payments/quickstart-checkout-sessions.md) のある Elements または [Payment Intents API](https://docs.stripe.com/payments/payment-intents.md) のいずれかの組み込みで使用できます。

納税者番号 Element を導入する方法の詳細については、選択したアプローチの導入ガイドを参照してください。

- [Checkout Sessions API 導入ガイド](https://docs.stripe.com/payments/advanced/tax.md?api-integration=checkout#render-tax-id-element)
- [Payment Intents API 導入ガイド](https://docs.stripe.com/tax/payment-intent/tax-ids.md)

デモが表示されない場合は、このページをサポート対象のブラウザで表示してみてください。

| オプション               | 説明                                                                                                                  |
| ------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **テーマ**             | ドロップダウンを使用してテーマを選択するか、[Elements Appearance API](https://docs.stripe.com/elements/appearance-api.md) でテーマをカスタマイズします。 |
| **デスクトップとモバイルのサイズ** | ドロップダウンを使用して、納税者番号 Element をマウントする親要素の最大ピクセル幅を設定します。750px (デスクトップ) または 320px (モバイル) に設定できます。                        |
| **顧客の住所**           | ドロップダウンを使用して、納税者番号情報を収集する所在地を選択します。所在地を変更すると、納税者番号のタイプと形式の要件が更新され、自動モードでの要素の表示が制御されます。                              |
| **可視性**             | ドロップダウンを使用して、表示モードを選択します。自動モードでは、納税者番号 Element は納税者番号回収をサポートする国の場合にのみ表示されます。                                        |
| **ビジネス名**           | ビジネス名を収集するには、このオプションを有効にします。収集したビジネス名は、請求書に顧客名として表示されます。                                                            |

## 対応可能な地域

納税者番号 Element は、以下の国と地域での納税者番号回収に対応しています。自動モードを使用する場合、Element は、これらのサポート対象地域の顧客に対してのみ自動的に表示されます。地域ごとに納税者番号の種類と形式要件が異なります。

### 北アメリカ

- AW
- BB
- BS
- CA
- CR
- MX

### 南米

- CL
- EC
- PE
- SR
- UY

### ヨーロッパ

- AL
- AM
- AT
- AZ
- BA
- BE
- BG
- BY
- CH
- CY
- CZ
- DE
- DK
- EE
- ES
- FI
- FR
- GB
- GE
- GR
- HR
- HU
- IE
- IS
- IT
- LI
- LT
- LU
- LV
- MD
- ME
- MK
- MT
- NL
- NO
- PL
- PT
- RO
- RS
- RU
- SE
- SI
- SK
- UA

### アジア

- AE
- BD
- BH
- IN
- KG
- KH
- KR
- KZ
- LA
- NP
- OM
- PH
- SA
- SG
- TH
- TJ
- TR
- TW
- UZ

### オセアニア

- AU
- NZ

### アフリカ

- AO
- BF
- BJ
- CD
- CM
- CV
- EG
- ET
- GN
- KE
- MA
- MR
- NG
- SN
- TZ
- UG
- ZA
- ZM
- ZW

納税者番号 Element と [Address Element](https://docs.stripe.com/elements/address-element.md) を一緒に使用すると、Stripe は顧客の住所に基づいて納税者番号のタイプと Element の表示を自動的に判別します。これにより、顧客の所在地に正しい納税者番号形式が表示されます。

## Tax ID Element の表示

Tax ID を集める理由はいくつかありますが、最も一般的な理由は売上税の計算や請求書への記載が必要だからです。

Tax ID Element は、デフォルトでは顧客の住所に合わせて表示が調整され、その国で納税者番号の収集が一般的である場合にのみ表示されます。納税者番号が関連するかどうかを判断するため、Tax ID Element は、顧客の IP アドレスと、[住所入力要素](https://docs.stripe.com/elements/address-element.md)から得られる国情報 (配送モードまたは請求モードのいずれか) をチェックします。住所入力要素が存在しない場合は、顧客の IP アドレスを使用します。(納税者番号の収集が一般的でない国に対しても) 必ず Tax ID Element を表示させたい場合は、表示設定を `always` に設定できます。

## Tax ID Element の作成

# Checkout Sessions API

> This is a Checkout Sessions API for when payment-ui is embedded-components. View the full page at https://docs.stripe.com/elements/tax-id-element?payment-ui=embedded-components.

Checkout Sessions API で[納税者番号 Element](https://docs.stripe.com/js/custom_checkout/create_tax_id_element) を使用して納税者番号を回収する方法は次のとおりです。

```html
<div class="tax-id-form">
  <div id="tax-id-element"></div>
</div>
```

```javascript
const stripe = window.Stripe('<<YOUR_PUBLISHABLE_KEY>>', {
  betas: [
    'custom_checkout_tax_id_1',
  ],
});
const appearance = { /* appearance */ };
const elementsOptions = { appearance };

const clientSecret = fetch('/create-checkout-session', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
  })
    .then((res) => res.json())
    .then((res) => {
      return res.clientSecret;
    });

const checkout = stripe.initCheckoutElementsSdk({
  clientSecret,
  elementsOptions
});

const taxIdElementOptions = {
  visibility: 'always',
};
const taxIdElement = checkout.createTaxIdElement(taxIdElementOptions);
taxIdElement.mount('#tax-id-element');
```

Checkout Sessions での納税者番号 Element の使用の詳細については、[Checkout Sessions 導入ガイド](https://docs.stripe.com/tax/checkout/tax-ids.md#enable-tax-id-collection)を参照してください。


# Payment Intents API

> This is a Payment Intents API for when payment-ui is elements. View the full page at https://docs.stripe.com/elements/tax-id-element?payment-ui=elements.

Payment Intents APIで[納税者番号 Element](https://docs.stripe.com/js/elements_object/create_tax_id_element) を使用して納税者番号を回収する方法は次のとおりです。

```html
<div class="tax-id-form">
  <div id="tax-id-element"></div>
</div>
```

```javascript
const stripe = window.Stripe('<<YOUR_PUBLISHABLE_KEY>>', {
  betas: [
    'elements_tax_id_1',
  ],
});

// Create a PaymentIntent on your server
const {clientSecret} = await fetch('/create-payment-intent', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
}).then((res) => res.json());

const appearance = { /* appearance */ };
const elements = stripe.elements({
  clientSecret,
  appearance
});

const taxIdElementOptions = {
  visibility: 'always',
};
const taxIdElement = elements.create('taxId', taxIdElementOptions);
taxIdElement.mount('#tax-id-element');
```

納税者番号を保存して再表示するには、[CustomerSession](https://docs.stripe.com/api/customer_sessions.md) を作成する必要があります。Payment Intents API で Tax ID Element を使用する方法の詳細については、[導入ガイド](https://docs.stripe.com/tax/payment-intent/tax-ids.md)を参照してください。