Collect Tips

When to use this

Use this article when you need to collect Tips in Topo. The main staff surface is Staff > Commerce > Tipping, POS. It is written for Front Desk, Managers.

What this covers

• POS-09 is the checkout article

• Settings articles should cover enable per location, terminal prompt, POS tip input, maximum order threshold, reporting, and permission requirements

Before you start

• Select one location before opening POS. POS cannot run from All Locations because stock, taxes, tips, and Terminal readers are location-specific.

• Use a staff role that can create sales. Ask an owner or admin if POS is hidden or checkout controls are disabled.

• Confirm Stripe payment readiness before accepting card payments.

• Choose one checkout context: an attached member for member-specific access, account credit, card-on-file payments, or post-sale check-in; Guest checkout for anonymous merchandise sales.

• Review the sale detail if payment is pending, failed, refunded, or disputed before retrying anything.

Steps

1. Confirm tipping is enabled for the selected location.

2. Open POS and build the cart.

3. Choose a preset or custom tip if the tip field is visible.

4. Review the final total before charging.

5. For Terminal payments, confirm whether the reader will prompt the customer.

6. Review sales/tip reporting after the transaction.

What happens after saving or completing this

• The sale record keeps the member or guest context, staff user, selected location, line items, discounts, taxes, tips, credit, and payment status.

• Receipts, refunds, disputes, inventory changes, and access grants depend on the sale status.

• Review the sale detail if payment is pending, failed, refunded, disputed, or if access did not apply as expected.

Common issues and fixes

• Checkout is disabled: confirm selected location, non-empty cart, member or guest checkout, payment readiness, and required payment method.

• An item is missing: check active status, location availability, variant sellability, bundle contents, and inventory tracking.

• A payment or Terminal sale is pending: review the sale record before retrying so you do not double-charge the customer.

Related articles

• Choose Member Checkout or Guest Checkout in POS

• Add Products, Plans, Bundles, and Access Items to the POS Cart

• Apply and Remove Promo Codes in POS