Stripe Payments からの入金およびトップアップ
Stripe Payments から Stripe Treasury に資金を移動するには、入金を使用できます。また、Stripe Treasury から Stripe Payments に資金を戻すには、トップアップを使用できます。
外部口座としての金融アカウント
Treasury 金融口座に入金したり、Treasury 金融口座からトップアップを受け取る前に、関連する Stripe アカウントに関連付けられた外部口座 (BankAccount
オブジェクト) として金融口座を設定する必要があります。
- 連結アカウント:
POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts
をその金融口座のrouting_number
とaccount_number
の情報とともに使用し、連結アカウントからの入金に使用できるBankAccount
オブジェクトを作成する - プラットフォームアカウント: Stripe ダッシュボードを使用して、プラットフォームアカウントからの入金またはプラットフォームアカウントへのトップアップに使用できる
BankAccount
オブジェクトを作成する
usd
通貨のデフォルト外部口座が設定されていない場合は、金融口座がデフォルトのアカウントの入金先になります。すでに usd
のデフォルトとして設定された外部口座があっても、金融口座を連結アカウントの新しいデフォルトにする場合は、以下の例のように呼び出しで default_for_currency
を true
に設定します。自動入金スケジュールを有効にしている場合は、これにより入金の対象が金融口座に変更されます。
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts \ -u
: \ -d "external_account[object]"="bank_account" \ -d "external_account[routing_number]"="{{FINANCIAL_ACCOUNT_ROUTING_NUMBER}}" \ -d "external_account[account_number]"="{{FINANCIAL_ACCOUNT_ACCOUNT_NUMBER}}" \ -d "external_account[country]"="US" \ -d "external_account[currency]"="usd" \ -d "default_for_currency"="true"sk_test_4eC39HqLyjWDarjtT1zdp7dc
成功すると、新しく作成された BankAccount
オブジェクトがレスポンスで返されます。
{ "id": "{{BANK_ACCOUNT_ID}}", "object": "bank_account", "account": "{{CONNECTED_ACCOUNT_ID}}", "account_holder_name": null, "account_holder_type": null, "available_payout_methods": [ "standard", "instant" ], ... "default_for_currency": true, ... }
入金
入金は、アカウント残高 (決済残高または Stripe 残高とも呼ばれる) を、Treasury 金融口座残高または外部銀行口座に移動します。プラットフォーム上の各 Stripe プラットフォームアカウントおよび連結アカウントには、アカウントの所有者が得た資金を保管するアカウント残高があります (Treasury アカウントのタイプの詳細については、Stripe Treasury のアカウント構造ガイドをご覧ください)。このような資金は、ユーザーがその資金を適切な口座に移動するまで、Stripe 外での使用のために直接アクセスすることはできません。Stripe Treasury では、そのアカウントは金融口座であり、自動または手動の入金で資金を追加できます。Stripe Connect での入金の詳細については、入金するのガイドをご覧ください。
自動入金
自動入金スケジュールを設定したプラットフォームに連結アカウントがある場合には、直接の入金先を、連結アカウントユーザーの外部銀行口座から、金融口座に変更できます。そのためには、Treasury 金融口座が BankAccount
オブジェクトとして設定されている必要があります。詳細については、外部口座としての金融口座セクションをご覧ください。
自動入金の速度
デフォルトでは、自動入金を使用する場合、カード支払いで受領する売上は、支払いの受領から 2 営業日後 (T+2 スケジュール) に金融口座で使用できるようになります。ACH 支払いなど、他の支払いタイプではさらに時間がかかります。
プラットフォームレベルの与信承認後に、連結アカウントごとに T+1 の早期入金を有効にできます。POST /v1/accounts
で interval
および delay_days
パラメーターを設定し、入金スケジュールを自動的に加速することができます (または、下記のように早期入金を手動でトリガーすることもできます)。プラットフォームで連結アカウントの早期入金 (手動、自動、または両方) の利用をリクエストする場合は、treasury-support@stripe.com までお問い合わせください。
T+1 の早期入金スケジュールは、カード支払いと ACH 支払いを含むすべての支払いタイプに適用されます。
T+1 自動入金スケジュール
翌営業日に金融口座で自動的に入金を使用できるようにするには、interval
を daily
に、delay_days
を 1
に設定してリクエストを送信します。
POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}
を使用して、入金スケジュールを更新します。
レスポンスは、更新された設定を確認します。
{ ... "settings": { "payouts": { "schedule": { "interval": "daily", "delay_days": 1, }, }, ... } ... }
手動入金
手動入金を使用して、アカウント残高の一定金額をそのアカウントの Treasury の金融口座に送金することができます。
POST /v1/payouts
を使用して、金融口座に関連付けられた id
を destination
パラメーターの値として設定します。Treasury 金融口座に関連付けられた BankAccount
オブジェクトがまだない場合は、外部口座としての金融アカウントセクションで詳細をご覧ください。
成功すると、新しく作成された Payout
オブジェクトがレスポンスで返されます。
{ "id": "{{PAYOUT_ID}}", "object": "payout", "amount": 1000, ... "currency": "usd", "destination": "{{BANK_ACCOUNT_ID}}", ... "method": "standard", ... }
手動入金の速度
手動入金では、standard
と instant
の 2 種類の速度の方法を使用できます。
standard
の速度を使用する手動入金は、available
残高にのみ反映され、資金は通常、1 営業日後に金融口座に入金されます (T+1 スケジュール)。
プラットフォームで早期入金が有効になっている場合、instant
の手動入金を使用して連結アカウントの金融口座に資金を 1 時間以内に移動できます。即時の手動入金は、週末や祝日を含めていつでもリクエストでき、Stripe アカウントの instant_available
残高に反映されます。プラットフォームで早期入金が有効になっておらず、この機能の追加をご希望の場合は、treasury-support@stripe.com に連絡して機能をリクエストしてください。
標準の手動入金ではなく、即時の手動入金をリクエストするには、入金リクエストの method
パラメーターを standard
から instant
に変更します。
入金をテストする
テスト環境の API キーを使用して、連結アカウントの金融口座への入金をシミュレーションすることができます。
ダッシュボードを使用して、プラットフォームの金融口座への入金のみをシミュレーションできます。テスト環境で、ダッシュボードの 残高ビューの右上にある資金を追加ボタンをクリックして、資金を追加ダイアログを開きます。プラットフォームアカウント残高から金融口座残高への送金をシミュレーションするための指示に従います。
資金を追加ボタン
トップアップ (資金の追加)
Connect プラットフォームの所有者であるお客様は、外部の銀行口座を使用する代わりに、Treasury 金融口座残高をプラットフォームアカウントの残高へのトップアップに使用できます。プラットフォームアカウントの残高へのトップアップを行うには、プラットフォームの金融口座をプラットフォームのデフォルトの外部 BankAccount
として設定する必要があります。それには、プラットフォームの残高に資金を追加するガイドの説明に従って、Stripe ダッシュボードを使用します。
実際の外部の銀行口座とは異なり、Treasury 金融口座の詳細を指定した新しい BankAccount
オブジェクトは作成時に自動で確認されるため、少額入金による確認は必要ありません。
Treasury の金融口座をプラットフォームのデフォルトの外部銀行口座として設定したら、POST /v1/topups
を使用してトップアップを作成します。
成功すると、レスポンスで Top-Up
オブジェクトが返されます。
{ "id": "{{TOP_UP_ID}}", "object": "topup", "amount": 2000, "currency": "usd", "description": "Top-up", ... }
Stripe Connect でのプラットフォーム残高への資金の追加の詳細をご覧ください。