Voucher Redemption · Gift Card / Store Credit Redemption¶

Customer redeems a voucher or gift card during checkout in store or online. The flow covers voucher validation, application of partial or full value, recalculation of the remaining balance, and final order confirmation.


Domains	`customer` · `order` · `payment` · `promotion`
Actors	`customer` · `store-associate`
Process	Voucher Redemption
Capabilities	6
Steps	7
Events	11
Lifecycles	4
Min UCMI	`2.5`

⚙️ Step-by-Step Flow¶

#	Step	Actor	Lifecycle	State Change	Event
1	Build basket	customer	`basket-lifecycle`	→ open	`basket-created`
2	Start checkout	customer	`basket-lifecycle`	open → locked	`basket-checkout-started`
3	Validate voucher	system	`payment-lifecycle`	pending → validated	`voucher-validated`
4	Redeem voucher value	system	`payment-lifecycle`	validated → partially-paid	fully-paid
5	Recalculate remaining amount	system	`price-list-lifecycle`	calculated → recalculated	`price-calculated`
6	Settle residual payment	customer	`payment-lifecycle`	partially-paid → captured	fully-paid → captured
7	Create order and issue receipt	system	`order-lifecycle`	draft → confirmed	`order-created` · `order-confirmed` · `basket-converted` · `receipt-issued`

⚡ Event Sequence¶

basket-created → basket-checkout-started → voucher-validated → voucher-redeemed → price-calculated → payment-authorized → payment-captured → order-created → order-confirmed → basket-converted → receipt-issued

🔄 Lifecycles Involved¶

🧩 Capabilities Required¶

Capability
`basket-management`	Basket Management
`pricing`	Pricing
`voucher-management`	Voucher Management
`checkout`	Checkout
`payment-processing`	Payment Processing
`order-management`	Order Management

🖥️ Application Coverage¶

Applications that implement the capabilities required by this scenario.

Capability	Implementing Applications
`basket-management`	POS · eCommerce Platform · Clienteling App
`pricing`	Promotion Engine
`voucher-management`	Promotion Engine
`checkout`	POS · eCommerce Platform · Associate Workspace
`payment-processing`	POS · Payment Hub
`order-management`	OMS · eCommerce Platform

📊 Readiness by Profile¶

Capability readiness across assessment profiles.

Profile	Capabilities Met	Avg Score	Ready?
Acme Electronics	6/6	2.2	❌
BuildPro Trade	5/6	2.5	❌
Flash Delivery	5/6	2.5	❌
Luxe Maison	4/6	2.2	❌
Metro Fresh Group	6/6	2.7	✅
Stella Fashion Group	6/6	2.7	✅
Reference Tier 2 Non-food Retailer	5/6	2.5	❌

✅ Preconditions¶

Voucher or gift card programme is active in the selling channel
Basket contains eligible merchandise for voucher redemption
Voucher identifier can be entered, scanned, or tokenised

🎯 Success Criteria¶

Voucher validity and available balance are checked before order confirmation
Partial tender scenarios are supported without manual intervention
Order audit trail shows voucher value and residual payment separately
Customer receives accurate remaining-balance outcome through the receipt or checkout confirmation

⚠️ Failure Modes¶

Voucher is expired, blocked, or already fully redeemed
Voucher balance is lower than expected because of concurrent use
Residual payment authorization fails after voucher value is reserved
Basket contains excluded items that invalidate voucher application

UCMI Requirements¶

Minimum UCMI Score: 2.5

Capability	Minimum Level
`basket-management`	🟠 2
`pricing`	🟠 2
`voucher-management`	🟠 2
`checkout`	🟠 2
`payment-processing`	🟠 2
`order-management`	🟠 2

UC-BoK Scenario Catalog · All Scenarios · Scenario Catalog