コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments
決済手段
支払いインターフェイス
決済シナリオ
店頭支払い
決済にとどまらない機能

Checkout で顧客の納税者番号を収集する

Checkout で VAT などの顧客の納税者番号を収集する方法をご紹介します。

顧客の納税者番号と法人名を請求書に表示することは一般的な要件であり、この要件を満たすには、Checkout で納税番号の収集を有効にします。このガイドでは、すでに Checkout が導入されていることを前提としています。まだ導入されていない場合は、支払いの受け付けに関するガイドをご覧ください。

納税者番号の収集を有効にする

納税者番号の収集が有効になっていると、Checkout は、顧客の場所に応じて納税者番号収集フォームの表示と非表示を切り替えます。納税者番号収集で対応できる場所に顧客が所在する場合は、顧客が業務上の購入であることを指定できるチェックボックスが表示されます。顧客がこのボックスをチェックすると、顧客企業の納税者番号と正式名称を入力するフィールドが表示されます。顧客の配送先住所が使用できる場合には、Checkout はその住所を使用して顧客の所在地を判断します。配送先住所がない場合は、顧客の請求先住所が使用されます。顧客が入力できる納税者番号は 1 つのみです。

新規顧客

新規顧客の納税者番号の収集を有効にするには、Checkout セッションを作成する際に、tax_id_collection[enabled] を true に設定します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][unit_amount]"=1000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=eur \
  -d "line_items[0][quantity]"=2 \
  -d "tax_id_collection[enabled]"=true \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

この例では、payment モードで納税者番号の収集が有効化されたセッションを作成します。サブスクリプションの場合は、mode を subscription に設定して同じ変更を行います。

Checkout をさらに設定して、customer_creation を使用するための Customer を新規で作成することもできます。この場合、Checkout はセッション中に収集された納税者番号情報をその新しい Customer に保存します。それ以外の場合、納税者番号情報を引き続き customer_details.tax_ids で利用できます。

既存の顧客

セッションの作成時に既存の顧客を渡すと、Checkout はセッションで収集された納税番号情報を使用してその顧客を更新します。収集された企業名が顧客の name プロパティに保存され、収集された納税者番号が顧客の customer.tax_ids 配列に追加されます。企業名を収集することにより顧客の既存の Name (名前) オブジェクトが上書きされる可能性があるため、セッション作成時に customer_update.name を auto に設定する必要があります。

注意

Checkout は、既存の納税者番号をまだ持っていない顧客の納税者番号のみを収集します。顧客が 1 つ以上の納税者番号を保存している場合、納税者番号の収集が有効になっていても、Checkout は納税者番号の収集フォームを表示しません。

既存の顧客の納税者番号を収集する場合は、顧客に既存の住所、または決済時に入力された住所に基づいて顧客の所在地を判断できます。デフォルトの場合、Checkout は顧客の既存の住所を調べて、所在地を探します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "line_items[0][price_data][unit_amount]"=1000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=eur \
  -d "line_items[0][quantity]"=2 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

既存の顧客に住所の保存を求めていない場合、決済時に入力された請求先住所や配送先住所から所在地を判定できます。顧客の所在地の判定に決済時に入力された請求先住所を使用するように指定するには、customer_update.address を auto に設定する必要があります。customer_update.address を auto に設定すると、Checkout では、以前に顧客に保存された住所がセッション中に入力された住所に置き換えられます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "line_items[0][price_data][unit_amount]"=1000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=eur \
  -d "line_items[0][quantity]"=2 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d "customer_update[address]"=auto \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

既存の顧客の配送先住所を収集している場合、顧客の住所の判断に決済時に入力された配送先住所を使用する必要があります。これを行うには、customer_update.shipping を auto に設定します。customer_update.shipping を auto に設定すると、Checkout では、以前に顧客に保存された配送先住所がセッション中に入力された配送先住所に置き換えられます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=cus_HQmikpKnGHkNwW \
  -d "line_items[0][price_data][unit_amount]"=1000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=eur \
  -d "line_items[0][quantity]"=2 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d "customer_update[shipping]"=auto \
  -d "shipping_address_collection[allowed_countries][0]"=DE \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

上記のコードサンプルでは、payment モードで納税者番号の収集が有効化されたセッションを作成します。サブスクリプションの場合は、mode を subscription に設定して同じ変更を行います。

セッション後に顧客の納税者番号の詳細を取得する

Checkout は、生成された Session (セッション) オブジェクトに提供された納税者番号を含めます。各セッションの完了後に、Checkout は checkout.session.completed イベントを送信します。これは Webhook エンドポイントでリッスンできます。納税者番号を Session オブジェクトから取得する場合は、セッションの customer_details.tax_ids 配列から取得できます。

{
  "object": {
    "id": "cs_test_a1dJwt0TCJTBsDkbK7RcoyJ91vJxe2Y",
    "object": "checkout.session",
    ...
    "customer": "cus_id_of_new_customer",
    "customer_details": {
      ...
      "tax_ids": [
        {
          "type": "eu_vat",
          "value": "FRAB123456789"
        }
      ]
    },
    ...
    "tax_id_collection": {
      "enabled": true
    },
    ...
  }
}

Checkout はさらに、セッションに Customer (顧客) オブジェクトが関連付けられている場合、収集された納税者番号と企業名をこのオブジェクトに保存します。決済時に収集された納税者番号は、Customer の customer.tax_ids 配列からアクセスできます。また、owner.type パラメーターを customer に、owner.customer を Customer’s ID に指定することで、Customer に保存されたすべての納税者番号を Tax ID リソースで取得することもできます。新しい納税者番号のすべてに関連付けられている企業の正式名称が含まれ、Checkout はそれを顧客の name プロパティに保存します。このようにすることで、収集された法人名がその顧客のサブスクリプションの請求書に常に表示されることになります。

実装内容をテストする

テスト環境では、サポートされている納税者番号タイプの正しい形式で英数字の文字列を入力できます (eu_vat の場合は DE123456789 など)。納税者番号のサンプルの一覧については、Stripe の顧客の納税者番号に関するガイドをご覧ください。また、テスト用納税者番号を使用して、さまざまな確認ステータスのフローをテストすることもできます。

検証

Checkout セッションの際に、Stripe は入力された納税者番号が正しい形式であること (有効かどうかではなく) を確認します。決済時に収集された顧客情報の有効性を確保する責任はお客様にあります。そのサポートとして、Stripe ではヨーロッパの付加価値税 (EU VAT) およびイギリスの付加価値税 (GB VAT) 番号を、政府データベースと照らし合わせる非同期の検証を自動的に行います。Stripe が実行する検証の詳細、およびそれらの検証のステータスを使用する方法をご確認ください。

お客様が Stripe Tax を使用していて、顧客が納税者番号を入力した場合、納税者番号が有効かどうかにかかわらず、納税者番号が必要な数値形式に準拠している限り、Stripe Tax は適用法に従ってリバースチャージまたはゼロレートを適用します。

サポートされる納税者番号の種類

Checkout は、特定の地域で以下の納税者番号を収集します。

国列挙値説明例
税金計算への影響
アイスランドis_vatアイスランドの VAT123456可
アイルランドeu_vatEuropean VAT numberIE1234567AB可
アゼルバイジャンaz_tinアゼルバイジャンの納税者番号0123456789可
アラブ首長国連邦ae_trnアラブ首長国連邦の TRN123456789012345可
アルバaw_tinアルバの納税者番号12345678可
アルバニアal_tinアルバニアの納税者番号J12345678N可
アルメニアam_tinアルメニアの納税者番号02538904可
アンゴラao_tinアンゴラの納税者番号5123456789不可
イギリスeu_vatNorthern Ireland VAT numberXI123456789可
イギリスgb_vatイギリスの VAT 番号GB123456789可
イタリアeu_vatEuropean VAT numberIT12345678912可
インドin_gstインドの GST 番号12ABCDE3456FGZH可
ウガンダug_tinウガンダの納税者番号1014751879可
ウクライナua_vatウクライナの VAT123456789可
ウズベキスタンuz_tinウズベキスタンの TIN 番号123456789不可
ウズベキスタンuz_vatウズベキスタンの VAT 番号123456789012可
ウルグアイuy_rucウルグアイの RUC 番号123456789012可
エクアドルec_rucエクアドルの RUC 番号1234567890001不可
エジプトeg_tinエジプトの納税者番号123456789可
エストニアeu_vatEuropean VAT numberEE123456789可
エチオピアet_tinエチオピアの納税者番号1234567890可
オーストラリアau_abnオーストラリア事業者登録番号 (AU ABN)12345678912可
オーストリアeu_vatEuropean VAT numberATU12345678可
オマーンom_vatオマーンの VAT 番号OM1234567890可
オランダeu_vatEuropean VAT numberNL123456789B12可
カーボベルデcv_nifカーボベルデの納税者番号 (Número de Identificação Fiscal)213456789不可
カザフスタンkz_binカザフスタンの企業識別番号123456789012可
カナダca_bnカナダの BN123456789不可
カナダca_gst_hstカナダの GST/HST 番号123456789RT0002可
カナダca_pst_bcカナダの PST 番号 (ブリティッシュコロンビア)PST-1234-5678不可
カナダca_pst_mbカナダの PST 番号 (マニトバ)123456-7不可
カナダca_pst_skカナダの PST 番号 (サスカチュワン)1234567不可
カナダca_qstカナダの QST 番号 (ケベック)1234567890TQ1234可
カメルーンcm_niuカメルーンの納税者番号 (Numéro d'Identifiant fiscal Unique)M123456789000L不可
カンボジアkh_tinカンボジアの納税者番号1001-123456789可
ギニアgn_nifギニアの納税者番号 (Número de Identificação Fiscal)123456789可
キプロスeu_vatEuropean VAT numberCY12345678Z可
ギリシャeu_vatEuropean VAT numberEL123456789可
キルギスkg_tinキルギスの納税者番号12345678901234不可
クロアチアeu_vatEuropean VAT numberHR12345678912可
ケニアke_pinケニア税務当局の個人識別番号P000111111A不可
コスタリカcr_tinコスタリカの納税者番号1-234-567890不可
コンゴ民主共和国(キンシャサ)cd_nifコンゴ民主共和国の納税者番号 (Número de Identificação Fiscal)A0123456M不可
サウジアラビアsa_vatサウジアラビアの VAT123456789012345可
ザンビアzm_tinザンビアの納税者番号1004751879不可
ジョージアge_vatジョージアの VAT123456789可
シンガポールsg_gstシンガポールの GSTM12345678X可
ジンバブエzw_tinジンバブエの納税者番号1234567890不可
スイスch_vatスイスの VAT 番号CHE-123.456.789 MWST可
スウェーデンeu_vatEuropean VAT numberSE123456789123可
スペインes_cifスペインの NIF 番号 (以前のスペインの CIF 番号)A12345678不可
スペインeu_vatEuropean VAT numberESA1234567Z可
スリナムsr_finスリナムの FIN 番号1234567890可
スロバキアeu_vatEuropean VAT numberSK1234567891可
スロベニアeu_vatEuropean VAT numberSI12345678可
セネガルsn_nineaセネガルの NINEA 番号12345672A2不可
セルビアrs_pibセルビアの PIB 番号123456789不可
タイth_vatタイの VAT1234567891234可
タジキスタンtj_tinタジキスタンの納税者番号123456789可
タンザニアtz_vatタンザニアの VAT 番号12345678A可
チェコ共和国eu_vatEuropean VAT numberCZ1234567890可
チリcl_tinチリの TIN12.345.678-K可
デンマークeu_vatEuropean VAT numberDK12345678可
ドイツeu_vatEuropean VAT numberDE123456789可
トルコtr_tinトルコの納税者番号0123456789可
ナイジェリアng_tinナイジェリアの納税者番号12345678-0001不可
ニュージーランドnz_gstニュージーランドの GST 番号123456789可
ネパールnp_panネパールの PAN 番号123456789可
ノルウェーno_vatノルウェーの VAT 番号123456789MVA可
バーレーンbh_vatバーレーンの VAT 番号123456789012345可
バハマbs_tinバハマの納税者番号123.456.789不可
バルバドスbb_tinバルバドスの納税者番号1123456789012不可
ハンガリーeu_vatEuropean VAT numberHU12345678可
バングラデシュbd_binバングラデシュの企業識別番号123456789-0123可
フィリピンph_tinフィリピンの納税者番号123456789012可
フィンランドeu_vatEuropean VAT numberFI12345678可
フランスeu_vatEuropean VAT numberFRAB123456789可
ブルガリアeu_vatEuropean VAT numberBG0123456789可
ブルキナファソbf_ifuブルキナファソの納税者番号 (Numéro d'Identifiant Fiscal Unique)12345678A可
ベナンbj_ifuベナンの納税者番号 (Identifiant Fiscal Unique)1234567890123可
ベラルーシby_tinベラルーシの TIN 番号123456789可
ペルーpe_rucペルーの RUC 番号12345678901可
ベルギーeu_vatEuropean VAT numberBE0123456789可
ポーランドeu_vatEuropean VAT numberPL1234567890可
ボスニア・ヘルツェゴビナba_tinボスニア・ヘルツェゴビナの納税者番号123456789012可
ポルトガルeu_vatEuropean VAT numberPT123456789可
マルタeu_vatEuropean VAT numberMT12345678可
メキシコmx_rfcメキシコの RFC 番号ABC010203AB9不可
モーリタニアmr_nifモーリタニアの納税者番号 (Número de Identificação Fiscal)12345678不可
モルドバmd_vatモルドバの VAT 番号1234567可
モロッコma_vatモロッコの VAT 番号12345678可
モンテネグロme_pibモンテネグロの PIB 番号12345678不可
ラオスla_tinラオスの納税者番号123456789-000不可
ラトビアeu_vatEuropean VAT numberLV12345678912可
リトアニアeu_vatEuropean VAT numberLT123456789123可
リヒテンシュタインli_vatリヒテンシュタインの VAT 番号12345可
ルーマニアeu_vatEuropean VAT numberRO1234567891可
ルクセンブルグeu_vatEuropean VAT numberLU12345678可
ロシアru_innロシアの INN1234567891可
ロシアru_kppロシアの KPP123456789可
北マケドニアmk_vat北マケドニアの VAT 番号MK1234567890123可
南アフリカza_vat南アフリカの VAT 番号4123456789可
台湾tw_vat台湾の VAT12345678可
韓国kr_brn韓国の BRN123-45-67890可
このページはお役に立ちましたか。
はいいいえ