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

ソフトウェアプラットフォームのための Tax

連結アカウントに納税義務がある場合に、連結アカウントで Stripe Tax の使用と税金の徴収を可能にする方法をご紹介します。

Stripe Tax を使用すると、100 カ国以上の国々でさまざまな商品カテゴリーの間接税を計算、徴収、報告できます。プラットフォームとして Stripe Tax を使用する場合、事前構築済み税務コンプライアンス機能を連結アカウントに提供できます。

このガイドは、連結アカウントが税金の徴収、納税申告書の提出、申告の義務を負う場合に使用します。

  1. 連結アカウントの税金を設定する
  2. (オプション) 商品カタログに税コードを割り当てる
  3. 税金の計算と徴収を導入する
  4. Stripe Tax のレポートにアクセスする

連結アカウントの税金を設定する

プラットフォームは、税額計算を有効にする前に、連結アカウントが税金設定と登録を設定していることを確認する必要があります。これは以下のように行います。

Stripe ダッシュボードを使用する連結アカウント

このオプションを利用できるのは、Stripe ダッシュボードにアクセスできる連結アカウント (Standard アカウントなど) のみです。本社所在地、事前設定の税コード、納税登録の追加に Stripe ダッシュボードを使用するように連結アカウントに依頼してください。連結アカウントの登録で Stripe Tax を有効にすると、貴社自身で本社所在地と事前設定の税コードを収集することができます。そのためには、ダッシュボードの Connect アカウント登録オプションで設定を行います。

プラットフォーム内に税金インターフェイスを作成する

このオプションにより、Stripe ダッシュボードにアクセスできないアカウント (Custom アカウント、Express アカウントなど) が Stripe Tax を設定できるようになります。

プラットフォームが連結アカウントの本社所在地とその他のデフォルト値を設定するには、インターフェイスを構築して Tax Settings API を使用する必要があります。さらにプラットフォームで Tax Registrations API を使用して、連結アカウントに納税義務がある場所の納税登録を追加する必要があります。

プラットフォームで Connect の埋め込みコンポーネントを使用する

Connect の埋め込みコンポーネントを使用すると、最小限の開発で、ウェブサイトで直接、Stripe の税務コンプライアンスに対応したシステムを連結アカウントに提供できます。Stripe では、埋め込みコンポーネントのシステムを定期的に更新しているため、税務コンプライアンス要件は常に最新の状態に維持されます。

Stripe は税金に次の 2 つのコンポーネントを提供しています。

  • 税金の設定: 本社の住所や事前設定された税コードなど、連結アカウントが税金を計算するために必要な情報を収集します。
  • 税金登録: 連結アカウントは、現地の税務当局に登録した場所を管理できます。登録を追加すると、Stripe は特定の場所の税金を計算して徴収できるようになります。

税金設定と納税登録をウェブサイトに埋め込むには、次のようにします。

  1. 埋め込みコンポーネント導入のクイックスターを使用して、環境を設定します。

  2. tax_settings: {enabled: true} および tax_registrations: {enabled: true} を指定して AccountSession を作成します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account={{CONNECTED_ACCOUNT_ID}} \
  -d "components[tax_settings][enabled]"=true \
  -d "components[tax_registrations][enabled]"=true
  1. 税金設定または税金登録コンポーネントを DOM に追加します。

アカウントセッションを作成して、ConnectJS を初期化すると、フロントエンドに支払いのコンポーネントを表示できます。

taxPage.jsx
React
HTML + JavaScript
No results
// Include this React component
import {
  ConnectTaxSettings,
  ConnectTaxRegistrations,
  ConnectComponentsProvider,
} from "@stripe/react-connect-js";

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      {/* You can also use a tab layout */}
      <div>
        <h2>Tax Business Details</h2>
        <ConnectTaxSettings />
      <div>
      <div style={{ marginTop: "12px" }}>
        <h2>Tax Registrations</h2>
        <ConnectTaxRegistrations />
      <div>
    </div>
  </ConnectComponentsProvider>
);

税金設定コンポーネントのプレビュー

税金設定コンポーネントを使用すると、連結アカウントは本社の住所と事前設定された税コードを設定できます。連結アカウントの税金を計算するには、両方の属性が必要です。

税務登録コンポーネント

税務登録コンポーネントを使用すると、連結アカウントは税務登録を管理できます。連結アカウントが税務登録を追加していないものの、その管轄区域の税金を計算している場合、Stripe Tax は税額 0.00 を返し、課税対象の理由を not_collecting に設定します。

プラットフォームは、連結アカウントが Stripe Tax を設定して税額計算を有効にしているかどうかを確認する必要があります。

注

サインインは、連結アカウントで Stripe Tax を使用する準備が整っているかを確認します。

ダッシュボードの連結アカウントページで、Stripe Tax が使用できるアカウントをフィルタリング表示できます。また、以下の Stripe Tax 関連の列からアカウントをエクスポートすることも可能です。

  • 税金設定のステータス: 値 active は、アカウントで Stripe Tax を使用する準備ができていることを示します。値 pending は、一部の必須フィールドが未入力であることを示します。
  • 税金しきい値のステータス: exceeded 値は、アカウントの計算された売上または取引がその場所のしきい値を超えており、企業は納税登録する必要がある可能性が高いことを示します。詳細については、義務を監視するを参照してください。
  • 税務登録のステータス: 値 active は、アカウントに 1 つ以上の有効な税務登録があることを示します。

また、Tax Settings API を使用して、アカウントに Stripe Tax が設定されているかどうかを確認することもできます。

商品カタログに税コードを割り当てる
オプション

Stripe Tax で税金を計算するには、対象の商品を税コードに分類する必要があります。その方法の一つは、連結アカウントのそれぞれに事前設定の税コードを指定することです。連結アカウントで通常販売するアイテムが同一の種別に属するときは、多くの場合、これで十分です。

ただし、より詳細に制御できる機能をユーザーに提供する場合は、ユーザーが税コードを各商品にマッピングできるようにすることができます。サポートされている商品税コードのリストは Stripe の Tax Code API で取得できます。また、連結アカウントが特定の種類の商品のみを販売している場合は、このリストの一部分を提供することもできます。

税金の計算と徴収を導入する

決済フローの一部として税金を計算するには、Stripe Tax と統合する必要があります。

Payment Links

1 回限りの支払いの Payment Links

現在、Stripe Payment Links で連結アカウント側の納税義務に対応している支払いタイプのいずれか 1 つを選択します。

Payment Links API コールの場合:

  • 連結アカウント ID の値を指定した Stripe-Account ヘッダーを含めます。
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=2 \
  -d "automatic_tax[enabled]"=true

サブスクリプションの Payment Links

現在、Stripe Payment Links で連結アカウント側の納税義務に対応している支払いタイプのいずれか 1 つを選択します。

Payment Links API コールの場合:

  • 連結アカウント ID の値を指定した Stripe-Account ヘッダーを含めます。
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "automatic_tax[enabled]"=true

Checkout

1 回限りの支払いの Checkout セッション

現在、Stripe Checkout で連結アカウント側の納税義務に対応している支払いタイプのいずれか 1 つを選択します。

Checkout Sessions API コールの場合:

  • 連結アカウント ID の値を指定した Stripe-Account ヘッダーを含めます。
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
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -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 セッション

現在、Stripe Checkout で連結アカウント側の納税義務に対応している支払いタイプのいずれか 1 つを選択します。

Checkout Sessions API コールの場合:

  • 連結アカウント ID の値を指定した Stripe-Account ヘッダーを含めます。
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
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "automatic_tax[enabled]"=true \
  -d mode=subscription \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

Billing

サブスクリプション

現在、Stripe サブスクリプションで連結アカウントの納税義務に対応している支払いタイプのいずれか 1 つを選択します。

Subscriptions API コールの場合:

  • 連結アカウント ID の値を指定した Stripe-Account ヘッダーを含めます。
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "items[0][quantity]"=1 \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d "automatic_tax[enabled]"=true

Invoicing

現在、Stripe Invoicing で連結アカウント側の納税義務に対応している支払いタイプのいずれか 1 つを選択します。

Invoices API コールの場合:

  • 連結アカウント ID の値を指定した Stripe-Account ヘッダーを含めます。
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d "automatic_tax[enabled]"=true

Stripe Tax API を使用するカスタムフロー

Payment Intents

現在、Stripe Tax API で連結アカウント側の納税義務に対応している支払いタイプのいずれか 1 つを選択します。

Tax Calculation API コールの場合:

  • 連結アカウント ID の値を指定した Stripe-Account ヘッダーを含めます。
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/tax/calculations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d currency=usd \
  -d "line_items[0][amount]"=1000 \
  -d "line_items[0][reference]"=L1 \
  -d customer=
"{{CUSTOMER_ID}}"

Payment Intents API コールの場合:

  • 連結アカウント ID の値を指定した Stripe-Account ヘッダーを含めます。
  • 税金計算によって返された amount_total を指定して amount を含めます。
  • 税金計算によって返された id を指定して metadata[tax_calculation] を含めます。
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1000 \
  -d currency=usd \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d "metadata[tax_calculation]"=
"{{CALCULATION_ID}}"

顧客から徴収した税金を記録して、返金に備えるために、税取引も作成する必要があります。

Stripe 外部での支払い

Stripe Tax API を使用した導入手順をご確認ください。連結アカウントが納税義務を負うように設定するには、以下のように Tax Calculation API コールで連結アカウント ID の値を指定した Stripe-Account ヘッダーを含めます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/tax/calculations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d currency=usd \
  -d "line_items[0][amount]"=1000 \
  -d "line_items[0][reference]"=L1 \
  -d customer=
"{{CUSTOMER_ID}}"

顧客から徴収した税金を記録して、返金に備えるために、税取引も作成する必要があります。

導入後、Stripeは、ユーザーに有効な登録がある管轄区域で税金の徴収を自動的に開始します。

注

実装内容とはかかわりなく、連結アカウントは、デフォルトで徴収された税金の返金を受けます。

Stripe Tax のレポートにアクセスする

連結アカウントは、Stripe Tax のレポートを使用して税金を適正に申告して納付することができます。

Stripe ダッシュボードを使用する連結アカウント

このオプションは、Stripe ダッシュボードにアクセスできるアカウント (Standard アカウントなど) のみが利用できます。

連結アカウントは、Stripe ダッシュボードの税務申告機能を使用して各自の納税申告書にアクセスできます。

Stripe API を使用する

このオプションは、Stripe ダッシュボードにアクセスできないアカウント (Custom アカウント、Expressアカウントなど) に使用します。

プラットフォームでは、Report API で connected_account_tax.transactions.itemized.2 レポートタイプを指定して、項目別の税取引をダウンロードすることができます。

プラットフォームで次のコマンドを実行すると、すべての連結アカウントの 2022 年の全取引がダウンロードされます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/reporting/report_runs \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d report_type="connected_account_tax.transactions.itemized.2" \
  -d "parameters[interval_start]"=1641013200 \
  -d "parameters[interval_end]"=1672549200

プラットフォームで次のコマンドを実行すると、1 つの連結アカウントの 2022 年の全取引がダウンロードされます。

注

連結アカウントのレポートを生成するには、Stripe-Account ヘッダーの代わりに connected_account パラメーターを使用します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/reporting/report_runs \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d report_type="connected_account_tax.transactions.itemized.2" \
  -d "parameters[interval_start]"=1641013200 \
  -d "parameters[interval_end]"=1672549200 \
  -d "parameters[connected_account]"={{CONNECTED_ACCOUNT_ID}}

Export Tax Transactions コンポーネントを使用

このコンポーネントの詳細と統合については、税務取引をエクスポートを参照してください。

参照情報

このページはお役に立ちましたか。
はいいいえ