# 税金を徴収する Stripe Checkout で 1 回限りの支払いの税金を徴収する方法は以下のとおりです。 # Hosted page > This is a Hosted page for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/taxes?payment-ui=stripe-hosted. Stripe Tax を利用すると、Checkout の使用時に 1 回限りの支払いと継続支払いに対する税金を計算できます。Stripe Tax を有効にして、Checkout でのすべての購入とサブスクリプションに対する税金を自動計算できます。 ## Checkout セッションを作成する Checkout Sessions は、1 回限りの購入と継続購入に対して作成できます。 新規顧客の税金を計算する際に、Checkout は提供された配送先住所または請求先住所を確認して使用します。既存の顧客の場合、Checkout は、顧客に関連付けられた配送先住所または請求先住所を確認して、税金計算に使用します。既存の顧客の新しい請求先住所または配送先住所が取り込まれた場合、Checkout で以前の請求先住所または配送先住所が自動的に上書きされることはありません。顧客住所の変更を明示的にリクエストする必要があります。 ### Apple Pay および Google Pay Checkoutで Stripe Tax を使用しているときに Google Pay が決済手段として提供されるようにするには、配送先住所の収集を要求するか、既存の顧客に保存された配送先住所を提供する必要があります。Stripe Tax での Apple Pay は、顧客のブラウザーが Apple Pay バージョン 12 以上をサポートしている場合にのみ表示されます。 ## 新規顧客の税金を計算する Checkout セッションの作成時に既存の顧客を渡さないときは、Checkout によって新規顧客が作成され、請求先住所と配送先情報が自動的に保存されます。Checkout はセッションで入力された配送先住所を使用して顧客の場所を判別し、税金を計算します。配送先情報を収集しない場合、Checkout は請求先住所を使用します。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=2 \ -d "automatic_tax[enabled]"=true \ -d mode=payment \ --data-urlencode success_url="https://example.com/success" ``` ## Optional: 商品と価格を更新する Stripe Tax では、*商品* (Products represent what your business sells—whether that's a good or a service)と*価格* (Prices define how much and how often to charge for products. This includes how much the product costs, what currency to use, and the interval if the price is for subscriptions)に保存されている、*税コード* (A tax code is the category of your product for tax purposes)や*税金処理* (Tax behavior determines whether you want to include taxes in the price ("inclusive") or add them on top ("exclusive"))などの情報を使用して、税額を計算します。これらの設定を明示的に指定しない場合、Stripe Tax は[税金設定](https://dashboard.stripe.com/settings/tax)で選択したデフォルトの税コードを使用します。 詳細については、[商品の税金コードと税金処理を指定する](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md) をご覧ください。 ## Optional: 既存の顧客の税金を計算する 既存の顧客の Checkout セッションで税金を計算するには、セッションを作成する際に、`automatic_tax[enabled]` パラメーターを `true` に設定します。税金は、顧客の既存の住所、または決済時に収集された新しい住所に基づいて計算できます。 ### 税金計算に顧客の既存の住所を使用する 既存の顧客の住所をすでに収集している場合は、決済フローで収集した住所ではなく、すでに収集されている住所にを基準にして税金を計算できます。 - Checkout で税金計算に使用される顧客の住所 利用可能であれば、Checkout は顧客の保存済みの[配送先住所](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address)を税金の計算に使用します。利用できない場合、Checkout は顧客の保存済みの[請求先住所](https://docs.stripe.com/api/customers/object.md#customer_object-address)を税金の計算に使用します。 - 顧客の住所が満たさなければならない要件 既存の住所を使用して税金を計算する場合、顧客の有効な[配送先住所](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address)または[請求先住所](https://docs.stripe.com/api/customers/object.md#customer_object-address)が保存されている必要があります。顧客の [customer.tax.automatic_tax](https://docs.stripe.com/api/customers/object.md#customer_object-tax-automatic_tax) プロパティを確認することで、保存された顧客の住所が有効かどうかを確認できます。`customer.tax.automatic_tax` の値が `supported` または `not_collecting` の場合、保存された住所が有効であり、その顧客の Checkout セッションで Stripe Tax を有効にできます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=2 \ -d "automatic_tax[enabled]"=true \ -d customer="{{CUSTOMER_ID}}" \ -d mode=payment \ --data-urlencode success_url="https://example.com/success" ``` ### Checkout の際に収集された住所を税金計算に使用する Checkout は、顧客の新しい請求先住所または配送先住所を保存するように設定できます。この場合、Checkout は決済時に入力された住所を使用して税金を計算します。 - Checkout が税金計算に使用する住所 [配送先住所を収集](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection)する場合、Checkout はセッションに入力された配送先住所を使用して税金を計算します。収集しない場合、Checkout はセッションに入力された請求先住所を使用して税金を計算します。 - Checkout の際に収集された住所の保存先 [配送先住所を収集](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection)している場合、Checkout はセッションで入力された配送先住所を、顧客の [customer.shipping.address](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) プロパティに保存します。収集していない場合、Checkout はセッションで入力された請求先住所を、顧客の [customer.address](https://docs.stripe.com/api/customers/object.md#customer_object-address) プロパティに保存します。どちらの場合も、税金計算に使用する住所によって既存の住所が上書きされます。 Checkout で配送先住所を収集している場合には、`customer_update[shipping]` プロパティを `auto` に設定します。これにより、Checkout から顧客に配送先情報をコピーできます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=2 \ -d "automatic_tax[enabled]"=true \ -d customer="{{CUSTOMER_ID}}" \ -d "customer_update[shipping]"=auto \ -d "shipping_address_collection[allowed_countries][0]"=US \ -d mode=payment \ --data-urlencode success_url="https://example.com/success" ``` Checkout で配送先住所を収集しておらず、決済時に入力された請求先住所を税金計算に使用する場合は、顧客に請求先住所を保存する必要があります。`customer_update[address]` プロパティを `auto` に設定して、新しく入力された住所が指定した顧客にコピーされるようにします。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=2 \ -d "automatic_tax[enabled]"=true \ -d customer="{{CUSTOMER_ID}}" \ -d "customer_update[shipping]"=auto \ -d mode=payment \ --data-urlencode success_url="https://example.com/success" ``` ## Optional: レスポンスを確認する Checkout セッションリソースの [total_details.amount_tax](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-total_details) プロパティに計算された税額が表示されるため、最新の税金額はここで確認できます。また、[ダッシュボード](https://dashboard.stripe.com/)を使用して、各支払いの税金額を確認することもできます。 # Embedded page > This is a Embedded page for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/taxes?payment-ui=embedded-form. Stripe Tax を利用すると、Checkout の使用時に 1 回限りの支払いと継続支払いに対する税金を計算できます。Stripe Tax を有効にして、Checkout でのすべての購入とサブスクリプションに対する税金を自動計算できます。 ## Checkout セッションを作成する 商品と価格を更新すると、Checkout セッションで税金計算を開始する準備が整います。1 回限りの購入と継続的な購入のセッションを作成できます。 新規顧客の税金を計算する際に、Checkout は提供された配送先住所または請求先住所を確認して使用します。既存の顧客の場合、Checkout は、顧客に関連付けられた配送先住所または請求先住所を確認して、税金計算に使用します。既存の顧客の新しい請求先住所または配送先住所が取り込まれた場合、Checkout で以前の請求先住所または配送先住所が自動的に上書きされることはありません。顧客住所の変更を明示的にリクエストする必要があります。 ### Apple Pay および Google Pay Checkoutで Stripe Tax を使用しているときに Google Pay が決済手段として提供されるようにするには、配送先住所の収集を要求するか、既存の顧客に保存された配送先住所を提供する必要があります。Stripe Tax での Apple Pay は、顧客のブラウザーが Apple Pay バージョン 12 以上をサポートしている場合にのみ表示されます。 ## 新規顧客の税金を計算する Checkout セッションの作成時に既存の顧客を渡さないときは、Checkout によって新規顧客が作成され、請求先住所と配送先情報が自動的に保存されます。Checkout はセッションで入力された配送先住所を使用して顧客の場所を判別し、税金を計算します。配送先情報を収集しない場合、Checkout は請求先住所を使用します。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=2 \ -d "automatic_tax[enabled]"=true \ -d mode=payment \ -d ui_mode=embedded \ --data-urlencode return_url="https://example.com/return" ``` ## Optional: 商品と価格を更新する Stripe Tax では、*商品* (Products represent what your business sells—whether that's a good or a service)と*価格* (Prices define how much and how often to charge for products. This includes how much the product costs, what currency to use, and the interval if the price is for subscriptions)に保存されている、*税コード* (A tax code is the category of your product for tax purposes)や*税金処理* (Tax behavior determines whether you want to include taxes in the price ("inclusive") or add them on top ("exclusive"))などの情報を使用して、税額を計算します。これらの設定を明示的に指定しない場合、Stripe Tax は[税金設定](https://dashboard.stripe.com/settings/tax)で選択したデフォルトの税コードを使用します。 詳細については、[商品の税金コードと税金処理を指定する](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md) をご覧ください。 ## Optional: 既存の顧客の税金を計算する 既存の顧客の Checkout セッションで税金を計算するには、セッションを作成する際に、`automatic_tax[enabled]` パラメーターを `true` に設定します。税金は、顧客の既存の住所、または決済時に収集された新しい住所に基づいて計算できます。 ### 税金計算に顧客の既存の住所を使用する 既存の顧客の住所をすでに収集している場合は、決済フローで収集した住所ではなく、すでに収集されている住所にを基準にして税金を計算できます。 - Checkout で税金計算に使用される顧客の住所 利用可能であれば、Checkout は顧客の保存済みの[配送先住所](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address)を税金の計算に使用します。利用できない場合、Checkout は顧客の保存済みの[請求先住所](https://docs.stripe.com/api/customers/object.md#customer_object-address)を税金の計算に使用します。 - 顧客の住所が満たさなければならない要件 既存の住所を使用して税金を計算する場合、顧客の有効な[配送先住所](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address)または[請求先住所](https://docs.stripe.com/api/customers/object.md#customer_object-address)が保存されている必要があります。顧客の [customer.tax.automatic_tax](https://docs.stripe.com/api/customers/object.md#customer_object-tax-automatic_tax) プロパティを確認することで、保存された顧客の住所が有効かどうかを確認できます。`customer.tax.automatic_tax` の値が `supported` または `not_collecting` の場合、保存された住所が有効であり、その顧客の Checkout セッションで Stripe Tax を有効にできます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=2 \ -d "automatic_tax[enabled]"=true \ -d customer="{{CUSTOMER_ID}}" \ -d mode=payment \ -d ui_mode=embedded \ --data-urlencode return_url="https://example.com/return" ``` ### Checkout の際に収集された住所を税金計算に使用する Checkout は、顧客の新しい請求先住所または配送先住所を保存するように設定できます。この場合、Checkout は決済時に入力された住所を使用して税金を計算します。 - Checkout が税金計算に使用する住所 [配送先住所を収集](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection)する場合、Checkout はセッションに入力された配送先住所を使用して税金を計算します。収集しない場合、Checkout はセッションに入力された請求先住所を使用して税金を計算します。 - Checkout の際に収集された住所の保存先 [配送先住所を収集](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_address_collection)している場合、Checkout はセッションで入力された配送先住所を、顧客の [customer.shipping.address](https://docs.stripe.com/api/customers/object.md#customer_object-shipping-address) プロパティに保存します。収集していない場合、Checkout はセッションで入力された請求先住所を、顧客の [customer.address](https://docs.stripe.com/api/customers/object.md#customer_object-address) プロパティに保存します。どちらの場合も、税金計算に使用する住所によって既存の住所が上書きされます。 Checkout で配送先住所を収集している場合には、`customer_update[shipping]` プロパティを `auto` に設定します。これにより、Checkout から顧客に配送先情報をコピーできます。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=2 \ -d "automatic_tax[enabled]"=true \ -d customer="{{CUSTOMER_ID}}" \ -d "customer_update[shipping]"=auto \ -d "shipping_address_collection[allowed_countries][0]"=US \ -d mode=payment \ -d ui_mode=embedded \ --data-urlencode return_url="https://example.com/return" ``` Checkout で配送先住所を収集しておらず、決済時に入力された請求先住所を税金計算に使用する場合は、顧客に請求先住所を保存する必要があります。`customer_update[address]` プロパティを `auto` に設定して、新しく入力された住所が指定した顧客にコピーされるようにします。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]"="{{PRICE_ID}}" \ -d "line_items[0][quantity]"=2 \ -d "automatic_tax[enabled]"=true \ -d customer="{{CUSTOMER_ID}}" \ -d "customer_update[shipping]"=auto \ -d mode=payment \ -d ui_mode=embedded \ --data-urlencode return_url="https://example.com/return" ``` ## Optional: レスポンスを確認する Checkout セッションリソースの [total_details.amount_tax](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-total_details) プロパティに計算された税額が表示されるため、最新の税金額はここで確認できます。また、[ダッシュボード](https://dashboard.stripe.com/)を使用して、各支払いの税金額を確認することもできます。