Stripe Tax に移行する
Stripe Tax を使用すると、取引で徴収する税金を計算できます。税額は商品および顧客の所在地に基づいて、自動的に計算され、支払いに追加されます。
When you integrate with Stripe Tax, you need to update existing subscriptions to make sure that tax is automatically calculated going forward. This guide assumes that you have existing, active subscriptions. Otherwise, see how to automatically collect tax on new subscriptions or learn more about subscriptions.
以下の大まかな手順を使用して、有効なサブスクリプションを Stripe Tax に更新します。
- まだ有効化していない場合は、Stripe Tax を有効化します。
- 顧客の場所を確認します。場合によっては、場所の更新が必要になることがあります。
- 税金コードと税金処理を使用し、商品と価格を更新します。
- サブスクリプションを更新し、以降のインボイスで税金を自動的に計算します。
- サブスクリプションを適切に更新したことを確認します。
Interested in using Stripe Tax and currency conversion?
We’re developing a Payment Element integration that manages tax, discounts, shipping, and currency conversion. Read the Build a checkout page guide to learn more.
Stripe Tax を有効にする
まず、Stripe Tax を有効にする必要があります。方法については、設定ガイドをご覧ください。
顧客の地域を確認する
正しく税額を計算するには、顧客の場所を把握する必要があります。Stripe Tax の本番環境での利用を可能にした後に、ダッシュボード、API、またはダッシュボードのエクスポートを使用することで、税金の場所のステータスを確認できます。
For more information on which customer address is valid, how they’re used, or how to handle errors, see Collect customer addresses.
商品と価格を更新する
Your products and prices use the default tax behavior you assigned when activating Stripe Tax. If you’d prefer to update active products and prices to calculate tax independently, set a tax_code and tax_behavior. See the full list of available tax codes and the guide for setting up tax codes and tax behavior for more information. For more information about products and prices, including how to decide whether a price should be inclusive or exclusive, see the Tax Setup FAQ.
商品を更新する
まず、tax_code
で既存の商品を更新します。商品の tax_code
が明示的に定義されていない場合、Stripe Tax は、設定されている事前設定の商品の税コードを使用します。
以下は、API を使用して tax_code
を指定して Product を更新する方法です。
ダッシュボードで tax_code
を指定して Product を更新するには、商品ページに移動して、編集する商品を選択し、商品情報ページでドロップダウンメニューから税コードを選択します。
価格を更新する
次に、価格の税金処理を更新します。
一般的な誤り
tax_behavior
は、一度 exclusive
または inclusive
のいずれかに設定すると、後から変更することはできません。価格の税金処理を変更するには、必要な税金処理で新しい価格を作成し、古い価格をアーカイブする必要があります。
以下は、API を使用して価格を更新する方法です。
ダッシュボードで価格を更新するには、商品ページに移動し、更新する価格の商品を選択し、料金情報セクションで追加オプションを選択します。価格に税金を含めるドロップダウンメニューから、価格に関連付ける税金処理を選択します。
サブスクリプションを更新する
顧客、商品、価格を更新すると、既存のサブスクリプションを更新する準備が整います。
注意
Stripe Tax では、サブスクリプションの税金を計算するために顧客の場所を認識しておく必要があります。このため、automatic_tax[enabled]=true
が指定されたサブスクリプションのインボイスは顧客の場所が認識できていないと確定できません。インボイスが確定できなければ支払いを回収できないことになります。詳細は顧客の場所を認識できない場合のサブスクリプションの動作をご覧ください。
更新する必要があるサブスクリプションのリストを取得するには、サブスクリプションページに移動してエクスポート をクリックし、日付範囲 としてすべて を選択し、列 ドロップダウンメニューですべての列 を選択します。これで、CSV エクスポートで Automatic Tax Enabled 列を基準にして絞り込むことができます。
ステータスに応じてサブスクリプションを更新する方法:
- サブスクリプションに既存の税率がない場合は、税金の自動計算を有効にするだけで済みます。
- サブスクリプションのサブスクリプションまたはラインアイテムのレベルに既存の税率がある場合は、既存の税率を消去し、税金の自動計算を有効化する必要があります。比例配分が適用されたアイテムの作成を避けるには、この更新のスケジュールを作成することができます。
- If your subscriptions have subscriptions schedules, you need to remove instances of
automatic_tax[enabled]=false
in the subscription schedule plans.
既存の税率がないサブスクリプションを更新する
税率が設定されていないサブスクリプションを更新するには、automatic_tax.enabled
を true
に設定します。
automatic_tax.enabled=true
に設定すると、そのサブスクリプションで作成されたその後のすべてのインボイスの自動税金計算が有効になります。
これをダッシュボードで実行するには、サブスクリプションを更新し、税金を自動計算オプションをオンにします。
既存の税率でサブスクリプションを更新する
サブスクリプションレベルで税率が設定されたサブスクリプションを更新するには、automatic_tax
を有効にする前に税率を削除する必要があります。更新する際には、以下を行います。
- 各サブスクリプション
item
のdefault_tax_rates
フィールドおよびtax_rates
フィールドで空の文字列を渡します。こうすることにより、サブスクリプション (default_tax_rates
) レベルとラインアイテム (tax_rates
) レベルの両方で税率がクリアされます。 automatic_tax.enabled
をtrue
に設定します。
この更新をダッシュボードで実行するには、サブスクリプションを編集し、税金を自動計算 オプションを有効にします。これ以降ダッシュボードは、税金を自動的に計算し、既存の税率を削除します。価格で tax_behavior
を設定する更新をしていない場合、ダッシュボードで、サブスクリプションを更新する前に、不足の詳細を更新するように求められます。
Update Subscriptions with subscription schedules
If you need to collect tax and any of your subscriptions include a subscription schedule that sets automatic_tax[enabled]=false
, you must remove this parameter. To do this, update all phases of the subscription’s schedule by removing automatic_tax[enabled]=false
and setting default_settings[automatic_tax][enabled]=true
.
When you update a subscription schedule, you need to pass in all current and future phases. To do this, verify the set parameters, then enable Stripe Tax in the subscription schedule.
To update the subscription schedule after you obtain it, remove the automatic_tax[enabled]=false
parameter, and pass down the other phases and parameters:
更新をスケジュールする
比例配分アイテムが作成されないようにするには、次のサイクルの開始時に更新するようにスケジュールできます。
現在、サブスクリプションの更新をスケジュールするには、API を使用する必要があります。
更新を確認する
サブスクリプションを適切に更新したことを確認するには、サブスクリプションの次回のインボイスを取得し、税額計算の結果を調べます。
次回のインボイスの tax
フィールドと total_tax_amounts
フィールド、およびラインアイテムごとの tax_amounts
フィールドから税額を取得できます。インボイスには、計算のステータスを表示する automatic_tax
フィールドがあります。このステータスは以下の 3 つのいずれかです。
ステータス | 説明 | 想定されるアクション |
---|---|---|
complete | Stripe Tax は支払いに対する税金の評価を完了しました。 | 税額は、最新のインボイスの tax および total_tax_amounts フィールドから、または各ラインアイテムの tax_amounts フィールドから取得できます。 |
requires_location_inputs | Stripe Tax に顧客の地域を特定できるだけの十分な情報がなかったため、税金を評価できませんでした。 | 顧客から番地などの詳細情報を収集して、customer.address フィールドを更新します。 |
failed | Stripe の内部エラー。 | 再度リクエストをお試しください。問題が解決しない場合は、Stripe サポートにご連絡ください。 |