Checkout で顧客の納税者番号を収集する
Checkout で VAT などの顧客の納税者番号を収集する方法をご紹介します。
請求書に顧客の納税者番号と法人名を表示することで、納税者番号の収集に伴う一般的な要件を満たせます。このガイドは、Elements と Checkout Sessions API がすでに連携済みであることを前提としています。この連携がまだお済みでない場合は、クイックスタートで始め方をご確認ください。
免責事項
Checkout Sessions API は、ビジネスの納税者番号を収集するように設計されています。また特定の管轄区域では、個人納税者番号と似た形式のものが収集されることがあります。この機能を使用する際は、このフィールドに指定されているビジネスの納税者番号のみを入力するようにしてください。
納税者番号の収集を有効にするサーバー側
新規顧客
新規顧客の納税者番号の収集を有効にするには、Checkout セッションの作成時に tax_id_collection[enabled] を true
に設定します。
既存の顧客
既存の Customer の Checkout セッションを作成し、決済時に収集された納税者番号情報で Customer を更新します。Checkout セッションは、収集した会社名を Customer の name として保存し、収集した納税者番号を customer.tax_ids に追加します。会社名の収集は Customer の既存の name を上書きする可能性があるため、Checkout セッションの作成時に customer_update.name を auto
に設定する必要があります。
既存の顧客の住所を保存していない場合は、決済時に入力された請求先住所または配送先住所に基づいて顧客の所在地を設定できます。決済時に入力された請求先住所を基に顧客の所在地を判定する場合は、customer_update.address を auto
に設定します。customer_update.address を auto
に設定すると、以前に保存された顧客の住所が、決済時に入力された住所に置き換えられます。
既存の顧客の配送先住所を収集する場合は、customer_update.shipping を auto
に設定し、決済時に入力される配送先住所を参照します。customer_update.shipping を auto
に設定すると、以前に保存された顧客の配送先住所が、決済時に入力された配送先住所に置き換えられます。
この例では、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_
の場合は DE123456789
など)。納税者番号のサンプルの一覧については、Stripe の顧客の納税者番号に関するガイドをご覧ください。また、テスト用納税者番号を使用して、さまざまな確認ステータスのフローをテストすることもできます。
検証
Checkout セッションの際に、Stripe は入力された納税者番号が正しい形式であること (有効かどうかではなく) を確認します。決済時に収集された顧客情報の有効性を確保する責任はお客様にあります。そのサポートとして、Stripe ではヨーロッパの付加価値税 (EU VAT) およびイギリスの付加価値税 (GB VAT) 番号を、政府データベースと照らし合わせる非同期の検証を自動的に行います。Stripe が実行する検証の詳細、およびそれらの検証のステータスを使用する方法をご確認ください。
お客様が Stripe Tax を使用していて、顧客が納税者番号を入力した場合、納税者番号が有効かどうかにかかわらず、納税者番号が必要な数値形式に準拠している限り、Stripe Tax は適用法に従ってリバースチャージまたはゼロレートを適用します。
サポートされる納税者番号の種類
Checkout セッションは、指定された地域の以下の納税者番号タイプを収集します。
国 | 列挙値 | 説明 | 例 | 税金計算への影響 |
---|---|---|---|---|
アイスランド | is_vat | アイスランドの VAT | 123456 | 可 |
アイルランド | eu_vat | European VAT number | IE1234567AB | 可 |
アゼルバイジャン | az_tin | アゼルバイジャンの納税者番号 | 0123456789 | 可 |
アラブ首長国連邦 | ae_trn | アラブ首長国連邦の TRN | 123456789012345 | 可 |
アルバ | aw_tin | アルバの納税者番号 | 12345678 | 可 |
アルバニア | al_tin | アルバニアの納税者番号 | J12345678N | 可 |
アルメニア | am_tin | アルメニアの納税者番号 | 02538904 | 可 |
アンゴラ | ao_tin | アンゴラの納税者番号 | 5123456789 | 不可 |
イギリス | eu_vat | Northern Ireland VAT number | XI123456789 | 可 |
イギリス | gb_vat | イギリスの VAT 番号 | GB123456789 | 可 |
イタリア | eu_vat | European VAT number | IT12345678912 | 可 |
インド | in_gst | インドの GST 番号 | 12ABCDE3456FGZH | 可 |
ウガンダ | ug_tin | ウガンダの納税者番号 | 1014751879 | 可 |
ウクライナ | ua_vat | ウクライナの VAT | 123456789 | 可 |
ウズベキスタン | uz_tin | ウズベキスタンの TIN 番号 | 123456789 | 不可 |
ウズベキスタン | uz_vat | ウズベキスタンの VAT 番号 | 123456789012 | 可 |
ウルグアイ | uy_ruc | ウルグアイの RUC 番号 | 123456789012 | 可 |
エクアドル | ec_ruc | エクアドルの RUC 番号 | 1234567890001 | 不可 |
エジプト | eg_tin | エジプトの納税者番号 | 123456789 | 可 |
エストニア | eu_vat | European VAT number | EE123456789 | 可 |
エチオピア | et_tin | エチオピアの納税者番号 | 1234567890 | 可 |
オーストラリア | au_abn | オーストラリア事業者登録番号 (AU ABN) | 12345678912 | 可 |
オーストリア | eu_vat | European VAT number | ATU12345678 | 可 |
オマーン | om_vat | オマーンの VAT 番号 | OM1234567890 | 可 |
オランダ | eu_vat | European VAT number | NL123456789B12 | 可 |
カーボベルデ | cv_nif | カーボベルデの納税者番号 (Número de Identificação Fiscal) | 213456789 | 不可 |
カザフスタン | kz_bin | カザフスタンの企業識別番号 | 123456789012 | 可 |
カナダ | ca_bn | カナダの BN | 123456789 | 不可 |
カナダ | 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_vat | European VAT number | CY12345678Z | 可 |
ギリシャ | eu_vat | European VAT number | EL123456789 | 可 |
キルギス | kg_tin | キルギスの納税者番号 | 12345678901234 | 不可 |
クロアチア | eu_vat | European VAT number | HR12345678912 | 可 |
ケニア | ke_pin | ケニア税務当局の個人識別番号 | P000111111A | 不可 |
コスタリカ | cr_tin | コスタリカの納税者番号 | 1-234-567890 | 不可 |
コンゴ民主共和国(キンシャサ) | cd_nif | コンゴ民主共和国の納税者番号 (Número de Identificação Fiscal) | A0123456M | 不可 |
サウジアラビア | sa_vat | サウジアラビアの VAT | 123456789012345 | 可 |
ザンビア | zm_tin | ザンビアの納税者番号 | 1004751879 | 不可 |
ジョージア | ge_vat | ジョージアの VAT | 123456789 | 可 |
シンガポール | sg_gst | シンガポールの GST | M12345678X | 可 |
ジンバブエ | zw_tin | ジンバブエの納税者番号 | 1234567890 | 不可 |
スイス | ch_vat | スイスの VAT 番号 | CHE-123.456.789 MWST | 可 |
スウェーデン | eu_vat | European VAT number | SE123456789123 | 可 |
スペイン | es_cif | スペインの NIF 番号 (以前のスペインの CIF 番号) | A12345678 | 不可 |
スペイン | eu_vat | European VAT number | ESA1234567Z | 可 |
スリナム | sr_fin | スリナムの FIN 番号 | 1234567890 | 可 |
スロバキア | eu_vat | European VAT number | SK1234567891 | 可 |
スロベニア | eu_vat | European VAT number | SI12345678 | 可 |
セネガル | sn_ninea | セネガルの NINEA 番号 | 12345672A2 | 不可 |
セルビア | rs_pib | セルビアの PIB 番号 | 123456789 | 不可 |
タイ | th_vat | タイの VAT | 1234567891234 | 可 |
タジキスタン | tj_tin | タジキスタンの納税者番号 | 123456789 | 可 |
タンザニア | tz_vat | タンザニアの VAT 番号 | 12345678A | 可 |
チェコ共和国 | eu_vat | European VAT number | CZ1234567890 | 可 |
チリ | cl_tin | チリの TIN | 12.345.678-K | 可 |
デンマーク | eu_vat | European VAT number | DK12345678 | 可 |
ドイツ | eu_vat | European VAT number | DE123456789 | 可 |
トルコ | 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_vat | European VAT number | HU12345678 | 可 |
バングラデシュ | bd_bin | バングラデシュの企業識別番号 | 123456789-0123 | 可 |
フィリピン | ph_tin | フィリピンの納税者番号 | 123456789012 | 可 |
フィンランド | eu_vat | European VAT number | FI12345678 | 可 |
フランス | eu_vat | European VAT number | FRAB123456789 | 可 |
ブルガリア | eu_vat | European VAT number | BG0123456789 | 可 |
ブルキナファソ | bf_ifu | ブルキナファソの納税者番号 (Numéro d'Identifiant Fiscal Unique) | 12345678A | 可 |
ベナン | bj_ifu | ベナンの納税者番号 (Identifiant Fiscal Unique) | 1234567890123 | 可 |
ベラルーシ | by_tin | ベラルーシの TIN 番号 | 123456789 | 可 |
ペルー | pe_ruc | ペルーの RUC 番号 | 12345678901 | 可 |
ベルギー | eu_vat | European VAT number | BE0123456789 | 可 |
ポーランド | eu_vat | European VAT number | PL1234567890 | 可 |
ボスニア・ヘルツェゴビナ | ba_tin | ボスニア・ヘルツェゴビナの納税者番号 | 123456789012 | 可 |
ポルトガル | eu_vat | European VAT number | PT123456789 | 可 |
マルタ | eu_vat | European VAT number | MT12345678 | 可 |
メキシコ | 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_vat | European VAT number | LV12345678912 | 可 |
リトアニア | eu_vat | European VAT number | LT123456789123 | 可 |
リヒテンシュタイン | li_vat | リヒテンシュタインの VAT 番号 | 12345 | 可 |
ルーマニア | eu_vat | European VAT number | RO1234567891 | 可 |
ルクセンブルグ | eu_vat | European VAT number | LU12345678 | 可 |
ロシア | ru_inn | ロシアの INN | 1234567891 | 可 |
ロシア | ru_kpp | ロシアの KPP | 123456789 | 可 |
北マケドニア | mk_vat | 北マケドニアの VAT 番号 | MK1234567890123 | 可 |
南アフリカ | za_vat | 南アフリカの VAT 番号 | 4123456789 | 可 |
台湾 | tw_vat | 台湾の VAT | 12345678 | 可 |
韓国 | kr_brn | 韓国の BRN | 123-45-67890 | 可 |