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

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

[プラットフォーム向け金融口座への API アクセス](https://docs.stripe.com/financial-accounts/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) 環境では、テストプラットフォームの金融口座です。

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

本番環境プラットフォーム金融口座は、プラットフォーム向け金融口座プログラムの運転資金として自己資金を保管する場所です。本番環境プラットフォーム金融口座は独自の金融番号とアカウント番号を持ち、お客様のプラットフォームの連結アカウントに接続された金融口座と同じ種類の資金移動のほとんどに対応します。

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

プラットフォームの金融口座 (本番用口座とテスト用口座の両方) は、プラットフォームの連結アカウントに関連付けられた金融口座と基本的に同じです。どの金融口座が関係しているかに関係なく、同じ 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/financial-accounts/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` ネットワークで使用して、プラットフォームの金融口座と同じプラットフォームに関連する連結アカウントの金融口座の間で即座に資金を移動します。詳細については、[金融口座への OutboundPayment の作成](https://docs.stripe.com/financial-accounts/connect/moving-money/out-of/outbound-payments.md#create-obp-for-fa) を参照してください。

## See also

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