チップを回収する

顧客からチップを回収するさまざまな方法についてご紹介します。

Terminal を使用して、支払いのオーソリ前またはオーソリ後に顧客からチップを回収します。以下の 2 つの方法で、自発的なチップを回収できます。

領収書上のチップ: チップは、支払いがキャプチャーされたときに回収されます。この方法は、印刷された紙の領収書でチップを回収する際に最も一般的に使用されます。
リーダー上のチップ: カードリーダーは、支払いを回収する前に顧客にチップを提示します。

必須のチップの場合には、チップの金額を、PaymentIntent の元のamountに含める必要があります。領収書上のチップ処理やリーダー上のチップ処理は使用できません。

領収書上のチップ処理とリーダー上のチップ処理

次の表は、領収書上のチップ処理とリーダー上のチップ処理の違いの一部を示しています。

	リーダー上のチップ処理	領収書上のチップ処理
国	BBPOS WisePad 3: 利用可能な国: Stripe リーダー S700 および BBPOS WisePOS E: 利用可能な国:
リーダー	BBPOS WisePad 3 BBPOS WisePOS E Stripe リーダー S700	すべての種類
組み込み/SDK	BBPOS WisePad 3: Android SDK iOS SDK React Native SDK BBPOS WisePOS E と Stripe リーダー S700: すべての SDK、サーバー主導型	すべての SDK、サーバー主導型
加盟店カテゴリー	すべての種類	制限付き
カードブランド	すべての種類	Visa、Mastercard、アメリカン・エキスプレス、ディスカバー
チップ処理の限度額	チップを含む合計金額の最大請求金額。通貨に応じて 8 桁または 9 桁です。	チップを含む合計金額の最大請求金額。
顧客への表示	リーダー上にチップを提示	POS または紙の領収書でカスタムの組み込みを使用して設定されたチップ
顧客のクレジットカード明細書	売上処理を待たずにチップを含む支払い金額が表示されます。	当初の保留中のオーソリ額が表示されます。この金額は、元の金額へのチップを反映して後で更新されます。

領収書上またはリーダー上のチップの提示方法

領収書およびリーダーでのチップ処理は、PaymentIntents APIを使用し、すべての Terminal SDK と連携し、手動キャプチャーを必要とします。

注意

チップの処理方法は、PaymentIntent ごとに 1 つのみ選択してください。リーダー上のチップ処理を使用する場合、同じ PaymentIntent を領収書上のチップ処理に使用することはできません。

以下の表は、個別の API の動作をまとめたものです。

リーダー上のチップ処理領収書上のチップ処理

API リクエストのチップリーダーは、支払いを処理するときに、顧客が選択したチップを自動的に加算します。 PaymentIntent をキャプチャーするときに、チップ金額を加算し、合計の amount_to_capture を渡します。amount_to_capture フィールドにはチップが含まれています。

チップと API レスポンスの金額 amount_details オブジェクトは、決済を処理する際に、API レスポンスに表示されます。チップ金額は、amount_details オブジェクトで返されます。チップは直接表示されませんが、Charge (支払い) オブジェクトから計算できます。PaymentIntent キャプチャーのレスポンスの amount にはチップが含まれています。

	リーダー上のチップ処理	領収書上のチップ処理
API リクエストのチップ	リーダーは、支払いを処理するときに、顧客が選択したチップを自動的に加算します。	PaymentIntent をキャプチャーするときに、チップ金額を加算し、合計の amount_to_capture を渡します。`amount_to_capture` フィールドにはチップが含まれています。
チップと API レスポンスの金額	amount_details オブジェクトは、決済を処理する際に、API レスポンスに表示されます。チップ金額は、`amount_details` オブジェクトで返されます。	チップは直接表示されませんが、Charge (支払い) オブジェクトから計算できます。`PaymentIntent` キャプチャーのレスポンスの `amount` にはチップが含まれています。
基になる `Charge` オブジェクトのチップ	チップは、`Charge` オブジェクトに直接表示されません。キャプチャーすると、下記のフィールドはすべて、チップを含めた同じ値を示します。 amount amount_authorized amount_captured	チップは `Charge` オブジェクトから計算できます。チップは、`amount` から `amount_authorized` を差し引くことで求めることができます。 `amount_authorized` は、元のオーソリ済みの金額です。チップは含まれません。 `amount_captured` と `amount` は同じで、どちらもチップを含みます。

基になる Charge オブジェクトのチップ

チップは、Charge オブジェクトに直接表示されません。

キャプチャーすると、下記のフィールドはすべて、チップを含めた同じ値を示します。

チップは Charge オブジェクトから計算できます。チップは、amount から amount_authorized を差し引くことで求めることができます。

amount_authorized は、元のオーソリ済みの金額です。チップは含まれません。
amount_captured と amount は同じで、どちらもチップを含みます。