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

You can move money from Stripe Payments to Financial Accounts for platforms with payouts, and from Financial Accounts for platforms back to Stripe Payments with top-ups.

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

Before you can send payouts to a financial account or receive top-ups from a financial account, you must set the financial account as an external account (BankAccount object) connected to the relevant Stripe account.

• 連結アカウント: 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"

入金

Every Stripe platform account and connected account has an account balance (also called a payments balance or acquiring balance) that stores their money. Those funds aren’t directly accessible for use outside Stripe. Payouts move funds from an account balance to an externally accessible financial account balance or external bank account.

You can fund a financial account using automatic or manual payouts. Learn more about financial accounts.

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

自動入金

If you have connected accounts on your platform with an automatic payout schedule, you can change the target of direct payouts from their external bank accounts to their financial accounts. It requires the financial account to be set up as a BankAccount object; see the Financial accounts as external accounts section for more information.

自動入金の速度

デフォルトでは、自動入金を使用する場合、カード支払いで受領する売上は、支払いの受領から 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,
      },
    },
    ...
  }
  ...
}

手動入金

You can use manual payouts to send specific portions of an account balance to that account’s financial account.

Use POST /v1/payouts with the bank account id associated with your financial account specified as the destination parameter value. If you don’t have a BankAccount object associated with your financial account yet, see the Financial accounts as external accounts section for more information.

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 種類の速度の方法を使用できます。

Manual payouts using standard speed can only draw on the available balance, and funds will generally arrive in the financial account within 2 hours.

If your platform is enabled for faster payouts, you can use instant manual payouts to move funds to a connected account’s financial account within 30 minutes. You can request instant manual payouts at any time, including weekends and holidays, and instant manual payouts can draw on the instant_available balance of a Stripe account. If your platform is not enabled for faster payouts and you’re interested in adding the ability, contact treasury-support@stripe.com to request the feature.

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

入金をテストする

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

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

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

As the owner of a Connect platform, you can use an eligible financial account balance to top-up your platform account balance instead of using an external bank account. Your financial account must have the financial_addresses.aba feature active to be eligible. To top-up a platform account balance, you must set the platform’s financial account as the platform’s default external BankAccount using the Stripe Dashboard as described in the Adding funds to your platform balance guide.

Unlike true external bank accounts, new BankAccount objects with financial account details owned by the merchant with the BankAccount object are automatically verified upon creation so they don’t require verification with microdeposits.

After you set the financial account as your platform’s default external bank account, use POST /v1/topups to create the top-up.

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 でのプラットフォーム残高への資金の追加の詳細をご覧ください。