# 顧客の納税者番号を収集 決済時に VAT やその他の顧客の納税者番号を収集する方法をご紹介します。 顧客の納税者番号と法人名 (商号) を *請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)に表示することは一般的な要件であり、決済で納税者番号の収集を有効にすることで対応できます。納税者番号の収集は、ホスト型ページ、埋め込みページ、elements モードのすべての Checkout 実装タイプで機能します。 > #### 免責条項 > > Checkout Sessions API は事業の Tax ID を収集するように設計されています。これは、特定の管轄区域では個人の Tax ID に似た形式になる場合があります。この機能を使用する際には、このフィールドに指定された事業の Tax ID のみを提供する必要があります。 ## 納税者番号の回収を有効にする [サーバー側] 納税者番号の収集を有効にすると、決済では顧客の所在地に応じて納税者番号の収集フォームの表示と非表示が切り替わります。顧客が納税者番号の収集に対応している所在地にいる場合、決済ではその事業者の納税者番号と法人名を入力するためのフィールドが表示されます。利用可能な場合、決済では顧客の配送先住所を使用して所在地を判断し、そうでない場合は請求先住所を使用します。顧客が入力できる納税者番号は 1 つのみです。 ### 新規顧客 新規顧客の Tax ID 収集を有効にするには、Checkout Session を作成する際に、[tax_id_collection[enabled]](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-tax_id_collection-enabled) を `true` に設定します。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "tax_id_collection[enabled]=true" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` [customer_creation](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_creation) を使用して、新しい [customer-configured Account](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer) または [Customer](https://docs.stripe.com/api/customers/object.md) を作成するよう決済を設定することもできます。その場合、セッション中に収集された納税者番号情報は、その新しい Account または Customer に保存されます。そうしない場合でも、納税者番号情報は [customer_details.tax_ids](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details-tax_ids) で引き続き利用できます。 ### 既存顧客 #### Accounts v2 既存の [v2アカウント](https://docs.stripe.com/api/v2/core/accounts/object.md)で Checkout Session を作成し、チェックアウト時に収集された納税者番号情報を追加します。Checkout Session は、法人名を [identity](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-identity) オブジェクトに保存し、収集された納税者番号をアカウントに関連付けられた[納税者番号](https://docs.stripe.com/api/tax_ids/object.md)リソースとして保存します。 > Checkout は、Account に既存の納税者番号がない場合にのみ、納税者番号を収集します。Account に納税者番号が 1 つ以上保存されている場合、Checkout で納税者番号の収集が有効になっていても、納税者番号の収集フォームは表示されません。 Checkout Session の作成時に、[customer_update.name](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-name) を `auto` に設定すると、セッションの詳細を使用して Account の ID の名前が自動的に更新されます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-address) =`auto` | 決済時に入力された請求先住所を使用します。アカウントに保存された住所を上書きします。 | | [customer_update.shipping](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-shipping) =`auto` | 決済時に入力された配送先住所を使用します。アカウントに保存された配送先住所を上書きします。[shipping_address_collection](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection) が必要です。 | #### Customer v1 既存の[顧客](https://docs.stripe.com/api/customers/object.md)で Checkout Session を作成し、チェックアウト時に収集された納税者番号情報を追加します。Checkout Session は、法人名を顧客の[名前](https://docs.stripe.com/api/customers/object.md#customer_object-name)として保存し、収集された納税者番号を [customer.tax_ids](https://docs.stripe.com/api/customers/object.md#customer_object-tax_ids) に追加します。 > Checkout は、既存の納税者番号をまだ持っていない顧客の納税者番号のみを収集します。顧客が 1 つ以上の納税者番号を保存している場合、納税者番号の収集が有効になっていても、Checkout は納税者番号の収集フォームを表示しません。 Checkout Session の作成時に、[customer_update.name](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-name) を `auto` に設定すると、セッションの詳細を使用して顧客の既存の `name` が自動的に更新されます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-address) =`auto` | 決済時に入力された請求先住所を使用します。顧客に以前保存されていた住所を上書きします。 | | [customer_update.shipping](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-customer_update-shipping) =`auto` | 決済時に入力された配送先住所を使用します。顧客に以前保存されていた配送先住所を上書きします。[shipping_address_collection](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection) が必要です。 | ## Optional: 納税者番号の回収の設定 [tax_id_collection[required]](https://docs.stripe.com/api/.md#create_checkout_session-tax_id_collection-required) パラメーターを設定することで、納税者番号の回収を必須にするよう Checkout を設定できます。`if_supported` に設定すると、[サポートされている請求先国](https://docs.stripe.com/tax/checkout/tax-ids.md#supported-types)の顧客について、決済時に納税者番号情報の入力が必須になります。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d "tax_id_collection[enabled]=true" \ -d "tax_id_collection[required]=if_supported" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## Optional: 決済フォームで納税者番号を回収する [elements モード](https://docs.stripe.com/tax/checkout/elements.md) (`ui_mode: 'elements'`) を使用している場合は、[Tax ID Element](https://docs.stripe.com/js/custom_checkout/create_tax_id_element) をレンダリングして、決済フォームで直接納税者番号を回収できます。クライアント側の設定手順については、[elements 実装ガイド](https://docs.stripe.com/tax/checkout/elements.md#render-tax-id-element)を参照してください。 ## セッション後に顧客の納税者番号の詳細を取得 Checkout は、生成された [Session (セッション)](https://docs.stripe.com/api/checkout/sessions/object.md) オブジェクトに提供された納税者番号を含めます。各セッションの完了後に、Checkout は [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) イベントを送信します。これは *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) エンドポイントでリッスンできます。納税者番号を Session オブジェクトから取得する場合は、セッションの [customer_details.tax_ids](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_details-tax_ids) 配列から取得できます。 ```json { "object": { "id": "cs_test_a1dJwt0TCJTBsDkbK7RcoyJ91vJxe2Y", "object": "checkout.session", ... "customer": {{CUSTOMER_ID}}, "customer_details": { ..."tax_ids": [ { "type": "eu_vat", "value": "FRAB123456789" } ] }, ..."tax_id_collection": { "enabled": true } ... } } ``` Checkout Session を Customer に関連付けると、Checkout は収集された納税者番号を [Customer](https://docs.stripe.com/api/customers/object.md) オブジェクトに保存します。Checkout は Customer の [customer.tax_ids](https://docs.stripe.com/api/customers/object.md#customer_object-tax_ids) 配列に収集された納税者番号を保存します。[owner.type](https://docs.stripe.com/api/tax_ids/list.md#list_tax_ids-owner-type) を `customer` に、[owner.customer](https://docs.stripe.com/api/tax_ids/list.md#list_tax_ids-owner-customer) を顧客 ID に設定することで、[Tax IDs](https://docs.stripe.com/api/tax_ids/list.md) を使用して Customer に保存されたすべての納税者番号を取得することができます。Checkout は事業者名を Customer の [name](https://docs.stripe.com/api/customers/object.md#customer_object-name) および [business_name](https://docs.stripe.com/api/customers/object.md#customer_object-business_name) プロパティに保存します。サブスクリプションの請求書には常に収集された法人名が表示されます。 ## 連携のテスト テスト環境では、サポートされている納税者番号タイプの正しい形式で英数字の文字列を入力できます (`eu_vat` の場合は `DE123456789` など)。納税者番号のサンプルの一覧については、Stripe の[顧客の納税者番号に関するガイド](https://docs.stripe.com/billing/customer/tax-ids.md#supported-tax-id)をご覧ください。また、[テスト用納税者番号](https://docs.stripe.com/connect/testing.md#test-business-tax-ids)を使用して、さまざまな確認ステータスのフローをテストすることもできます。 ## 検証 Checkout Session 中、Stripe は指定された納税者番号の形式が正しいことを確認しますが、有効かどうかは確認しません。Checkout で収集された顧客情報の有効性を確認する責任はお客様にあります。これを支援するため、Stripe は[オーストラリア事業者登録番号 (ABN)](https://docs.stripe.com/tax/invoicing/tax-ids.md#australian-business-numbers-abn)、[欧州付加価値税 (EU VAT)](https://docs.stripe.com/tax/invoicing/tax-ids.md#european-value-added-tax-eu-vat-numbers) および[イギリス付加価値税 (GB VAT)](https://docs.stripe.com/tax/invoicing/tax-ids.md#united-kingdom-value-added-tax-gb-vat-numbers) 番号を政府のデータベースに対して非同期で自動的に照合します。Stripe が[実施する検証](https://docs.stripe.com/tax/invoicing/tax-ids.md#validation)と、これらのチェックのステータスの使用方法の詳細をご確認ください。 お客様が Stripe Tax を使用していて、顧客が納税者番号を入力した場合、納税者番号が有効かどうかにかかわらず、納税者番号が必要な数値形式に準拠している限り、Stripe Tax は適用法に従ってリバースチャージまたはゼロレートを適用します。 ## サポートされる納税者番号の種類 Checkout は、特定の地域で以下の納税者番号を収集します。 | Country | Enum | Description | Example | Impact in Tax Calculation* | | ------- | ---------- | --------------------------------------------------------------------------- | -------------------- | -------------------------- | | AE | ae_trn | United Arab Emirates TRN | 123456789012345 | Yes | | AL | al_tin | Albania Tax Identification Number | J12345678N | Yes | | AM | am_tin | Armenia Tax Identification Number | 02538904 | Yes | | AO | ao_tin | Angola Tax Identification Number | 5123456789 | No | | AT | eu_vat | European VAT number | ATU12345678 | Yes | | AU | au_abn | Australian Business Number (AU ABN) | 12345678912 | Yes | | AW | aw_tin | Aruba Tax Identification Number | 12345678 | Yes | | AZ | az_tin | Azerbaijan Tax Identification Number | 0123456789 | Yes | | BA | ba_tin | Bosnia and Herzegovina Tax Identification Number | 123456789012 | Yes | | BB | bb_tin | Barbados Tax Identification Number | 1123456789012 | No | | BD | bd_bin | Bangladesh Business Identification Number | 123456789-0123 | Yes | | BE | eu_vat | European VAT number | BE0123456789 | Yes | | BF | bf_ifu | Burkina Faso Tax Identification Number (Numéro d'Identifiant Fiscal Unique) | 12345678A | Yes | | BG | eu_vat | European VAT number | BG0123456789 | Yes | | BH | bh_vat | Bahraini VAT Number | 123456789012345 | Yes | | BJ | bj_ifu | Benin Tax Identification Number (Identifiant Fiscal Unique) | 1234567890123 | Yes | | BS | bs_tin | Bahamas Tax Identification Number | 123.456.789 | No | | BY | by_tin | Belarus TIN Number | 123456789 | Yes | | CA | ca_bn | Canadian BN | 123456789 | No | | CA | ca_gst_hst | Canadian GST/HST number | 123456789RT0002 | Yes | | CA | ca_pst_bc | Canadian PST number (British Columbia) | PST-1234-5678 | No | | CA | ca_pst_mb | Canadian PST number (Manitoba) | 123456-7 | No | | CA | ca_pst_sk | Canadian PST number (Saskatchewan) | 1234567 | No | | CA | ca_qst | Canadian QST number (Québec) | 1234567890TQ1234 | Yes | | CD | cd_nif | Congo (DR) Tax Identification Number (Número de Identificação Fiscal) | A0123456M | No | | CH | ch_vat | Switzerland VAT number | CHE-123.456.789 MWST | Yes | | CL | cl_tin | Chilean TIN | 12.345.678-K | Yes | | CM | cm_niu | Cameroon Tax Identification Number (Numéro d'Identifiant fiscal Unique) | M123456789000L | No | | CR | cr_tin | Costa Rican tax ID | 1-234-567890 | No | | CV | cv_nif | Cape Verde Tax Identification Number (Número de Identificação Fiscal) | 213456789 | No | | CY | eu_vat | European VAT number | CY12345678Z | Yes | | CZ | eu_vat | European VAT number | CZ1234567890 | Yes | | DE | eu_vat | European VAT number | DE123456789 | Yes | | DK | eu_vat | European VAT number | DK12345678 | Yes | | EC | ec_ruc | Ecuadorian RUC number | 1234567890001 | No | | EE | eu_vat | European VAT number | EE123456789 | Yes | | EG | eg_tin | Egyptian Tax Identification Number | 123456789 | Yes | | ES | es_cif | Spanish NIF number (previously Spanish CIF number) | A12345678 | No | | ES | eu_vat | European VAT number | ESA1234567Z | Yes | | ET | et_tin | Ethiopia Tax Identification Number | 1234567890 | Yes | | FI | eu_vat | European VAT number | FI12345678 | Yes | | FR | eu_vat | European VAT number | FRAB123456789 | Yes | | GB | eu_vat | Northern Ireland VAT number | XI123456789 | Yes | | GB | gb_vat | United Kingdom VAT number | GB123456789 | Yes | | GE | ge_vat | Georgian VAT | 123456789 | Yes | | GN | gn_nif | Guinea Tax Identification Number (Número de Identificação Fiscal) | 123456789 | Yes | | GR | eu_vat | European VAT number | EL123456789 | Yes | | HR | eu_vat | European VAT number | HR12345678912 | Yes | | HU | eu_vat | European VAT number | HU12345678 | Yes | | HU | hu_tin | Hungary tax number (adószám) | 12345678-1-23 | No | | IE | eu_vat | European VAT number | IE1234567AB | Yes | | IN | in_gst | Indian GST number | 12ABCDE3456FGZH | Yes | | IS | is_vat | Icelandic VAT | 123456 | Yes | | IT | eu_vat | European VAT number | IT12345678912 | Yes | | KE | ke_pin | Kenya Revenue Authority Personal Identification Number | P000111111A | No | | KG | kg_tin | Kyrgyzstan Tax Identification Number | 12345678901234 | No | | KH | kh_tin | Cambodia Tax Identification Number | 1001-123456789 | Yes | | KR | kr_brn | Korean BRN | 123-45-67890 | Yes | | KZ | kz_bin | Kazakhstani Business Identification Number | 123456789012 | Yes | | LA | la_tin | Laos Tax Identification Number | 123456789-000 | No | | LI | li_vat | Liechtensteinian VAT number | 12345 | Yes | | LK | lk_vat | Sri Lanka VAT number | 123456789-1234 | Yes | | LT | eu_vat | European VAT number | LT123456789123 | Yes | | LU | eu_vat | European VAT number | LU12345678 | Yes | | LV | eu_vat | European VAT number | LV12345678912 | Yes | | MA | ma_vat | Morocco VAT Number | 12345678 | Yes | | MD | md_vat | Moldova VAT Number | 1234567 | Yes | | ME | me_pib | Montenegro PIB Number | 12345678 | No | | MK | mk_vat | North Macedonia VAT Number | MK1234567890123 | Yes | | MR | mr_nif | Mauritania Tax Identification Number (Número de Identificação Fiscal) | 12345678 | No | | MT | eu_vat | European VAT number | MT12345678 | Yes | | MX | mx_rfc | Mexican RFC number | ABC010203AB9 | No | | NG | ng_tin | Nigerian Tax Identification Number | 12345678-0001 | No | | NL | eu_vat | European VAT number | NL123456789B12 | Yes | | NO | no_vat | Norwegian VAT number | 123456789MVA | Yes | | NP | np_pan | Nepal PAN Number | 123456789 | Yes | | NZ | nz_gst | New Zealand GST number | 123456789 | Yes | | OM | om_vat | Omani VAT Number | OM1234567890 | Yes | | PE | pe_ruc | Peruvian RUC number | 12345678901 | Yes | | PH | ph_tin | Philippines Tax Identification Number | 123456789012 | Yes | | PL | eu_vat | European VAT number | PL1234567890 | Yes | | PL | pl_nip | Polish NIP number | 1234567890 | No | | PT | eu_vat | European VAT number | PT123456789 | Yes | | RO | eu_vat | European VAT number | RO1234567891 | Yes | | RS | rs_pib | Serbian PIB number | 123456789 | No | | RU | ru_inn | Russian INN | 1234567891 | Yes | | RU | ru_kpp | Russian KPP | 123456789 | Yes | | SA | sa_vat | Saudi Arabia VAT | 123456789012345 | Yes | | SE | eu_vat | European VAT number | SE123456789123 | Yes | | SG | sg_gst | Singaporean GST | M12345678X | Yes | | SI | eu_vat | European VAT number | SI12345678 | Yes | | SK | eu_vat | European VAT number | SK1234567891 | Yes | | SN | sn_ninea | Senegal NINEA Number | 12345672A2 | No | | SR | sr_fin | Suriname FIN Number | 1234567890 | Yes | | TH | th_vat | Thai VAT | 1234567891234 | Yes | | TJ | tj_tin | Tajikistan Tax Identification Number | 123456789 | Yes | | TR | tr_tin | Turkish Tax Identification Number | 0123456789 | Yes | | TW | tw_vat | Taiwanese VAT | 12345678 | Yes | | TZ | tz_vat | Tanzania VAT Number | 12345678A | Yes | | UA | ua_vat | Ukrainian VAT | 123456789 | Yes | | UG | ug_tin | Uganda Tax Identification Number | 1014751879 | Yes | | UY | uy_ruc | Uruguayan RUC number | 123456789012 | Yes | | UZ | uz_tin | Uzbekistan TIN Number | 123456789 | No | | UZ | uz_vat | Uzbekistan VAT Number | 123456789012 | Yes | | ZA | za_vat | South African VAT number | 4123456789 | Yes | | ZM | zm_tin | Zambia Tax Identification Number | 1004751879 | No | | ZW | zw_tin | Zimbabwe Tax Identification Number | 1234567890 | No | \*Stripe Tax won't apply tax if this tax ID is provided, in line with the relevant laws.