Stripe 残高で支払う公開プレビュー

Connect プラットフォームとして、連結アカウントの Stripe 残高に関連付けられた決済手段を作成できます。これにより、カードなどの外部決済手段ではなく、連結アカウントの利用可能残高から直接サブスクリプションの支払いを回収できます。

Stripe 残高での支払いの実装

この支払い方法は、Accounts V2 のプレビュー版リリースの一部としてのみ利用できます。

利用資格

Stripe 残高での支払いには、以下の条件が適用されます。

• この決済手段はプラットフォームによって管理され、card_payments 機能が有効になっている連結アカウントに対してのみ設定できます。
• この決済手段は、プラットフォームが Connect 経由で決済機能を提供している連結アカウントから、サブスクリプションの支払いを引き落とす場合のみ使用でき、その他の商品やサービスには使用できません。
• 動的な決済手段を使用している場合、Stripe 残高での支払いはご利用いただけません。サブスクリプションの支払いを作成する際は、Stripe 残高での支払いを決済手段として明示的に指定する必要があります。

連結アカウントから必要な承認

Stripe 残高から支払いを回収する前に、連結アカウントから同意を得る必要があります。次の文言を使用して連結アカウントに通知し、Stripe 残高での支払いをオプトアウトするオプションを提供することをお勧めします。

資金のタイミングと利用可能性

Stripe 残高から行われた支払いは直ちに確定されます。プラットフォームと同じ国の連結アカウントからの Stripe 残高での支払いは、当日決済 (T+0) で Stripe 残高で利用可能になります。別の国の連結アカウントからのクロスボーダー決済は、翌日決済 (T+1) で Stripe 残高で利用可能になります。

海外支払い

プラットフォームのデフォルト通貨以外の通貨で Stripe 残高支払いを作成できます。ただし、連結アカウントの Stripe アカウントにその通貨が含まれている場合に限ります。Stripe は、売上をプラットフォームアカウントのデフォルト通貨に自動的に換算します。

返金

Stripe 残高での支払いが成功していた場合、カード決済と同じ方法で、その一部または全額を返金できます。

取引の失敗

連結アカウントの Stripe 残高から支払いを行う場合、指定された取引通貨の利用可能残高が十分になければなりません。残高がない場合、PaymentIntent は支払い拒否コード insufficient_funds で失敗します。アカウントに別の通貨で資金が必要額ある場合でも、支払いは失敗します。

残高関連の支払いの失敗を管理するようにシステムを設定することをお勧めします。

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

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

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

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

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

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

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

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

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

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

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

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

残高不足が原因で、Stripe 残高での支払いに失敗した場合は、以下の手順で再試行できます。

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

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

レポートと決済の追跡

連結アカウントの Stripe 残高を使用して行われる支払いでは、プラットフォームと連結アカウントの両方で支払い情報を反映した取引データが生成されます。

プラットフォームでは、決済によって正の金額の Charge と BalanceTransaction が作成されます。BalanceTransaction には、次の値が含まれます。

• reporting_category: charge
• source: Charge オブジェクト ID
• type: payment

連結アカウントでは、決済によって負の金額と次の値を持つ BalanceTransaction のみが作成されます。

• description: "Stripe balance payment - " + PaymentIntent からの説明
• reporting_category: stripe_balance_payment_debit
• source: null
• type:
  • 決済の場合: stripe_balance_payment_debit
  • 返金の場合: stripe_balance_payment_debit_reversal