コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン
概要構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つける
支払い方法
Payment UIs
Payment scenarios
店頭支払い
Other Stripe products

注

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

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

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

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

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

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

新規顧客

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

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 only collects tax IDs on Customers that don’t already have an existing tax ID. If a Customer has one or more tax IDs saved, Checkout doesn’t display the tax ID collection form even if tax ID collection is enabled.

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

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 プロパティに保存します。このようにすることで、収集された法人名がその顧客のサブスクリプションの請求書に常に表示されることになります。

実装内容をテストする

In test mode, you can enter any alphanumeric string that is in the correct format of a supported tax ID type (for example, DE123456789 for eu_vat). For a full list of example tax IDs you can reference our Customer Tax ID guide. You can also use our test tax IDs to test various verification state flows.

検証

Checkout performs checks during the Session to make sure that provided tax IDs are formatted correctly. We don’t verify that provided tax IDs are valid during the Session. You’re responsible for ensuring the validity of customer information collected during Checkout. To help, Stripe automatically performs asynchronous validation against government databases for Australian Business (ABN) numbers, European Value-Added-Tax (EU VAT) numbers, and United Kingdom Value-Added-Tax (GB VAT) numbers. You can read more on the validation we perform, and how to consume the status of those checks in our Customer Tax ID guide.

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

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

国列挙値説明例
アイスランドis_vatアイスランドの VAT123456
アイルランドeu_vatEuropean VAT numberIE1234567AB
アラブ首長国連邦ae_trnアラブ首長国連邦の TRN123456789012345
アルバニアal_tinアルバニアの納税者番号J12345678N
アルメニアam_tinArmenia Tax Identification Number02538904
アンゴラao_tinAngola Tax Identification Number5123456789
イギリスeu_vatNorthern Ireland VAT numberXI123456789
イギリスgb_vatイギリスの VAT 番号GB123456789
イタリアeu_vatEuropean VAT numberIT12345678912
インドin_gstインドの GST 番号12ABCDE3456FGZH
ウガンダug_tinUganda Tax Identification Number1014751879
ウクライナ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
オーストラリアau_abnオーストラリア事業者登録番号 (AU ABN)12345678912
オーストリアeu_vatEuropean VAT numberATU12345678
オマーンom_vatオマーンの VAT 番号OM1234567890
オランダeu_vatEuropean VAT numberNL123456789B12
カザフスタン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
カンボジア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
クロアチアeu_vatEuropean VAT numberHR12345678912
ケニアke_pinケニア税務当局の個人識別番号P000111111A
コスタリカcr_tinコスタリカの納税者番号1-234-567890
コンゴ民主共和国(キンシャサ)cd_nifCongo (DR) Tax Identification Number (Número de Identificação Fiscal)A0123456M
サウジアラビアsa_vatサウジアラビアの VAT123456789012345
ザンビアzm_tinZambia Tax Identification Number1004751879
ジョージアge_vatジョージアの VAT123456789
シンガポールsg_gstシンガポールの GSTM12345678X
ジンバブエzw_tinZimbabwe Tax Identification Number1234567890
スイスch_vatスイスの VAT 番号CHE-123.456.789 MWST
スウェーデンeu_vatEuropean VAT numberSE123456789123
スペインes_cifスペインの NIF 番号 (以前のスペインの CIF 番号)A12345678
スペインeu_vatEuropean VAT numberESA1234567Z
スリナムsr_finSuriname FIN Number1234567890
スロバキアeu_vatEuropean VAT numberSK1234567891
スロベニアeu_vatEuropean VAT numberSI12345678
セネガルsn_nineaSenegal NINEA Number12345672A2
セルビアrs_pibセルビアの PIB 番号123456789
タイth_vatタイの VAT1234567891234
タジキスタンtj_tinTajikistan Tax Identification Number123456789
タンザニア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_panNepal PAN Number123456789
ノルウェーno_vatノルウェーの VAT 番号123456789MVA
バーレーンbh_vatバーレーンの VAT 番号123456789012345
バハマbs_tinBahamas Tax Identification Number123.456.789
バルバドスbb_tinBarbados Tax Identification Number1123456789012
ハンガリーeu_vatEuropean VAT numberHU12345678
フィンランドeu_vatEuropean VAT numberFI12345678
フランスeu_vatEuropean VAT numberFRAB123456789
ブルガリアeu_vatEuropean VAT numberBG0123456789
ベラルーシby_tinベラルーシの TIN 番号123456789
ペルーpe_rucペルーの RUC 番号12345678901
ベルギーeu_vatEuropean VAT numberBE0123456789
ポーランドeu_vatEuropean VAT numberPL1234567890
ボスニア・ヘルツェゴビナba_tinBosnia and Herzegovina Tax Identification Number123456789012
ポルトガルeu_vatEuropean VAT numberPT123456789
マルタeu_vatEuropean VAT numberMT12345678
メキシコmx_rfcメキシコの RFC 番号ABC010203AB9
モーリタニアmr_nifMauritania Tax Identification Number (Número de Identificação Fiscal)12345678
モルドバmd_vatモルドバの VAT 番号1234567
モロッコma_vatモロッコの VAT 番号12345678
モンテネグロme_pibMontenegro PIB Number12345678
ラトビア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_vatNorth Macedonia VAT NumberMK1234567890123
南アフリカza_vat南アフリカの VAT 番号4123456789
台湾tw_vat台湾の VAT12345678
韓国kr_brn韓国の BRN123-45-67890
このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
Stripe の製品変更ログを確認してください。
ご不明な点がございましたら、お問い合わせください。
Powered by Markdoc