納税者番号 Element公開プレビュー

Tax ID Element は、顧客の納税者番号情報を収集する組み込み可能な UI コンポーネントです。Tax ID Element を有効にする方法の詳細については、導入ガイドを参照してください。

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

対応可能な地域

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

納税者番号 Element と Address Element を一緒に使用すると、Stripe は顧客の住所に基づいて納税者番号のタイプと Element の表示を自動的に判別します。これにより、顧客の所在地に正しい納税者番号形式が表示されます。

Tax ID Element の表示

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

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

Tax ID Element の作成

ここでは、Stripe 納税者番号 Element を使用して Tax ID を集める方法をご説明します。

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

const stripe = window.Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx', {
  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.initCheckout({
  clientSecret,
  elementsOptions
});

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

納税者番号 Element の使用の詳細については、導入ガイドを参照してください。