Object Index

You are viewing an old version of the API

2021-03-17

Version 2021-03-17

• All Versions

TipSettings

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

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

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

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, and 25.

Enables the "Smart Tip Amounts" behavior. Exact tipping options depend on the region in which the Square seller is active.

In the United States and Canada, tipping options are 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.

To learn more about smart tipping, see Accept Tips with the Square App.