Operator guideENcoupon-codesaffiliatepromo-codes

Coupon Codes

Operator documentation for affiliate coupon-code maintenance, inline create or edit modals, coupon usage counts, and the reference PID panel.

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this module is for

Use Coupon Codes to manage promo codes that are linked to affiliate PIDs.

Operators use this module to:

  • create a new affiliate coupon code
  • edit the coupon code, PID, or force-registration flag
  • delete an obsolete coupon code
  • confirm how many distinct players have already used a code
  • copy a verified PID from the affiliate reference panel before creating a new code

Main surface

  • Coupon Codes / List is the only verified operator surface for this module.

The route combines three things on one page:

  • orientation cards at the top
  • a collapsible affiliate PID reference panel
  • the main coupon-code list with inline create, edit, delete, copy, filter, and export actions

Important caveats

  • There is no standalone create page, edit page, detail page, or reorder page in the verified FE route. Create, edit, and delete all happen through modals on the list screen.
  • The top stat cards are orientation-only. They help operators understand the size and shape of the coupon catalog, but they are not audited marketing or revenue reporting.
  • The verified FE transport uses POST /api/admin/affiliate-coupon-codes with an action value in the request body for read, stats, create, update, and delete. The backend router also exposes method-specific handlers on the same path, but the current FE path does not use them directly.

Verified ownership

  • FE route, list UI, filters, cards, panel, and modals: nx-admin-fe-workspace
  • CRUD and stats ownership: gs-admin-backend
  • Affiliate PID lookup for the reference panel: gs-admin-backend

Verification status

  • status: verified_backend
  • verified path:
    • FE route and inline modal actions in nx-admin-fe-workspace
    • backend coupon-code CRUD and stats service in gs-admin-backend
    • backend affiliate PID lookup service in gs-admin-backend
Related references

Related pages

pageCoupon Codes / List

Main affiliate coupon-code workspace with catalog stats, PID reference panel, inline create or edit modals, filters, export, and destructive delete confirmation.

pageRefer a Friend

Operator documentation for the refer-a-friend subsection hosted by the shared casino settings editor.

pageReporting / Affiliate Events Report

Audit log of the events and saved amounts the platform sent to the affiliate system, with per-currency successful totals and a CSV export.

pageActivity Tag Rules

Operator documentation for activity-driven tag automation rules, including list, create, edit, detail inspection, and recent application history.

pageActivity Tag Rules / Applications

Recent application history shown inside the detail page for one rule, including action performed, timestamp, and captured activity data.

pageActivity Tag Rules / Create

Create flow for a new activity tag rule, including optional clone-from-existing behavior and condition testing.