Clarify Campaigns coupon offer eligibility

Author: next-devin

content/docs/apps/campaigns-app/campaigns-offers-and-discounts.mdx

@@ -10,6 +10,14 @@ _Product + Quantity + Price + (optionally a Subscription schedule and recurring
 
 Campaigns App **Offers & Discounts** opens up the possibility of selling at multiple price points on your checkout, without the need for creating individual Packages for each variation.
 
+## Packages, Offers, and Coupon Codes
+
+In Campaign Cart SDK 0.4.x checkout flows, the **Offer** is the source of truth for which Packages or items qualify for a discount. A coupon code does not need to be hand-wired to a specific bundle card in the checkout template. The coupon code activates one or more Offers, and each Offer's conditions and incentive define which cart items receive the discount.
+
+For example, if an exit intent popup or promo code field applies a code for an extra discount, configure the Offer to target the eligible Package quantity, Product Range, or shipping incentive. The checkout should then apply the coupon code and let Campaigns API cart calculation return the discounted package prices, shipping price, and order summary totals.
+
+Use checkout template state, such as whether a coupon code is currently applied, only for presentation: success messages, badges, or conditional copy. Do not use it to decide which bundle price should be shown. Bundle picker pricing should follow the calculated Offer result.
+
 ### Set up Offers
 
 From the Campaigns App main list view, click on your campaign name, or choose "View".
@@ -40,4 +48,4 @@ Define the discount to be applied when the offer conditions are met
   * Apply a percentage off the shipping price
   * Apply a percentage off the entire order
 * Discount Amount (Percentage)
-* **Discount Price Rounding** - set a custom rouding rule to force discounted prices to round to a desired value
+* **Discount Price Rounding** - set a custom rouding rule to force discounted prices to round to a desired value

content/docs/features/offers/coupons.mdx

@@ -10,6 +10,10 @@ It's useful to think of Coupon Codes as containers for [**Offers**](/docs/featur
 
 </Callout>
 
+A Coupon Code is the activation surface for the discount.  The Offers attached to that Coupon define the actual rules: which products, Packages, quantities, or shipping charges qualify, what incentive applies, and whether the Offer can combine with other Offers.
+
+In Campaigns checkout flows, this distinction is important.  A promo code field, shareable coupon link, exit intent popup, or other checkout control may apply the same Coupon Code, but the Package or bundle correlation should still be defined by the Offer conditions and incentive.  The checkout should apply the code and render the calculated cart result, rather than hard-coding "this coupon means this bundle card has this price."
+
 View and track the usage of Coupons via the [**Orders by Coupon**](/docs/analytics/orders-reports#orders-by-coupon) report.
 
 ### View Coupons
@@ -40,4 +44,6 @@ Optionally define **Start** and **End** **Dates** if you want to restrict the us
 
 Finally, choose which Offers should apply when this coupon code is entered.
 
-Use this setting to attach Offer(s) to the coupon code.  Offers should be non-exclusive, and set up to work in [**combination**](/docs/features/offers/create-and-manage-offers#create-and-manage-offers) with each other if you wish to apply multiple offers to a single coupon code.  For coupon codes with Exclusive Offers attached, the highest priority offer will take precedence.
+Use this setting to attach Offer(s) to the coupon code.  Offers should be non-exclusive, and set up to work in [**combination**](/docs/features/offers/create-and-manage-offers#create-and-manage-offers) with each other if you wish to apply multiple offers to a single coupon code.  For coupon codes with Exclusive Offers attached, the highest priority offer will take precedence.
+
+When attaching Offers to a Coupon, verify that each Offer's Condition targets the intended eligible items or Product Range.  This is what lets Campaigns API calculate the correct package prices, discounts, shipping adjustments, and order totals when the code is applied.

content/docs/features/offers/create-and-manage-offers.mdx

@@ -19,6 +19,8 @@ On the **General** card, configure the following parameters
 
 Next, set up the **Condition** under which your Offer will apply to the customer's cart.  The Condition lays out the requirements for the customer (for example certain products, or a number of products being added to the cart) to qualify for the Offer incentive.
 
+The Condition is also where you define the relationship between a coupon-driven promotion and the items it should affect.  If a coupon code should discount only certain products, Packages, or bundle quantities in a Campaigns checkout, configure that eligibility here instead of relying on custom checkout code to map a coupon code to a specific bundle card.
+
 Specify the **Condition** **Type** from the list of options:
 
 * Quantity greater than or equal to
@@ -39,6 +41,8 @@ Choose a specific [**Product Range**](/docs/features/offers/product-ranges), fro
 
 Define the incentive (discount) the customer will receive for applying the offer.  For example, you may choose to give the customer a discount off the total value of their cart, off a certain number of items in their cart, or off the shipping cost of their order.
 
+The Incentive defines what changes once the Condition is met.  This may be a product discount, a fixed bundle price, free or discounted shipping, or another supported discount strategy.  For Campaigns checkouts using the Campaign Cart SDK, bundle pickers and order summaries should render the calculated result returned by the cart, not duplicate the Offer logic in frontend code.
+
 Specify the **Discount** **Type** to define the customer incentive from the list of options:
 
 * Discount is a percentage off of the product's value
@@ -75,4 +79,4 @@ The final step in setting up an Offer is to define Restrictions.  These limit th
 * **Max User Applications** - The number of times a single user can use this offer
 * **Max Global Applications** - The number of times this offer can be used store-wide before it is made unavailable
 
-Leave these values blank if you do not want to set limits on the offer's usage.
+Leave these values blank if you do not want to set limits on the offer's usage.