19.94. DD 94: Discounts & Passes Wallet UI#
19.94.1. Summary#
This document describes the design and behavior of all wallet screens related to discounts and passes. It defines a unified way to present, manage, and display these entities across the wallet, including their states, structure, and visual representation.
19.94.2. Motivation#
Merchants can provide users with discounts or passes that apply to specific products or services. The wallet must support:
Clear presentation of available discounts and passes Ability for users to review and apply them during checkout Overview of all owned items, including: Currently active Not yet active (future validity) Available for use
A consistent design ensures users can easily understand what benefits they have, when they can use them, and how they affect their purchases.
19.94.3. Requirements#
19.94.4. Proposed Solution#
19.94.4.1. Discounts & Passes Pages#
19.94.4.1.1. Available#
Inside card next information is displayed:
Name of the discount or pass
Description
For discount card: “Redeemable at:” with the merchant name. For pass card: “Provided by:” with the merchant name.
Validity section:
For active items: “Valid until” with the expiration date. Background color is SecondaryContainer. Text color is onSecondaryContainer.
For future items: “Valid from” with the start date.
Badge used to indicate number of items of the same type. If only one item of the same type is owned, the badge is not shown.
For active items: badge background color is Primary. Text color is onPrimary.
For future items: badge background color is SurfaceVariant. Text color is onSurfaceVariant.
19.94.4.1.2. Expired#
Inside card next information is displayed:
Name of the discount or pass
Description
For discount card:
Redeemed: “Redeemable at” + merchant name + “on” + redeemed date. Text button Primary color “View order” with the link to the order details page.
Not redeemed: “Was redeemable at:” with the merchant name.
For pass card:
“Provided by:” with the merchant name.
For used pass show text button Primary color “View orders” with the link to the orders list.
Validity section: “Validity period” and date range.
Badge used to indicate number of items of the same type. If only one item of the same type is owned, the badge is not shown.
19.94.5. Test Plan#
(If this DD concerns a new or changed feature, describe how it can be tested.)
19.94.6. Definition of Done#
(Only applicable to design documents that describe a new feature. While the DoD is not satisfied yet, a user-facing feature must be behind a feature flag or dev-mode flag.)
19.94.7. Alternatives#
19.94.8. Drawbacks#
19.94.9. Discussion / Q&A#
(This should be filled in with results from discussions on mailing lists / personal communication.) Got it — here’s a design document–style description aligned with your previous DD format and written for implementation.
—