税金を徴収する

Stripe Tax では、商品と価格に保存されている、税コードや税金処理などの情報を使用して、税額を計算します。これらの設定を明示的に指定しない場合、Stripe Tax は税金設定で選択したデフォルトの税コードを使用します。

詳細については、商品の税金コードと税金処理を指定する をご覧ください。

既存の顧客の Checkout セッションで税金を計算するには、セッションを作成する際に、automatic_tax[enabled] パラメーターを true に設定します。税金は、顧客の既存の住所、または決済時に収集された新しい住所に基づいて計算できます。

税金計算に顧客の既存の住所を使用する

既存の顧客の住所をすでに収集している場合は、決済フローで収集した住所ではなく、すでに収集されている住所にを基準にして税金を計算できます。

• Checkout で税金計算に使用される顧客の住所

  利用可能であれば、Checkout は顧客の保存済みの配送先住所を税金の計算に使用します。利用できない場合、Checkout は顧客の保存済みの請求先住所を税金の計算に使用します。

• 顧客の住所が満たさなければならない要件

  既存の住所を使用して税金を計算する場合、顧客の有効な配送先住所または請求先住所が保存されている必要があります。顧客の customer.tax.automatic_tax プロパティを確認することで、保存された顧客の住所が有効かどうかを確認できます。customer.tax.automatic_tax の値が supported または not_collecting の場合、保存された住所が有効であり、その顧客の Checkout セッションで Stripe Tax を有効にできます。

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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" \
  --data-urlencode cancel_url="https://example.com/cancel"

Checkout の際に収集された住所を税金計算に使用する

Checkout は、顧客の新しい請求先住所または配送先住所を保存するように設定できます。この場合、Checkout は決済時に入力された住所を使用して税金を計算します。

• Checkout が税金計算に使用する住所

  配送先住所を収集する場合、Checkout はセッションに入力された配送先住所を使用して税金を計算します。収集しない場合、Checkout はセッションに入力された請求先住所を使用して税金を計算します。

• Checkout の際に収集された住所の保存先

  配送先住所を収集している場合、Checkout はセッションで入力された配送先住所を、顧客の customer.shipping.address プロパティに保存します。収集していない場合、Checkout はセッションで入力された請求先住所を、顧客の customer.address プロパティに保存します。どちらの場合も、税金計算に使用する住所によって既存の住所が上書きされます。

Checkout で配送先住所を収集している場合には、customer_update[shipping] プロパティを auto に設定します。これにより、Checkout から顧客に配送先情報をコピーできます。

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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" \
  --data-urlencode cancel_url="https://example.com/cancel"

Checkout で配送先住所を収集しておらず、決済時に入力された請求先住所を税金計算に使用する場合は、顧客に請求先住所を保存する必要があります。customer_update[address] プロパティを auto に設定して、新しく入力された住所が指定した顧客にコピーされるようにします。

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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" \
  --data-urlencode cancel_url="https://example.com/cancel"

Checkout セッションリソースの total_details.amount_tax プロパティに計算された税額が表示されるため、最新の税金額はここで確認できます。また、ダッシュボードを使用して、各支払いの税金額を確認することもできます。