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

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

利用資格

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

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

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

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

入金による決済の失敗を回避する別の方法として、サブスクリプションの支払いの前に手動入金に変更できます。各サブスクリプション支払いの一定期間前に、すでに連結アカウントに十分な残高がある場合は、手動入金に切り替えます。サブスクリプションの支払いが終わったら自動入金に戻します。これにより、サブスクリプションの支払いに必要な資金が自動的に入金されなくなります。

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

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

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.

Supported currencies by country

Stripe doesn’t support all currencies in every jurisdiction. When you collect a payment from a connected account’s Stripe balance, that account’s country determines which currencies are available. The following table shows the supported currencies for Stripe balance payments from accounts in each country.

Below is the full table of supported currencies for paying from a Stripe balance, based on the connected account’s country.

レポートと決済の追跡

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