Discounts & Promotions

Pagge includes a complete, high-converting discount and promotions engine designed to boost Average Order Value (AOV), reward loyal customers, and drive urgent sales.

From customizable coupon codes and automated storewide flash sales to tiered volume bundles and advance payment deposits, all features integrate seamlessly across your storefront, product cards, cart drawer, checkout, order receipts, and dashboard analytics.

---

Promotion Types

Pagge supports four distinct promotion types:

Promotion Type	How It Works	Best Used For
Percentage Discount	Deducts a fixed percentage (e.g., 15% off) from the subtotal or selected items.	Seasonal sales, welcome offers, influencer promo codes.
Fixed Amount Discount	Deducts a specific cash amount (e.g., $10 off) from the subtotal.	First-time buyer credits, loyalty rewards.
Free Shipping	Waives shipping charges when qualification rules are met.	Cart threshold incentives (e.g., "Spend $50 for Free Shipping").
Quantity Tier Bundles	Offers increasing discounts based on item quantities (e.g., Buy 2 get 10% off, Buy 3 get 20% off).	Volume wholesale, multi-buy packs, apparel, cosmetics.
Buy X Get Y (BOGO)	Buy a specific quantity of an item and receive additional units free or at a steep discount.	Buy 1 Get 1 Free inventory clearance campaigns.

---

Coupon Codes vs. Automatic Sales

You can configure any promotion to trigger in one of two modes:

1. Coupon Codes

• Customer-Entered: The customer types the code in the discount code input box on the storefront cart drawer or checkout page.
• Usage Controls: Set a maximum total usage limit across the entire store (e.g., first 100 customers) and/or a per-customer limit (e.g., 1 use per customer email/phone).
• Case-Insensitive: Codes are automatically normalized to uppercase (e.g., summer20 and SUMMER20 work identically).

2. Automatic Discounts

• Zero Friction: No code entry required. As soon as the customer adds eligible items or reaches the required threshold, the discount calculates and applies automatically in real time.
• Instant Visual Feedback: The cart drawer and checkout show live savings with original prices crossed out and savings badges highlighted.

---

Quantity Tier Bundles

Tiered volume discounting is one of the most effective strategies to increase basket sizes.

Configuring Bundle Tiers

When creating or editing a discount with the Quantity Bundle type:

1. Specify quantity thresholds (e.g., 2 items, 3 items, 4 items).
2. Choose either Percentage or Fixed Amount discount for each tier.
3. Add a custom storefront promotional badge for each tier (e.g., Most Popular, Best Value - Save 25%).

Storefront Experience

• Interactive Tier Widget: On the product details page, an interactive bundle selector displays each tier with live calculated prices, instant savings badges, and 1-click quantity selection.
• Cart Drawer Sync: As items are added or quantities are updated, the cart drawer highlights the active tier badge and automatically shows the total saved amount.

---

Promotion Rules & Targeting

Control exactly when and where your promotions apply:

• Target Scope:
  • All Products: Applies to your entire store catalog.
  • Specific Products: Select one or more individual products.
  • Specific Collections: Apply discounts exclusively to products in targeted collections (e.g., "Summer Collection" or "Clearance").
• Minimum Requirements:
  • None: Applies to any order with eligible items.
  • Minimum Purchase Amount: Requires cart subtotal to meet a minimum (e.g., $50.00).
  • Minimum Quantity: Requires a minimum number of eligible units in the cart.
• Active Dates & Scheduling:
  • Set optional Start Date and End Date.
  • Scheduled promotions automatically activate and expire at midnight or your chosen timestamp.

---

Promotions & Sale Homepage Section

Highlight active deals directly on your storefront homepage using the Promotions & Sale layout block:

1. Navigate to Dashboard → Stores → Layout.
2. Expand the Promotions & Sale block.
3. Configure the display options:
   • Source: Choose Active Discounts (automatically pulls active sales and bundle cards), Specific Products, or a Selected Collection.
   • Layout Style: Choose between Cards Grid, Compact Strip, or Full-Width Hero Banner.
   • Countdown Timer: Set an expiration date/time to display an urgent live countdown timer (DD : HH : MM : SS).
   • Action Button: Customize the headline, description, button text, and destination link.

---

Advance Payment & Deposit Collection

For sellers offering Cash on Delivery (COD) or Bank Transfer, fraudulent returns and fake orders can cause significant delivery losses. Pagge allows you to enforce an upfront advance deposit on manual payment methods.

How It Works:

1. In store payment settings, configure Advance Payment:
   • Set advance requirement as a percentage (e.g., 20%) or a fixed amount (e.g., $5.00 / PKR 500).
2. At checkout, customers choosing COD or Bank Transfer see a clean financial breakdown:
   • Total Order Amount
   • Advance Payment Required (to confirm the order)
   • Remaining Balance (payable on delivery)
3. For Bank Transfer orders, copyable bank/wallet account numbers (EasyPaisa, JazzCash, SadaPay, NayaPay, PayPal, Wise, etc.) and reference submission fields are presented.
4. Receipts and the seller dashboard cleanly track both the deposit paid and remaining balance collected.

---

Managing Discounts with AI Chatbots & MCP

You can manage all store discounts directly through ChatGPT, Claude, Gemini, or the built-in Pagge AI Assistant via Model Context Protocol (MCP):

• list_discounts: List store promotions with filters (active, automatic, bundle, expired) and stats.
• get_discount: Retrieve full details, bundle configuration, and recent customer usages.
• create_discount: Create coupon codes, automated sales, or bundle offer tiers.
• update_discount: Modify active dates, limits, values, or tier configurations.
• delete_discount: Remove a promotion.

Example AI Prompts:

"Create a 15% coupon code FLASH15 for orders over $50 expiring this Sunday."
"Set up a bundle offer on my Organic Serum: Buy 2 get 10% off, Buy 3 get 20% off with badge 'Best Value'."
"List all active discounts on my store and show total uses."