連結アカウントに SaaS 利用料を請求する公開プレビュー

サブスクリプション料金を表す商品と料金を作成します。API またはダッシュボードを使用できます。

連結アカウントの Stripe 残高から SaaS サブスクリプション料金を直接回収できます。連結アカウントは以下の要件を満たしている必要があります。

• merchant 設定と customer 設定の両方が必要です。
• merchant 設定の card_payments ケイパビリティを有効にする必要があります。
• 利用可能残高には、全額を支払うのに十分な資金が必要です。

curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-04-30.preview" \
  -d "payment_method_types[]"=stripe_balance \
  -d confirm=true \
  -d customer_account=acct_xxxxxxxxxxxxxx \
  -d usage=off_session \
  -d "payment_method_data[type]"=stripe_balance

{
  "id": "seti_123",
  "object": "setup_intent",
  "customer": "cus_xxxxxxxxxxxxxx",
  "customer_account": "acct_xxxxxxxxxxxxxx",
  "payment_method": "pm_xxxxxxxxxxxxxx",
  "status": "succeeded"
}

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-04-30.preview" \
  -d customer_account=acct_xxxxxxxxxxxxxx \
  -d default_payment_method=pm_xxxxxxxxxxxxxx \
  -d "items[0][price]"=price_xxxxxxxxxxxxxx \
  -d "items[0][quantity]"=1 \
  -d "payment_settings[payment_method_types][0]"=stripe_balance

連結アカウントの Stripe 残高から支払いを回収する際は、アカウントの利用可能残高に全額を支払えるだけの十分な資金がなければなりません。残高が十分でなかった場合、支払いは失敗します。連結アカウントの Stripe 残高から直接支払いを回収する場合は、残高に関連する支払いの失敗を管理するようにシステムを設定することをお勧めします。

残高支払いの失敗を回避する

連結アカウントの Stripe 残高での支払いは、利用可能な資金に依存するため、連結アカウントの残高を最大化する手順を実行することで、支払いの失敗を回避できます。

連結アカウントの入金スケジュールを調整する

入金スケジュールをサブスクリプションの請求サイクルに合わせて調整します。たとえば、毎月 1 日にサブスクリプション料金を請求し、毎週月曜日に入金をスケジュール設定する場合、月曜日が多い月は入金額が多くなります。これらの月は、入金の少ない月よりも利用可能な残高が少なくなり、支払いが失敗する可能性が高くなります。

入金による決済の失敗を回避する別の方法として、サブスクリプションの決済前に手動入金に変更できます。各サブスクリプション決済の一定期間前に、連結アカウントに十分な残高がある場合は手動入金に切り替えて、自動入金によってアカウントが清算される前にサブスクリプションの決済が行われるようにします。サブスクリプションの決済後に、自動入金を再開します。

連結アカウントの最低残高を設定する

アカウントの最低残高を定義することで、自動入金によって連結アカウントの利用可能残高が一定額を下回るのを防ぐことができます。

1. ダッシュボードでアカウントを見つけます。
2. アカウントのオーバーフローメニュー () から、…のダッシュボードを表示を選択します。
3. 歯車のアイコンをクリックし、設定を選択します。
4. アカウント設定でビジネスをクリックします。
5. 外部の入金口座とスケジュール設定タブを選択します。
6. 支払い残高に最低金額を保持するをオンにして、金額を入力します。

連結アカウントごとに最低残高を手動で設定する必要があります。

残高支払いの失敗に対応する

Webhook とイベントの送信先を設定して、サブスクリプションの支払いに関する通知を受信します。invoice.payment_failed イベントをリッスンして、支払いの失敗を特定します。支払いに失敗したときは、以下のようになります。

• PaymentIntent のステータスが requires_action に変わります。
• 現在の請求書のサブスクリプションステータスは incomplete のままです。
• サブスクリプションは引き続き請求書を生成しますが、請求書は draft ステータスのままです。

自動での再試行

継続支払いのサブスクリプション請求書で利用可能な残高が不十分なために残高決済に失敗した場合は、再試行を有効にします。自動再試行では、残高不足の失敗後に 2 回の決済試行がスケジュールされます。

• 最初の再試行は、決済の失敗から少なくとも 24 時間後に行われます。
• 必要に応じて、2 回目の再試行は、最初の再試行の次の日曜日に行われます。

この再試行スケジュールは、連結アカウントが Stripe 残高により多くの資金を蓄積し、スケジュールされた入金との競合を回避できるようにすることを目的としています。

追加手数料なしで任意の金額の再試行を有効にできます。

手動で再試行する

利用可能な残高が不足しているために Stripe 残高からの決済が失敗した場合は、次の手順に従って手動で再試行できます。

1. 連結アカウントの入金スケジュールの期間を manual に設定します。
2. 次回連結アカウントに入金される支払いをリッスンしてから、アカウントの利用可能な残高を確認します。
3. 利用可能な残高がサブスクリプション料金以上の場合は、未払い請求書の決済手段を stripe_balance に設定して再試行します。それ以外の場合は、利用可能な残高が請求書の支払いに十分になるまで、支払いのリッスンを続けます。
4. 支払いが成功したら、連結アカウントの通常の入金スケジュールに戻します。

失敗した Stripe 残高での支払いを再試行する代わりに、別の決済手段を請求書で直接指定して、試すことができます。また、連結アカウントが自身のサブスクリプションの決済手段を更新できるようにするフローを実装することもできます。