# 料金グループを作成する

連結アカウントグループごとに別個の料金体系を定義します。

個々のアカウントに特定の手数料を定義するには、料金グループではなく、[上書き](https://docs.stripe.com/connect/platform-pricing-tools/pricing-schemes.md#override-a-specific-account)を使用します。

料金グループを定義して、特定の料金体系を複数の連結アカウントに同時に割り当てることができます。これにより、同じ手数料の上書きを各連結アカウントに個別に手動で追加または更新するよりも時間を節約できます。

すべての料金体系で、最大 50 のグループを作成できます。

## 料金体系にグループを割り当てる

商品ごとに最大 50 件の料金体系 ( Payments や Instant Payouts など) を定義して、それぞれを[利用資格のある連結アカウント](https://docs.stripe.com/connect/platform-pricing-tools.md#eligibility-for-payments)の 1 つ以上のグループに適用できます。1 つの連結アカウントに対して有効にできる料金体系は 1 つのみです。

新しい料金体系を作成して料金グループを定義するには、以下の手順に従います。

1. Stripe ダッシュボードの[プラットフォームの料金体系](https://dashboard.stripe.com/settings/connect/platform_pricing)ページ (**設定** > **Connect** > **プラットフォームの料金体系**) の [支払い] タブで、**+ Add scheme**をクリックします。
1. **新しいブランドフィーを作成する**または**既存のブランドフィーから開始する**を選択します。
1. ブランドフィーに名前を付けます。
1. [料金体系を作成する](https://docs.stripe.com/connect/platform-pricing-tools/pricing-schemes.md)手順を使用して、料金体系、フォールバックルール、手数料の修飾子を含めて定義します。
1. 料金体系にグループを割り当てます。
   - 名前を入力し、**+ 追加**をクリックして新しいグループを作成します。料金体系を保存すると、[新しいグループにアカウントを追加](https://docs.stripe.com/connect/platform-pricing-tools/pricing-groups.md#add-accounts-to-groups)できるようになります。
   - または、**グループを再割り当てする**をクリックして既存のグループを選択し、**+ 再割り当てする**をクリックします。
1. **保存して有効にする**をクリックし、割り当てられているグループと各グループのアカウント数など、料金体系の詳細を確認します。**確定する**をクリックして変更を送信します。
1. 料金体系のオーバーフローメニュー (⋯) をクリックし、**編集**をクリックして変更します。

## グループにアカウントを追加する

以下のようにして、連結アカウントを既存のグループに追加できます。

- **CSV インポート**: 即時に有効になりますが、UI のグループ件数の更新に少し時間がかかります。
- **API**: 直ちに有効になります。

最近のグループ割り当ての変更が CSV エクスポートに反映されるまでに、最大 24 時間かかります。

### CSV インポート

ダッシュボードを使用して、グループに追加する連結アカウントを定義する CSV ファイルをインポートします。

1. アカウントを追加するグループの GroupID をコピーします。
1. グループの料金体系のオーバーフローメニュー (⋯) をクリックして、**アカウントを追加**を選択します。
1. 事前設定されたグループの CSV をダウンロードします (または独自に作成します)。
1. 追加する連結アカウントごとに、以下の 2 つの列を入力します。
   - **connected\_account**: このグループに割り当てる連結アカウントの `account id`。
   - **account\_group**: アカウントを追加するグループの `group id`。
1. **CSV をアップロードする**をクリックして、入力済みのファイルを選択します。
1. Stripe はファイルを検証して、ファイルに含まれて_いない_ プラットフォームの連結アカウントの数を返します。これは、誤ってユーザーを省略していないことを確認するのに役立ちます。
1. **確定する**をクリックして、インポートを完了します。

### API

連結アカウントを料金グループに割り当てる前に、ダッシュボードのプラットフォームの料金体系ページからグループ ID (`acctgrp_xxx`) を取得します。

#### 既存のアカウントにグループを割り当てる

> #### Accounts v2
> 
> Accounts v2 API は料金グループに対応していません。Accounts v1 API を使用して、`Accounts` の料金グループを管理してください。

1. [update Account](https://docs.stripe.com/api/accounts/update.md) コールの `groups.payments_pricing` パラメーターに、`Account` を割り当てるグループの `ID` を入力します。
1. `groups` オブジェクトを[展開](https://docs.stripe.com/expand.md)して、レスポンスで `groups` パラメーターをリクエストします。

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "groups[payments_pricing]=acctgrp_NrikrzNEvHZ4go" \
  -d "expand[]=groups"
```

レスポンスでは、拡張された `groups` パラメーターが含まれた連結アカウントのオブジェクトが返されます。

```json
{
  // ...
  "groups": {
    "payments_pricing": "acctgrp_NrikrzNEvHZ4go"
  }
}
```

#### 新しいアカウントの作成時にグループを割り当てる

> #### Accounts v2
> 
> Accounts v2 API は料金グループに対応していません。Accounts v1 API を使用して、`Accounts` の料金グループを管理してください。

1. [create Account](https://docs.stripe.com/api/accounts/update.md) コールの `groups.payments_pricing` パラメーターに、`Account` を割り当てるグループの `ID` を入力します。

   または、アカウント作成時に `groups` パラメーターを省略して、アカウントをデフォルトグループに自動的に割り当てます。特定のグループに指定されていない対象の連結アカウントはすべて、デフォルトグループに属します。

1. `groups` オブジェクトを[展開](https://docs.stripe.com/expand.md)して、レスポンスで `groups` パラメーターをリクエストします。

```curl
curl https://api.stripe.com/v1/accounts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "groups[payments_pricing]=acctgrp_NrikrzNEvHZ4go" \
  -d "expand[]=groups"
```

レスポンスでは、拡張された `groups` パラメーターが含まれた新しい連結アカウントのオブジェクトが返されます。

```json
{
  // ...
  "groups": {
    "payments_pricing": "acctgrp_NrikrzNEvHZ4go"
  }
}
```

#### アカウントのグループを取得する

アカウント検索コールの `groups` パラメーターを展開して、アカウントの料金グループを確認します。`payments_pricing` グループに null 値が含まれている場合、連結アカウントには[料金の上書き](https://docs.stripe.com/connect/platform-pricing-tools/pricing-schemes.md#override-a-specific-account)が設定されます。

```curl
curl -G https://api.stripe.com/v1/accounts/{{CONNECTEDACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "expand[]=groups"
```

レスポンスでは、拡張された `groups` パラメーターが含まれた新しい連結アカウントのオブジェクトが返されます。

```json
{
  // ...
  "groups": {
    "payments_pricing": "acctgrp_NrikrzNEvHZ4go"
  }
}
gated=["groups"]
```

## 料金体系から料金グループの割り当てを解除する

料金体系からグループとその連結アカウントの関連付けを解除するには、以下の手順に従います。

1. 料金体系のオーバーフローメニュー (⋯) をクリックして、**編集**を選択します。
1. **グループを割り当てる**セクションで、目的のグループのオーバーフローメニュー (⋯) をクリックして、**割り当て解除**を選択します。
1. **保存して有効にする**をクリックしてから、**確定する**をクリックします。

これにより、料金グループとそれに関連付けられた連結アカウントは削除されません。料金グループはデフォルトの料金体系に再度割り当てられます。その場合でも、[料金グループを別の料金体系に再割り当てする](https://docs.stripe.com/connect/platform-pricing-tools/pricing-groups.md#assign-groups-to-a-pricing-scheme)ことができます。

## 料金グループを削除する

料金グループを削除して、その連結アカウントを、デフォルトの料金体系に関連付けられた料金グループに再度割り当てることができます。料金グループはダッシュボードからのみ削除できます。

> API コールで引き続き参照する料金体系グループを削除すると、システムが正常に機能しなくなる可能性があります。

1. 料金体系のオーバーフローメニュー (⋯) をクリックして、**編集**を選択します。
1. **グループを割り当てる**セクションで、目的のグループのオーバーフローメニュー (⋯) をクリックして、**削除**を選択します。
1. **保存して有効にする**をクリックしてから、**確定する**をクリックします。

削除された料金グループに含まれる連結アカウントはすべて、デフォルトの料金体系の料金グループに再度割り当てられます。

## 支払いの料金体系に割り当てられたアカウントを表示する

料金体系の連結アカウントとそれに割り当てられたグループの CSV リストをダウンロードできます。ダッシュボードの[プラットフォームの料金体系](https://dashboard.stripe.com/settings/connect/platform_pricing)ページから、料金体系のオーバーフローメニュー (⋯) をクリックし、**アカウントをエクスポート**を選択します。

また、 [プラットフォームの料金体系](https://dashboard.stripe.com/settings/connect/platform_pricing)ページの上部にある**アカウントをエクスポート**をクリックして、すべての連結アカウントとそれに割り当てられた料金体系の CSV リストをダウンロードすることもできます。