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 通貨のデフォルト外部口座が設定されていない場合は、金融口座がデフォルトのアカウントの入金先になります。この口座がすでにある場合、以下の例のように呼び出しで 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 残高とも呼ばれる) があります。これらの資金は Stripe 外での使用のために直接アクセスすることはできません。Payouts では、アカウント残高の資金を、外部からアクセス可能な Treasury 金融口座残高または外部銀行口座に移動します。

自動入金または手動入金を使用して Treasury 金融口座に入金できます。Treasury 口座の詳細については、Stripe Treasury のアカウント構造ガイドを参照してください。

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}}を使用して、入金スケジュールを更新します。

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,
      },
    },
    ...
  }
  ...
}

手動入金

手動入金を使用して、アカウント残高の一定金額をそのアカウントの Treasury の金融口座に送金することができます。

POST /v1/payoutsを使用して、金融口座に関連付けられた銀行口座 id を destination パラメーターの値として設定します。Treasury 金融口座に関連付けられた 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 残高にのみ反映され、資金は通常、1 営業日後に金融口座に入金されます (T+1 スケジュール)。

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

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

入金をテストする

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

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

資金を追加ボタン

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

Connect プラットフォームの所有者であるお客様は、外部の銀行口座を使用する代わりに、利用資格のある Treasury 金融口座残高をプラットフォームアカウントの残高へのトップアップに使用できます。利用資格を得るには、金融口座で financial_addresses.aba 機能が有効になっている必要があります。プラットフォームアカウントの残高へのトップアップを行うには、プラットフォームの Treasury 金融口座をプラットフォームのデフォルトの外部 BankAccount として設定する必要があります。それには、プラットフォームの残高に資金を追加するガイドの説明に従って、Stripe ダッシュボードを使用します。

実際の外部の銀行口座とは異なり、BankAccount オブジェクトを持つ加盟店が所有する Treasury 金融口座の詳細を指定した新しい BankAccount オブジェクトは作成時に自動で確認されるため、少額入金による確認は必要ありません。

Treasury の金融口座をプラットフォームのデフォルトの外部銀行口座として設定したら、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 でのプラットフォーム残高への資金の追加の詳細をご覧ください。