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 で失敗します。アカウントに別の通貨で資金が必要額ある場合でも、支払いは失敗します。

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

Avoid balance payment failures

Because payments from a connected account’s Stripe balance rely on its available funds, you can avoid payment failures by taking steps to maximize your connected accounts’ balances.

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

Coordinate your payout schedules with your subscription billing cycles. For example, if you charge subscription fees on the first day of each month, and schedule weekly payouts on Mondays, then months with more Mondays have more payouts. Those months have lower available balances than months with fewer payouts, making payment failures more likely.

Another way to avoid payment failures due to payouts is to change to manual payouts before a subscription payment. At a set time before each subscription payment, if a connected account has sufficient available funds, switch it to manual payouts so the subscription payment gets paid before the automatic payout clears the account. After the subscription payment, resume automatic payouts.

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

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

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

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

Handle balance payment failures

Set up webhooks and event destinations to receive notifications about subscription payments. Identify payment failures by listening for the invoice.payment_failed event. When a payment fails:

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

If a payment from a Stripe balance fails due to insufficient available funds, you can retry it by following these steps:

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

Instead of retrying a failed payment from a Stripe balance, you can try using a different payment method by specifying it directly on the invoice. You can also implement a flow that allows connected accounts to update their own subscription payment methods.

レポートと決済の追跡

連結アカウントの 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