Checkout で顧客の納税者番号を収集する
Checkout で VAT などの顧客の納税者番号を収集する方法をご紹介します。
請求書に顧客の納税者番号と法人名を表示することで、納税者番号の収集に伴う一般的な要件を満たせます。このガイドは、Elements と 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 プロパティに保存します。このようにすることで、収集された法人名がその顧客のサブスクリプションの請求書に常に表示されることになります。
実装内容をテストする
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_
). 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 は、セッションの際にチェックを行って、指定された納税者番号の形式が正しいことを確認します。セッションでは指定された納税者番号が有効かどうかの検証は行われません。決済時に収集された顧客情報の有効性の確認はお客様の責任で行う必要があります。これを支援するため、Stripe では、オーストラリア事業者登録 (ABN) 番号、ヨーロッパの付加価値税 (EU VAT) 番号、およびイギリスの付加価値税 (GB VAT) 番号の政府データベースと照らし合わせる非同期の検証を自動的に行います。Stripe が実行する検証の詳細、およびそれらの検証結果を使用する方法については、顧客の納税者番号ガイドをご覧ください。
サポートされる納税者番号の種類
Checkout セッションは、指定された地域の以下の納税者番号タイプを収集します。
国 | 列挙値 | 説明 | 例 |
---|---|---|---|
アイスランド | is_ | アイスランドの VAT | 123456 |
アイルランド | eu_ | European VAT number | IE1234567AB |
アラブ首長国連邦 | ae_ | アラブ首長国連邦の TRN | 123456789012345 |
アルバニア | al_ | アルバニアの納税者番号 | J12345678N |
アルメニア | am_ | アルメニアの納税者番号 | 02538904 |
アンゴラ | ao_ | アンゴラの納税者番号 | 5123456789 |
イギリス | eu_ | Northern Ireland VAT number | XI123456789 |
イギリス | gb_ | イギリスの VAT 番号 | GB123456789 |
イタリア | eu_ | European VAT number | IT12345678912 |
インド | in_ | インドの GST 番号 | 12ABCDE3456FGZH |
ウガンダ | ug_ | ウガンダの納税者番号 | 1014751879 |
ウクライナ | ua_ | ウクライナの VAT | 123456789 |
ウズベキスタン | uz_ | ウズベキスタンの TIN 番号 | 123456789 |
ウズベキスタン | uz_ | ウズベキスタンの VAT 番号 | 123456789012 |
ウルグアイ | uy_ | ウルグアイの RUC 番号 | 123456789012 |
エクアドル | ec_ | エクアドルの RUC 番号 | 1234567890001 |
エジプト | eg_ | エジプトの納税者番号 | 123456789 |
エストニア | eu_ | European VAT number | EE123456789 |
オーストラリア | au_ | オーストラリア事業者登録番号 (AU ABN) | 12345678912 |
オーストリア | eu_ | European VAT number | ATU12345678 |
オマーン | om_ | オマーンの VAT 番号 | OM1234567890 |
オランダ | eu_ | European VAT number | NL123456789B12 |
カザフスタン | kz_ | カザフスタンの企業識別番号 | 123456789012 |
カナダ | ca_ | カナダの BN | 123456789 |
カナダ | ca_ | カナダの GST/HST 番号 | 123456789RT0002 |
カナダ | ca_ | カナダの PST 番号 (ブリティッシュコロンビア) | PST-1234-5678 |
カナダ | ca_ | カナダの PST 番号 (マニトバ) | 123456-7 |
カナダ | ca_ | カナダの PST 番号 (サスカチュワン) | 1234567 |
カナダ | ca_ | カナダの QST 番号 (ケベック) | 1234567890TQ1234 |
カンボジア | kh_ | カンボジアの納税者番号 | 1001-123456789 |
ギニア | gn_ | ギニアの納税者番号 (Número de Identificação Fiscal) | 123456789 |
キプロス | eu_ | European VAT number | CY12345678Z |
ギリシャ | eu_ | European VAT number | EL123456789 |
クロアチア | eu_ | European VAT number | HR12345678912 |
ケニア | ke_ | ケニア税務当局の個人識別番号 | P000111111A |
コスタリカ | cr_ | コスタリカの納税者番号 | 1-234-567890 |
コンゴ民主共和国(キンシャサ) | cd_ | コンゴ民主共和国の納税者番号 (Número de Identificação Fiscal) | A0123456M |
サウジアラビア | sa_ | サウジアラビアの VAT | 123456789012345 |
ザンビア | zm_ | ザンビアの納税者番号 | 1004751879 |
ジョージア | ge_ | ジョージアの VAT | 123456789 |
シンガポール | sg_ | シンガポールの GST | M12345678X |
ジンバブエ | zw_ | ジンバブエの納税者番号 | 1234567890 |
スイス | ch_ | スイスの VAT 番号 | CHE-123.456.789 MWST |
スウェーデン | eu_ | European VAT number | SE123456789123 |
スペイン | es_ | スペインの NIF 番号 (以前のスペインの CIF 番号) | A12345678 |
スペイン | eu_ | European VAT number | ESA1234567Z |
スリナム | sr_ | スリナムの FIN 番号 | 1234567890 |
スロバキア | eu_ | European VAT number | SK1234567891 |
スロベニア | eu_ | European VAT number | SI12345678 |
セネガル | sn_ | セネガルの NINEA 番号 | 12345672A2 |
セルビア | rs_ | セルビアの PIB 番号 | 123456789 |
タイ | th_ | タイの VAT | 1234567891234 |
タジキスタン | tj_ | タジキスタンの納税者番号 | 123456789 |
タンザニア | tz_ | タンザニアの VAT 番号 | 12345678A |
チェコ共和国 | eu_ | European VAT number | CZ1234567890 |
チリ | cl_ | チリの TIN | 12.345.678-K |
デンマーク | eu_ | European VAT number | DK12345678 |
ドイツ | eu_ | European VAT number | DE123456789 |
トルコ | tr_ | トルコの納税者番号 | 0123456789 |
ナイジェリア | ng_ | ナイジェリアの納税者番号 | 12345678-0001 |
ニュージーランド | nz_ | ニュージーランドの GST 番号 | 123456789 |
ネパール | np_ | ネパールの PAN 番号 | 123456789 |
ノルウェー | no_ | ノルウェーの VAT 番号 | 123456789MVA |
バーレーン | bh_ | バーレーンの VAT 番号 | 123456789012345 |
バハマ | bs_ | バハマの納税者番号 | 123.456.789 |
バルバドス | bb_ | バルバドスの納税者番号 | 1123456789012 |
ハンガリー | eu_ | European VAT number | HU12345678 |
フィンランド | eu_ | European VAT number | FI12345678 |
フランス | eu_ | European VAT number | FRAB123456789 |
ブルガリア | eu_ | European VAT number | BG0123456789 |
ベラルーシ | by_ | ベラルーシの TIN 番号 | 123456789 |
ペルー | pe_ | ペルーの RUC 番号 | 12345678901 |
ベルギー | eu_ | European VAT number | BE0123456789 |
ポーランド | eu_ | European VAT number | PL1234567890 |
ボスニア・ヘルツェゴビナ | ba_ | ボスニア・ヘルツェゴビナの納税者番号 | 123456789012 |
ポルトガル | eu_ | European VAT number | PT123456789 |
マルタ | eu_ | European VAT number | MT12345678 |
メキシコ | mx_ | メキシコの RFC 番号 | ABC010203AB9 |
モーリタニア | mr_ | モーリタニアの納税者番号 (Número de Identificação Fiscal) | 12345678 |
モルドバ | md_ | モルドバの VAT 番号 | 1234567 |
モロッコ | ma_ | モロッコの VAT 番号 | 12345678 |
モンテネグロ | me_ | モンテネグロの PIB 番号 | 12345678 |
ラトビア | eu_ | European VAT number | LV12345678912 |
リトアニア | eu_ | European VAT number | LT123456789123 |
リヒテンシュタイン | li_ | リヒテンシュタインの VAT 番号 | 12345 |
ルーマニア | eu_ | European VAT number | RO1234567891 |
ルクセンブルグ | eu_ | European VAT number | LU12345678 |
ロシア | ru_ | ロシアの INN | 1234567891 |
ロシア | ru_ | ロシアの KPP | 123456789 |
北マケドニア | mk_ | 北マケドニアの VAT 番号 | MK1234567890123 |
南アフリカ | za_ | 南アフリカの VAT 番号 | 4123456789 |
台湾 | tw_ | 台湾の VAT | 12345678 |
韓国 | kr_ | 韓国の BRN | 123-45-67890 |