# 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

1. **Create a pass** — choose a style, add your business name, fields, colors, and barcode
2. **Get a tracked link** — every pass auto-creates a short link with analytics enabled
3. **Share the link** — customers visit a landing page and tap "Add to Apple Wallet"
4. **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.