# プラットフォームの金融アカウント

プラットフォームの金融口座についてご紹介します。

プラットフォーム向け Stripe Treasury への [gained API access](https://docs.stripe.com/treasury/connect/access.md) を取得すると、プラットフォーム用の金融口座が自動的に用意されます。*サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)環境では、これはテスト用プラットフォームの金融口座です。

サンドボックス環境のテストプラットフォーム金融口座を使用すると、本番用口座のプラットフォーム金融口座に実際に影響を与えることなく、実装を設定してテストできます。

本番環境のプラットフォーム金融口座は、プラットフォーム向け Treasury プログラムの運転資金として、自社の資金を保管する場所です。本番環境のプラットフォーム金融口座には、独自の金融番号と口座番号があり、プラットフォームの連結アカウントに紐付けられた金融口座とほぼ同じ種類の資金移動に対応しています。

## プラットフォームの金融口座の違い

プラットフォームの金融口座 (本番用口座とテスト用口座の両方) は、プラットフォームの連結アカウントに関連付けられた金融口座と基本的に同じです。どの金融口座が関係しているかに関係なく、同じ API リクエストを使用します。ただし、プラットフォームの金融口座に対して API コールを行う際に [Stripe-Account ヘッダー](https://docs.stripe.com/connect/authentication.md#stripe-account-header)は含めません。`Stripe-Account` ヘッダーは、リクエストがプラットフォームの金融口座ではなく、関連付けられた連結アカウントの金融口座に対するものであることを示します。

以下のリストは、プラットフォームの金融口座と連結アカウントに関連付けられた金融口座の間を違いをまとめたものです。

- Stripe Issuing カードを、プラットフォームの金融口座に関連付けることはできません。
  - Stripe Issuing カードを、連結アカウントに関連付けられた金融口座に関連付けることができます。
- プラットフォームの金融口座の残高から連結アカウントのアカウント残高に直接送金することはできません。
  - プラットフォームの金融口座の残高から連結アカウントに関連付けられた金融口座の残高には直接送金できます。

- プラットフォームの金融口座を、プラットフォームの支払い残高からの入金またはプラットフォームの支払い残高へのトップアップ (資金の追加) に使用できる `BankAccount` オブジェクトとして設定するには、(API ではなく) Stripe ダッシュボードを使用する必要があります。
  - 詳細については、[Payouts and top-ups](https://docs.stripe.com/treasury/connect/moving-money/payouts.md#financial-accounts-as-external-accounts) ガイドを参照してください。
- プラットフォームアカウントの残高からプラットフォームの金融口座の残高への入金をスピードアップすることはできません。

## プラットフォームの金融口座詳細を取得する

プラットフォームの金融口座の詳細は、API と Stripe ダッシュボードを使用して取得できます。

#### ダッシュボード

Stripe [ダッシュボード](https://dashboard.stripe.com/test/treasury/balances)の **残高** タブにある **金融口座** セクションで、プラットフォーム金融口座とその金融番号、口座番号、残高を確認できます。

プラットフォームの金融口座をクリックすると、展開ビューが開き、以下を含む詳細情報が表示されます。

- 金融口座の機能
- 残高履歴
- 最近の取引
- イベントとログ

#### API

`GET /v1/treasury/financial_accounts` を使用し、API を通じてプラットフォームの金融アカウントのあらゆる詳細をリストできます。このリクエストはプラットフォームの金融アカウントに対するリクエストのため、`Stripe-Account` ヘッダーは含まれません。

```curl
curl https://api.stripe.com/v1/treasury/financial_accounts \
  -u "<<YOUR_SECRET_KEY>>:"
```

成功すると、レスポンスには、プラットフォームの金融口座の `id` が含まれます。その金融口座 ID を使用し、`GET /v1/treasury/financial_accounts/{{FINANCIALACCOUNT_ID}}` でプラットフォームの金融口座の詳細を直接取得することができます。

```curl
curl https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:"
```

`FinancialAccount` オブジェクトは、残高と保留中の取引の残高を含む、金融口座を定義するデータを表示します。

#### JSON (コメント付き)

```json
{
  "object": "treasury.financial_account",
  "created": 1612927106,
  "id": "fa_123",
  "country": "US",
  "supported_currencies": ["usd"],
  // Arrays of active, pending and restricted features summarize the status of all requested features
  "active_features": ["financial_addresses.aba", "deposit_insurance"],
  "pending_features": ["inbound_transfers.ach"],
  "restricted_features": ["intra_stripe_flows", "outbound_payments.ach", "outbound_payments.us_domestic_wire"],
  "balance": {
    "cash": {"usd": 9000},
    "inbound_pending": {"usd": 0},
    "outbound_pending": {"usd": 1000}
  },
  // The FinancialAccount gains a FinancialAddress once the `financial_addresses.aba` feature is active. For more information, see "Activating features"
  "financial_addresses": [
    {
      "type": "aba",
      "supported_networks": ["ach", "domestic_wire_us"],
      "aba": {
        "account_number_last4": "7890",
        // Use the expand[] parameter to view the `account_number` field hidden by default
        "account_number": "1234567890",
        "routing_number": "000000001",
        "bank_name": "Goldman Sachs"
      }
    }
  ],
  "livemode": true,

  // Financial accounts begin in the "open" state, but can be closed
  // `status_details.closed` is populated once a financial account is closed
  "status": "open",
  "status_details": {
    // `closed` is null if financial account is not closed
    "closed": {
      // List of one or more reasons why the FinancialAccount was closed:
      // - account_rejected
      // - closed_by_platform
      // - other
      "reasons": []
    }
  },

  // User-defined metadata
  "metadata": {}
}
```

### プラットフォームの金融口座機能の取得

`GET /v1/treasury/financial_accounts/{{FINANCIALACCOUNT_ID}}/features` を使用して、プラットフォームの金融口座の機能の情報を取得できます。

```curl
curl https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}}/features \
  -u "<<YOUR_SECRET_KEY>>:"
```

成功すると、レスポンスには、プラットフォームの金融口座に割り当てられた機能がリストされています。

```json
{
  "object": "treasury.financial_account_features",
  "card_issuing": {
    "requested": true,
    "status": "active",
    "status_details": []
  },
  "deposit_insurance": {
    "requested": true,
    "status": "active",
    "status_details": []
  },
  "financial_addresses": {
    "aba": {
      "requested": true,
      "status": "active",
      "status_details": []
    }
  },
  "inbound_transfers": {
    "ach": {
      "requested": true,
      "status": "active",
      "status_details": []
    }
  },
  "intra_stripe_flows": {
    "requested": true,
    "status": "active",
    "status_details": []
  },
  "outbound_payments": {
    "ach": {
      "requested": true,
      "status": "active",
      "status_details": []
    },
    "us_domestic_wire": {
      "requested": true,
      "status": "active",
      "status_details": []
    }
  }
}

```

## プラットフォームに新しく金融口座を作成する

プラットフォームアカウントに最大 3 件の金融口座を作成できます。`Stripe-Account` ヘッダーを指定せずに `POST /v1/treasury/financial_accounts` を使用して、新しい金融口座を作成します。

## プラットフォームのデフォルトの金融口座

プラットフォームにはデフォルトの金融口座が 1 つ設定されており、Stripe はこの口座を使用してプラットフォームにサービスを提供しています。たとえば、Stripe はデフォルトの金融口座を使用して、連結アカウントで発生したマイナス残高を補填します。

デフォルトでは、プラットフォームアカウントで最初に作成した金融口座がデフォルトの金融口座になります。これは、金融口座の `is_default` フィールドが `true` に設定されていることで確認できます。

## プラットフォームの金融口座と連結アカウント間の資金移動

`OutboundPayments` を `stripe` ネットワーク経由で使用すると、プラットフォームの金融口座と、同じプラットフォームに関連付けられた連結アカウントの金融口座との間で資金を即座に移動できます。詳細については、[Creating an OutboundPayment to a financial account](https://docs.stripe.com/treasury/connect/moving-money/out-of/outbound-payments.md#create-obp-for-fa) を参照してください。

## See also

- [プラットフォーム向け Treasury のアカウント構成](https://docs.stripe.com/treasury/connect/account-management/accounts-structure.md)
- [連結アカウントの操作](https://docs.stripe.com/treasury/connect/account-management/connected-accounts.md)
- [残高の操作](https://docs.stripe.com/treasury/connect/account-management/working-with-balances-and-transactions.md)
- [金融口座への資金移動](https://docs.stripe.com/treasury/connect/moving-money/moving-money-into-financial-accounts.md)
- [金融口座からの資金移動](https://docs.stripe.com/treasury/connect/moving-money/moving-money-out.md)