For on-reader tipping, follow the instructions for collecting payments and create your
When you collect a payment method, your customer sees a tip selection screen on the reader that prompts them to select a tip before asking for their payment method.
Depending on your tipping configuration, the customer can choose a suggested tip, specify a custom tip, or leave no tip.
After the customer makes their selection, the reader waits for them to present a card.
When you process the payment, the reader adds the selected tip. If the payment is successful, the amount in the
Charge is updated to include the tip amount.
The tip amount is returned in the amount_details object:
|Scenario||amount return value|
|On-reader tipping is disabled|
|On-reader tipping is enabled, no tip selected|
|On-reader tipping is enabled, tip amount selected||The amount selected|
Customers won’t see a tipping selection screen in these cases:
Configuration object is missing a tipping configuration.
- You enabled
skipTipping in your tipping configuration.
- The reader is in an unsupported country.
- A tipping configuration can’t be applied to the current payment currency. For example, if the payment is in EUR but the
Configuration object only specifies a tipping configuration for USD.
When testing payments with the Stripe reader, the total amount (inclusive of any tip) may trigger decline responses depending on the decimal value of the total amount.