コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン

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

Checkout で税金を自動的に計算する方法をご紹介します。

Stripe Tax は、Checkout セッション中に累計されたすべての購入とサブスクリプションの税金を自動的に計算します。Checkout を導入していない場合は、支払いの受け付けガイドを使用して導入を完了する必要があります。

この動画では、Stripe Checkout などのホスト型インテグレーションを使用して、税金の自動徴収を有効にする方法を示しています。

動画コンテンツの読み込み中...

Checkout セッションを作成する

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

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

新規顧客既存の顧客
請求先住所のみを収集Checkout は Checkout セッションに入力された顧客の請求先住所を基準に税金を計算します。顧客が以前に保存した配送先住所を所有している場合、Checkout はこの住所を基準に税金を計算します。それ以外の場合は、決済時に入力された請求先住所 (customer_update[address]=auto を指定)、または顧客に保存された請求先住所 (デフォルト動作) を基準に税金を計算できます。
配送先住所を収集Checkout は Checkout セッションに入力された顧客の配送先住所を基準に税金を計算します。Checkout は Checkout セッションに入力された顧客の配送先住所を基準に税金を計算します。「この場合、顧客の既存の住所は使用されません。」

メモ

Checkoutで Stripe Tax を使用しているときに Google Pay が決済手段として提供されるようにするには、配送先住所の収集を要求するか、既存の顧客に保存された配送先住所を提供する必要があります。Stripe Tax での Apple Pay は、顧客のブラウザーが Apple Pay バージョン 12 以上をサポートしている場合にのみ表示されます。

新規顧客の税金を計算する

既存の顧客を特定できない場合に、収集した請求先・配送先住所を含む 顧客または を作成するには、Checkout Session で customer_creation=always を設定してください。

決済では、配送先住所 (指定されている場合) または請求先住所の地域に基づいて税額を計算します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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_creation=always \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

既存の顧客の税金を計算する

既存の顧客に対して作成された Checkout セッションで税額を計算するには、automatic_tax[enabled] を true に設定し、customer ID を指定します。Checkout では税額計算に以下の住所の優先順位を使用します。

  1. 指定されている場合には、Checkout は税額計算に収集された配送先住所を使用します。配送先住所を収集するには、customer_update[shipping] を auto に設定し、収集された配送先住所を Customer に追加または更新する必要があります。

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    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"

  2. 配送先住所を収集しない場合には、Checkout は税額計算に Customer の既存の配送先住所を使用します (可能な場合)。

  3. 配送先住所が利用できない場合、Checkout は税額計算に請求先住所を使用します。請求先住所を常に収集するには、billing_address_collection を required に設定し、必要に応じて収集する場合には auto (デフォルト) のままにします。Checkout で請求先住所を収集する場合、customer_update[address] を auto に設定すると、収集した住所を税額計算に使用するように Stripe Tax に指示できます。一方、never に設定した場合には、収集した住所ではなく Customer の既存の住所が税額計算に使用されます。

    Command Line
    cURL
    Stripe CLI
    Ruby
    Python
    PHP
    Java
    Node.js
    Go
    .NET
    No results
    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 billing_address_collection=required \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

  4. それ以外の場合、Checkout はアドレス階層に従って顧客のアドレスを使用します。

レスポンスを確認する

最新の税金計算の結果を調べるには、Checkout セッションリソースの total_details.amount_tax から Checkout によって計算された税金額を確認できます。また、ダッシュボードで支払いを表示する際にも、各支払いの税金額を確認できます。

オプション商品と価格を更新する

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

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

オプションインラインで商品を作成する際に課税するコードを指定する

line_items.price_data.product_data で決済セッションを作成するときは、リクエストで税コードを直接指定できます。これは、既存の商品 ID を使用するのではなく、新しい商品を作成するときに行うことをお勧めします。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][product_data][tax_code]"=txcd_99999999 \
  -d "line_items[0][quantity]"=1 \
  -d "automatic_tax[enabled]"=true \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

txcd_99999999 を商品に適切な税コードに置き換えます。税コードは、税務上の商品をどのように分類するかを決定します。税コードを指定しない場合、Stripe Tax は税務設定のデフォルトの税コードを使用します。

参照情報