Offers & Coupons

Last reviewed: 16 November 2026

Overview

An offer reduces what a customer pays. BillHive has two kinds:

  • a Discount, which you apply to an order, and
  • a Coupon, which has a code the customer (or you) enters.

A coupon set is a batch of single-use codes for one coupon, for campaigns where every customer gets their own code.

Why it exists. Discounts win deals, reward loyalty and run promotions, without creating extra rate plans for every price point.

Who uses it. Marketing and sales set offers up. Admins apply them to orders. Customers enter coupon codes at Hosted Checkout.

Prerequisites. At least one product with rate plans. See Products.

ScreenPath
Offers listCatalogue > Offers
New offerCatalogue > Offers > Add New Offer
Offer detailsClick an offer’s ID
Coupon setsCatalogue > Coupon Sets

Offers list

The Offers list with one active coupon and one draft discount

The Offers list. Draft offers can be activated from the Actions column.

ColumnDescription
Offer IDOpens the offer details
Offer TypeDiscount or Coupon
Offer NameThe internal name
Offer ValueThe amount or percentage
StatusDraft, Active, Inactive or Expired
ActionsEdit, Activate (or Deactivate), Delete

Only Active offers can be applied. Deactivating an offer also stops it on renewals of subscriptions that already have it.

Creating an offer

The Create an Offer form

The Create an Offer form.

  1. Go to Catalogue > Offers and click Add New Offer.
  2. Fill in the fields below.
  3. Save. The offer is created as a draft.
  4. Open the offer and link it to rate plans, add-ons or charges (see Applicable items).
  5. Click Activate in the offers list.

Fields

FieldRequiredDescription
Type of OfferYesDiscount or Coupon
Coupon CodeFor couponsThe code customers type, e.g. WELCOME20
Internal NameYesYour name for the offer, shown in the portal
External NameThe name customers see on invoices and checkout
DescriptionNotes for your team
Discount TypeYesFixed (an amount), Percentage, or Custom Trial (a trial period instead of money off)
Currency and AmountFor FixedThe amount off, at least 1
PercentageFor PercentageThe percentage off
Custom Trial PeriodFor Custom TrialTrial length: number and period
Apply OnYesInvoice Amount (the whole order) or Each Specified Item (only the linked items)
Duration of DiscountYesForever, Single Use or Limited Time
Discount DurationFor Limited TimeNumber and period, e.g. 3 Month. At least 1
Expiry DateLast date the offer can be newly redeemed
Minimum Purchase AmountThe order must reach this amount
Maximum Redemptions (All Customers)Unlimited or a Specific Number (Total Redemption Count)
Redemptions Per CustomerUnlimited or a Specific Number (Per Customer Count)

Discount duration

DurationWhat happens
ForeverApplies to the first order and every renewal
Single UseApplies once. Not carried to renewals; an account can’t use it again
Limited TimeApplies to renewals until the first-applied date plus the duration

The Expiry Date limits new redemptions only. A customer who already has a Forever or Limited Time offer keeps it after the expiry date. See Discounts on renewal.

Applicable items

An offer details page with discount details and applicable items

An offer details page. Link rate plans, add-ons and charges under Applicable Items.

On the offer details page, the Applicable Items section has three tabs: Rate Plans, Addons and Charges. For each, choose:

OptionMeaning
AllEvery plan (add-on, charge) is eligible
NoneNone are eligible
SpecificPick individual items
By CriteriaFilter by product, currency and frequency

Coupon sets

Use a coupon set when each customer should get a unique, single-use code.

  1. Go to Catalogue > Coupon Sets and click Create Coupon Sets.
  2. Pick a tab:
    • Auto-generate tab: enter the Number of Coupons, and an optional Prefix and Suffix. The Code Preview shows the format, e.g. SUMMER-A1B2C3-2026.
    • Upload CSV tab: a .csv file with one code per row under a coupon_code header. Use Download sample CSV for the format.
  3. In both tabs, enter the Coupon Set Name and choose the Coupon (an offer of type Coupon).
  4. Click Upload Coupons (or the generate button).

Each code has a status: Unredeemed, Redeemed or Archived. A redeemed or archived code is refused.

Applying an offer

WhereHow
New subscriptionAdd the offer in the order form; the estimate shows the discount
Plan changeCoupon / Offer in the Change Plan form
Hosted checkoutThe customer enters the coupon code
APIAdd the offer to the order’s cart

Business rules and validations

When an offer is applied, BillHive checks it and shows the reason when it is refused:

CheckMessage
Offer not ActiveThis offer is currently inactive or unavailable.
Amount or percentage missingThis offer is not configured correctly. Please contact support.
Total redemptions reachedThis offer has reached its maximum redemption limit.
Past its expiry dateThis offer has expired and is no longer valid.
Per-customer limit reachedYou have already used this offer the maximum number of times.
Single Use already used by the accountThis offer has already been used and cannot be applied again.
Limited Time period overThe validity period for this offer has ended.
Order below the minimumYour order does not meet the minimum purchase amount required for this offer.
Coupon set code already usedThis coupon code has already been redeemed.

Form validations: Amount at least 1 for Fixed; Discount Duration at least 1 for Limited Time; counts at least 1 when Specific Number is chosen.

Billing impact

  • The discount is shown as its own line on the order estimate and invoice, and GST is worked out on the discounted amount.
  • On renewal, the discount is recalculated on the renewal’s lines, not copied, so a percentage discount follows a new price after a plan change.
  • Invoice-amount offers carry to renewals on plan and add-on lines; usage is not part of that amount. Offers on charges don’t carry to renewals.

Example

Festive campaign. “25% off for 3 months” on all monthly plans, for the first 500 customers, one use per customer.

FieldValue
Type of OfferCoupon, code FESTIVE25
Discount TypePercentage, 25
Apply OnInvoice Amount
DurationLimited Time, 3 Month
Maximum RedemptionsSpecific Number, 500
Redemptions Per CustomerSpecific Number, 1
Rate PlansBy Criteria: frequency Monthly

A customer on ₹1,200/month pays ₹900 + GST for three months, then ₹1,200.

FAQ

Can I change an offer after customers have used it? You can edit it, but changes apply to new orders and later renewals. Prefer creating a new offer for a new campaign.

How do I stop a discount for everyone? Deactivate it. It stops for new orders and on future renewals.

Can a customer combine two coupons? Each offer is checked on its own; test combinations with the order estimate before announcing them.