# リーダー上のチップを設定する

リーダーに表示されるチップ処理オプションをカスタマイズします。

[リーダー上のチップ](https://docs.stripe.com/terminal/features/collecting-tips/overview.md)を使用して、顧客が支払い方法を提示する前に、推奨されるチップの金額をリーダーに表示することができます。以下のリーダー上のチップのタイプに対応しています。

- **スマートチップを提示**: リーダーは、チップ加算前の金額帯に応じて、3 種類のパーセンテージまたは金額を動的に表示します。
- **パーセンテージで提示**: リーダーにパーセンテージに基づく 3 種類のチップ金額を表示します。
- **金額で提示**: リーダーは3 種類のチップ金額を表示します。

# ダッシュボード

> This is a ダッシュボード for when dashboard-or-api is dashboard. View the full page at https://docs.stripe.com/terminal/fleet/tipping?dashboard-or-api=dashboard.

## 店舗の詳細ページから

1. [Terminal Locations](https://dashboard.stripe.com/terminal/locations) ページに移動します。
1. パスコードを変更したい特定の店舗をクリックします。
1. **ローカル設定** または **継承された設定** の **チップ** 行の横にある編集アイコン (✏) をクリックします。
1. **チップ処理モード**を選択します。
1. **通貨**を選択します。
1. 希望のチップ処理オプション (割合に基づくチップ処理の場合に 10%、15%、20% と入力できます) を入力して、さまざまなチップ処理のモードと通貨に対してこのプロセスを繰り返します。
1. **確認**をクリックして、変更を表示し、**確定する**をクリックします。
1. 店舗の最終設定をレビューし、 **変更を適用** をクリックします。

## 店舗管理ページから

1. [店舗を管理する](https://dashboard.stripe.com/terminal/locations/manage)ページに移動します。
1. 変更する特定の店舗を探します。
1. オーバーフローメニュー (⋯) > **設定を編集**をクリックして、設定ドロワーを表示します。
1. **チップ処理**アイコンの横にある**編集**または**上書きする**をクリックします。
1. **チップ処理モード**を選択します。
1. **通貨**を選択します。
1. 希望のチップ処理オプション (割合に基づくチップ処理の場合に 10%、15%、20% と入力できます) を入力して、さまざまなチップ処理のモードと通貨に対してこのプロセスを繰り返します。
1. **確認**をクリックして、変更を表示し、**確定する**をクリックします。
1. **変更を適用する**をクリックします。

Stripe は 10 分以内にリーダーのチップ設定を適用します。


# API

> This is a API for when dashboard-or-api is api. View the full page at https://docs.stripe.com/terminal/fleet/tipping?dashboard-or-api=api.

[Configuration](https://docs.stripe.com/api/terminal/configuration.md) オブジェクトを作成または更新するときに、リーダー上のチップを指定できます。

特定のチップ処理オプションを指定して `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 "tipping[usd][percentages][]=15" \
  -d "tipping[usd][percentages][]=20" \
  -d "tipping[usd][percentages][]=25" \
  -d "tipping[usd][fixed_amounts][]=100" \
  -d "tipping[usd][fixed_amounts][]=200" \
  -d "tipping[usd][fixed_amounts][]=300" \
  -d "tipping[usd][smart_tip_threshold]=1000"
```

特定のチップ処理オプションを指定して `Configuration` オブジェクトを更新するには、[update configuration (設定更新)](https://docs.stripe.com/api/terminal/configuration/update.md) リクエストを使用します。

```curl
curl https://api.stripe.com/v1/terminal/configurations/tmc_EjHtMwLT8HmATT \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "tipping[usd][percentages][]=15" \
  -d "tipping[usd][percentages][]=20" \
  -d "tipping[usd][percentages][]=25" \
  -d "tipping[usd][fixed_amounts][]=100" \
  -d "tipping[usd][fixed_amounts][]=200" \
  -d "tipping[usd][fixed_amounts][]=300" \
  -d "tipping[usd][smart_tip_threshold]=1000"
```

[リーダー上のチップ](https://docs.stripe.com/terminal/features/collecting-tips/on-reader.md#customize-tips-reader)を有効にしてカスタマイズする方法をご覧ください。