> 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: Tips

# Type: Tip Object

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

## Description: A tip holds information about how much a customer has tipped, how the tip is
distributed among staff, and the associated order’s line item subtotal.

## Schema:

```json
 Type: Tip Object | type: Tip
 Description: A tip holds information about how much a customer has tipped, how the tip is
distributed among staff, and the associated order’s line item subtotal.
       - name: id  | type: string | description: ID of the tip. Identical to the `code` of the related `order.additionalFee`.
           - name: value  | type: string | description: 
       - name: lineItemSubtotal  | type: string | description: Subtotal of all line items from the eCommerce order ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/introduction.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/order-object.md)) that's related to the tip. In the response of Preview Tip, there is no related eCommerce order. Then, value of this field corresponds to the sum of all line item prices passed in the request.
       - name: amount  | type: string | description: Total amount of the tip.  Min: `0.00`
       - name: distributions  | type: Array<TipDistribution> | description: Details about how the tip is shared among staff. Available only if at least one staff member receives part of the tip, and it's not entirely allocated to the business.  Max: 50 distributions
           - name: id  | type: string | description: ID of the tip distribution.
           - name: tipId  | type: string | description: ID of the tip associated with the distribution. Matches the corresponding `order.additionalFee.code`.
           - name: staff  | type: Staff | description: Information about the business staff receiving the tip distribution.
               - name: id  | type: string | description: ID of the staff receiving the tip. Matches `staffMemberId` if available, or `identificationData.wixUserId` if not.
               - name: name  | type: string | description: Staff name. Matches `staffMember.name` if the staff is a Bookings staff member, or the contact's `info.name` if not. See the Bookings Staff Members API and the Contacts API for additional details.  Max: 500 characters
               - name: staffMemberId  | type: string | description: ID of the staff member ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/staff-members/introduction.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members/staff-member-object.md)). Available only if the staff is a staff member and not a [site collaborator](https://support.wix.com/en/article/inviting-people-to-contribute-to-your-site).
               - name: identificationData  | type: IdentificationData | description: Identification data. Available only if the staff is a contact on the Wix site. See the Contacts API for additional details.  Note that not all site collaborators qualify as staff members ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/staff-members/introduction.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members/staff-member-object.md)).
           - name: amount  | type: string | description: Amount of the tip distribution.  Min: `0.00`
           - name: lineItemInfo  | type: Array<LineItemInfo> | description: Details about the related line items from the eCommerce order ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/introduction.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/order-object.md)).  Max: 10 `lineItemInfo` objects
               - name: lineItemId  | type: string | description: IDs of the line items associated with the tip.  Min: 1 character <br/> Max: 100 characters
               - name: catalogReference  | type: CatalogReference | description: Information about the line item and the corresponding catalog. Catalogs include Wix Bookings and Wix Stores.
               - name: price  | type: string | description: Price of the line item.  Min: `0.00`
               - name: name  | type: string | description: Name of the line item, which is identical to: + `product.name` for Stores ([SDK](https://dev.wix.com/docs/sdk/backend-modules/stores/introduction.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/stores/about-wix-stores.md)). + `service.name` for Bookings ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/introduction.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/about-wix-bookings.md)).  Min: 1 character  <br/> Max: 200 characters
               - name: quantity  | type: number | description: Quantity of the line item.  Min: `1` <br/> Max: `100000` (one hundred thousand)
           - name: transaction  | type: Transaction | description: Details of how the customer is charged for the tip. Available only if the transaction ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/order-transactions/setup.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/order-transactions/order-transactions-object.md)) has been created.
               - name: id  | type: string | description: ID of the transaction that's associated with the tip distribution.
               - name: date  | type: string | description: Date and time the transaction was created in `YYYY-MM-DDThh:mm:ss.sssZ` format. Isn't identical to the time the customer was actually charged.
           - name: orderId  | type: string | description: ID of the eCommerce order ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/introduction.md) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/order-object.md)) associated with the tip distribution. Identical for all distributions that belong to the same tip.
           - name: createdDate  | type: string | description: Date and time the distribution was created in `YYYY-MM-DDThh:mm:ss.sssZ` format.
               - name: seconds  | type: string | description: 
               - name: nanos  | type: number | description: 
           - name: source  | type: string | description: Information about who created the tip distributions.
               enum: UNKNOWN_SOURCE, POS, WEB, DASHBOARD
       - name: undistributedAmount  | type: string | description: Undistributed tip amount. Calculated as the difference between `tip.amount` and the sum of all `tip.tipDistributions.amount` values.  Min: `0.01`

```