Apple Wallet Passes
Create Apple Wallet passes that customers can add to their iPhone or Apple Watch. Each pass gets a tracked short link with analytics.
How It Works
- Create a pass — choose a style, add your business name, fields, colors, and barcode
- Get a tracked link — every pass auto-creates a short link with analytics enabled
- Share the link — customers visit a landing page and tap "Add to Apple Wallet"
- Track everything — every visit to the link is counted in your analytics dashboard
Pass Styles
| Style | Use Case | Layout |
|---|---|---|
| Generic | Membership, claim tickets | Thumbnail + fields |
| Coupon | Discounts, offers | Strip image + primary field |
| Event Ticket | Concerts, movies, sports | Strip/background + fields |
| Store Card | Loyalty, gift cards | Strip image + fields |
| Boarding Pass | Flights, transit | Two primary fields + transit type |
Fields
Each pass can have up to 5 levels of fields:
- Header fields (max 3) — shown at top right, visible when pass is stacked
- Primary fields (max 2) — the big bold text in the center
- Secondary fields (max 4) — below primary
- Auxiliary fields (max 5) — below secondary
- Back fields (max 20) — scrollable back of pass (terms, details, links)
Barcodes
Supported formats: QR, Aztec, PDF417, Code 128. If you don't set a barcode, a QR code with your tracked short link is added automatically.
Tracked Links & Analytics
Every wallet pass auto-creates a tracked short link. The link points to a landing page where customers can preview the pass and tap "Add to Apple Wallet".
- Share the short link on social media, email, print materials, or QR codes
- Every click is tracked with referrer, device, browser, and location data
- View analytics in the Links section of your dashboard
- The barcode on the pass can also encode the tracked link
Pricing
$0.03 per pass created. No platform fee, no monthly minimum. Includes the tracked short link and analytics.
| Volume | Monthly Cost |
|---|---|
| 100 passes | $3.00 |
| 1,000 passes | $30.00 |
| 5,000 passes | $150.00 |
API
Create passes programmatically via the dashboard API or MCP tools.
MCP Tools
list-wallet-passes — List all passes
get-wallet-pass — Get pass details + tracked link
create-wallet-pass — Create a pass (auto-creates tracked link)
delete-wallet-pass — Delete a pass
Dashboard API
POST /:teamId/qr/wallet-passes Create pass
GET /:teamId/qr/wallet-passes List passes
GET /:teamId/qr/wallet-passes/:passId Get pass
PUT /:teamId/qr/wallet-passes/:passId Update pass
DELETE /:teamId/qr/wallet-passes/:passId Delete pass
Public Endpoints (no auth)
GET /api/wallet/:teamId/:passId/info Pass data for landing page
GET /api/wallet/:teamId/:passId/download Download signed .pkpass
Branding
All passes are issued under the CompactSaaS brand per Apple licensing terms. Your business name is displayed prominently via the logoText field. Custom logo and strip images can be uploaded from the image library.