リーダー上のチップを回収

リーダー上のチップ処理を使用すると、顧客が支払い方法を提示する前に、推奨されるチップ金額をリーダーに表示できます。リーダーは、お客様のチップオプションに基づいて 3 種類の提示額を顧客に表示します。リーダーは、支払いを回収する呼び出しのたびに、チップ処理の選択画面を自動的に表示します。支払いを確定すると、選択したチップを含む金額の PaymentIntent が確定されます。

決済画面

チップの選択画面 (パーセント)

合計画面

承認画面

Enable and customize on-reader tipping

Configuration (設定) オブジェクトを使用し、BBPOS WisePad 3 リーダーまたは BBPOS WisePOS E リーダーのチップ処理を設定します。

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

BBPOS WisePad 3 でリーダー上のチップ機能を使用するには、以下の Terminal SDK のいずれかのバージョンを使用する必要があります。

• Android SDK 2.8.1 以上
• iOS SDK 2.16.1 以上

curl https://api.stripe.com/v1/terminal/configurations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 オブジェクトで複数の通貨を指定する場合は、各通貨に同じ設定キーを指定する必要があります。たとえば、USD に percentages のみを指定した場合、他の通貨に fixed_amounts や smart_tip_threshold を指定することはできません。

チップ処理を設定して Configuration オブジェクトを作成したら、アカウントまたは場所にその設定を割り当てることができます。BBPOS WisePad 3 リーダーは、POS アプリケーションに接続したときに新規または更新された設定を受信します。BBPOS WisePOS E リーダーが新規または更新された設定を受信するまでには、最大で 5 分かかります。

Collect payment

リーダー上のチップ処理については、支払いの回収手順を参照し、capture_method を manual として PaymentIntent を作成してください。

支払い方法を収集するときに、リーダーにチップ選択画面が表示され、支払い方法の決定を促す前に、顧客にチップの選択を求めます。

チップ処理の設定に応じて、顧客は、提示されたチップを選択するか、カスタムのチップを指定するか、チップなしにすることができます。

顧客がこの選択を行うと、リーダーはカードが提示されるまで待機します。

支払いを処理すると、リーダーは選択されたチップを追加します。支払いが成功すると、PaymentIntent と Charge の amount が更新されて、チップ金額が加算されます。

チップ金額は、amount_details オブジェクトで返されます。

次のケースでは、顧客に対してチップ処理の選択画面は表示されません。

1. Configuration オブジェクトにチップ処理設定がない場合。
2. チップ処理設定で skipTipping を有効にした場合。
3. リーダーがサポート対象外の国にある場合。
4. チップ設定を現在の支払い通貨に適用することができない場合。たとえば、決済が EUR であり、Configuration オブジェクトで USD のチップ処理のみが指定されている場合です。

Stripeリーダーで支払いをテストするとき、合計金額の小数点以下の値によっては、合計金額 (チップを含む) に対して支払い拒否のレスポンスがトリガーされることがあります。

チップ処理のスキップ

チップ処理設定を無視することができます。こうすると、支払いの回収時に BBPOS WisePad 3 リーダーまたは BBPOS WisePOS E リーダーでチップ選択画面が表示されないようにすることができます。

チップ選択画面は、個々の取引で非表示にすることも、一時的にすべての取引で非表示にすることもできます。これにより、顧客はカード提示画面に直接移動できます。

たとえば、レストランでは、テイクアウトの注文のチップはリーダーで受け付け、店内で食事をする顧客については領収書上でのみチップを受け付けられるようにすることがあります。

チップ選択画面をスキップするには、以下のいずれかのオプションを使用します。

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/process_payment_intent \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d payment_intent="<payment_intent>" \
  -d "process_config[skip_tipping]"=true

Tip-eligible amounts

支払いを回収する際に、チップ加算前の金額とは異なるチップ対象金額を設定できます。チップ対象金額を設定することで、パーセンテージに基づくチップの計算対象となる値が変更されます。また、顧客のチップ選択画面には、チップ加算前の金額の横にチップ対象金額が表示されます。

この設定は、商品を販売するだけでなくサービスを提供するビジネスに使用できます。たとえば、ヘアカットサービスとシャンプー商品を販売しているサロンでは、ヘアカットに対してのみパーセンテージに基づくチップを計算することを顧客に通知することができます。

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/process_payment_intent \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d payment_intent="<payment_intent>" \
  -d "process_config[tipping][amount_eligible]"=1500

上記の例では、支払いの通貨に基づいてチップ対象金額を設定しています。USD での支払いの場合、チップ対象金額は 15 USD です。

eligible_amount の値は 0 以上である必要があります。 eligible_amount が 0 の場合、skip_tipping の値に関係なくチップはスキップされます。eligible_amount が PaymentIntent の金額と同じ場合、eligible_amount は無視され、指定された金額に基づいてチップが計算されます。