CouponCraft – Advanced Coupon Control Suite for WooCommerce
WooCommerce’s coupon engine is powerful — but blunt. Every coupon uses the same notice system, the same “Coupon” label, and the same URL format. Merchants running affiliate programs, B2B pricing, membership sites, or loyalty campaigns hit a wall: there’s no way to control how discounts look, feel, or behave without expensive plugins that still don’t solve the UX layer.
CouponCraft is that missing layer. It gives you per-coupon behavioral controls that sit between WooCommerce’s discount logic and the experience your customers actually see.
What CouponCraft solves
The coupon code is exposed in the URL
Affiliate links that look like
yourstore.com/?coupon=SAVE20 are shareable, scrapable, and trackable by anyone. CouponCraft replaces the real code with a secure HMAC-SHA256 token alias — ?ref=X7kMp2 — that maps to your coupon server-side. The actual coupon code never appears in the browser, in the page source, or in referral logs.“Coupon” can’t be renamed
Your B2B store shouldn’t say “Coupon” — it should say “Trade Discount.” Your membership site should say “Member Reward.” Your loyalty program should say “Referral Credit.” CouponCraft lets you rename the word “Coupon” globally across your entire store, or set a unique display name per coupon. The new label appears everywhere: the cart, the checkout field, the order confirmation email, and the admin order view.
Every coupon looks the same
Some discounts should be invisible — silently applied without a green notice in the cart. Some should show as a reduced product price rather than a separate coupon row. Some should hide the code entirely after it’s applied. CouponCraft gives you four per-coupon visibility controls to make each discount behave exactly the way your promotion strategy requires.
No way to restrict a coupon to a geographic area
Running a local pickup promotion? A regional distributor deal? CouponCraft lets you restrict any coupon to a specific country, state, city, or postal code range — with a custom error message per coupon when the address doesn’t match.
Cashback rewards need a separate expensive plugin
CouponCraft’s cashback engine lets you issue store credit equal to a percentage of the order value — automatically on order completion. Set up tiers: spend $100 and get 5% back, spend $200 and get 10% back. Set an expiry date on the issued credit. No third-party cashback plugin required.
Currency switchers inflate discount values
When a customer switches to a foreign currency, WooCommerce calculates coupons against the displayed amount — not the base currency. A $10 coupon becomes worth $12 or $15 depending on the exchange rate. CouponCraft anchors all coupon and points calculations to your defined base currency, regardless of what currency the customer is viewing.
Features
URL-Only Coupon Application
- Per-coupon toggle: block manual entry and apply via URL only
- Token obfuscation:
?ref=ABC123maps to the actual coupon code server-side — the real code is never exposed - Token security: HMAC-SHA256 signing, single-use enforcement, expiry control, and rate limiting
- Admin whitelist: define which pages trigger URL coupon application
- Works with WooCommerce block checkout (Gutenberg) and classic checkout
Custom Coupon Label Rename
- Global setting: rename “Coupon” to any word across your entire store
- Per-coupon override: give each coupon its own display name (“Spring Member Offer,” “Trade Discount,” “Referral Credit”)
- Applied everywhere: cart, checkout field, order summary, confirmation email, admin order view
- Translation-ready: WPML and Polylang compatible
Per-Coupon Visibility Controls
- Hide notice: coupon applies silently — no green discount row shown in cart
- Inline mode: discount shows as a reduced product line price instead of a separate coupon row
- Code mask: cart shows
****instead of the coupon code after application - Email toggle: control whether the coupon line appears in order confirmation emails
Address-Restricted Coupons
- Restrict validity to specific countries, states, cities, or ZIP/postal code ranges
- Real-time validation at checkout with a per-coupon custom error message
- Works for both billing and shipping address
- Ideal for local pickup deals, regional distributor pricing, and city-specific promotions
Cashback & Dynamic Reward Rules
- Issue store credit equal to a percentage of order value on completion
- Tiered rules: define spend thresholds with different cashback percentages
- Set expiry dates on issued store credit
- Integrates with WooCommerce Points & Rewards and Smart Coupons
- Respects WooCommerce “individual use only” flag — no stacking abuse
Currency-Aware Coupon & Points Calculation
- Anchors all discount and points math to your defined base currency
- Prevents discount inflation when currency switchers are active
- Supported switchers: CURCY, WooCommerce Multilingual (WPML Currency), WP Wham Currency Switcher
Coupon Recipient Message
- Add a sender name and personalized message that displays in the cart
- Example: “This 20% discount was sent to you by Sarah — Happy Birthday!”
- Shown in cart, checkout, and optionally in the order confirmation email
Who is CouponCraft for?
Compatibility
- WordPress: 6.5+
- WooCommerce: 8.0+
- PHP: 8.1+
- Block Checkout: Fully compatible (Gutenberg Cart and Checkout blocks)
- HPOS: Fully compatible (High-Performance Order Storage)
- WooCommerce Points & Rewards: Integrated
- WooCommerce Smart Coupons: Compatible
- Advanced Coupons for WooCommerce: Non-conflicting
- CURCY Multi Currency: Base currency override supported
- WooCommerce Multilingual (WPML): Currency and translation supported
Developer-Friendly
CouponCraft is built to extend. Every core behavior is filterable:
couponcraft_coupon_label— filter the final resolved coupon label stringcouponcraft_token_ttl— filter token time-to-live in secondscouponcraft_url_param— filter the URL query parameter keycouponcraft_inline_mode_items— filter which cart items are eligible for inline discount distribution
Frequently Asked Questions
Does this work with the WooCommerce block checkout?
Yes. CouponCraft is fully compatible with the Gutenberg Cart and Checkout blocks. URL coupon application, label rename, and all visibility controls work in both classic and block checkout.
Will this conflict with Advanced Coupons for WooCommerce?
No. CouponCraft is designed to complement Advanced Coupons, not replace it. Advanced Coupons handles coupon conditions and scheduling; CouponCraft handles the UX and display layer. Both can be active simultaneously.
Is the actual coupon code ever visible in the URL or page source?
Never. When token obfuscation is enabled, the URL contains only a token alias (e.g.,
?ref=X7kMp2). The token is resolved server-side via HMAC-SHA256 verification. The real coupon code never appears in the browser, in the page source, in browser history, or in server logs.Can a URL token be used more than once?
No. Each token is single-use by default. Once a token resolves successfully and applies a coupon, it is marked as used in the database and cannot be reused. This prevents sharing and abuse.
What happens if I rename “Coupon” globally — does it affect all existing coupons?
Yes. The global label setting applies to all coupons store-wide. You can override it per coupon using the Custom Display Name field in the CouponCraft Settings meta box on each coupon edit screen.
Does cashback work with order refunds?
Cashback is issued only on “completed” orders. If an order is refunded after completion, the issued store credit is not automatically revoked — you can manage this manually through the WooCommerce store credit system.
Is CouponCraft compatible with HPOS (High-Performance Order Storage)?
Yes. CouponCraft declares HPOS compatibility and uses WooCommerce’s order abstraction layer throughout. It does not query the
wp_posts table directly for order data.v1.0.0NewApril 29, 2026
- URL-Only Coupons & Token Obfuscation
- URL-only coupon mode — restrict coupons to URL-only application
- HMAC-SHA256 token generation with per-token usage limits and expiry
- Token management UI with generate, copy, revoke, and revoke-all actions
- Guest support — URL coupons work for guests with empty carts via session persistence
- Configurable URL parameter name and success message
- Error messages sanitized to never leak coupon codes
- Block checkout Store API manual entry blocking
- Label Renaming
- Global label replacement for coupon field, apply button, and discount line
- Per-coupon custom labels override global settings
- Classic cart/checkout support via gettext and WooCommerce filters
- Block cart/checkout support via wp.i18n.setLocaleData() translation overrides
- Success/error notice text customization
- Visibility Controls
- Hide coupon input field from cart and/or checkout
- Hide discount line from cart/checkout totals
- Mask coupon code display (show as ********)
- Hide coupon details from order confirmation emails
- Inline strikethrough pricing on product line items
- Block cart/checkout support via registerCheckoutFilters and Store API extension
- Address Restrictions
- Restrict coupons by country, state/region, city, or ZIP/postal code
- ZIP pattern support: exact match, ranges (10000-19999), wildcards (SW1*)
- Validate against billing, shipping, or either address
- Custom error messages per coupon
- Global default address type and error message settings
- Cashback / Store Credits
- Issue store credits after order completion
- Flat percentage or tiered cashback by order total
- Native WooCommerce coupon credits with configurable prefix and expiry
- Integration support for Smart Coupons and Points & Rewards
- Cashback info displayed in order admin, emails, and PDF invoices
- Idempotent processing — no duplicate credits on status changes
- Multi-Currency Support
- Auto-detects CURCY, WPML, and WP Wham currency switchers
- Converts fixed coupon amounts and spend thresholds to active currency
- Percentage discounts remain unconverted (correct behavior)
- Configurable base currency override
- Auto-Apply Coupons
- Automatically apply coupons when cart conditions are met
- Conditions: minimum cart total, minimum item count, user roles (including guest)
- Auto-remove when conditions are no longer met
- Silent application — no "coupon applied" notice for auto-applied coupons
- No coupon limit — evaluates all qualifying auto-apply coupons
- BOGO Deals (Buy X Get Y)
- Buy X Get Y deals with free, percentage, or fixed discount types
- Same product mode (cheapest qualifying item) or cheapest-in-cart mode
- Repeat mode — Buy 2 Get 1 scales to Buy 4 Get 2, etc.
- Uses WooCommerce native product restrictions for qualifying items
- Custom cart label showing deal summary
- Guest Abuse Prevention
- Track coupon usage by IP address and email for guest customers
- Per-coupon limits for IP and email usage
- Global default IP limit setting
- IP addresses hashed with wp_hash() for GDPR compliance
- Purge usage logs from settings page
- Analytics Dashboard
- Coupon performance dashboard under WooCommerce menu
- Stat cards: total discounts, orders with coupons, average discount, revenue
- Top 10 coupons by usage count
- Source breakdown: URL vs. manual vs. auto-apply
- Date range filtering with REST API endpoint
- Usage logging with order and source tracking
- PDF Invoice Integration
- Compatible with WooCommerce PDF Invoices & Packing Slips (WP Overnight)
- Custom coupon labels in PDF invoices
- Hidden coupons excluded from PDF output
- Masked coupon codes in PDF invoices
- Cashback info and recipient messages rendered in invoices
- Admin Experience
- Tabbed coupon meta box with 6 sections and dashicons
- Conditional field visibility — sub-fields disabled when feature is off
- WooCommerce settings tab with 8 sections
- General tab dashboard with plugin status and quick stats
- HPOS-compatible order view with source badges and cashback panel
- Token table with status badges, usage tracking, and bulk actions
- Developer / Technical
- PSR-4 autoloading via Composer
- Singleton dependency container with proper service wiring
- 3 custom database tables with dbDelta upgrades
- WP-Cron job for expired token cleanup
- Store API extension for block cart/checkout data
- REST API endpoints for token management and analytics
- Complete PHPDoc on all classes and methods
- PHPUnit test suite (77 tests, 116 assertions)
- Clean uninstall — drops tables, deletes options, removes meta
- HPOS and block checkout compatibility declarations
Only logged in customers who have purchased this product may leave a review.
Reviews
There are no reviews yet.