Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
About Stripe payments
Upgrade your integration
Payments analytics
Online payments
OverviewFind your use caseManaged Payments
Use Payment Links
Build a checkout page
Build an advanced integration
Build an in-app integration
Payment methods
Add payment methods
Manage payment methods
Faster checkout with Link
Payment interfaces
Payment Links
Checkout
Web Elements
In-app Elements
Payment scenarios
Custom payment flows
Flexible acquiring
Orchestration
In-person payments
Terminal
    Overview
    Accept in-person payments
    Integration design
    Select your reader
    Design an integration
    Quickstart
    Example applications
    Testing
    Terminal setup
    Set up your integration
    Connect to a reader
    Accepting a payment
    Collect card payments
    Additional payment methods
    Accept offline payments
    Mail order and telephone order payments
    Regional considerations
    During checkout
    Collect tips
      Collect on-receipt tips
      Collect on-reader tips
    Collect and save payment details for future use
    Flexible authorizations
    After checkout
    Refund transactions
    Provide receipts
    Customize checkout
    Cart display
    Collect on-screen inputs
    Collect swiped data
    Collect tapped data for NFC instruments
    Apps on devices
    Manage readers
    Order, return, replace readers
    Register readers
    Manage locations and zones
    Configure readers
    Encryption
    References
    API references
    Mobile readers
    Smart readers
    SDK migration guide
    Deployment checklist
    Stripe Terminal reader product sheets
Other Stripe products
Financial Connections
Crypto
Climate
HomePaymentsTerminal

Collect tips

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

Copy page

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.

On-receipt versus on-reader tipping

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

On-reader tippingOn-receipt tipping

Country

BBPOS WisePad 3:

Available in:

Stripe Reader S700 and BBPOS WisePOS E:

Available in:

Reader

BBPOS WisePad 3

BBPOS WisePOS E

Stripe Reader S700

Any

Integrations/SDKs

BBPOS WisePad 3:

  • Android SDK
  • iOS SDK
  • React Native SDK

BBPOS WisePOS E and Stripe Reader S700:

  • All SDKs, server-driven

All SDKs, server-driven

Merchant categoryAnyRestricted
Card brandAnyVisa, Mastercard, American Express, Discover
Tipping limitMaximum charge amount for the total amount inclusive of the tip, which is eight or nine digits depending on the currencyMaximum charge amount for the total amount inclusive of the tip
Customer experienceTips suggested on the readerTips set with custom integration on the point of sale or on a paper receipt
Customer credit card statementShows the payment amount inclusive of the tip, without waiting for settlementShows an initial pending authorization that’s later updated to reflect the initial amount inclusive of the tip

How tips are displayed on-receipt or on-reader

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

Caution

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 tippingOn-receipt tipping
Tips in the API requestThe 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 amountThe 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.
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc