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

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

決済画面

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

合計画面

承認画面

リーダー: Stripe Reader S700、BBPOS WisePOS E、BBPOS WisePad 3

リーダーでのチップ処理の有効化とカスタマイズ

Configuration オブジェクトを使用して、リーダーのチップ設定を設定します。

• スマートチップで提示: リーダーは、チップ加算前の金額帯に応じて、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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 分かかります。

支払いを回収する

リーダーを介してチップを渡す場合は、支払いの回収の手順に従ってください。

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

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

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

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

PaymentIntent の確認前は、チップの金額は amount_tip フィールドに返されますが、amount には返されません。PaymentIntent の確認後、amount_tip フィールドはゼロに設定され、amount にはチップ金額が含まれます。チップ金額は amount_details オブジェクトに返されます。

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

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

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

チップ処理のスキップ

チップ設定は無視してかまいません。これにより、支払いの回収時にリーダーのチップ選択画面を非表示にすることができます。

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

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

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

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

チップ対象金額

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

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

curl https://api.stripe.com/v1/terminal/readers/tmr_xxx/process_payment_intent \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 は無視され、指定された金額に基づいてチップが計算されます。