商品税コードセレクター非公開プレビュー
連結アカウントが税コードで商品を分類できるようにします。
商品税コードセレクターコンポーネントを実装すると、連結アカウントで商品を分類できるようになります。連結アカウントは通常、プラットフォーム内の商品ページでこのコンポーネントを操作します。このコンポーネントは、ソフトウェアプラットフォームとマーケットプレイスの両方のユーザーインターフェイスへの実装に適しています。連結アカウントは、商品税コードセレクターを使用することで、各商品に適した税コードを選択できます。プラットフォームまたは連結アカウントのいずれかは税金の徴収義務を負います。
Stripe Tax と連携しているプラットフォームの場合、税金を正しく計算するには、Stripe Tax の商品税コードを指定する必要があります。
商品税コードセレクターコンポーネントは、Tax codes API を使用して、利用可能なすべての税コードを表示します。連結アカウントが新しい商品税コードを選択すると、リッスン可能なイベントハンドラが呼び出されます。これを使用して、プラットフォーム内の商品税コードを更新します。このコンポーネント内の税コードはすべて、Connect の埋め込みコンポーネントがサポートしているすべての言語に翻訳されます。
商品税コードセレクターコンポーネントを実装する
Account Session (アカウントセッション) の作成時に、components パラメーターに product_tax_code_selector を指定して、商品税コードセレクターコンポーネントを有効にします。
curl https://api.stripe.com/v1/account_sessions \
-u "sk_test_BQokikJOvBiI2HlWgH4olfQ2
アカウントセッションを作成して、Connect.js を初期化した後に、商品税コードセレクターコンポーネントをフロントエンドに表示します。
import {
ConnectProductTaxCodeSelector,
ConnectComponentsProvider,
} from "@stripe/react-connect-js";
return (
<ConnectComponentsProvider connectInstance={stripeConnectInstance}>
<div>
<h2>Tax code</h2>
<ConnectProductTaxCodeSelector
/>
</div>
</ConnectComponentsProvider>
);
| 方法 | タイプ | 説明 | デフォルト | 必須、または任意 |
|---|
setOnTaxCodeSelect | (id: string) => void | ユーザーが税コードを選択したときにその ID を指定できるコールバック関数。税コードの詳細を取得するには、税コードエンドポイントの取得を使用します。 | 未定義 | オプション |
setHideDescription | boolean | true に設定すると、商品税コードセレクターで税コードの説明が非表示になります。 | false | オプション |
setDisabled | boolean | true に設定すると、商品税コードセレクターのドロップダウンが無効になります。 | false | オプション |
setInitialTaxCode | string | txcd_10000000 など、Stripe のサポートされている税コードのいずれかに設定すると、税コードの初期値が自動的に選択されます。 | 未定義 | オプション |
早期アクセスをリクエストする Private preview
サインインするか、Stripeに登録して、このConnect組み込みコンポーネントのプレビューへのアクセスをリクエストします。
参照情報