既存のサブスクリプションを更新する

まず、Stripe Tax を有効にする必要があります。方法については、設定ガイドをご覧ください。

正しく税額を計算するには、顧客の場所を把握する必要があります。Stripe Tax の本番環境での利用を可能にした後に、ダッシュボード、API、またはダッシュボードのエクスポートを使用することで、税金の場所のステータスを確認できます。

有効な顧客の住所、その使用方法、エラーの対処方法については、顧客の住所を収集するで詳細をご覧ください。

商品と価格には、Stripe Tax を有効にしたときに割り当てたデフォルトの税金処理が使用されます。税金を別途計算するために有効な商品と価格を更新する場合は、tax_code と tax_behavior を設定します。詳細については、すべての使用可能な税コードのリストと、税コードおよび税金処理の設定のガイドをご覧ください。価格を内税にするか外税にするかの決定方法など、商品と価格についての詳細は、Tax の設定に関してよくある質問をご覧ください。

商品を更新する

まず、tax_code で既存の商品を更新します。商品の tax_code が明示的に定義されていない場合、Stripe Tax は、設定されている事前設定の商品の税コードを使用します。

価格を更新する

次に、価格の税金処理を更新します。

顧客、商品、価格を更新すると、既存のサブスクリプションを更新する準備が整います。

ダッシュボードのサブスクリプションページから、更新が必要なサブスクリプションのリストを取得します。フィルターをクリックし、税金の自動計算にチェックマークを付け、無効を選択すると、税金の自動計算が有効化されていないサブスクリプションのみが表示されます。または、フィルターで絞り込んだすべてのサブスクリプションをエクスポートして、CSV ファイルとして表示することもできます。これを行うには、エクスポートをクリックし、日付範囲としてすべてを選択します。

ステータスに応じてサブスクリプションを更新する方法:

• サブスクリプションに既存の税率がない場合は、税金の自動計算を有効にするだけで済みます。
• サブスクリプションのサブスクリプションまたはラインアイテムのレベルに既存の税率がある場合は、既存の税率を消去し、税金の自動計算を有効化する必要があります。比例配分が適用されたアイテムの作成を避けるには、この更新のスケジュールを作成することができます。
• サブスクリプションにサブスクリプションスケジュールがある場合、サブスクリプションスケジュールプランで automatic_tax[enabled]=false のインスタンスを削除する必要があります。

既存の税率がないサブスクリプションを更新する

既存の税率でサブスクリプションを更新する

サブスクリプションのスケジュールを使用してサブスクリプションを更新する

税金を徴収する必要があり、automatic_tax[enabled]=false が設定されているサブスクリプションスケジュールがサブスクリプションに含まれている場合は、このパラメーターを削除する必要があります。このためには、automatic_tax[enabled]=false を削除して default_settings[automatic_tax][enabled]=true を設定することで、サブスクリプションのスケジュールのすべてのフェーズを更新します。

サブスクリプションのスケジュールを更新する際には、現在および以降のフェーズをすべて渡す必要があります。このためには、設定されているパラメーターを確認してから、サブスクリプションのスケジュールで Stripe Tax を有効にします。

curl https://api.stripe.com/v1/subscription_schedules/
{{SUBSCRIPTION_SCHEDULE_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

サブスクリプションのスケジュールを取得後に更新するには、automatic_tax[enabled]=falseパラメーターを削除し、他のフェーズとパラメーターを渡します。

curl https://api.stripe.com/v1/subscription_schedules/
{{SUBSCRIPTION_SCHEDULE_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "phases[0][items][0][price]"=price_1GqNdGAJVYItwOKqEHb \
  -d "phases[0][items][0][quantity]"=1 \
  -d "phases[0][start_date]"=1577865600 \
  -d "phases[0][end_date]"=1578038400 \
  -d "phases[1][items][0][price]"=price_1GqNdGAJVYItwOKqEHb \
  -d "phases[1][items][0][quantity]"=2 \
  -d "phases[1][start_date]"=1578038400 \
  -d "phases[1][end_date]"=1580544000 \
  -d "default_settings[automatic_tax][enabled]"=true

更新をスケジュールする

比例配分アイテムが作成されないようにするには、次のサイクルの開始時に更新するようにスケジュールできます。

現在、サブスクリプションの更新をスケジュールするには、API を使用する必要があります。

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

subscription = Stripe::Subscription.retrieve(
  '{{SUBSCRIPTION_ID}}',
)
schedule = Stripe::SubscriptionSchedule.create({
  from_subscription: subscription.id
})
Stripe::SubscriptionSchedule.update(
  schedule.id,
  {
    end_behavior: 'release',
    phases: [
      # The first phase contains items for the
      # latest subscription invoice
      {
        items: [
          # Prices and tax_rates for each item
          {
            price: '{{PRICE_ID}}',
            tax_rates: [
              '{{TAX_RATE_ID}}'
            ]
          }
        ],
        default_tax_rates: ['{{TAX_RATE_ID}}'],
        start_date: subscription.current_period_start,
        end_date: subscription.current_period_end
      },
      # The second phase removes manual tax rates and enables
      # automatic tax calculation
      {
        items: [
          # Prices for each item with tax_rates: ''
          {
            price: '{{PRICE_ID}}',
            tax_rates: ''
          }
        ],
        default_tax_rates: '',
        automatic_tax: {enabled: true},
        iterations: 1
      }
    ]
  }
)

Update subscriptions through Stripe Tax

You can update your subscriptions through Stripe Tax. Updating existing subscriptions ensures that tax is calculated and collected automatically.

You can update subscriptions that meet the following criteria:

• Are active
• Don’t automatically collect tax
• Have sufficient address information to calculate tax

You can’t update subscriptions that are:

• On subscription schedules (refer to this subsection to update subscriptions on subscription schedules)
• Using charge types: Destination charges or Separate charges and transfers

How the process works:

• Removal of manual tax rates: Any existing tax rates on the subscription are removed during the update process.
• Processing time: The update process can take up to 5 business days to complete.
• Completion notification: You receive an email notification after the update is completed.
• Proration: The update doesn’t prorate the tax changes. The updates come into effect from the next billing cycle.

サブスクリプションを適切に更新したことを確認するには、サブスクリプションの次回のインボイスを取得し、税額計算の結果を調べます。

You can retrieve the tax amounts from the tax and total_tax_amounts fields on the upcoming invoice, and from the per-line-item tax_amounts fields. The invoice has an automatic_tax field showing the status of the calculation, with one of three possible statuses: