# 連結アカウントの使用

treasury ケイパビリティをリクエストして、連結アカウントのオンボーディング要件を収集します。

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

プラットフォーム向け金融口座を使用するには、プラットフォームが Stripe *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) を導入している必要があります。Stripe Connect により、プラットフォームは売り手や代行業者に連結アカウントを提供できます。連結アカウントがプラットフォーム向け金融口座のアカウント構造にどのように適合するかの概要については、[プラットフォーム向け金融口座のアカウント構造](https://docs.stripe.com/financial-accounts/connect/account-management/accounts-structure.md) ガイドをご覧ください。

Financial Accounts for platforms が対応するのは、Stripe がホストするダッシュボードを使用せず、カスタム連結アカウントを含め、プラットフォームが要件の収集と損失責任を負う連結アカウントのみです。[プラットフォーム向け金融口座で動作する連結アカウント](https://docs.stripe.com/connect/interactive-platform-guide.md?connect-charge-type=direct&connect-loss-liability-owner=platform) の作成方法については、こちらをご覧ください。

連結アカウントを持つプラットフォームとしては、最低 API バージョンを維持し、利用規約の更新を連結アカウントに伝え、連結アカウントからの情報リクエストに対応し、サポートを提供する責任があります。プラットフォームは、連結アカウントが被る損失の最終的な責任を負うため、不正利用がないかどうかを審査する責任もあります。詳細については、[プラットフォーム向け金融口座不正利用ガイド](https://docs.stripe.com/financial-accounts/connect/examples/fraud-guide.md) をお読みください。

連結アカウントは、プラットフォーム向け金融口座の機能を使用するために、アカウント上で有効化された特定のケイパビリティを必要とします。異なる機能には異なるケイパビリティが必要であり、連結アカウントの所有者の追加情報が必要になる場合があります。例えば、`treasury` ケイパビリティは、プラットフォーム向け金融口座アクセスのために連結アカウントに必要です。アカウントに `treasury` をリクエストすると、そのアカウントがプラットフォーム向け金融口座を使用する前に、その連結アカウントに追加のフィールドが要求されます。

プラットフォーム向け金融口座の導入のために本番環境で連結アカウントを作成する前に、まず *サンドボックス* (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) 環境でテスト連結アカウントを作成することをお勧めします。テスト用連結アカウントは実際の資金を送受信できず、本番環境では使用できませんが、その他の構成や機能は同じです。

## 現在の連結アカウントのタイプを確認する

プラットフォームですでに連結アカウントの Connect 組み込みがあり、しかしそのタイプが分からない場合には、ダッシュボードや API を使用してこの情報を取得できます。

#### ダッシュボード

ダッシュボードの[連結アカウントのページ](https://dashboard.stripe.com/test/connect/accounts/overview)に移動します。連結アカウントが表形式で一覧表示されます。

アカウントの機能を見つけるには、表でアカウントを選択して詳細ビューを開き、**プロフィール** > **アカウント情報** をクリックします。

#### API リクエスト

`GET /v1/accounts` を使用して、プラットフォームのアカウントのリストを取得します。

```json
{
  "object": "list",
  "data": [
    {
      "id": "acct_1KUbgB2E0Hr5XQiY",
      "object": "account",
      "controller": {
        "type": "application",
        "dashboard": {
          "type": "none"
        },
        "losses": {
          "payments": "application"
        },
        "requirement_collection": "application",
        "fees": {
          "payer": "application"
        }
      },
      ...
    }
  ]
}
```

## treasury ケイパビリティを持つ新しい連結アカウントを作成する

> このガイドでは、プラットフォーム向け金融口座用の Stripe API を使用して新しい連結アカウントを作成する方法を説明しますが、網羅的ではありません。ホストされたアカウント登録を含む連結アカウント作成に関する完全なドキュメントは、[Connect 連携ガイド](https://docs.stripe.com/connect/interactive-platform-guide.md?connect-charge-type=direct&connect-loss-liability-owner=platform)をご覧ください。

`POST /v1/accounts` を使用して新しい連結アカウントを作成します。プラットフォーム向け金融口座を使用するために必要な、アカウントの以下のケイパビリティをリクエストします。

- `transfers` (すべての連結アカウントに必要)
- `treasury`

> アカウントを作成する際にリクエストしない場合には、後でアカウントを更新してこれらのケイパビリティをリクエストできます。

Stripe Issuing でカードを連結アカウントに発行する場合は、`card_issuing` ケイパビリティもリクエストする必要があります。詳しくは、[Stripe Issuing カードの使用](https://docs.stripe.com/financial-accounts/connect/account-management/issuing-cards.md) ガイドをご覧ください。

ACH を使用して外部アカウントとの間での資金を移動する必要がある場合には、`us_bank_account_ach_payments` ケイパビリティもリクエストする必要があります。

前のオプションのすべてが含まれたリクエストは以下のようになります。

```javascript
const account = await stripe.accounts.create({
  country: 'US',
  email: email,
  capabilities: {
    transfers: {requested: true},
    treasury: {requested: true},
    card_issuing: {requested: true},
  },
  controller: {
    dashboard: {type: "none"},
    losses: {payments: "application"},
    requirement_collection: "application",
    fees: {payer: "application"}
  },
});
```

成功すると、受信されるレスポンスで、連結アカウントとリクエストされた `capabilities` が確認されます。

```json
{
  "id": "acct_1234",
  "object": "account",
  "capabilities": {
    "card_issuing": "inactive", // Should be requested only for Stripe Issuing users.
    "treasury": "inactive",
    "us_bank_account_ach_payments": "inactive"
  },
  ...
}
```

連結アカウントのケイパビリティの詳細については、Connect 用の[アカウントのケイパビリティ](https://docs.stripe.com/connect/account-capabilities.md)ガイドをご覧ください。

## 連結アカウントを更新して treasury ケイパビリティを含める

すでに `card_payments` が有効になった連結アカウントがある場合には、`POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}` を使用して、関連付けられた ID のアカウントを `treasury` ケイパビリティのリクエストで更新します。以下のリクエストは、連結アカウントを `treasury` ケイパビリティのリクエストで更新します。また、このリクエストにはオプションの `card_issuing` と `us_bank_account_ach_payments` のケイパビリティが含まれています。

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "capabilities[treasury][requested]=true" \
  -d "capabilities[card_issuing][requested]=true" \
  -d "capabilities[us_bank_account_ach_payments][requested]=true"
```

`FinancialAccount` が既に割り当てられている連結アカウントのケイパビリティを更新するには、`POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}` を使用してください。[金融口座の使用](https://docs.stripe.com/financial-accounts/connect/account-management/financial-accounts.md) または [FinancialAccount オブジェクト](https://docs.stripe.com/api/treasury/financial_accounts/object.md) の API ドキュメントを参照してください。

## 連結アカウントを登録する

アカウントを作成したら、そのアカウントに売り手やサービスプロバイダーをアカウント登録して所有者を設定する必要があります。連結アカウントを表す [Account](https://docs.stripe.com/api/accounts/object.md#account_object-requirements-currently_due) オブジェクトには、`requirements` ハッシュがあり、そこには `currently_due` の[本人確認](https://docs.stripe.com/connect/handling-api-verification.md)要件が含まれています。プラットフォームの売り手やサービスプロバイダーは、連結アカウントの支払いと[入金](https://docs.stripe.com/payouts.md)を有効にし、金融口座でリクエストされたすべての機能を有効化するため、`requirements` ハッシュに項目化された詳細を提供する必要があります。

プラットフォーム向け金融口座への連結アカウント所有者のアカウント登録には、[ホストされたアカウント登録](https://docs.stripe.com/financial-accounts/connect/account-management/connected-accounts.md#using-hosted-onboarding) と [カスタムアカウント登録](https://docs.stripe.com/financial-accounts/connect/account-management/connected-accounts.md#using-custom-onboarding) の 2 つのオプションがあります。Stripe はホストされたアカウント登録をお勧めします。

テスト用の `Account` オブジェクトを作成し、アカウント登録要件をバイパスして機能をテストする場合は、`POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}` を使用して、すべての要件を満たす[テスト値を指定](https://docs.stripe.com/connect/testing-verification.md)します。次のリクエストでは、以前に作成した連結アカウントを使用して、必要なアカウントの詳細を適用します。

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "tos_acceptance[date]=1547923073" \
  -d "tos_acceptance[ip]=172.18.80.19" \
  -d "settings[treasury][tos_acceptance][date]=1547923073" \
  -d "settings[treasury][tos_acceptance][ip]=172.18.80.19" \
  -d "business_profile[mcc]=5045" \
  --data-urlencode "business_profile[url]=https://bestcookieco.com" \
  -d "company[address][city]=Schenectady" \
  -d "company[address][line1]=123 State St" \
  -d "company[address][postal_code]=12345" \
  -d "company[address][state]=NY" \
  -d "company[tax_id]=000000000" \
  -d "company[name]=The Best Cookie Co" \
  -d "company[phone]=8888675309" \
  -d "individual[first_name]=Jenny" \
  -d "individual[last_name]=Rosen"
```

### オンラインのアカウント登録を使用する

Connect アカウント登録を使用して、必要な情報を効率的に収集します。これにより、確認の複雑さをお客様のプラットフォームから Stripe にオフロードし、利用規約を収集します。または、独自の API リクエストを作成して初期導入することもできますが、アカウント登録ワークフローを最新の状態に保つため、法令遵守要件の変更を監視する必要があります。プラットフォーム向け金融口座で動作する連結アカウントの作成方法については、[こちら](https://docs.stripe.com/connect/interactive-platform-guide.md?connect-charge-type=direct&connect-loss-liability-owner=platform)をご覧ください。

Connect アカウント登録を使用する前に、[Connect の設定ページ](https://dashboard.stripe.com/test/settings/connect)の**Branding**セクションで、ブランドの名前、色、アイコンを設定する必要があります。こうすることで、売り手やサービスプロバイダーがプラットフォームにアカウント登録する際に使用するフォームの視覚的外観をカスタマイズできます。

Connect アカウント登録のメリットを活用するには、`POST /v1/account_links` を使用して `AccountLink` を作成し、連結アカウントの所有権を取得する売り手またはサービスプロバイダーに提供します。

> セキュリティ上の理由から、アカウントリンクの URL をメールやテキスト、またはその他の方法でユーザーに直接送信しないでください。代わりに、プラットフォームのアプリケーション内から認証済みユーザーをアカウントリンクの URL にリダイレクトします。

```curl
curl https://api.stripe.com/v1/account_links \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  --data-urlencode "refresh_url=https://example.com/reauth" \
  --data-urlencode "return_url=https://example.com/return" \
  -d type=account_onboarding
```

受信されるレスポンスには、ユーザーに提供する URL が含まれます。

```json
{
  "object": "account_link",
  "created": 1612927106,
  "expires_at": 1612927406,
  "url": "https://connect.stripe.com/setup/s/iCtLfmYb2tEU"
}
```

### 埋め込み型アカウント登録を使用する

埋め込み型アカウント登録は、テーマを適用できるアカウント登録 UI であり、Stripe のブランディングは限定的にしか表示されません。Stripe 上のオンラインアカウント登録ソリューションよりも、きめ細かくユーザー体験をコントロールできます。埋め込み型アカウント登録を使用すると、カスタマイズされたアカウント登録フローを利用できます。規制要件の変更に応じた、アカウント登録システムの更新に関連する、複雑な作業やメンテナンスは不要です。

プラットフォームがアプリケーションに[アカウント登録コンポーネント](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md)を埋め込むと、連結アカウントはアプリケーションを離れることなく埋め込みコンポーネントを操作できます。埋め込みアカウント登録では、[Accounts API](https://docs.stripe.com/api/accounts.md) を使用して要件を読み取り、Stripe がサポートするすべての国に合わせて調整された、堅牢なデータ検証機能を持つアカウント登録フォームを生成します。

### カスタマイズしたアカウント登録を使用する

ユーザー向けにカスタムのアカウント登録を構築する場合は、`POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}` と `POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons/{{PERSON_ID}}` を使用し、該当する `Account` オブジェクトと `Person` オブジェクトを必要な情報で更新します。

また、連結アカウントの所有者が [Financial Accounts for platforms Agreement](https://stripe.com/treasury-connect-account/legal) を読み、同意していることを確認する必要があります。アカウント登録要件を満たすための詳細については、[Handling verification with the API](https://docs.stripe.com/connect/handling-api-verification.md) を参照してください。

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "company[name]=Homebox" \
  -d "company[address][line1]=123 Market St." \
  -d "company[address][city]=San Francisco" \
  -d "company[address][state]=CA" \
  -d "company[address][postal_code]=94107" \
  -d "company[address][country]=US"
```

### 要件

以下の表のフィールドは、プラットフォーム向け金融口座のユーザーには必須です。

| 法人タイプ                    | アカウント登録時                                                                                                                                                                                                                                                                                                               |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 個人、個人事業主                 | 法人の詳細:
  - ビジネス名 (顧客に表示される正式名称)
  - 法人タイプ
  - ビジネスの所在地
  - ビジネスの電話番号
  - 商品またはサービスの説明
  - 業種または加盟店カテゴリーコード
  - 納税者番号 (SSN、ITIN、または EIN）
  - プラットフォーム向け金融口座の TOS 受け入れ
  - Stripe 利用規約への同意
所有者の詳細:
  - 法人名
  - 生年月日
  - メールアドレス
  - 現住所
  - 完全な SSN、またはアメリカ以外の人の場合や SSN を確認できない場合には身分証明書を直接撮影した画像ファイル
  - 役職
  - 電話番号    |
| 会社 (LLC、企業、非営利団体、共同事業など) | 法人の詳細:
  - ビジネス名 (顧客に表示される正式名称)
  - 法人タイプ
  - ビジネスの所在地
  - ビジネスの電話番号
  - 商品またはサービスの説明
  - 業種または加盟店カテゴリーコード
  - 納税者番号 (EIN)
  - プラットフォーム向け金融口座の TOS 受け入れ
  - Stripe 利用規約への同意
オーナー/代表者の詳細:
  - 法人名
  - 生年月日
  - メールアドレス
  - 現住所
  - 電話番号
  - 役職
  - 会社の所有率
  - 完全な SSN、またはアメリカ以外の人の場合や SSN を確認できない場合には身分証明書を直接撮影した画像ファイル |

### 完了

連結アカウントのアカウント登録プロセスは、連結アカウントの以下のフィールドを確認する `account.updated` [Webhook](https://docs.stripe.com/webhooks.md) を受信すると完了します。

```
{
  "object": {
    "object": "account",
    "id": "acct_1234",
    "capabilities": {
      "treasury": "active",
      "card_issuing": "active", // Only appears if requesting the `card_issuing` capability.
      "us_bank_account_ach_payments": "active" // Only appears if requesting the `us_bank_account_ach_payments` capability.
    },
    ...
  }
}
```

プラットフォームの銀行パートナーが Evolve Bank & Trust の場合のアカウント登録の遅延は、5 分未満です。

### 要件の更新

金融規制の変更に適応するため、Stripe はプラットフォーム向け金融口座の情報収集要件を更新する必要があります。`Account` オブジェクトの `requirements.eventually_due` 配列は、このような規制の変更によって要求される更新情報をキャプチャーします。[requirements](https://docs.stripe.com/api/accounts/object.md#account_object-requirements) ハッシュの詳細については、こちらをご覧ください。