CPN — Coupons

Traces to the business requirements.

FR-CPN-01 — Creator scopeCopy Anchor Link

A coupon shall apply only inside its creator's scope: admin coupons to any trip (optionally limited to a market); organization coupons to its own trips; driver and photographer coupons to bookings where that supplier is assigned.

MustsourceBR-CPN-01BRL-03

• Given a driver coupon and a booking without that driver, when applied, then it is refused.

FR-CPN-02 — Cross-entity rejectionCopy Anchor Link

Cross-entity use shall always be rejected with "not applicable to this booking", without naming the other entity (OD-20).

MustsourceBR-CPN-02BRL-03

• Given organization A's coupon on organization B's trip, when validated, then the generic message shows.

FR-CPN-03 — Real-time validationCopy Anchor Link

Validation shall check existence, status, validity window, scope, usage limit, per-user limit and minimum spend, in that order, and return the first failing reason.

MustsourceBR-CPN-03

• Given a coupon that expired yesterday, when applied, then the reason is "expired".
• Given a total below the minimum, when applied, then the reason is "minimum spend not met".

FR-CPN-04 — Coupon typesCopy Anchor Link

Coupons shall support fixed amount, percentage, program-specific, free program, first booking and minimum spend.

MustsourceBR-CPN-03

• Given a first-booking coupon, when a traveler with a confirmed booking with that entity applies it, then it is refused.

FR-CPN-05 — Lifecycle and controlsCopy Anchor Link

Coupons shall use the states in section 7.7. Creators pause, resume and revoke their own; admins revoke any.

MustsourceBR-CPN-01

• Given a Paused coupon, when applied, then it is refused with reason "paused".

FR-CPN-06 — Redemption and reversalCopy Anchor Link

Each redemption shall be recorded against its booking. A refund reverses the redemption, frees the traveler's per-user use, and decrements the total usage count (architecture 10.6); an Exhausted coupon returns to Active if still in its window.

MustsourceBR-CPN-04BRL-11

• Given a refunded booking with a coupon, when saved, then the redemption is reversed and the traveler can use the coupon again.

FR-CPN-07 — Analytics and abuse flagsCopy Anchor Link

Creators shall see redemptions, discount total and remaining uses per coupon with 7, 30 and 90-day presets. Admins see platform analytics and abuse flags. Flags never block automatically; admins review within 2 working days (D-217). Thresholds are [OPEN: D-216].

MustsourceBR-CPN-05RSK-05

• Given a flagged coupon, when the admin opens it, then the flag shows the rule that raised it and its review due date.

FR-CPN-08 — Coupon count by planCopy Anchor Link

Active and paused coupons count against the plan limit (D-203): organizations 5, 20, unlimited; drivers and photographers 3, 10, unlimited.

MustsourceBR-SUB-02

• Given a Starter organization with 5 active or paused coupons, when it creates a sixth, then it is blocked with an upgrade prompt.