Introduction

By the end of this guide, you will be able to scan a customer’s coupon, review its details and validity, and redeem it — all in a few taps.

What is coupon redemption?

When a customer presents a digital coupon (QR code or barcode from Apple Wallet, Google Wallet, or the PassKit app), you scan it to view the offer details and mark it as redeemed. Once redeemed, the coupon cannot be used again. The redemption syncs to PassKit in real time, so the customer’s pass updates on their device.

Before you start

The PassKit PassReader app must be installed (Android or iOS).
You must be logged in with your staff credentials.
Your device needs an active internet connection.

Step 1 — Scan the coupon

From the Home screen, tap the Start Scanning card and point the camera at the customer’s QR code or barcode. The app detects the pass type automatically — for a coupon, the Coupon Details screen opens.

Step 2 — Review the coupon details

The Coupon Details screen displays the coupon as a card with the following information:

Field	Description
Status badge	ACTIVE, REDEEMED, EXPIRED, or DISABLED — shown in the top-left corner of the hero card
Offer title	The name of the offer (e.g. “20% Off Your Next Purchase”)
Campaign name	The campaign this coupon belongs to
Coupon code	A tappable pill showing the first 10 characters of the coupon ID — tap to copy the full ID to your clipboard
Countdown timer	For active coupons with an expiry date, a live countdown shows days, hours, minutes, and seconds remaining
Coupon Validity	Full coupon ID, current status, expiry date (if set), and redemption date (if redeemed)
Customer Info	First name, last name, and email (shown only if available for this coupon)
Offer Details	Full description of the offer (if available)

Take a moment to verify the coupon is valid and belongs to the customer before redeeming.

NOTE If the coupon has already been redeemed, the hero card appears with a dark overlay and the status badge shows REDEEMED in purple.

Step 3 — Redeem the coupon

At the bottom of the screen, tap the Redeem Now button.
A confirmation dialog appears: “Redeem this coupon?” with the message “This cannot be undone. This coupon will be marked as redeemed.”
Tap Confirm Redemption to proceed, or Cancel to go back.
The button shows “Redeeming...” while the app contacts the PassKit server.

IMPORTANT Redemption is permanent — once a coupon is redeemed, it cannot be un-redeemed. Make sure you are redeeming the correct coupon before confirming.

Step 4 — Confirm the result

After successful redemption:

A green confirmation message — “Coupon Redeemed” — appears at the bottom of the
screen.
The status badge updates to REDEEMED.
The hero card dims with a dark overlay.
The Redeem Now button changes to a disabled Coupon Redeemed button with a checkmark icon.
The Coupon Validity section shows the Redeemed On date and time.

Changing the expiry date (optional)

For active coupons, you can set or change the expiry date before redeeming:

In the Coupon Validity section, tap the Expiry Date row (or Set Date if no expiry is
currently set).
A date picker opens. Select the new expiry date (must be today or later).
Tap Save to confirm.
The countdown timer updates to reflect the new expiry date.

NOTE You can only change the expiry date on active, non-redeemed coupons. Once a coupon is redeemed, the label changes to Was Valid Until. For expired coupons, it shows Expired On. Both are read-only.

Understanding coupon states

State	Status badge	Redeem button	What it means
Active	Green ACTIVE	Redeem Now (enabled)	Coupon is valid and ready to redeem
Redeemed	Purple REDEEMED	Coupon Redeemed (disabled)	Already used — cannot be redeemed again
Expired	Red EXPIRED	Coupon Expired (disabled)	Past its expiry date — no longer valid
Disabled	Red DISABLED	Coupon Unavailable	Disabled by an administrator

Troubleshooting

Problem	What to do
Redeem Now button is not visible	The coupon may already be redeemed, expired, or disabled. Check the status badge at the top of the card.
"Network error. Please try again."	Check your internet connection and try again. The coupon has not been redeemed.
Coupon shows EXPIRED but the customer says it should be valid	The expiry date may have passed. If this is an error, contact your administrator to reissue the coupon.
Hero image is not loading	This is a display issue only — the coupon can still be redeemed. Check your internet connection; the image will load when connectivity returns.
Coupon code does not copy when tapped	Tap the code pill (not the surrounding area). The full coupon ID is copied to your clipboard.