Voucher Redemption — Operational Experience¶

End-to-end human journey for Voucher Redemption.
Modelled using the UC-BoK Experience Model (SPEC-016 / ADR-016).

Journeys¶

Journey	Actor	Touchpoint	Channel	Tasks	Type
Voucher Redemption — Cashier Journey	Cashier	`pos-terminal`	`in-store`	4	Happy path
Voucher Redemption — Digital Customer Journey	Customer	`web-browser`	`online`	3	Happy path

End-to-End Sequence¶

Happy-path flow across all actors.

sequenceDiagram
    participant cashier as Cashier
    participant customer as Customer

    cashier->>SYS: Enter Voucher Code POS
    SYS-->>cashier: VoucherEntered
    cashier->>SYS: Validate Voucher POS
    SYS-->>cashier: VoucherValidated
    cashier->>SYS: Apply Voucher Discount
    SYS-->>cashier: VoucherApplied
    cashier->>SYS: Confirm Discounted Total
    SYS-->>cashier: DiscountedTotalConfirmed
    customer->>SYS: Enter Voucher Code Online
    SYS-->>customer: OnlineVoucherEntered
    customer->>SYS: Verify Voucher Online
    SYS-->>customer: OnlineVoucherVerified
    customer->>SYS: Review Discounted Basket Total
    SYS-->>customer: DiscountedBasketReviewed

Voucher Redemption — Cashier Journey¶

In-store voucher redemption flow at POS from code entry through discounted total confirmation.


Actor	Cashier
Touchpoint	`pos-terminal`
Channel	`in-store`
Precondition	—
Postcondition	—

📥 Step 1 — Enter Voucher Code POS¶

Cashier enters or scans the voucher code at POS so the system can identify the voucher or coupon against the current basket.

Direction	Business Objects
Input	`voucher`, `basket`
Output	`basket`

Capabilities: voucher-management checkout

Events: VoucherEntered

Interactions:

#	Interaction	Type	Input	Output	Event
1	Scan or Enter Voucher	🟦 input	`voucher`	`basket`	—
2	Confirm Voucher Entry	✅ confirm	`voucher`	`basket`	`VoucherEntered`

✅ Step 2 — Validate Voucher POS¶

POS validates the voucher against campaign rules, expiry, and basket conditions before it can be redeemed in store.

Direction	Business Objects
Input	`voucher`, `basket`
Output	`voucher`

Capabilities: voucher-management checkout

Events: VoucherValidated

Interactions:

#	Interaction	Type	Input	Output	Event
1	Review Voucher Status	✅ verify	`voucher`	`voucher`	—
2	Confirm Voucher Eligibility	✅ confirm	`voucher`	`voucher`	`VoucherValidated`

⚙️ Step 3 — Apply Voucher Discount¶

System applies the voucher discount to the basket and recalculates the payable total for the transaction.

Direction	Business Objects
Input	`voucher`, `basket`
Output	`basket`

Capabilities: voucher-management promotions

Events: VoucherApplied

Interactions:

#	Interaction	Type	Input	Output	Event
1	Review Discount Effect	👁️ review	`voucher`	`basket`	—
2	Apply Voucher to Basket	⚙️ execute	`voucher`	`basket`	`VoucherApplied`

👁️ Step 4 — Confirm Discounted Total¶

Cashier reviews the discounted basket total with the customer before proceeding to payment.

Direction	Business Objects
Input	`basket`
Output	`basket`

Capabilities: checkout promotions

Events: DiscountedTotalConfirmed

Interactions:

#	Interaction	Type	Input	Output	Event
1	Review Updated Total	👁️ review	`basket`	`basket`	—
2	Confirm Discounted Amount	✅ confirm	`basket`	`basket`	`DiscountedTotalConfirmed`

Voucher Redemption — Digital Customer Journey¶

Digital voucher redemption flow from code entry through discounted basket review.


Actor	Customer
Touchpoint	`web-browser`
Channel	`online`
Precondition	—
Postcondition	—

📥 Step 1 — Enter Voucher Code Online¶

Customer enters a voucher or coupon code during online checkout so the system can attempt redemption against the basket.

Direction	Business Objects
Input	`voucher`, `basket`
Output	`basket`

Capabilities: voucher-management checkout

Events: OnlineVoucherEntered

Interactions:

#	Interaction	Type	Input	Output	Event
1	Enter Voucher Code	🟦 input	`voucher`	`basket`	—
2	Submit Voucher Code	✅ confirm	`voucher`	`basket`	`OnlineVoucherEntered`

✅ Step 2 — Verify Voucher Online¶

Checkout validates the voucher online against promotion rules, expiry, and qualifying basket conditions.

Direction	Business Objects
Input	`voucher`, `basket`
Output	`voucher`

Capabilities: voucher-management checkout

Events: OnlineVoucherVerified

Interactions:

#	Interaction	Type	Input	Output	Event
1	Review Voucher Response	✅ verify	`voucher`	`voucher`	—
2	Confirm Voucher Acceptance	✅ confirm	`voucher`	`voucher`	`OnlineVoucherVerified`

👁️ Step 3 — Review Discounted Basket Total¶

Customer reviews the revised basket total after the voucher has been applied during checkout.

Direction	Business Objects
Input	`basket`
Output	`basket`

Capabilities: checkout promotions

Events: DiscountedBasketReviewed

Interactions:

#	Interaction	Type	Input	Output	Event
1	Review Discounted Basket	👁️ review	`basket`	`basket`	—
2	Confirm Revised Total	✅ confirm	`basket`	`basket`	`DiscountedBasketReviewed`

Process: Process Catalog
Experience Index: All Operational Experiences

EXP-VOUCHERREDEMPTION — Voucher Redemption Operational Experience — UC-BoK v0.9-alpha

Voucher Redemption — Operational Experience¶

Journeys¶

End-to-End Sequence¶

Voucher Redemption — Cashier Journey¶

📥 Step 1 — Enter Voucher Code POS¶

✅ Step 2 — Validate Voucher POS¶

⚙️ Step 3 — Apply Voucher Discount¶

👁️ Step 4 — Confirm Discounted Total¶

Voucher Redemption — Digital Customer Journey¶

📥 Step 1 — Enter Voucher Code Online¶

✅ Step 2 — Verify Voucher Online¶

👁️ Step 3 — Review Discounted Basket Total¶

Related¶