> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/other-services/tips/tip-settings/introduction.md

## Article Content:

# About the Tips Settings API

The Tips Settings API allows you to manage how Wix Tips calculates
tips and distributes them among staff.

With the Tips Settings API, you can:

- Update a site's default tip settings.
- Manage non-default tips settings.

See also:
+ [Tips API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/other-services/tips/tips/introduction.md)
+ [Tippable Staff API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/other-services/tips/tippable-staff/introduction.md)

## Before you begin

It's important to note the following points before starting to code:

+ Ensure that a site has installed [Wix Tips](https://www.wix.com/app-market/wix-tips). 
  Wix Tips is automatically installed with every
  [Wix Bookings](https://www.wix.com/app-market/bookings) installation.
+ You can't delete the default tip settings that Wix Tips automatically creates
  upon installation, but you can update them.
+ For each `tipSettings` object, you can configure up to 3 preset tip choices
  that Wix Tips displays to customers during the
  [eCommerce checkout](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/checkout/checkout/checkout-object.md).
  Additionally, you can allow customers to manually enter a custom tip amount.

## Sample use cases

- [Create location-specific tip settings](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/other-services/tips/tip-settings/sample-flows.md#create-location-specific-tip-settings).
- [Create payment-terminal-specific tip settings](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/other-services/tips/tip-settings/sample-flows.md#create-payment-terminal-specific-tip-settings).

## Terminology

+ **Tip**: Details the tip amount, how it’s distributed among staff, and the
  associated order’s line item subtotal. Refer to the
  [Tips API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/other-services/tips/tips/introduction.md)
  for more information.
+ **Tip distribution**: How the total tip is allocated among eligible staff.
  You can split tips equally among staff or define proportional shares. The
  business receives the undistributed tip amount.
+ **Tip settings**: Allow you to customize how Wix Tips previews and calculates
  tips based on various factors; including
  [business location](https://dev.wix.com/docs/rest/business-management/locations/introduction.md),
  external payment terminal used for the
  [eCommerce checkout](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/checkout/checkout/introduction.md),
  product or service being purchased or which
  [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site)
  manages the payment process via the site's dashboard.
+ **Staff**: Team members receiving a portion of the tip. Currently, only
  [Bookings staff members](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members/introduction.md)
  and [site collaborators](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site)
  are eligible to receive tip distributions. Refer to the
  [Tippable Staff API](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/other-services/tips/tippable-staff/introduction.md)
  for more information.

@sdk_package_setup