Haruno Knowledge base

Promos

Make promo codes that give free access or bonus credit, share them, and switch them off.

  • Operator consoleAvailable

A promo code gives someone free or cheaper access. They enter it on the customer dashboard. Promos is where operators make codes, copy them or their links, and switch them off.

The Promos page: a table of made-up codes with what each grants, how many times it was redeemed, when it expires and its status

The list

Type in the search box to find a code by its text, its plan or its note.

ColumnWhat it shows
CodeThe code. Click it to copy it. The note you gave it is underneath
GrantTier with the plan, or Credit with the amount
LifetimeFor a plan code, how many days it lasts before the person goes back. A dash means no end
RedeemedHow many people used it, out of the most allowed
ExpiresThe last day it can be redeemed
StatusActive or Revoked
ActionsCopy link, and Revoke or Enable

Codes are not secret. They are meant to be shared.

Two kinds of code

KindWhat it does
Tier (plan for a lifetime)Puts the person on a plan. If you set a lifetime in days, they go back to their old plan after that. You can set a budget instead of the plan's own
Credit (bonus budget)Adds a dollar amount to the person's budget

Make a code

The New promo code window with the grant type, tier, budget, period, lifetime, maximum redemptions, code, expiry and note fields
  1. Press New promo.
  2. Choose the Grant type.
  3. For a plan code, choose the Tier. For a credit code, type the Credit amount (USD). It must be above zero.
  4. Fill in what you need: a Period such as 30d, a Lifetime (days) for a plan code, Max redemptions across all people, and Redeemable until. That date counts to the end of that day, UTC.
  5. Type a Code, or leave it blank and one is made for you. A code can have letters, digits and dashes. It is made upper case.
  6. Add a Note to remember what the code was for.
  7. Press Create.

If the code you typed already exists, you are told and nothing is made.

Share a code

Copy link copies a web address that opens the person's dashboard with the code already filled in. All they do is press Redeem. Use it when you hand a code to a tester.

Switch a code off

Revoke stops anyone from redeeming it from then on. People who already redeemed it keep what they got. Enable turns it back on. A revoked code behaves like one that does not exist, so a guess cannot tell which codes were ever made.

Each person can redeem a code once.

Promos are a cost, not income

Redemptions are booked as Haruno's expense. They are never counted as revenue. The Financials page shows what promos have cost.

Who can use it

Every operator can read the list. Making a code and revoking or enabling one are for super admins. A viewer who tries is told their role does not allow it.

What a person in sales can ask an operator

  • "Make me a code for the webinar, 40 uses, $50 credit, until the end of the month." An operator makes it and sends the link.
  • "Is the webinar code still being used?" Read Redeemed.
  • "Stop the old code." An operator revokes it. It can be enabled again later.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    PR #2944Commit a2a7836The page at this version
    What changed
    @@ -0,0 +1,74 @@
+---
+title: Promos
+summary: Make promo codes that give free access or bonus credit, share them, and switch them off.
+feature: ops-promos
+covers:
+  - web/monitoring/components/PromosPage.tsx
+  - server-dotnet/src/Haruno.Server/Controllers/AdminPromoController.cs
+  - server-dotnet/src/Haruno.Server/Services/PromoService.cs
+---
+
+A promo code gives someone free or cheaper access. They enter it on the customer dashboard. **Promos** is where operators make codes, copy them or their links, and switch them off.
+
+<Shot src="/m/9c03c85fbbc6-ops-promos-dark.png" alt="The Promos page: a table of made-up codes with what each grants, how many times it was redeemed, when it expires and its status" />
+
+## The list
+
+Type in the search box to find a code by its text, its plan or its note.
+
+| Column | What it shows |
+|---|---|
+| Code | The code. Click it to copy it. The note you gave it is underneath |
+| Grant | **Tier** with the plan, or **Credit** with the amount |
+| Lifetime | For a plan code, how many days it lasts before the person goes back. A dash means no end |
+| Redeemed | How many people used it, out of the most allowed |
+| Expires | The last day it can be redeemed |
+| Status | **Active** or **Revoked** |
+| Actions | **Copy link**, and **Revoke** or **Enable** |
+
+Codes are not secret. They are meant to be shared.
+
+## Two kinds of code
+
+| Kind | What it does |
+|---|---|
+| **Tier (plan for a lifetime)** | Puts the person on a plan. If you set a lifetime in days, they go back to their old plan after that. You can set a budget instead of the plan's own |
+| **Credit (bonus budget)** | Adds a dollar amount to the person's budget |
+
+## Make a code
+
+<Shot src="/m/3c2e447dcb29-ops-promo-new-dark.png" alt="The New promo code window with the grant type, tier, budget, period, lifetime, maximum redemptions, code, expiry and note fields" />
+
+1. Press **New promo**.
+2. Choose the **Grant type**.
+3. For a plan code, choose the **Tier**. For a credit code, type the **Credit amount (USD)**. It must be above zero.
+4. Fill in what you need: a **Period** such as `30d`, a **Lifetime (days)** for a plan code, **Max redemptions** across all people, and **Redeemable until**. That date counts to the end of that day, UTC.
+5. Type a **Code**, or leave it blank and one is made for you. A code can have letters, digits and dashes. It is made upper case.
+6. Add a **Note** to remember what the code was for.
+7. Press **Create**.
+
+If the code you typed already exists, you are told and nothing is made.
+
+## Share a code
+
+**Copy link** copies a web address that opens the person's dashboard with the code already filled in. All they do is press **Redeem**. Use it when you hand a code to a tester.
+
+## Switch a code off
+
+**Revoke** stops anyone from redeeming it from then on. People who already redeemed it keep what they got. **Enable** turns it back on. A revoked code behaves like one that does not exist, so a guess cannot tell which codes were ever made.
+
+Each person can redeem a code once.
+
+<Callout variant="info" title="Promos are a cost, not income">
+Redemptions are booked as Haruno's expense. They are never counted as revenue. The [Financials](/ops/customers/financials/) page shows what promos have cost.
+</Callout>
+
+## Who can use it
+
+Every operator can read the list. Making a code and revoking or enabling one are for super admins. A viewer who tries is told their role does not allow it.
+
+## What a person in sales can ask an operator
+
+- "Make me a code for the webinar, 40 uses, $50 credit, until the end of the month." An operator makes it and sends the link.
+- "Is the webinar code still being used?" Read **Redeemed**.
+- "Stop the old code." An operator revokes it. It can be enabled again later.