8 views Updated 11 days ago

Apply and Remove Promo Codes in POS

How promotion codes apply to POS carts, how discounts affect taxes and totals, and how to troubleshoot promo errors.

Before applying a code

Add the relevant cart items first. Topo validates a promotion code against the current cart, attached member, and POS sale context. A code that works for one product, plan, or member may not apply to another cart.

Annotated POS promo code field and validation error

Apply a promo code

  1. Add items to the cart.

  2. Enter the promotion code in the Promo code field.

  3. Select Apply.

  4. Review the promo line, discount amount, tax, and total before charging.

Remove a promo code

When a promotion has been applied, the cart shows a promo line with a Remove action. Select Remove to delete that promotion from the cart and recalculate discounts, tax, and total.

Annotated POS cart showing cart totals and checkout controls

How Topo calculates POS promotions

  • A promo must be active and valid for the current time.

  • A promo must apply to at least one sellable line in the cart.

  • Bundles are excluded from additional POS promotion allocation because bundle pricing already includes its package discount logic.

  • Non-combinable promotions are exclusive. Combinable promotions may stack when all existing promotions allow it.

  • Automatic promotions are re-derived after cart changes. Manually entered code promotions remain unless they stop being valid or applicable.

  • Tax is recomputed on the post-discount line amount.

Common promo errors

  • Enter a promotion code: the field was blank.

  • No active promotion matches the code: the code is wrong, inactive, or not available as an active POS code.

  • That promotion is expired or not yet active: check the promotion start and end dates.

  • That promotion doesn't apply to anything in this cart: add an eligible item or use a different code.

  • This cart already has a promo that can't be combined: remove the current promo or use a combinable code.

  • That promotion has reached its usage limit: the cap has already been used.

Sign in

Enter your email and we'll send you a one-time sign-in link.

New to Topo Demo? Create an account