In this section · 2 articles

Set up a promotion code

Create a discount code for your business with a percentage or fixed amount, how many periods it lasts, its limits and dates, and withdraw a redemption when you need to.

Applies to
Monetization 3.0 and later
Who can do this
Administrator
Permission
feature.mon.promotion.create
Where
Monetization › Promotions
On this page

A promotion is a discount code, such as WELCOME10, that your business offers. It sets how much it takes off, for how many billing periods, how many times it can be used, and between which dates.

Promotions belong to the business that creates them. Another of your businesses can't see or use them.

In Monetization 3.0.0 nothing in your Laramin redeems a promotion code. CRM quotes and renewals don't apply them. A promotion only takes effect when another add-on or your own integration redeems it.

Before you start

  • You need feature.mon.promotion.create. Changing one needs feature.mon.promotion.edit.
  • Switch to the business the promotion is for. You can't create promotions in All Workspaces. See Switch workspace.

Create a promotion

  1. Go to Monetization › Promotions.

  2. Select New Promotion.

    The Create Promotions drawer with Name set to Welcome offer, Code WELCOME10, Discount type Percentage and Percentage 10, followed by empty Periods, limits, Starts, Ends and Status fields.
  3. In Name, enter a name your team will recognize, such as Welcome offer. You can enter it in each of your languages.

  4. In Code, enter the code customers will type, up to 60 characters. Capitals don't matter when it's redeemed.

  5. In Discount type, choose Percentage or Fixed amount.

  6. For Percentage, enter the Percentage, from 0 to 100. For Fixed amount, enter the Amount and its three-letter Currency, such as INR.

  7. Optional: in Periods, enter how many billing periods the discount lasts, from 1 to 120. Leave it empty for as long as the subscription runs.

  8. Optional: in Total limit, enter how many times it can be redeemed in all. Leave it empty for no limit.

  9. Optional: in Per-account limit, enter how many times one customer can redeem it.

  10. Optional: set Starts and Ends. Ends can't be before Starts.

  11. Leave Status as Active.

  12. Select Save.

You see Promotion saved. The list's Redeemed column counts its redemptions.

A code is used once for good. In Monetization 3.0.0 the form refuses a code that any promotion has ever used, in any of your businesses, including deleted ones, with The code has already been taken.

Change a promotion

Changes apply to redemptions from then on. A customer who already redeemed it keeps the discount as it was when they did. Lowering Percentage doesn't lower anyone's existing discount.

To stop a promotion, set Status to Inactive, or set Ends to today.

When a code is refused

Whatever redeems a code gets one of these answers when it can't be used:

MessageWhy
No promotion is running with the code ….No promotion in this business has that code. A code from another of your businesses is unknown here.
This promotion is not currently running.Its Status is Inactive.
This promotion does not start until ….Starts is in the future.
This promotion ended on ….Ends has passed.
This promotion has been fully redeemed.Total limit is reached.
This promotion can be redeemed … time(s) per account, and this account has used them.Per-account limit is reached.

Withdraw a redemption

Each redemption records which customer redeemed the code, the discount they got and how many periods are left. You can withdraw one, for example if it was given by mistake.

  1. Open the promotion's Redemptions.

  2. In the redemption's row, select Revoke.

  3. In Reason, enter why.

  4. Read Withdraw this redemption? It stops discounting anything further and frees the slot it occupied. The record that this account had the discount is kept. and confirm.

The redemption shows Revoked with the date, and it no longer counts against the limits. You need feature.mon.promotion_redemption.revoke.

In Monetization 3.0.0 the Redemptions list has no link from the Promotions list or the menu. It's at /admin/mon/promotions/<id>/redemptions, where <id> is the promotion's ID.

Delete a promotion

Select Delete on its row to put it in the trash. You can restore it.

A promotion that has ever been redeemed can't be removed for good. Laramin says This promotion has … redemption(s) and cannot be permanently removed. Those records explain why a customer was charged less. Its code also stays taken.