--- title: "Troubleshoot discount code redemption errors" slug: "troubleshoot-pos-discount-code-redemption-errors" description: "Find where a discount code error shows at POS or online, what it means and the setting to change so the code applies again." tags: ["Fix"] updated: 2026-11-19T19:34:26Z published: 2026-11-19T19:34:26Z canonical: "mysupport.roller.software/troubleshoot-pos-discount-code-redemption-errors" --- > ## Documentation Index > Fetch the complete documentation index at: https://mysupport.roller.software/llms.txt > Use this file to discover all available pages before exploring further. # Troubleshoot discount code redemption errors When a discount code won't apply at POS, a message usually tells you why. Find what you're seeing below to learn which setting caused it and what to change. Once it's fixed, guests get the price your promotion offers, whether they book at POS, online or at a self-serve kiosk. ![The POS Discounts panel with a selected code and the message "Discount is not valid for this transaction", which matches a heading in this guide](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/image(276).png) > [!NOTE] > The [permission](/v1/docs/permissions-by-feature-and-role) required to check a discount's settings is **Can view discounts**. To change them, staff need **Can access discount code settings**. The administrator and manager roles have both permissions enabled by default. ## Find where the message shows At POS, the message names the problem. Online, guests see the same general message whatever went wrong, and you find the cause in the discount's settings. | Where | What you see | What to do | | --- | --- | --- | | POS, as you type a code | The code doesn't show under **Codes**, and there's no message | See **Fix a code POS or online checkout won't accept** in this guide | | POS, when you select **Apply** | A banner at the top of the **Discounts** panel names the problem | Find that message in this guide | | POS cart | The same banner at the top of the cart, when a code stops fitting after the cart changes | Find that message in this guide | | POS cart, after you redeem a member | A banner or pop-up gives a reason from the membership (eg Membership is expired, no longer valid for discounts) | See the guide [Redeem memberships at POS](/v1/docs/redeem-memberships-at-pos) | | Online checkout | Guests see "Please enter valid discount code" under the code field | See **Please enter valid discount code** in this guide | ## Check what POS needs before it applies a discount Start here when the **Discount** button is missing or POS stops you before it checks the code. You fix each one on the POS device or in the sale, without opening the discount in Venue Manager. If there's no **Discount** button in the cart, or it won't open, check these: - **The POS device allows discounts.** In POS, go to **More** > **Settings** > **Device**. Under **Tender & payment**, turn on **Enable discounts**, then select **Save settings**. - **There's something to discount.** The button is grayed out until there's an item in the cart. A booking that's paid in full has no discount option. Add an item, or refund the payment first. When you select **Apply** in the **Discounts** panel, POS can also show these: **Booking total is already zero** There's nothing left to discount (eg another discount already covers the full price). **Percentage and 2-for-1 discounts cannot be applied to products with recurring billing** The cart has a membership with recurring billing. At POS, you can't apply a percentage discount to it. Use a fixed amount discount instead, or one set up for recurring memberships. **POS asks for a manager PIN** The discount has **Require a Manager PIN to use this code at POS** turned on, under **Availability** > **Sales channels** in its settings. A manager with the **Can approve discount codes in POS** or **Manager PIN Override** [permission](/v1/docs/permissions-by-feature-and-role) enters their PIN to apply it. ## Find the discount in Venue Manager Every fix from here on starts in the discount's settings. 1. From Venue Manager, go to **Products** > **Discount codes** > **All codes**. 2. In **Search all items**, enter the code the guest used. 3. Select the discount to open its settings. The list shows active discounts only. If the code isn't there, select the **Status** filter at the top of the list, then select **Archived** and **Expired**. For a discount with more than 100 codes (eg codes you uploaded), search by the discount's name instead. ![The All codes list with Archived and Expired selected in the Status filter, showing discounts the default view hides](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/image(278).png) > [!NOTE] > To learn more about setting up discounts, see the guide [Get started with discount codes](/v1/docs/get-started-with-discount-codes). ## Fix a code POS or online checkout won’t accept If you enter a code and it doesn’t show, or a guest says their code won’t work online, it’s usually a typo or one of the discount code’s settings. Use the checks below to find which one. **The code doesn’t show at POS** As you type a code in the **Discounts** panel, POS lists it under **Codes**. Select the code, then select **Apply**. If the code doesn't show, you can't select **Apply**. POS only lists a code when all of these are true: - **The code is spelled right.** Capitals don't matter, but check for typos (eg the letter O typed as a zero). - **The discount is active.** Look for it in **Venue Manager** > **Products** > **Discount codes** > **All codes** with **Archived** and **Expired** added to the **Status** filter (see **Find the discount in Venue Manager** in this guide). - If it shows as **Archived**, select its **options menu** (3 dots), then select **Unarchive**. - If it shows as **Expired**, open the discount code, set a later end date under **Availability** > **Discount usage** and select **Save**. - **The discount can be used at POS.** In the discount's settings, check **Availability** > **Sales channels**. **Point of Sale** must be selected. - **The code isn't already applied to the booking.** To let staff add the same code more than once, turn on **Allow multiple uses of a code in the same booking** in its discount settings in Venue Manager. It's available with the **Per code** limit. A code issued to a guest from an earlier purchase applies as soon as POS finds it. You don't need to select **Apply** again. **Please enter valid discount code** Guests see this in online checkout for any code that won't apply, so it doesn't tell you the reason. Check these first. They're the most common causes online: - **The code is spelled right and the discount is active.** Look for it with **Archived** and **Expired** added to the **Status** filter. - **The discount can be used online.** Under **Availability** > **Sales channels**, **Checkout & API** must be selected. - **Discount usage has started.** Under **Availability** > **Discount usage**, the start date must be today or earlier, even when the visit is later. If those look right, check the other settings, such as **Visit dates** and **Products**. ## Check a code's channel, date and guest settings These messages may show in the **Discounts** panel at POS when you select **Apply**. Each one points to a channel, date or guest setting in the discount. You set the channel and dates under **Availability** in the discount’s settings. Guest segments are under **Additional options.** **Discount location '[channel]' is not valid** The discount isn’t set up for POS. For a sale at POS, the message reads Discount location ‘POS’ is not valid. For a booking made somewhere else (eg online), it names that channel instead. To use the code at POS, select Point of Sale under Availability > Sales channels in the discount’s settings. **Discount is not valid at this time** Today falls outside the dates the code can be used. In the discount’s settings, check **Availability** > **Discount usage**. With **Ongoing**, the start date must be today or earlier. With **Date range**, today must fall inside one of the ranges. At POS, you'll see this when the start date is still to come or today falls between date ranges. Once the last end date passes, ROLLER marks the discount **Expired** within the hour and the code stops showing at POS. **Booking dates are not valid for this discount** The visit date in the booking falls outside the dates the discount allows. In the discount, check **Availability** > **Visit dates**. Check the start date too. A code whose visit dates start next month won't apply to a booking for this weekend. **Session times are not valid for this discount** The session in the cart falls outside the times the discount allows. In the discount’s settings, check the times set for each day under **Availability** > **Visit dates** (**Available times by day**). These times apply to sessions only. For example, a code set to 6 PM and 7 PM sessions won't apply to an 11 AM session. **This discount is restricted to specific guest segments** The code only works for guests in the segments chosen under **Additional options** > **Limit to specific guest segments** in the discount. Add the guest to the booking before you apply the code. Without a booking holder, ROLLER can't check which segment they're in. ## Check which items a code covers These messages mean the items in the cart aren't ones the discount covers, or the code is already on the booking. **Discount is not valid for this transaction** The discount applies to selected products only, and none of them are in the cart. For example, the code covers a 120-minute pass and the cart holds a 60-minute one. In the discount's settings, check which products are selected under **Products**. **Buy [X] get [Y] requires [N] items** A **Buy & Get** discount needs enough qualifying items in the cart (eg Buy 2 get 1 requires 3 items). Add the items the guest is buying, then apply the code again. **Cannot apply discount codes to Gift Cards** This message shows when everything in the cart is a gift card. A discount set to **All products** doesn't cover gift cards. To discount gift cards, choose **Gift cards** under **Products** in the discount’s settings. Discount codes can't be applied to wallets or cashless cards at all. For a cart of those, you'll see "Cannot apply discount codes to wallets" or "Cannot apply discount codes to cashless cards". ![The Products setting in a discount with Gift cards chosen, which lets the code apply to gift card sales](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/image(280).png) **Discount code already applied** Guests see this online when they enter a code that's already in their cart. At POS, a code that's already applied to the booking doesn't show when you type it again. To let guests use one code more than once in a booking, turn on **Allow multiple uses of a code in the same booking**. It's available with the **Per code** limit. ## Check a code's usage limits These messages mean the code has been used as many times as its limit allows. Each one matches a setting under **Additional options** > **Limit discount uses** in the discount. To see where the code was used, see **Check how many times a code has been used** in this guide. **Discount code limit has been reached** The code has reached its **Per code** limit (eg 100 uses in total), or **Codes can only be used once** is turned on and it's been used. To let more guests use it, raise the number of uses. **Discount already used on [date]** The code has reached its **Per code per day** limit for the visit date in the message (eg Discount already used on 2026-11-21). The date is the booking's visit date, not today's date. **Guest has already claimed this discount** The booking holder has already used the code as many times as the **Per guest** limit allows. **Discount already used on products** The code has reached its **For each selected product** limit for every product in the cart it covers. The message lists product IDs, not product names (eg Discount already used on products 1234,5678). **Discount already used across bookings** The code has reached its **Across selected products** limit. With this setting, every item bought counts as one use. For example, three session tickets in one booking use three of five uses. ## Check how many times a code has been used The usage report shows each booking the code was used on. Use it to confirm a limit message and see when and where the code was used. 1. From Venue Manager, go to **Products** > **Discount codes** > **All codes**. 2. Select the **options menu** (3 dots) for the discount, then select **View uses**. 3. Set the date range to cover when the code could have been used (eg the last 12 months), then select **Apply filters**. The **Discounts by Booking** report opens with that discount selected. Each row shows the **Redemption Date**, **Booking Id**, **Product Name** and **Channel**. The **Redemptions** column shows uses against the limit. For example, 1 / 1 means the code has been used once out of one allowed use. It shows N/A for limits counted per day, per guest or per product. ## FAQs **The dates look right but the code still won't apply. Which date setting controls what?** **Discount usage** is when the code can be applied (the day of the sale). **Visit dates** is when the guest can visit with it. If guests book ahead, **Discount usage** must already have started when they book. For example, for a July holiday offer that guests can book from 1 June, set **Discount usage** from 1 June to 14 July and **Visit dates** from 1 July to 14 July. **I fixed a setting and now see a different message. Why?** ROLLER shows the first problem it finds with a code. Once that's fixed, the next one shows. Find the new message in this guide and check that setting too. **Can staff pick a code without typing it?** Yes. Open the discount in Venue Manager and select **Favorite**. It's then listed under **Codes** in the **Discounts** panel at POS. For a discount created in HQ, favorite it in HQ. A discount drops off the list when it expires. > [!NOTE] > If the message isn't in this guide, or the settings look right and the code still won't apply, contact your customer success manager or the [support team](/v1/docs/contact-roller-support). ## Related - [Get started with discount codes](/get-started-with-discount-codes.md) - [Sell items, apply discounts and take payment at POS](/sell-items-and-redeem-discounts-and-memberships-at-pos.md) - [How do I set usage limits on a discount code?](/how-do-i-set-usage-limits-on-a-discount-code.md) - [Track discount code usage](/track-discount-code-usage.md) - [Can I apply a discount to one item only at POS?](/can-i-apply-a-discount-to-one-item-only-at-pos.md)