Checkout セッションで税金を自動徴収する

Checkout Sessions は、1 回限りの購入と継続購入に対して作成できます。

顧客の税率は顧客の所在地を基準としています。この所在地は、Checkout が顧客の住所を基に決定しています。Checkout が税金の計算に使用する住所は、顧客が新規か既存か、さらに Checkout セッションで配送先住所を収集するかどうかによって決まります。

Checkout セッションを作成する際に既存の顧客を渡さないと、新しい顧客が作成され、請求先住所と配送先情報が自動的に保存されます。Checkout は請求先住所と配送先住所を使用して顧客の場所を特定し、税金を徴収します。

Checkout は、セッションで入力された配送先住所を使用して顧客の場所を特定し、税金を計算します。配送先情報を収集していない場合、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 mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

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

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

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

• Checkout が税金計算のために使用する顧客の住所: 利用可能な場合、Checkout は顧客の保存済みの配送先住所を税金の計算に使用します。利用できない場合は、顧客の保存済みの請求先住所を使用して税金を計算します。

• 顧客の住所要件: 既存の住所を使用して税金を計算する場合、顧客には有効な配送先住所または請求先住所が保存されている必要があります。顧客の 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 はセッションで入力された配送先住所を、顧客の 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[address]"=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 から Checkout によって計算された税金額を確認できます。また、ダッシュボードで支払いを表示する際にも、各支払いの税金額を確認できます。