• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”

Object Index

You are viewing an old version of the API
TipSettings

Properties

Name Description
allow_tipping
boolean

Indicates whether tipping is enabled for this checkout. Defaults to false.

separate_tip_screen
boolean

Indicates whether tip options should be presented on their own screen before presenting the signature screen during card payment. Defaults to false.

custom_tip_field
boolean

Indicates whether custom tip amounts are allowed during the checkout flow. Defaults to false.

tip_percentages
integer [ ]

A list of tip percentages that should be presented during the checkout flow. Specified as up to 3 non-negative integers from 0 to 100 (inclusive). Defaults to [15, 20, 25]

smart_tipping
boolean

Enables the "Smart Tip Amounts" behavior described in https://squareup.com/help/us/en/article/5069-accept-tips-with-the-square-app. Exact tipping options depend on the region the Square seller is active in.

In the United States and Canada, tipping options will be presented in whole dollar amounts for payments under 10 USD/CAD respectively.

If set to true, the tip_percentages settings is ignored. Defaults to false.

Share Feedback

Thanks for visiting the Square API documentation. What's on your mind?