Coupon Client for WHMCS

Auto-apply coupon codes to assigned clients. Keep discounts exclusive with Locked coupons, or allow normal manual use with Unlocked coupons.

What It Does

Links clients to coupon codes. When that client views their cart, the coupon applies automatically.

Use cases:

• VIP client discounts
• Partner pricing
• Corporate contracts
• Loyalty programs

Requirements

• WHMCS 8.9+
• PHP 8.1–8.4 with a compatible ionCube Loader
• License key from ArkHost

Installation

1. Upload modules folder to WHMCS root
2. Setup > Addon Modules
3. Activate "Coupon Client"
4. Enter license key

Database table creates automatically. Hooks load from module directory.

Configuration

Auto-Apply Mode

• Silent: No notification (default)
• Notification: Shows message when applied

Priority Mode

• Client First: Auto-coupon overrides manual entry (default)
• Manual First: Manual entry wins

Locked and Unlocked Coupons

Choose a policy when assigning a coupon, or change it in the association list. The policy belongs to the coupon and applies to every client assigned to it.

• Locked (default): coupons with active assignments can only be redeemed by the actively assigned clients. Guests and other clients cannot use them.
• Unlocked: coupons still auto-apply to assigned clients, while guests and other clients can enter them manually under normal WHMCS promotion rules.
• Existing coupons and assignments remain Locked after updating. Inactive assignments do not grant access to Locked coupons.
• Expiry dates, usage limits, product restrictions and other WHMCS promotion rules remain unchanged.

Policy is separate from priority. In Client First mode, the assigned coupon still overrides another manually entered code; choose Manual First if manual entry should take priority.

Usage

Creating Associations

1. Addons > Coupon Client
2. Search client (name, email, company)
3. Select coupon and its Locked/Unlocked policy
4. Add notes (optional)
5. Click Add

One active coupon per client. Create multiple associations but only activate one.

Managing

Search/Filter:

• By client name, email, or coupon code
• By status (all/active/inactive)
• 25 per page

Actions:

• Activate/Deactivate
• Change the coupon policy for all its assignments
• Delete
• View details

Validation:

• Warns on expired coupons
• Warns on usage limits
• Blocks duplicates
• Prevents multiple active coupons

How It Works

1. Client views cart → hook fires
2. Module checks for active association
3. Validates coupon (expiry, limits)
4. Applies based on priority mode
5. Logs action

Client must be logged in. Anonymous users can't have auto-coupons.

Updating

Back up the module files and database, replace the module directory, then open Addons > Coupon Client to initialize the policy table automatically. Do not deactivate the module or delete assignments. Existing assignments remain Locked.

Database

Module-owned tables: mod_coupon_client and mod_coupon_client_policy.