> 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: Tip Settings

# Type: Tip Settings Object

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

## Description: Tip settings define how tips are calculated and distributed among staff. When
Wix Tips is installed, default settings are automatically created. You can't
delete these default settings but you can update them. Creating additional
settings allows Wix users to customize tip screens for different payment
terminals or set specific presets for various products or services.

## Schema:

```json
 Type: Tip Settings Object | type: TipSettings
 Description: Tip settings define how tips are calculated and distributed among staff. When
Wix Tips is installed, default settings are automatically created. You can't
delete these default settings but you can update them. Creating additional
settings allows Wix users to customize tip screens for different payment
terminals or set specific presets for various products or services.
       - name: id  | type: string | description: ID of the tip settings.
           - name: value  | type: string | description: 
       - name: tipType  | type: string | description: Tip type.
           enum: UNKNOWN_TIP_TYPE, PERCENTAGE, AMOUNT
       - name: presets  | type: Array<Preset> | description: Information about the tip choices that Wix Tips displays to customers during the eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction.md)).  Min: `1` preset Max: `3` presets
           - name: value  | type: FloatValue | description: Value of the preset tip choice that's displayed to customers in the eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction.md)). For example, `5`, `10`, and `15` percent or `1`, `3`, and `5` USD.  Min: `0`
               - name: value  | type: float | description: 
           - name: default  | type: boolean | description: Whether this tip choice value is the default preset that's highlighted automatically in the eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction.md)).  Default: `false`
               - name: value  | type: boolean | description: 
       - name: allowCustomerTip  | type: boolean | description: Whether customers are allowed to tip during the eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/introduction.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction.md)).  Default: `true`
       - name: allowBusinessTipAtPayment  | type: boolean | description: Whether the Wix users are given the option to add a tip during the payment collection flow in their dashboard.  Default: `true`
       - name: allowCustomAmount  | type: boolean | description: Whether customers can enter a custom tip amount. If set to `false`, customers can only select a tip value from the available `presets` and can't enter a custom amount.  Default: `true`
       - name: allowEditDistribution  | type: boolean | description: Whether Wix users are allowed to edit tip distributions. If set to `false`, Wix users can't edit distributions after they were created.  Default: `true`
       - name: staffDistributionMethod  | type: string | description: How the tip is distributed among staff.  Supported values: `UNKNOWN_SPLIT_METHOD`: There is no information about the staff distribution method. `EQUAL`: The tip is distributed equally among all staff. `PROPORTIONAL`: The tip is distributed proportionally among staff.
           enum: UNKNOWN_SPLIT_METHOD, EQUAL, PROPORTIONAL
       - name: revision  | type: string | description: Revision number, which increments by 1 each time `tipSettings` object is updated. To prevent conflicting changes, the current revision must be passed when updating `tipSettings`. Ignored when creating a `tipSettings` object.
           - name: value  | type: string | description: 
       - name: createdDate  | type: string | description: Date and time the tip settings were created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: updatedDate  | type: string | description: Date and time the tip settings were last updated in `YYYY-MM-DDThh:mm:ss.sssZ` format.
       - name: default  | type: boolean | description: Whether these are the default tip settings.  Wix Tips automatically creates the default settings during the app's installation. You can't delete these default settings but you can update them. Wix Tips uses the default settings to calculate tips, unless you specify other settings.
       - name: appId  | type: string | description: ID of the app that has created the settings. See the list of app IDs for Wix business solutions ([SDK](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/apps-created-by-wix.md) | [REST](https://dev.wix.com/docs/rest/articles/getting-started/apps-created-by-wix.md)).
       - name: extendedFields  | type: ExtendedFields | description: Custom field data for the `tipSettings` object. Extended fields must be configured in the app dashboard before they can be accessed with API calls.
           - name: namespaces  | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured.  You can only access fields for which you have the appropriate permissions.  Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md).

```