# 商品税コードセレクター

連結アカウントが税コードで商品を分類できるようにします。

商品税コードセレクターコンポーネントを実装すると、連結アカウントで商品を分類できるようになります。連結アカウントは通常、プラットフォーム内の商品ページでこのコンポーネントを操作します。このコンポーネントは、[ソフトウェアプラットフォーム](https://docs.stripe.com/tax/tax-for-platforms.md)と[マーケットプレイス](https://docs.stripe.com/tax/tax-for-marketplaces.md)の両方のユーザーインターフェイスへの実装に適しています。連結アカウントは、商品税コードセレクターを使用することで、各商品に適した税コードを選択できます。プラットフォームまたは連結アカウントのいずれかは税金の徴収義務を負います。

Stripe Tax と連携しているプラットフォームの場合、税金を正しく計算するには、Stripe Tax の商品税コードを指定する必要があります。

商品税コードセレクターコンポーネントは、[Tax codes API](https://docs.stripe.com/api/tax_codes.md) を使用して、利用可能なすべての税コードを表示します。連結アカウントが新しい商品税コードを選択すると、リッスン可能なイベントハンドラが呼び出されます。これを使用して、プラットフォーム内の商品税コードを更新します。このコンポーネント内の税コードはすべて、[Connect の埋め込みコンポーネントがサポートしているすべての言語](https://docs.stripe.com/connect/get-started-connect-embedded-components.md?platform=web#localization)に翻訳されます。

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

## 商品税コードセレクターコンポーネントを実装する

[Account Session (アカウントセッション)](https://docs.stripe.com/api/account_sessions/create.md) の作成時に、`components` パラメーターに `product_tax_code_selector` を指定して、商品税コードセレクターコンポーネントを有効にします。

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview; embedded_connect_beta=v2;" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[product_tax_code_selector][enabled]=true"
```

アカウントセッションを作成して、[Connect.js を初期化](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions)した後に、商品税コードセレクターコンポーネントをフロントエンドに表示します。

#### React

```jsx
// Include this React component
import {
  ConnectProductTaxCodeSelector,
  ConnectComponentsProvider,
} from "@stripe/react-connect-js";

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      <h2>Tax code</h2>
      <ConnectProductTaxCodeSelector
        // Optional
        // onTaxCodeSelect={(id: string | null, {analyticsName: string} | null) => {console.log({id, analyticsName})}}
        // hideDescription={false}
        // disabled={false}
        // initialTaxCode={"txcd_99999999"}
       />
    </div>
  </ConnectComponentsProvider>
);
```

#### HTML + JS

| 方法                   | タイプ                                                           | 説明                                                                                                                                                                                                                | デフォルト | 必須、または任意 |
| -------------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | -------- |
| `setOnTaxCodeSelect` | `(id: string | null, {analyticsName: string} | null) => void` | ユーザーが税務コードを選択したときに、ID と税務コードの名前を受け取るコールバック関数。ユーザーが選択を解除した場合は `null`。`analyticsName` フィールドの値は変更または削除される可能性があるため、分析の目的にのみ使用します。税務コードの詳細については、[税務コードの取得](https://docs.stripe.com/api/tax_codes/retrieve.md) を呼び出します。 | 未定義   | オプション    |
| `setHideDescription` | `boolean`                                                     | true に設定すると、商品税コードセレクターで税コードの説明が非表示になります。                                                                                                                                                                         | false | オプション    |
| `setDisabled`        | `boolean`                                                     | true に設定すると、商品税コードセレクターのドロップダウンが無効になります。                                                                                                                                                                          | false | オプション    |
| `setInitialTaxCode`  | `string`                                                      | `txcd_10000000` など、Stripe の[サポートされている税コード](https://docs.stripe.com/tax/tax-codes.md)のいずれかに設定すると、税コードの初期値が自動的に選択されます。                                                                                              | 未定義   | オプション    |

#### React

| React プロパティ       | タイプ                                                           | 説明                                                                                                                                                                                                                | デフォルト | 必須、または任意 |
| ----------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | -------- |
| `onTaxCodeSelect` | `(id: string | null, {analyticsName: string} | null) => void` | ユーザーが税務コードを選択したときに、ID と税務コードの名前を受け取るコールバック関数。ユーザーが選択を解除した場合は `null`。`analyticsName` フィールドの値は変更または削除される可能性があるため、分析の目的にのみ使用します。税務コードの詳細については、[税務コードの取得](https://docs.stripe.com/api/tax_codes/retrieve.md) を呼び出します。 | 未定義   | オプション    |
| `hideDescription` | `boolean`                                                     | true に設定すると、商品税コードセレクターで税コードの説明が非表示になります。                                                                                                                                                                         | false | オプション    |
| `disabled`        | `boolean`                                                     | true に設定すると、商品税コードセレクターのドロップダウンが無効になります。                                                                                                                                                                          | false | オプション    |
| `initialTaxCode`  | `string`                                                      | `txcd_10000000` など、Stripe の[サポートされている税コード](https://docs.stripe.com/tax/tax-codes.md)のいずれかに設定すると、税コードの初期値が自動的に選択されます。                                                                                              | 未定義   | オプション    |

## 早期アクセスをリクエストする (Private preview)

サインインするか、[Stripeに登録](https://dashboard.stripe.com/register)して、このConnect組み込みコンポーネントのプレビューへのアクセスをリクエストします。

## See also

- [Connect での Tax](https://docs.stripe.com/tax/connect.md)
- [ソフトウェアプラットフォームのための Tax](https://docs.stripe.com/tax/tax-for-platforms.md)
- [マーケットプレイスのための Tax](https://docs.stripe.com/tax/tax-for-marketplaces.md)