コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン

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

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

請求書 に顧客の納税者番号と法的事業者名を表示し、VAT 還付を処理することは、Checkout で税務番号収集を有効にすることで満たすことができる一般的な要件です。このガイドでは、Checkout を既に統合済みであることを前提としています。まだ統合していない場合は、決済の受け付けに関するガイド をご覧ください。

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

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

新規顧客

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
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"

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

さらに、customer_creation を使用して、新しい 顧客 を作成するように Checkout を設定することも可能です。この設定を有効にした場合、セッション中に収集された納税者番号の情報は、その新しい 顧客に保存されます。有効にしない場合でも、納税者番号の情報は 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.js
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"

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
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"

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

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
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[shipping]"=auto \
  -d "shipping_address_collection[allowed_countries][0]"=DE \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

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

オプション納税者番号の収集を求める

必要に応じて、tax_id_collection[required] パラメーターを設定し、納税者番号の収集を求めるように Checkout を設定することができます。if_supported に設定すると、Checkout はサポートされている請求国で顧客の支払いに納税者番号の情報を要求します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
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 "tax_id_collection[required]"=if_supported \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

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

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

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

Checkout Session を Customer に関連付けると、Checkout は収集された納税者番号を Customer オブジェクトに保存します。Checkout は Customer の customer.tax_ids 配列に収集された納税者番号を保存します。owner.type を customer に、owner.customer を顧客 ID に設定することで、Tax IDs を使用して Customer に保存されたすべての納税者番号を取得することができます。Checkout は事業者名を Customer の name および business_name プロパティに保存します。サブスクリプションの請求書には常に収集された法人名が表示されます。

実装内容をテストする

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

検証

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

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

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

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

国列挙値説明例
税金計算への影響
アイスランドis_vatIcelandic VAT123456はい
アイルランドeu_vatEuropean VAT numberIE1234567ABはい
アゼルバイジャンaz_tinAzerbaijan Tax Identification Number0123456789はい
アラブ首長国連邦ae_trnUnited Arab Emirates TRN123456789012345はい
アルバaw_tinAruba Tax Identification Number12345678はい
アルバニアal_tinAlbania Tax Identification NumberJ12345678Nはい
アルメニアam_tinArmenia Tax Identification Number02538904はい
アンゴラao_tinAngola Tax Identification Number5123456789いいえ
イギリスeu_vatNorthern Ireland VAT numberXI123456789はい
イギリスgb_vatUnited Kingdom VAT numberGB123456789はい
イタリアeu_vatEuropean VAT numberIT12345678912はい
インドin_gstIndian GST number12ABCDE3456FGZHはい
ウガンダug_tinUganda Tax Identification Number1014751879はい
ウクライナua_vatUkrainian VAT123456789はい
ウズベキスタンuz_tinUzbekistan TIN Number123456789いいえ
ウズベキスタンuz_vatUzbekistan VAT Number123456789012はい
ウルグアイuy_rucUruguayan RUC number123456789012はい
エクアドルec_rucEcuadorian RUC number1234567890001いいえ
エジプトeg_tinEgyptian Tax Identification Number123456789はい
エストニアeu_vatEuropean VAT numberEE123456789はい
エチオピアet_tinEthiopia Tax Identification Number1234567890はい
オーストラリアau_abnAustralian Business Number (AU ABN)12345678912はい
オーストリアeu_vatEuropean VAT numberATU12345678はい
オマーンom_vatOmani VAT NumberOM1234567890はい
オランダeu_vatEuropean VAT numberNL123456789B12はい
カーボベルデcv_nifCape Verde Tax Identification Number (Número de Identificação Fiscal)213456789いいえ
カザフスタンkz_binKazakhstani Business Identification Number123456789012はい
カナダca_bnCanadian BN123456789いいえ
カナダca_gst_hstCanadian GST/HST number123456789RT0002はい
カナダca_pst_bcCanadian PST number (British Columbia)PST-1234-5678いいえ
カナダca_pst_mbCanadian PST number (Manitoba)123456-7いいえ
カナダca_pst_skCanadian PST number (Saskatchewan)1234567いいえ
カナダca_qstCanadian QST number (Québec)1234567890TQ1234はい
カメルーンcm_niuCameroon Tax Identification Number (Numéro d'Identifiant fiscal Unique)M123456789000Lいいえ
カンボジアkh_tinCambodia Tax Identification Number1001-123456789はい
ギニアgn_nifGuinea Tax Identification Number (Número de Identificação Fiscal)123456789はい
キプロスeu_vatEuropean VAT numberCY12345678Zはい
ギリシャeu_vatEuropean VAT numberEL123456789はい
キルギスkg_tinKyrgyzstan Tax Identification Number12345678901234いいえ
クロアチアeu_vatEuropean VAT numberHR12345678912はい
ケニアke_pinKenya Revenue Authority Personal Identification NumberP000111111Aいいえ
コスタリカcr_tinCosta Rican tax ID1-234-567890いいえ
コンゴ民主共和国(キンシャサ)cd_nifCongo (DR) Tax Identification Number (Número de Identificação Fiscal)A0123456Mいいえ
サウジアラビアsa_vatSaudi Arabia VAT123456789012345はい
ザンビアzm_tinZambia Tax Identification Number1004751879いいえ
ジョージアge_vatGeorgian VAT123456789はい
シンガポールsg_gstSingaporean GSTM12345678Xはい
ジンバブエzw_tinZimbabwe Tax Identification Number1234567890いいえ
スイスch_vatSwitzerland VAT numberCHE-123.456.789 MWSTはい
スウェーデンeu_vatEuropean VAT numberSE123456789123はい
スペインes_cifSpanish NIF number (previously Spanish CIF number)A12345678いいえ
スペインeu_vatEuropean VAT numberESA1234567Zはい
スリナムsr_finSuriname FIN Number1234567890はい
スリランカlk_vatSri Lanka VAT number123456789-1234はい
スロバキアeu_vatEuropean VAT numberSK1234567891はい
スロベニアeu_vatEuropean VAT numberSI12345678はい
セネガルsn_nineaSenegal NINEA Number12345672A2いいえ
セルビアrs_pibSerbian PIB number123456789いいえ
タイth_vatThai VAT1234567891234はい
タジキスタンtj_tinTajikistan Tax Identification Number123456789はい
タンザニアtz_vatTanzania VAT Number12345678Aはい
チェコ共和国eu_vatEuropean VAT numberCZ1234567890はい
チリcl_tinChilean TIN12.345.678-Kはい
デンマークeu_vatEuropean VAT numberDK12345678はい
ドイツeu_vatEuropean VAT numberDE123456789はい
トルコtr_tinTurkish Tax Identification Number0123456789はい
ナイジェリアng_tinNigerian Tax Identification Number12345678-0001いいえ
ニュージーランドnz_gstNew Zealand GST number123456789はい
ネパールnp_panNepal PAN Number123456789はい
ノルウェーno_vatNorwegian VAT number123456789MVAはい
バーレーンbh_vatBahraini VAT Number123456789012345はい
バハマbs_tinBahamas Tax Identification Number123.456.789いいえ
バルバドスbb_tinBarbados Tax Identification Number1123456789012いいえ
ハンガリーeu_vatEuropean VAT numberHU12345678はい
ハンガリーhu_tinHungary tax number (adószám)12345678-1-23いいえ
バングラデシュbd_binBangladesh Business Identification Number123456789-0123はい
フィリピンph_tinPhilippines Tax Identification Number123456789012はい
フィンランドeu_vatEuropean VAT numberFI12345678はい
フランスeu_vatEuropean VAT numberFRAB123456789はい
ブルガリアeu_vatEuropean VAT numberBG0123456789はい
ブルキナファソbf_ifuBurkina Faso Tax Identification Number (Numéro d'Identifiant Fiscal Unique)12345678Aはい
ベナンbj_ifuBenin Tax Identification Number (Identifiant Fiscal Unique)1234567890123はい
ベラルーシby_tinBelarus TIN Number123456789はい
ペルーpe_rucPeruvian RUC number12345678901はい
ベルギーeu_vatEuropean VAT numberBE0123456789はい
ポーランドeu_vatEuropean VAT numberPL1234567890はい
ポーランドpl_nipPolish NIP number1234567890いいえ
ボスニア・ヘルツェゴビナba_tinBosnia and Herzegovina Tax Identification Number123456789012はい
ポルトガルeu_vatEuropean VAT numberPT123456789はい
マルタeu_vatEuropean VAT numberMT12345678はい
メキシコmx_rfcMexican RFC numberABC010203AB9いいえ
モーリタニアmr_nifMauritania Tax Identification Number (Número de Identificação Fiscal)12345678いいえ
モルドバmd_vatMoldova VAT Number1234567はい
モロッコma_vatMorocco VAT Number12345678はい
モンテネグロme_pibMontenegro PIB Number12345678いいえ
ラオスla_tinLaos Tax Identification Number123456789-000いいえ
ラトビアeu_vatEuropean VAT numberLV12345678912はい
リトアニアeu_vatEuropean VAT numberLT123456789123はい
リヒテンシュタインli_vatLiechtensteinian VAT number12345はい
ルーマニアeu_vatEuropean VAT numberRO1234567891はい
ルクセンブルグeu_vatEuropean VAT numberLU12345678はい
ロシアru_innRussian INN1234567891はい
ロシアru_kppRussian KPP123456789はい
北マケドニアmk_vatNorth Macedonia VAT NumberMK1234567890123はい
南アフリカza_vatSouth African VAT number4123456789はい
台湾tw_vatTaiwanese VAT12345678はい
韓国kr_brnKorean BRN123-45-67890はい