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

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

このツールを使用するには、次の手順に従います。

1. ダッシュボードに移動します。
2. 更新が必要なサブスクリプションを確認します。
3. 推奨される対応を確認します。
4. 必要に応じて手動で更新します。

Stripe は手動の税率をサブスクリプションから削除します。これには最大 5 営業日かかる場合があります。手続きが完了すると、メールでお知らせします。

このツールを使用して、次の条件を満たすサブスクリプションを更新できます。

• アクティブである
• 税金を自動的に徴収しない
• 税金を計算できる詳細な住所情報がある
• 価格に税金処理を設定する

以下のタイプのサブスクリプションを更新する必要があります。

• スケジュールが設定されたサブスクリプション。詳細については、サブスクリプションスケジュールを使用してサブスクリプションを更新するセクションをご覧ください。
• デスティネーション支払いまたは支払いと送金別方式の支払いタイプを使用するサブスクリプション。

自動化ツールでは、一部のサブスクリプションを更新できない場合があります。これは通常、顧客の有効な住所がないことが原因です。

自動化ツールを使用すると、再度実行できるようになるまで数日待つ必要があります。その間に、最初の試行で失敗したサブスクリプションを確認して修正します。

• 顧客の居住地を確認するをクリックし、必要な更新を行います。
• 税コードと税金処理を指定して商品と価格を更新します。
• サブスクリプションを更新し、以降のインボイスで税金を自動的に計算します。
• サブスクリプションを適切に更新したことを確認します。

税金を正しく計算するには、顧客の納税場所ステータスを把握する必要があります。ダッシュボードまたはエクスポートされたデータで確認するか、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_BQokikJOvBiI2HlWgH4olfQ2
:"

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

curl https://api.stripe.com/v1/subscription_schedules/
{{SUBSCRIPTION_SCHEDULE_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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_BQokikJOvBiI2HlWgH4olfQ2'

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.items.data[0].current_period_start,
        end_date: subscription.items.data[0].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
      }
    ]
  }
)

サブスクリプションが適切に更新されたことを確認するには、各サブスクリプションの請求書のプレビューを作成し、税額計算の結果を確認します。

税額は、請求書のプレビューの tax フィールドと total_tax_amounts フィールド、および項目ごとの tax_amounts フィールドから取得できます。請求書には計算のステータスを示す automatic_tax フィールドがあり、ステータスは以下の 3 つのいずれかです。