# Terminal を構成する

Terminal Configuration オブジェクトを使用して、リーダーに設定を適用します。

Terminal の [Configuration](https://docs.stripe.com/api/terminal/configuration.md) オブジェクトには、[スプラッシュ画面](https://docs.stripe.com/terminal/fleet/splash-screen.md)、[チップ処理設定](https://docs.stripe.com/terminal/fleet/tipping.md)、[オフライン モード](https://docs.stripe.com/terminal/fleet/offline-mode.md)など、リーダーに関連するすべての設定が含まれます (具体的な手順とオプションについては、個人設定ガイドを参照してください)。

これらの設定は階層的であるため、アカウントレベルまたは個人の店舗レベルで設定を適用できます。設定は次の方法で行うことができます:

- 個人[店舗](https://docs.stripe.com/api/terminal/locations.md): その店舗に登録されているすべてのリーダーに適用されます
- アカウントレベル: すべてのリーダーに一括適用されます

アカウントレベルの設定を店舗レベルの設定で上書きできます。店舗レベルで設定を行わない場合は、アカウントレベルの設定が適用されます。

> ゾーンの設定作成はプライベートプレビューで行います。プレビューへの参加をリクエストされる場合、[メールでお問い合わせください](mailto:terminal-zones-configuration-preview@stripe.com)。

たとえば、`Configuration` オブジェクトを次のようにモデル化できます。
![Configuration の階層](https://b.stripecdn.com/docs-statics-srv/assets/configuration-object-tree.5ec745ad57500a800c4f34f0a970224e.png)

このシナリオでは、店舗 3 はアカウントの「デフォルト設定」から設定を継承して、店舗 1 と 2 はそれぞれ独自に設定されています。

> 店舗レベルで設定を行わない場合、店舗はアカウントのデフォルト設定を継承します。たとえば、Location でスプラッシュスクリーンを設定しない場合は、アカウントレベルで設定されたデフォルト設定から継承されます。

API またはダッシュボードを使用して行われた設定変更は、対象のリーダーに反映されるまでに最大 10 分かかることがあります。

# API


## アカウントのデフォルト構成を取得する

Stripe は、アカウントにデフォルトの構成を自動的に提供します。階層を設定する際に、店舗レベルで確立されなかった設定は、デフォルトの構成から設定を継承します。デフォルトの構成を店舗に直接適用することはできません。アカウントのデフォルト設定を取得するには、[設定取得](https://docs.stripe.com/api/terminal/configuration/retrieve.md)リクエストを使用します。

```curl
curl -G https://api.stripe.com/v1/terminal/configurations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d is_account_default=true
```

## 個々の店舗の設定を作成する

`Configuration` オブジェクトを作成するには、[create configuration (設定作成)](https://docs.stripe.com/api/terminal/configuration/create.md) リクエストを使用します。

```curl
curl https://api.stripe.com/v1/terminal/configurations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "bbpos_wisepos_e[splashscreen]={{FILE_ID}}"
```

店舗に割り当てるには、以前に作成した `Configuration` オブジェクトを [update location](https://docs.stripe.com/api/terminal/locations/update.md) リクエストに指定します。

```curl
curl https://api.stripe.com/v1/terminal/locations/{{TERMINALLOCATION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "configuration_overrides={{TERMINALCONFIGURATION_ID}}"
```

## 既存の設定を更新する

`Configuration` オブジェクトを更新するには、[update configuration (設定更新)](https://docs.stripe.com/api/terminal/configuration/update.md) リクエストを使用します。

```curl
curl https://api.stripe.com/v1/terminal/configurations/{{TERMINALCONFIGURATION_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "bbpos_wisepos_e[splashscreen]={{FILE_ID}}"
```

## 設定を削除する

`Configuration` オブジェクトを削除するには、[delete configuration (設定削除)](https://docs.stripe.com/api/terminal/configuration/delete.md) リクエストを使用します。

```curl
curl -X DELETE https://api.stripe.com/v1/terminal/configurations/tmc_EjHtMwLT8HmATT \
  -u "<<YOUR_SECRET_KEY>>:"
```