Stripe Payments からの入金およびトップアップ

入金 で Stripe Payments からプラットフォーム向け金融口座へ、トップアップ でプラットフォーム向け金融口座から Stripe Payments へ、それぞれ資金を移動できます。

外部口座としての金融アカウント

金融口座への入金や金融口座からのトップアップ資金を受け取る前に、金融口座を Stripe アカウントに連結する外部口座 (BankAccount オブジェクト) に設定する必要があります。

• 連結アカウント: POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts をその金融口座の routing_number と account_number とともに使用し、連結アカウントからの入金に使用できる BankAccount オブジェクトを作成する
• プラットフォームアカウント: Stripe ダッシュボードを使用して、プラットフォームアカウントからの入金またはプラットフォームアカウントへのトップアップに使用できる BankAccount オブジェクトを作成する

usd 通貨のデフォルト外部口座が設定されていない場合は、金融口座がデフォルトのアカウントの入金先になります。この口座がすでにある場合、以下の例のように呼び出しで default_for_currency を true に設定することによって、金融口座を連結アカウントのデフォルトにすることができます。自動入金スケジュールを有効にしている場合は、これにより入金の対象が金融口座に変更されます。

curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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"

成功すると、新しく作成された 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,
  ...
}

外部口座としての 5 番目の金融口座

金融口座の id を指定して外部口座を設定するオプションが利用できるようになりました。また、金融口座で intra_stripe_flows 機能をリクエストする必要があります。

curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "external_account[object]"="bank_account" \
  -d "external_account[financial_account]"="{{FINANCIAL_ACCOUNT_ID}}" \
  -d "external_account[country]"="US" \
  -d "external_account[currency]"="usd" \
  -d "default_for_currency"="true"

入金

すべての Stripe プラットフォームのアカウントおよび連結アカウントには、資金を保管するアカウント残高 (決済残高または取得残高とも呼ばれる) があります。これらの資金は Stripe 外での使用のために直接アクセスすることはできません。Payouts では、アカウント残高の資金を、外部からアクセス可能な金融口座残高または外部銀行口座に移動します。

金融口座へのご入金は、自動または手動で行うことができます。金融口座の詳細。

Connect での入金の仕組みについて詳しくは、入金に関するガイド をご覧ください。

自動入金

プラットフォーム上に自動入金スケジュールの連結アカウントがある場合、外部の銀行口座から金融口座への直接入金の対象を変更できます。この場合、金融口座が 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}}を使用して、入金スケジュールを更新します。

curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "settings[payouts][schedule][interval]"=daily \
  -d "settings[payouts][schedule][delay_days]"=1

レスポンスは、更新された設定を確認します。

{
  ...
  "settings": {
    "payouts": {
      "schedule": {
        "interval": "daily",
        "delay_days": 1,
      },
    },
    ...
  }
  ...
}

手動入金

手動入金を使用すると、口座残高の特定の部分をその口座の金融口座に送信できます。

POST /v1/payouts を使用し、destination パラメーター値として金融口座に関連付けられた銀行口座id を指定します。金融口座に関連付けられているBankAccount オブジェクトがまだない場合は、外部口座としての金融口座 セクションを参照してください。

curl https://api.stripe.com/v1/payouts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d method=standard \
  -d amount=1000 \
  -d currency=usd \
  -d destination={{BANK_ACCOUNT_ID}}

成功すると、新しく作成された Payout オブジェクトがレスポンスで返されます。

{
  "id": "{{PAYOUT_ID}}",
  "object": "payout",
  "amount": 1000,
  ...
  "currency": "usd",
  "destination": "{{BANK_ACCOUNT_ID}}",
  ...
  "method": "standard",
  ...
}

手動入金の速度

手動入金では、standard と instant の 2 種類の速度の方法を使用できます。

standard の速度を使用する手動入金は、available 残高にのみ反映され、売上は通常、2 時間以内に金融口座に入金されます。

プラットフォームで早期入金が有効になっている場合、instant 手動入金を使用して連結アカウントの金融口座に売上を 30 分以内に移動できます。即時手動入金は、週末や祝日を含めていつでもリクエストでき、Stripe アカウントの instant_available 残高に反映されます。早期入金が有効になっておらず、この機能の追加をご希望の場合は、treasury-support@stripe.com に連絡してこの機能をリクエストしてください。

標準の手動入金ではなく、即時の手動入金をリクエストするには、入金リクエストの method パラメーターを standard から instant に変更します。

入金をテストする

テスト環境から API キーを使用して、連結アカウントの金融口座への入金をシミュレートできます。

プラットフォームの金融口座への入金は、テスト環境のダッシュボードを使用してのみシミュレートできます。ダッシュボードの 残高 ビューの右上にある 資金を追加 ボタンをクリックして、資金を追加 ダイアログを開きます。プロンプトに従って、プラットフォームアカウントの残高から金融口座の残高への送金をシミュレートします。

トップアップ (資金の追加)

Connect プラットフォームの所有者は、外部の銀行口座を利用する代わりに、対象となる金融口座残高を使用してプラットフォーム口座の残高をトップアップできます。対象となる金融口座は、financial_addresses.aba 機能が有効になっている必要があります。プラットフォーム口座残高をトップアップするには、プラットフォーム残高に資金を追加する ガイドに記載されているように、Stripe ダッシュボードを使用して、プラットフォームの金融口座をプラットフォームのデフォルト外部 BankAccount として設定する必要があります。

真の外部銀行口座とは異なり、BankAccount オブジェクトを持つ加盟店が所有する金融アカウントの詳細を持つ新しい BankAccount オブジェクトは、作成時に自動的に検証されるため、マイクロデポジットでの検証は必要ありません。

金融口座をプラットフォームのデフォルト外部銀行口座として設定したら、POST /v1/topups を使用してトップアップします。

curl https://api.stripe.com/v1/topups \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=2000 \
  -d currency=usd \
  -d description=Top-up \
  -d statement_descriptor=Top-up

成功すると、レスポンスで Top-Up オブジェクトが返されます。

{
  "id": "{{TOP_UP_ID}}",
  "object": "topup",
  "amount": 2000,
  "currency": "usd",
  "description": "Top-up",
  ...
}

Stripe Connect でのプラットフォーム残高への資金の追加の詳細をご覧ください。