Skip to content

Voucher Management

management promotion

Gift vouchers and store credits can be issued, validated, redeemed and cancelled.

Issues, validates, and redeems gift vouchers, e-gift cards, and store credits. Manages voucher balance, partial redemption, and expiry. Operates as a payment instrument alternative within the checkout flow and supports both digital and physical voucher formats across all channels.


Overview

ID voucher-management
Domain promotion
Classification management
Actors customer, store-associate, customer-service-agent, system
Services 4
Events 4
Processes 1
Applications 1

Services

ID Name Description
issue-voucher Issue Voucher Issues a new gift voucher or store credit with a specified value, generating a unique voucher code.
validate-voucher Validate Voucher Validates a voucher code against balance, expiry, and channel eligibility.
redeem-voucher Redeem Voucher Redeems a voucher for the specified amount, debiting its balance and returning the applied credit.
cancel-voucher Cancel Voucher Cancels an unused or partially used voucher, zeroing its balance and voiding the code.

Events Emitted

Event Type Subject Description
voucher-issued `` A new gift voucher or store credit was issued to a customer.
voucher-validated `` A voucher was validated as genuine and within its validity period.
voucher-redeemed `` A valid voucher was fully or partially redeemed against a transaction.
voucher-cancelled `` A voucher was cancelled and rendered invalid for future redemption.

Processes

Process Name Classification
voucher-redemption Voucher Redemption transactional

Applications

Application Name Tier
promotion-engine Promotion Engine

Lifecycle

Lifecycle States ID
Voucher Lifecycle 6 states voucher-lifecycle

Metrics & KPIs

Metric Alias Unit Direction
Loyalty Redemption Rate LRedR percentage

Touchpoints

Touchpoint Type
💻 Web Store Digital
💻 Mobile App Digital
🏪 Physical Store Physical
🤝 Call Centre / Customer Service Assisted

Validation Rules

Rule Type Applies To Severity
voucher-redemption-requires-valid-voucher pre-condition voucher-redemption invariant