Coupons — platform console

Platform console → Operations → Coupons. ADR-029; the partner plan is docs/partners/PLANNERWICK_CONNECTION.md.

Who opens it: an EntryWick owner or finance operator running a sale. What they came to do: make a code that takes money off EntryWick's own plans, a partner product's, or both; put it on the website as a bar or a pop-up; see what it has given away; switch it off. What must be true when they leave: the code is on (or not) on both websites at once, and nobody can use it for something it was not meant for.

The list

Every code, newest first: the code, the discount, which products, where it stands, uses against the limit, the money given, and whether it shows as a bar or a pop-up. Filter by product; search by code.

Status is worked out from the row and the clock — nothing has to be switched at midnight. Days are read in the coupons' timezone (Central by default, EW_COUPON_TIMEZONE) and a day runs to its end.

Switch off / on, Edit, Delete. Only a code nobody has used can be deleted; a used one stays as the record of what it gave and is switched off instead. A used code also keeps its code and its discount — dates, limit and words can still change.

Making a code

The code. 3 to 24 capital letters, digits, dashes or underscores (typed in any case, stored in capitals). Percent off (1–100) or an amount off in cents. On a monthly plan: the first payment only, the first N months, or every payment — a one-time price is charged once, so this only matters for monthly plans.

What it is for. The products (EntryWick; a partner appears once its switch is on) and, per product, the plans — leave the plans empty for every plan. Maximum uses (blank = no limit). Valid from / until. One use per customer (on by default). First purchase only. On.

Show on a website. Sale bar, pop-up, which websites, colour (maroon, midnight, gold, green, blue), and the words: tag, end label, headline, message, button words and link (https only). The preview under the fields is the bar as the website will draw it. A code with neither bar nor pop-up is a quiet code: it works at checkout and shows nowhere.

Every make, change, switch and delete is on the operators' activity log with the operator's name.

What a buyer sees

• EntryWick plans. Settings → Billing has a Have a code? box above the yearly plans: typing a code shows the price with it on every plan card, or the one sentence saying why it does not apply (not on yet, ended, used up, not for this plan, already used on this account, first purchase only). Buy this event on an event has the same box. The code goes to Stripe Checkout, which takes the money off and shows it on the receipt.
• A partner's website asks GET /api/public/offer?product=plannerwick and draws the bar or pop-up from the answer; entrywick.com draws its own from the same answer. The pop-up is shown once per visitor per offer.

One discount per order. A referred organization's welcome coupon and a typed code compete and the bigger wins; the welcome is kept for the next invoice when the code beats it.

Who may

Known limits

• A code cannot be stacked with another, and a partner's bundle discount (phase 4) is not here yet.
• Codes on a partner's plans are quoted and shown now; the partner checkout that spends them is phase 2.