PIF Wireframes — Claim + Wallet how-to

8.2 Claim — happy path

SMS landing → age gate → OTP → gift summary → claim → Wallet how-to → balance

C1 · SMS landing PRD §8.2 entry

Messages

SMS (draft copy)

Alex sent you a Pour it Forward tab for Harbor & Rye. Claim & add to Wallet:
https://pif.app/c/x7k9…
(21+). Expires Sep 28.

Tap link → mobile browser (Safari iOS / Chrome Android preferred).

Deep link opens PWA

Route: /c/{token} · no app install

[ wireframe: lock screen / notification optional ]

Sender first name or “Someone”. Optional venue fragment. Twilio A2P separate eng task.

C2 · Age gate (recipient) PRD §8.2 step 2

9:41 · Safari

logo

Pour it Forward

working wordmark · TEMPORARY

You’ve got a tab

Confirm you’re 21+ to claim.

I am 21 or older.

Links: ToS · Privacy

Continue

Block if unchecked. Store age_gate_recipient_at.

Hard 21+ gate on claim. No under-21 path.

C3 · Phone OTP PRD §8.2 step 4 · soft auth

9:41

←

Verify it’s you

OTP

Enter the code we texted

Sent to +1 ••• ••• 4567 (must match gifted phone).

Verify Resend code

Prevents random link forwards from provisioning cards to strangers.

OTP or magic link (EngBot 4.1). Fail → retry + support. Recommended before provision.

C4 · Gift summary PRD §8.2 step 3

9:41

←

Your gift

summary

Available to spend

$48.00

Includes tip buffer · open-loop Visa/MC

FromAlex

SuggestedHarbor & Rye

Expiresin 6d 14h

Message

“Happy hour’s on me tonight 🍻”

Continue to claim See venues →

Show load, message, suggested venue, expiry countdown. Soft venue — not spend lock.

C5 · Claim CTA PRD §8.2 step 5

9:41

←

Claim tab

claim

Ready to add your card?

We’ll create a virtual Visa/Mastercard and walk you through adding it to Wallet. Staff just sees a normal tap.

Balance$48.00

Spend TTL~30 days after claim

Claim & get my card

On tap → issuer provision · status=claimed · then Wallet how-to.

Loading/spinner state while issuer API runs. Fail → C-E3 provisioning error.

C6 · Wallet how-to · iOS Apple Wallet

9:41 · iOS

Add to Apple Wallet

iOS

iPhone

Android

＋ Add to Apple Wallet

How to pay at the bar

Double-click the side button to open Wallet.

Select your Pour it Forward card (or Face ID if default).

Hold near the POS reader — tap. It’s a card.

[ placeholder: side-button → Wallet → tap illustration ]

I’ve added it — show balance

Platform detect → iOS tab default. Real provisioning button via issuer SDK / Apple Pay webhook. Screenshots later from DesignBot.

C7 · Wallet how-to · Android Google Wallet

9:41 · Chrome

Add to Google Wallet

Android

iPhone

Android

＋ Add to Google Wallet

How to pay at the bar

Open Google Wallet (or lock-screen payment shortcut).

Select your Pour it Forward virtual card.

Hold phone to NFC reader — wait for confirmation.

NFC tip

Keep NFC on. Case/metal wallets can block tap.

[ placeholder: Google Wallet add + NFC tap ]

I’ve added it — show balance

Android NFC tips matter for support load. Push Wallet-add success metric (pilot ≥80%).

C8 · Balance / success PRD §8.2 steps 7–8

9:41

logo

Pour it Forward

working wordmark · TEMPORARY

Card ready

$48.00

···· 4242 · Visa virtual

Active

ExpiresOct 21

SuggestedHarbor & Rye

WalletAdded ✓

Browse venues Show Wallet how-to again Need help?

Show last-4, balance, expiry, venue CTA. Token stays valid for re-open until expire/burn.

Claim — errors & edge cases

Expired link, already claimed, OTP fail, provisioning fail, desktop warning

C-E1 · Expired link

9:41

⏱

This gift expired

Claim window ended. If unclaimed, the sender should get a refund. Ask them to resend if needed.

Need help?

status=expired. No provision.

C-E2 · Already claimed

9:41

Already claimed

This gift was claimed on another device. If that’s you, open the original link or check Wallet.

Claimed

Balance$48.00

Continue to balance / how-to This wasn’t me → support

OTP should still gate sensitive actions. Show status, don’t re-issue card blindly.

C-E3 · Provisioning fail

9:41

Couldn’t create card

Issuer provisioning failed. Your gift is still reserved — try again or contact support with gift ID.

Retry Need help? · gift gft_8K2m

Biggest tech risk. Support path + retry. Don’t mark depleted.

C-E4 · Desktop on claim

Desktop browser

Open this on your phone

Apple Wallet / Google Wallet add works from your phone (Safari iOS or Chrome Android).

SMS yourself this link

https://pif.app/c/x7k9…

Text me the link

[ QR of claim URL — optional nice-to-have ]

Desktop send OK; claim/Wallet add is mobile. Detect UA / coarse pointer.

C-ST · Recipient status stubs

9:41

My tab

recipient

States (stubs)

Paid · waiting for you to claim

Claimed · add to Wallet

Active · $32.40 left · ····4242

Expired · card deactivated

Refunded · to sender

Support

Lightweight — not a full banking app.