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

納税者番号 Element は、顧客の納税者番号情報を収集する埋め込み可能な UI コンポーネントです。納税者番号 Element は、Checkout Sessions API のある Elements または Payment Intents API のいずれかの組み込みで使用できます。

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

• Checkout Sessions API 導入ガイド
• Payment Intents API 導入ガイド

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

対応可能な地域

納税者番号 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 の作成

<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');