Collect tips

Learn about the different ways you can collect tips from customers.

Use Terminal to collect tips from your customer before or after authorizing a payment. You can collect voluntary tips in two ways:

On-receipt tipping : Tips are collected when the payment is captured. This method is most commonly used when collecting tips on printed paper receipts.
On-reader tipping : The card reader suggests tips to customers before collecting payment.

For mandatory tips, you must include the tip amount in the original PaymentIntent amount. You can’t use on-receipt or on-reader tipping.

The table below outlines some differences between on-receipt tipping and on-reader tipping.

	On-reader tipping	On-receipt tipping
Country	the related setting WisePad 3: Available in: Stripe Reader the related setting/the related setting and the related setting WisePOS E: Available in:
Reader	the related setting WisePad 3 the related setting WisePOS E Stripe Reader the related setting/the related setting	Any
Integrations/SDKs	the related setting WisePad 3: Android SDK iOS SDK React Native SDK the related setting WisePOS E and Stripe Reader the related setting/the related setting: All SDKs, server-driven	All SDKs, server-driven
Merchant category	Any	Restricted
Card brand	Any	Visa, Mastercard, American Express, Discover
Tipping limit	Maximum charge amount for the total amount inclusive of the tip, which is eight or nine digits depending on the currency	Maximum charge amount for the total amount inclusive of the tip
Customer experience	Tips suggested on the reader	Tips set with custom integration on the point of sale or on a paper receipt
Capture method	Works with both `capture_method=automatic` and `capture_method=manual`. The tip is collected before payment, so the total amount (including the tip) is known at authorization time.	Requires manual capture ( `capture_method=manual`). The tip is added after authorization through overcapture.
Customer credit card statement	Shows the payment amount inclusive of the tip, without waiting for settlement	Shows an initial pending authorization that’s later updated to reflect the initial amount inclusive of the tip

On-receipt and on-reader tipping use the PaymentIntents API and work with all Terminal SDKs.

Choose only one tipping method per PaymentIntent. If you use on-reader tipping, you can’t use the same PaymentIntent for on-receipt tipping.

The table below summarizes the specific API behavior.

	On-reader tipping	On-receipt tipping
Tips in the API request	The reader automatically adds the customer-selected tip when processing a payment.	You add the tip amount and pass the total amount_to_capture when capturing a PaymentIntent. The `amount_to_capture` field is inclusive of the tip.
Tips and API response amount	The amount_details object appears in the API response when processing a payment. The tip amount is returned in the `amount_details` object.	Tips aren’t directly represented but can be derived from the Charge object. The `amount` in the `PaymentIntent` capture response is inclusive of the tip.
Tips in the underlying `Charge` object	Tips aren’t directly represented in the `Charge` object. After capture, the fields below all show the same value inclusive of the tip. amount amount_authorized amount_captured	Tips can be derived from the `Charge` object. You can derive the tip by subtracting `amount_authorized` from `amount`. `amount_authorized` is the original authorized amount exclusive of the tip. `amount_captured` and `amount` are the same and both are inclusive of the tip.