Apple Wallet & Google Wallet Distribution touchpoints

Priiize Virtual Scratch-Off Games – Practical ways we make an optional mobile wallet pass the “save it now, redeem later” bridge for Priiize winners—covering both how you hand it out and how it behaves after being saved.

Distribution touchpoints (how they get the pass)

1. End-screen CTA (per prize): Show Add to Apple Wallet / Save to Google Wallet right on the win screen. Issue a unique pass tied to that winner/prize.
2. Prize-claim email: Include the Add/Save buttons in the confirmation email. Great for desktop users who want to move it to their phone later.
3. SMS handoff: Text a short URL that deep-links to the pass. Works well at trade shows or when the win occurs on a kiosk/shared device.
4. QR code on the win screen: Display a QR that opens the pass link on the player’s own phone (handy for iPad booths).
5. Thank-you page / “My Prizes” portal: After claiming, host a simple page with a pass button and FAQs (“How to add to Wallet”).
6. Deferred-claim button (“Save for later”): The Winner taps once; you generate the pass, but skip the redemption steps until they reach the POS.
7. Auto-issue on Windows: If allowed, silently create the pass on the server side and display a single “Add to Wallet” button—no additional form fields are required.
8. Follow-up reminder email/SMS: If they didn’t add the pass on day 1, send a “Don’t forget to save your prize” nudge with the same secure link.
9. Static signage/post-event handoff: Place a QR code on signage or a take-home card that directs to the Winner’s unique pass (when authenticated).

Pass behaviors (how it “holds” value until redemption)

1. One-time coupon pass: Store the Prize Validation Code (PVC) along with a scannable barcode/QR code. Upon redemption, you flip the pass to ‘Used‘ and gray it out.
2. Time-windowed pass: Add start/end dates or a countdown field (“Redeem within 14 days”). Update the pass to “Expired” automatically.
3. Location-aware prompts: Add store locations/geofences so the phone nudges them (“You’re near Store X—redeem your prize”).
4. Multi-use/balance field: For “$X off each visit” or points, maintain a Remaining Balance/Visits field and update it after each scan.
5. Tiered prize text & art: Dynamically brand the pass per prize tier (Free 6oz, 10% Off, 20% Off) so the saved pass is crystal-clear at a glance.
6. Barcode standards matched to POS: Encode PVC or coupon codes in Code128/EAN/QR exactly as the POS expects, minimizing cashier friction.
7. “Tap to redeem” flow: Keep a Redeem URL on the pass back; the cashier taps it to trigger your verification endpoint and update the pass to “Redeemed“.
8. Auto-convert to loyalty: After it’s used (or if it expires), update the headline and CTA to invite them to save a Loyalty Rewards Pass (or switch the same pass to “member” mode).
9. Inventory/Blackout Messaging: Use pass fields to display blackout dates, store list, or “Out of stock—try Location B”.
10. Personalization fields: Add the Winner’s first name, a brief prize note, and a support link to minimize confusion and reduce queue time.
11. Device-agnostic fallback: If Apple/Google Wallet isn’t available, the same link displays a web “pass” with the barcode and details, ensuring no one is left without access.

Implementation tips for Priiize

• Per-winner link format:
• https://priiize.com/wallet/pass?prize_id=ABC123&winner_id=U789&sig=…
• Your server returns either a .pkpass (Apple) or a Google Wallet Save link/JWT. The same link can detect the device and route accordingly.
• Core pass fields to set
  • primaryLabel / primaryValue: Prize name (e.g., “Free 6oz GOO”)
  • Secondary: “Redeem by Oct 31, 2025” (or dynamic countdown)
  • auxiliary: PVC or short code; store/region; terms
  • barcode: QR or Code128 with PVC (plus a human-readable text line)
  • locations: store lat/long for “nearby” reminders
  • userInfo: hidden JSON (winner_id, prize_id, campaign_id) for your webhook updates
• Lifecycle webhooks
  1. Issue on win (status=Issued)
  2. Save event (status=Saved; send a “how to redeem” tip)
  3. Scan at POS (validate PVC; status=PendingRedeem)
  4. Confirm (status=Redeemed, field turns green, barcode disabled)
  5. Expire (status=Expired; update top line to “Expired—tap for new offers”)
• Security
  • Short-lived JWT/links; server checks winner_id + sig.
  • Rotate PVCs or mark them single-use server-side.
  • Throttle attempts on your validation endpoint.

QUESTIONS? Contact tech support.

How Zero-Party Data Fits into Priiize Campaigns