料金グループを作成する

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

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

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

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

商品ごとに最大 50 件の料金体系 ( Payments や Instant Payouts など) を定義して、それぞれを利用資格のある連結アカウントの 1 つ以上のグループに適用できます。1 つの連結アカウントに対して有効にできる料金体系は 1 つのみです。

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

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

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

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

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

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

CSV インポート

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

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

API

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

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

アカウントを更新コールの groups.payments_pricing パラメーターに、アカウントを割り当てるグループの ID を入力します。
groups オブジェクトを展開して、レスポンスで groups パラメーターをリクエストします。

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

Assign group to existing account response example
{
  // ...
  "groups": {
    "payments_pricing": "acctgrp_NrikrzNEvHZ4go"
  }
}

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

アカウントを作成するコールの groups パラメーターに、アカウントを割り当てるグループの name と ID を入力します。
または、アカウント作成時に groups パラメーターを省略して、アカウントをデフォルトグループに自動的に割り当てます。特定のグループに指定されていない対象の連結アカウントはすべて、デフォルトグループに属します。
groups オブジェクトを展開して、レスポンスで groups パラメーターをリクエストします。

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

Assign group during account creation response example
{
  // ...
  "groups": {
    "payments_pricing": "acctgrp_NrikrzNEvHZ4go"
  }
}

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

アカウント検索コールの groups パラメーターを展開して、アカウントの料金グループを確認します。payments_pricing グループに null 値が含まれている場合、連結アカウントには料金の上書きが設定されます。

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

Retrieve account group response example
{
  // ...
  "groups": {
    "payments_pricing": "acctgrp_NrikrzNEvHZ4go"
  }
}
gated=["groups"]

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

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

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

これにより、料金グループとそれに関連付けられた連結アカウントは削除されません。料金グループはデフォルトの料金体系に再度割り当てられます。その場合でも、料金グループを別の料金体系に再割り当てすることができます。

料金グループを削除する

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

注意

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

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

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

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

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

また、プラットフォームの料金体系ページの上部にあるアカウントをエクスポートをクリックして、すべての連結アカウントとそれに割り当てられた料金体系の CSV リストをダウンロードすることもできます。