コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要
アカウント管理
アカウントのダッシュボードを設定する
決済処理
プラットフォーム管理

商品税コードセレクター非公開プレビュー

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

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

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

商品税コードセレクターコンポーネントは、Tax codes API を使用して、利用可能なすべての税コードを表示します。連結アカウントが新しい商品税コードを選択すると、リッスン可能なイベントハンドラが呼び出されます。これを使用して、プラットフォーム内の商品税コードを更新します。このコンポーネント内の税コードはすべて、Connect の埋め込みコンポーネントがサポートしているすべての言語に翻訳されます。

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

Account Session (アカウントセッション) の作成時に、components パラメーターに product_tax_code_selector を指定して、商品税コードセレクターコンポーネントを有効にします。

Command Line
cURL
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-12-15.clover; embedded_connect_beta=v2;" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[product_tax_code_selector][enabled]"=true

アカウントセッションを作成して、Connect.js を初期化した後に、商品税コードセレクターコンポーネントをフロントエンドに表示します。

productPage.jsx
React
HTML + JavaScript
No results
// 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>
);
方法タイプ説明デフォルト必須、または任意
setOnTaxCodeSelect(id: string | null, {analyticsName: string} | null) => voidユーザーが税務コードを選択したときに、ID と税務コードの名前を受け取るコールバック関数。ユーザーが選択を解除した場合は null。analyticsName フィールドの値は変更または削除される可能性があるため、分析の目的にのみ使用します。税務コードの詳細については、税務コードの取得 を呼び出します。未定義オプション
setHideDescriptionbooleantrue に設定すると、商品税コードセレクターで税コードの説明が非表示になります。falseオプション
setDisabledbooleantrue に設定すると、商品税コードセレクターのドロップダウンが無効になります。falseオプション
setInitialTaxCodestringtxcd_10000000 など、Stripe のサポートされている税コードのいずれかに設定すると、税コードの初期値が自動的に選択されます。未定義オプション

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

サインインするか、Stripeに登録して、このConnect組み込みコンポーネントのプレビューへのアクセスをリクエストします。

参照情報