# 決済残高からの入金とトップアップ

決済口座残高と金融口座残高の間で資金を移動する方法をご紹介します。

> #### Accounts v2 API 互換性
> 
> Accounts v2 API は Treasury ワークフローをサポートしていません。Accounts v2 で作成されたアカウントがある場合は、Accounts v1 を使用して `treasury` と `card_issuing` のケイパビリティを管理できます。詳細については、[Accounts を顧客として使用する](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md)を参照してください。

[入金](https://docs.stripe.com/treasury/connect/moving-money/payouts.md#payouts)では決済残高から金融口座に、[トップアップ](https://docs.stripe.com/treasury/connect/moving-money/payouts.md#top-ups)では金融口座から決済残高に資金を移動できます。

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

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

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

`usd` 通貨のデフォルト外部口座が設定されていない場合は、金融口座がデフォルトのアカウントの入金先になります。この口座がすでにある場合、以下の例のように呼び出しで [default_for_currency](https://docs.stripe.com/api/external_account_bank_accounts/create.md?lang=node#account_create_bank_account-default_for_currency) を true に設定することによって、金融口座を連結アカウントのデフォルトにすることができます。自動入金スケジュールを有効にしている場合は、これにより入金の対象が金融口座に変更されます。

```bash
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts \
  -u <<YOUR_SECRET_KEY>>: \
  -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` オブジェクトがレスポンスで返されます。

```json
{
  "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 番目の金融口座

> 現在、Fifth Third にアクセスできるユーザーは、プレビューユーザーのみとなっています。お試しになりたい場合は、[お問い合わせください](mailto:treasury-support@stripe.com)。

金融口座の `id` を指定して外部口座を設定するオプションが利用できるようになりました。また、金融口座で [intra_stripe_flows](https://docs.stripe.com/api/treasury/financial_accounts/object.md#financial_account_object-features-intra_stripe_flows) 機能をリクエストする必要があります。

```bash
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts \
  -u <<YOUR_SECRET_KEY>>: \
  -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 では、アカウント残高の資金を、外部からアクセス可能な金融口座残高または外部銀行口座に移動します。

自動または手動の入金を使用して、金融口座に資金を追加できます。[金融口座](https://docs.stripe.com/treasury/connect/account-management/accounts-structure.md)の詳細をご覧ください。

Connect の入金の仕組みについて、詳しくは[連結アカウントへの入金](https://docs.stripe.com/connect/payouts-connected-accounts.md)をご覧ください。

## 自動入金

プラットフォーム上に自動入金スケジュールの連結アカウントがある場合、外部の銀行口座から金融口座への直接入金の対象を変更できます。この場合、金融口座が `BankAccount` オブジェクトとして設定されている必要があります。詳細は [外部口座としての金融口座](https://docs.stripe.com/treasury/connect/moving-money/payouts.md#financial-accounts-as-external-accounts) セクションを参照してください。

## 自動入金の速度

デフォルトでは、自動入金を使用する場合、カード支払いで受領する売上は、支払いの受領から 2 営業日後 (T+2 スケジュール) に金融口座で使用できるようになります。*ACH* (Automated Clearing House (ACH) is a US financial network used for electronic payments and money transfers that doesn’t rely on paper checks, credit card networks, wire transfers, or cash) 支払いなど、他の支払いタイプではさらに時間がかかります。

プラットフォームレベルの与信承認後に、連結アカウントごとに T+1 の早期入金を有効にできます。`POST /v1/accounts` で `interval` および `delay_days` パラメーターを設定し、入金スケジュールを自動的に加速することができます (または、下記のように早期入金を手動でトリガーすることもできます)。プラットフォームで連結アカウントの早期入金 (手動、自動、または両方) の利用をリクエストする場合は、[treasury-support@stripe.com](mailto:treasury-support@stripe.com) までお問い合わせください。

T+1 の早期入金スケジュールは、カード支払いと ACH 支払いを含むすべての支払いタイプに適用されます。

### T+1 自動入金スケジュール

翌営業日に金融口座で自動的に入金を使用できるようにするには、`interval` を `daily` に、`delay_days` を `1` に設定してリクエストを送信します。

[POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}](https://docs.stripe.com/api/accounts/object.md#account_object-settings-payouts-schedule)を使用して、入金スケジュールを更新します。

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

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

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

## 手動入金

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

[POST /v1/payouts](https://docs.stripe.com/api/payouts/create.md) を使用し、`destination` パラメーター値として金融口座に関連付けられた銀行口座`id` を指定します。金融口座に関連付けられている`BankAccount` オブジェクトがまだない場合は、[外部口座としての金融口座](https://docs.stripe.com/treasury/connect/moving-money/payouts.md#financial-accounts-as-external-accounts) セクションを参照してください。

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

成功すると、新しく作成された [Payout オブジェクト](https://docs.stripe.com/api/payouts/object.md)がレスポンスで返されます。

```json
{
  "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](mailto:treasury-support@stripe.com) に連絡してこの機能をリクエストしてください。

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

## 入金をテストする

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

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

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

*Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients) プラットフォームの所有者は、外部の銀行口座を利用する代わりに、対象となる金融口座残高を使用してプラットフォーム口座残高をトップアップできます。対象となるには、金融口座で [financial_addresses.aba](https://docs.stripe.com/treasury/connect/account-management/financial-account-features.md#available-features) 機能が有効になっている必要があります。プラットフォーム口座残高をトップアップするには、`BankAccount` をプラットフォームのデフォルトの外部口座として、[プラットフォーム残高への資金追加](https://docs.stripe.com/connect/top-ups.md)ガイドで説明されているとおりに Stripe ダッシュボードでプラットフォームの金融口座を設定する必要があります。

外部の実際の銀行口座とは異なり、事業者が所有する金融口座情報を持つ新規の `BankAccount` オブジェクトは、作成時に自動で検証されます。したがって、マイクロデポジットによる検証は不要です。

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

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

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

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

Stripe Connect での[プラットフォーム残高への資金の追加](https://docs.stripe.com/connect/top-ups.md)の詳細をご覧ください。