Skip to content
STAMP PASS GUIDE

Stamp collection rules: automated punch cards in Apple Wallet & Google Wallet

Replace paper punch cards and manual image exports with deterministic stamp grids, built-in duplicate-scan cooldowns, 720 × 720 px custom icons, and automatic post-reward cycles.

1 to 50 stamps per card cycle
Duplicate scan cooldown (minutes)
3 / 4 / 5 column auto-composed grids
Reset, keep completed, or start cycle
Interactive Stamp Simulator
Apple Wallet4 × 2CR-00124 · 2030-12-31
After reward completionCompleted cycles: 0
Apple Wallet strip auto-composed per scan

WHY STAMP COLLECTION RULES ARE NEEDED

Why manual stamp images and paper punch cards fail at scale

Stamp Pass rules bind scan math, artwork composition, daily limits, and post-reward lifecycle transitions to one verifiable template—eliminating counter errors and manual art exports.

01

Paper punch cards get lost, forged, or forgotten before redemption

Physical punch cards stay in wallets or drawers while ink stamps give stores zero audit trail, zero duplicate-scan checks, and zero push re-engagement.

02

Maintaining separate artwork for 1/8, 2/8, ..., 8/8 stamps does not scale

Without a dynamic stamp composer, updating your coffee icon or changing a 10-stamp card to 8 stamps requires regenerating every individual state image manually.

03

Unconstrained scans lead to accidental double-punches and dead-end rewards

Without per-day validation caps, duplicate scan cooldowns, and post-reward cycle rules, staff can double-stamp a single purchase or stall a customer on a completed card.

Without automated stamp rules
  • Static images require manual re-exports for every stamp count change
  • No protection against rapid duplicate QR scans at busy counters
  • Manual staff bookkeeping to decide when a card resets or begins a new cycle
  • Disconnected paper cards with no lock-screen progress updates
With Passinstance Stamp collection rules
  • Server-side stamp image composer draws filled, empty, and reward slots live on every pass
  • Configurable 3, 4, or 5 column layout with live size, alignment, shape, and contrast controls
  • Built-in duplicate scan cooldown (minutes), max-stamp cap, and daily validation limits
  • Automatic post-reward Reset stamps, Keep completed, or Start new cycle handling

COLLECTION & REWARD MECHANICS

Three validation behaviors and three completion modes

Whether cashiers punch forward toward a free reward, deduct prepaid visit punches, or update balances from a POS webhook, Stamp Pass rules enforce the full lifecycle.

Most common

Add stamps

Each validated scan increments the holder's stamp count by Stamps per validation up to the Stamps required target.

STAMP_CARD_ADD
Redemption mode

Deduct stamps

Each scan subtracts stamps from a preloaded or earned stamp balance while blocking scans below minimum zero balance.

STAMP_CARD_DEDUCT
Manual / API

No automatic change

Validation scans verify the pass without auto-mutating stamps; adjustments happen explicitly via Studio or API integrations.

NO_AUTOMATIC_CHANGE

After reward completion

Reset stamps

Once the reward is claimed, the card resets cleanly to zero stamps so the customer starts collecting again on the same pass.

Keep completed

Keeps every slot filled and marks the pass as complete—ideal for finite challenges, event series, or one-time punch cards.

Start new cycle

Automatically launches a fresh collection cycle immediately after reward completion while recording completed cycles in the ledger.

STEP-BY-STEP CONFIGURATION

How to configure Stamp collection rules in Passinstance Studio

Follow these six steps inside Stamp Pass -> Stamp collection rules and inspect both Studio tabs below.

1

Open Stamp Pass -> Stamp collection rules

In Passinstance Studio, open Points & Tiers -> Stamp Pass (using a strip-enabled pass type such as Store Card, Coupon, or Event Ticket) to configure Collection & rewards, Wallet & assets, and Advanced settings.

2

Pick Validation behavior & target math

Select Add stamps, Deduct stamps, or No automatic change, then enter Stamps required (1 to 50), Start with (e.g. 0), and Stamps per validation (e.g. 1).

3

Configure Reward behavior & After reward completion

Enter a clear Reward name and Reward description, and choose Reset stamps, Keep completed, or Start new cycle once a full card is claimed.

4

Style the grid in Wallet & assets

Switch to Wallet & assets to set Grid columns (3, 4, or 5 columns), Stamp size (36px–72px), Grid alignment (Left, Center, Right, Auto), Auto-match stamp slot backgrounds, and Use pass background behind stamps.

5

Upload optional Stamp icon & Reward icon (720 × 720 px)

Upload custom transparent PNG/SVG brand artwork for earned stamps and the final reward slot—or leave them optional to use Studio's crisp built-in icons.

6

Enforce limits in Advanced settings & test live

Toggle Do not exceed required stamps, Allow multiple validations per day, and set Duplicate scan protection (default 5 minutes) before publishing and scanning a live Wallet pass.

INSIDE PASSINSTANCE STUDIO

Collection & rewards — validation mode, stamp target & post-reward behavior

1 / 2
Dashboard view1 / 2
Key UI elements

Collection & rewards — validation mode, stamp target & post-reward behavior

Configure how scans affect balances (Add stamps, Deduct stamps, or No automatic change), set 8 Stamps required, name your reward, and pick Reset stamps, Keep completed, or Start new cycle.

REAL WALLET OUTPUTS

One stamp pass configuration, rendered cleanly in Apple Wallet & Google Wallet

Upload your stamp icons once in Studio. Passinstance automatically generates native strip compositions on iPhone and Android hero cards on every scan.

Apple Wallet Stamp Card

iOS · PassKit

Renders the composite coffee strip banner above member ID and expiry fields with a crisp scannable QR code.

StoreCard strip banner compositionInstant APNs pass refresh

Google Wallet Stamp Card

Android · Loyalty API

Positions the QR code, stamp counter, member ID, and validity date up front, paired with the dynamic hero stamp graphic below.

Hero stamp graphic syncUp-front QR & balance counter

GUARDRAILS & ADVANCED SETTINGS

Built-in scan protection, layout limits, and balance checks

Expand Advanced settings inside Stamp collection rules to prevent abuse at busy checkout counters while keeping visual rendering uniform on Apple Wallet and Google Wallet.

Range 1–50 stamps

Do not exceed required stamps

Prevents scans from pushing stored stamp counts past Stamps required (`MAXIMUM_EXCEEDED`), keeping wallet grid progress clean.

Default: single/day

Once-per-day or multi-scan toggle

Keep Allow multiple validations per day off to restrict holders to one stamp per calendar day, or turn it on for high-frequency cafes and orders.

Default: 5 minutes

Duplicate scan protection window

Configurable cooldown in minutes (5 minutes by default) blocks unintentional back-to-back camera scans of the same pass at checkout.

3 / 4 / 5 columns

Deterministic Wallet banner composer

Computes active, inactive, and final reward slot coordinates automatically on your strip/poster artwork across Apple Wallet and Google Wallet.

Fine layout controls

Advanced shape, spacing & slot placement

Fine-tune Stamp shape (Circle, Square, Rounded), Stamp spacing (2–24px), Background separation opacity (0–60%), fixed Rows, or custom Reward slot position.

Atomic ledger guard

Non-negative deduct validation

In Deduct stamps mode, scans with fewer stamps than requested reject safely with `INSUFFICIENT_BALANCE` instead of dropping below zero.

FREQUENTLY ASKED QUESTIONS

Stamp collection rules FAQ

How many stamps can a Passinstance Stamp Pass hold?

Stamp Pass cards support 1 to 50 total stamps per cycle (`Stamps required`) and 1 to 10 stamps per validation scan, arranged across 3, 4, or 5 visual columns in Studio.

Which wallet pass types support custom Stamp icons and banner grids?

Visual stamp strips render on pass types with strip image slots—Store Card, Coupon, and Event Ticket—as well as supported poster variants, across both Apple Wallet and Google Wallet.

Do I have to upload custom Stamp icon and Reward icon files?

Both Stamp icon and Reward icon are optional. When uploaded (recommended 720 × 720 px transparent PNG/SVG), Passinstance stamps them into each active and reward slot; if omitted, clean default stamp and reward icons are generated automatically.

What is the difference between Reset stamps, Keep completed, and Start new cycle?

Reset stamps empties collected slots back to Start with when the reward is redeemed; Keep completed leaves the card full and marked finished; Start new cycle begins the next stamp card cycle automatically for ongoing repeat loyalty.

How does Passinstance prevent double-stamping when staff scan a phone twice?

Under Advanced settings, Duplicate scan protection blocks repeat scans of the same pass for your configured cooldown (default 5 minutes), and keeping Allow multiple validations per day off caps earning at one validation per day.

Build your Stamp Pass template in Passinstance Studio

Start free, customize your 3/4/5-column stamp grid and 720 × 720 px icons, and test Apple Wallet & Google Wallet scans immediately.