Coupon
A Coupon in Salesforce (Coupon in the API) is a standard object used in Loyalty Management and Salesforce Commerce that represents a single redeemable discount code issued to a buyer or loyalty member.
Definition
A Coupon in Salesforce (Coupon in the API) is a standard object used in Loyalty Management and Salesforce Commerce that represents a single redeemable discount code issued to a buyer or loyalty member. Each Coupon record holds a unique CouponCode, a reference to its parent Promotion (which defines the discount mechanics — percentage off, fixed amount, free shipping, BOGO), an issued-to identifier (typically a Loyalty Member or Account), an EffectiveFromDate and EffectiveToDate that bound the validity window, a Status (Issued, Redeemed, Expired, Cancelled), and a UsageCount tracking redemption against the parent Promotion's max-use rules. Coupons differ from Promotions: a Promotion defines the rule (every customer who applies code SAVE10 gets 10% off), while a Coupon represents a single instance of that rule (member 12345 was issued code SAVE10-XYZ123 valid through April 30). This per-instance modeling enables precise tracking of who received which coupon, when it was used, and what its lifetime contribution to revenue and engagement was.
In plain English
“A Coupon in Salesforce is a single discount code issued to a specific buyer or loyalty member — like a gift card you can use once. It links back to a parent Promotion that defines what the discount actually does (10% off, free shipping, etc.), but the Coupon itself is the unique instance with its own validity window and redemption status.”
Worked example
A retailer running a Salesforce Loyalty Management program decides to send a one-time appreciation discount to its top 1,000 loyalty members. The marketing team configures a Promotion (15% off any single order, max one use, valid 14 days) and triggers a Coupon-issuance flow. Salesforce generates 1,000 unique Coupon records — one per loyalty member — each with a distinct CouponCode like APPR-2026-A1B2C3, EffectiveFromDate of today, EffectiveToDate of two weeks out, and Status = Issued. Each member receives an email with their unique code. When a member shops on the storefront and applies their code at checkout, Salesforce validates the Coupon (active member, within date window, not yet redeemed) and applies the discount. The Coupon's Status flips to Redeemed and the redemption is logged for marketing-attribution and lifetime-value analysis.
Why Coupon matters
Coupons sit in a clear hierarchy with Promotions: Promotion (the rule) > Coupon Code (the named code with shared mechanics) > Coupon (the unique-per-buyer instance). This three-layer model supports both shared codes (every customer uses SAVE10 — one Promotion, one Coupon Code, no per-buyer Coupon records) and one-time targeted codes (each customer gets a unique APPR-2026-XYZ — one Promotion, one Coupon Code, thousands of Coupon records). Reporting on Coupon redemption rate by issuance batch is one of the highest-leverage promotion analytics in commerce.
Coupon validity is enforced at redemption time through a server-side validation pipeline that checks date windows, redemption count, member eligibility, cart contents (Promotion's qualifying-products rules), and stacking restrictions (whether multiple Coupons can apply to the same Cart). Failed validations return descriptive error codes back to the storefront so buyers see meaningful messages rather than generic 'invalid coupon' responses.
Coupons can be issued through several channels: bulk generation via Loyalty Promotion processes, individual issuance via Service Console workflows (a service rep apologizing for a bad experience by issuing a one-time coupon), referral-driven issuance through Loyalty Member referral programs, or programmatic issuance through Apex during signup or milestone events. Tracking the IssuanceSource on each Coupon enables ROI analysis per acquisition channel.
How organizations use Coupon
Issues unique Coupons to top loyalty tiers as appreciation rewards. Each Coupon's per-member uniqueness lets the marketing team track exactly who redeemed and within what window — informing future personalized-offer targeting based on response rates.
Generates a Coupon for every successful customer referral. The referring customer receives a discount Coupon, the new customer receives a welcome Coupon, and both Coupons are tied back to the referral event for full lifecycle attribution.
Empowers service agents to issue a one-time recovery Coupon when handling a complaint. The Coupon is linked to the originating Case, providing a measurable closed-loop on whether recovery offers actually improve retention and CSAT.
Trust & references
Straight from the source — Salesforce's reference material on Coupon.
- Coupon in Object Reference for the Salesforce PlatformSalesforce Developer Documentation
Discussion
Loading discussion…