Terminal を構成する
Terminal Configurations オブジェクトを使用してリーダーに設定を適用する方法をご紹介します。
The Terminal Configuration object contains all relevant configurations for a reader, such as the splash screen, tipping settings, offline mode, and so on. Because these settings are hierarchical, you can apply a configuration at either the account level or at the individual location level. You can set configurations in the following ways:
- On individual Locations: Applies to all readers registered to that Location
- アカウントレベル: すべてのリーダーに一括適用されます
アカウントレベルの設定を場所レベルの設定で上書きできます。場所レベルで設定を行わない場合は、アカウントレベルの設定が適用されます。
注
ゾーンに対する設定の割り当てや追加はサポートされていません。
たとえば、Configuration
オブジェクトを次のようにモデル化できます。
![Configuration の階層](https://b.stripecdn.com/docs-statics-srv/assets/configuration-object-tree.5ec745ad57500a800c4f34f0a970224e.png)
このシナリオでは、場所 3 はアカウントの「デフォルト設定」から設定を継承して、場所 1 と 2 はそれぞれ独自に設定されています。
注
場所レベルで設定を行わない場合、場所はアカウントのデフォルト設定を継承します。たとえば、Location でスプラッシュスクリーンを設定しない場合は、アカウントレベルで設定されたデフォルト設定から継承されます。
API またはダッシュボードを使用して行われた設定変更は、対象のリーダーに反映されるまでに最大 10 分かかることがあります。
アカウントのデフォルト構成を取得する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe automatically provisions the default configuration for your account. When you set up your hierarchy, any setting that isn’t established at the location level inherits the setting from the default configuration. You can’t apply the default configuration directly to a Location. To retrieve the account default configuration, use the configuration retrieve request:
個々の場所の設定を作成する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
To create a Configuration
object, use the create configuration request:
To assign it to a location, provide the Configuration
object you previously created to the update location request:
既存の設定を更新する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
To update a Configuration
object, use the update configuration request:
設定を削除する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
To delete a Configuration
object, use the delete configuration request: