A coupon code changes an order’s price during the coupon and credit step of checkout. This article explains which codes checkout accepts, why checkout might refuse a code, and how the discount changes based on what the buyer is purchasing.
Entering a Code
A buyer or staff member can enter one or more coupon codes while creating an order. Each accepted code adds its own discount to the order.
Rhythm does not have a setting or eligibility rule that limits an order to exactly one coupon. You can control how many times one code is used overall, per customer, or per organization, but you cannot control how many different codes one order accepts. If you need to allow only one coupon per order, that option is not currently available as configuration and would require a product enhancement.
You can apply a code before payment in both the Console and the Portal. If the order already exists, such as an order created by a billing run, the coupon may not appear automatically. Open the order and apply the coupon retroactively instead. See Apply a Coupon to a Processed Order.
Checkout refuses a code that does not exist and removes it from the order. When checkout refuses a code during preview, the preview explains why. If checkout refuses a code only after you submit the order, processing removes the refused code without adding a message to the order. Order audit history only shows a coupon if it was part of the order when the order was processed. It does not show whether someone entered and then removed a code earlier in checkout.
When checkout accepts a code, it updates the amount due right away and shows a message confirming that the coupon was applied. You do not need to move to a later step to see whether the code worked. If the coupon fully covers the balance, the coupon-applied message does not appear; the balance drops to zero, which confirms that the code worked.
If a discounted transaction needs a coupon and must trigger downstream fulfillment or advancement, such as granting an entitlement or advancing an application, start that transaction from its own application process or create an order directly. A manually created invoice does not go through this coupon and order pipeline.
Why a Code Might Be Refused
Several checks can keep a code from applying:
- Inactive, expired, or outside its own dates. Rhythm checks the code’s own status and dates, which may not match the coupon’s dates. A coupon can be past its expiration and still give a discount through a code that has not expired, so the refusal is about the code you entered, not always the coupon behind it. If a discount does not behave as expected during testing, check whether the code itself is expired or outside its dates before you troubleshoot the discount math. An expired code blocks the whole scenario, not just that code’s use.
- Use limits reached. A code can have a total use limit, a per-customer limit, a per-organization limit, or a combination of those limits. Once a limit is reached, checkout refuses the code. If a code stops working after one redemption, check whether it was set up as single use or with a maximum usage of one. To allow more uses, increase that code’s maximum-usage setting. Combine limits to get the restriction you need: a total-use limit caps overall redemptions, but to guarantee only one use per person or organization, also set the matching per-customer or per-organization limit to 1. A group-registration order still counts as one use of the code, no matter how many registrants it includes, so a per-person limit does not separately limit each registrant in the same order. Voiding an order that used the code frees that use again, and should also reduce the coupon’s own aggregate discount-given total, not just free the use for someone else. In some cases, cancelling the purchase that used the code does the same. See How Cancellation and Return Processing Works for what a cancellation or return does and does not release. Canceling one registrant from a group registration that used a coupon was previously seen to remove that coupon’s usage record in some cases, even though the coupon stayed connected to the order. A fix has since been confirmed: coupon usage now remains visible on both Coupon 360 and the order after one registrant in a group registration is cancelled. If you still see the usage record disappear after a partial cancellation like this, treat it as unexpected and check with Support.
- Eligibility. Rhythm checks a code with eligibility criteria against the contact placing the order, not the organization the order might be billed to. A company cannot use a members-only code just because someone eligible works there, because the eligibility check runs against the party placing the order. Eligibility criteria are based on attributes of that contact or organization, such as membership status, profile fields, and similar details. They are not based on whether the order already has another discount applied, and there is no eligibility criterion for “only if no other coupon has been used on this order.” A code can also be restricted to a specific set of contacts or organizations. If the person placing the order is not in that allowed set, checkout refuses the code even if they otherwise qualify under the coupon’s other criteria. Rhythm does not treat an inactive membership as a non-member for this purpose. A code restricted to members still recognizes someone with an inactive membership as a member. Eligibility criteria include state-based options for members, but there is no general address or state field for non-members or all purchasers. Because of that, you cannot restrict a code by location alone unless the buyer is a member with that state on file. An eligibility rule based on someone’s history with other events can misfire if the current event is included in that history list. Remove the current event from the list if the coupon should still apply to it, and check whether the rule requires meeting all listed criteria or none of them, because that setting changes who qualifies. An eligibility criterion based on event registrations only checks whether a matching registration exists. It cannot count how many related registrations there are, and it cannot require the registration to be in a completed status. The error “Coupon cannot be used for any items in this order” is not always about a fee-to-product mismatch. It can also mean the coupon’s application-type restriction excludes the kind of application being submitted, such as a coupon limited to new applications being used on a renewal, even when the fee itself is listed as eligible.
How the Discount Is Calculated
The discount math depends on what the coupon applies to:
- A discount that applies “per item” applies once per line, not once per unit. If a line has a quantity of three, the line is discounted once, not three times. A percentage-off coupon discounts every eligible item on the order this way, not just one item. If you want to cap a multi-item order at no more than a single item’s worth of discount, set a maximum discount amount on the coupon in addition to any use limits. Use limits control how many orders or customers can use the code, not how many items on one order it discounts.
- A shipping coupon needs an order with a shipping charge. If the order has no shipping charge, the coupon has nothing to discount.
- A coupon that discounts nothing does not make the order fail by itself. The order goes through with the coupon recorded at a zero discount. Other refusal reasons, such as an expired or over-limit code, still block the order regardless of what the coupon would have discounted. To confirm that a coupon changed the price, compare the order total before and after applying it instead of assuming the coupon appearing on the order means the price changed. If a line’s price was manually edited before the coupon was applied, the coupon can appear on the order without taking a discount, even when the coupon is configured correctly. Apply the coupon before editing the line’s price, or reapply it after the edit, to get the expected discount.
- A fixed-amount coupon takes off the same number in the order’s currency. For example, a coupon set to discount 100 removes 100 units of the order’s own currency, not a converted amount from a base currency. If your account sells in more than one currency, keep that in mind when you set a fixed discount amount, because it does not automatically adjust to hold the same value in every currency a shopper might choose.
See How a Coupon Discount Is Calculated and Applied to an Order for how Rhythm caps the discount and where a whole-order discount appears.
Tip
A coupon’s maximum discount limits how much is taken off one order, not a running total across every use of the coupon. A multi-use coupon with an overall use limit can still give its full discount on each qualifying order until that use limit is reached.
A coupon that reduces the balance due to zero has, in some cases, left the order in Open status instead of moving it to Complete. This has happened particularly when the discount is configured to show as its own line item on a membership or certification-application purchase. This has been corrected for membership-package orders in Orders & Inventory. If you still see a zero-balance order stuck as Open elsewhere, contact Support.
Different Math for Different Kinds of Purchases
The discount calculation depends on which kind of purchase the coupon applies to:
- Membership coupons discount membership packages and dues. Rhythm decides whether the order is new or renewing based on the bill-to party’s own membership, not necessarily the person the line is shipped to. Because of that, a renewal coupon can fail to apply when the bill-to party is classed as new, even if the intended recipient is renewing. A membership coupon can also be restricted to specific organizations. If a renewing member’s organization is not on that list, checkout refuses the coupon during renewal even though the renewal logic would otherwise allow it.
- Event coupons discount event registrations, add-ons, sessions, functions, and exhibitor fees. They apply only to the events or event types the coupon lists. Products from other events are not discounted.
- Certification coupons discount certification application, course, and exam fees. A certification coupon can also be limited by application type. One configured for new applications only is refused on a renewal or recertification order, even if the fee itself is listed as eligible, unless the coupon is also configured to allow renewing applications.
- Award coupons discount an award application fee. They apply only to the awards the coupon lists.
If members and non-members need different discount amounts for the same purchase, create a separate coupon for each group. One coupon cannot change its discount based on the buyer’s current membership status at checkout. If a buyer’s status might change between when they receive a code and when they use it, separate codes for each audience are the current option.
A coupon code applies once per order, no matter how many lines or registrants the order includes. Using the same code on a group registration counts as one use of that code, not one use per registrant.
After the Order Is Processed
After an order that used a coupon code finishes processing successfully, Rhythm records that use so future use-limit checks and usage reports include it. Rhythm records the use only when the code actually discounted something on the order.
A code entered on an order with nothing it can discount, such as an event coupon entered on an order with no event product, stays on the order at a zero discount without consuming one of its allowed uses. The same is true whether the order has only ineligible products or mixes an eligible product with others. Rhythm does not count a use for an order that fails to process.
Once a coupon has been applied to a processed order, you cannot remove it from that order. If a coupon was applied by mistake and needs to come off, cancel the order and create a new one without the coupon instead.