Skip to content
Multi-Pass Distribution

Pass bundling to deliver multiple Wallet passes in one save

Package up to 10 related Apple Wallet (.pkpasses) and Google Wallet passes into a single delivery—so customers add a membership card, welcome voucher, or full group ticket order in one flow.

  • AUTO template & Linked Templates grouping
  • MANUAL named bundles up to 10 passes
  • Native .pkpasses & Google Multi-Save JWT
  • Custom order, pack void/renew & merged PDF
Works on:
Apple WalletApple WalletGoogle WalletGoogle Wallet
Multi-Pass Bundle
3 linked passes • 1 save flow
01Membership Card
Club Atelier Gold
Points: 1,240 • Active
MEM-4082
MIME: application/vnd.apple.pkpassesLead card
02Welcome Voucher
Welcome Gift -€15
Single-use • Independent sync
OFF-9120
03VIP Access Pass
Private Preview Pass
Valid 30 days • Transferable
VIP-2214
1-tap Add All Passes on iOS
Max 10 passes/bundle
Overview

Sending separate links or QR codes for every pass creates friction at checkout and check-in. Pass bundling lets teams group up to 10 related credentials—like a membership card paired with a welcome voucher, multi-seat event tickets with parking, or a hotel check-in pass with spa access—into a single customer save flow.

Choose AUTO mode via template bundling flags (bundleEnabled, bundleOnDownload) and Wallet Experience Linked Templates ordered by bundlingOrder, or assemble MANUAL named packs through the dashboard and REST API (/api/v1/bundles/upsert). Inside the customer's wallet, each pass still retains its own serial number, barcode, and independent APNs or Google Wallet live updates.

AUTO & MANUAL Bundling

Enable template bundling (bundleEnabled / Linked Templates) for automatic packs or compose named bundles via Dashboard and REST API.

Apple .pkpasses & Google Multi-Save

Stream native application/vnd.apple.pkpasses bundles for Safari/iPhone or generate one signed Google Wallet link for all objects.

Custom Order & Merged PDF

Control which pass appears first via define-order and export a merged printable PDF pack via GET /bundles/{id}/print-pdf.

Independent Sync & Pack Actions

Update points, tiers, or dates on each pass separately via APNs/Google, or atomically renew or void the entire pack.

1–10
Passes per bundle
.pkpasses
Native Apple archive
Multi-JWT
Google Save link
print-pdf
Merged PDF backup
Interactive Bundle Explorer

Inspect how real multi-pass packs assemble & sync

Auto-bundle a member card with a welcome voucher so new members save both credentials in a single tap.

AUTOClick any pass in the bundle order
3/10 passes
Club Atelier Gold (MEM-4082): Each pass keeps its own template fields, barcode, APNs/Google update push, and scan telemetry—updating one pass never alters the other cards in the bundle.
# 1) Group up to 10 passes into one ordered bundle
curl -X POST "https://api.passinstance.com/api/v1/bundles/upsert" \
  -H "X-API-Key: $PASSINSTANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "passes": [
      "b1d972dc-eccf-4f87-ab21-25939d9213d8",
      "c2e083ed-fddf-4a98-bc32-36040e0324e9"
    ],
    "bundleId": "e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b"
  }'

# 2) Download Apple .pkpasses (application/vnd.apple.pkpasses)
curl -L -X GET "https://api.passinstance.com/api/v1/bundles/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b/download" \
  -H "X-API-Key: $PASSINSTANCE_API_KEY" -o pass-bundle.pkpasses
Streams signed .pkpasses bundle; iPhone prompts once to add all cards.Bundle API reference
Apple Wallet

Delivered as a .pkpasses archive with up to 10 signed .pkpass files.

Google Wallet

Delivered via one signed JWT Save URL adding the full set on Android.

Capabilities

What you launch with in production

01

Auto template & Linked Template bundling

Turn on bundleEnabled / bundleOnDownload or link secondary templates inside a Wallet Experience (AUTO mode) so new passes join the customer's pack automatically.

02

Named MANUAL bundles via UI or API

Compose custom bundles up to 10 passes using POST /api/v1/bundles or idempotent POST /api/v1/bundles/upsert for orders, reservations, and partner campaigns.

03

Native Apple Wallet .pkpasses stream

Deliver a signed multi-pass archive (application/vnd.apple.pkpasses) from /api/v1/bundles/{id}/download so iPhone users install the entire pack with one confirmation prompt.

04

Google Wallet multi-object save links

Generate one signed multi-pass JWT link (/api/v1/bundles/{id}/google-wallet-link or ?platform=google) so Android users add every grouped pass together.

05

Deterministic display ordering

Configure bundlingOrder per template or call POST /api/v1/bundles/{id}/define-order to ensure the lead membership card or primary ticket always opens first.

06

Atomic attach, detach & unbundle

Add passes (assign-passes), remove individual cards (remove-passes), or split an entire group (unbundle) while keeping every underlying pass record intact.

07

Merged printable PDF packs

Export all passes in a bundle as a single ready-to-print PDF via GET /api/v1/bundles/{id}/print-pdf for front-desk packets, concierge desks, or offline backups.

08

Independent per-pass Wallet updates

Update points, tiers, or balances on one card inside the bundle via Apple APNs and Google Wallet without re-issuing or touching sibling passes in the pack.

09

Pack-wide void, renew & batch controls

Renew expiration across every bundled pass (/renew), void cancelled group bookings (/void), automate batch creation/updates, and read bundle telemetry (/stats).

FAQ

Frequently asked questions

What is a pass bundle and how many passes can it hold?

A pass bundle is a named or template-driven group of 1 to 10 Apple Wallet or Google Wallet passes for a customer flow—such as a membership card with a welcome voucher or a multi-ticket booking—distributed through one download or Save link.

How do Apple (.pkpasses) and Google Wallet deliver bundles?

On iOS, Passinstance streams a signed application/vnd.apple.pkpasses bundle so Safari lets customers add all passes together. On Android, Google Wallet uses a single signed multi-object Save URL (/google-wallet-link) covering the grouped passes without needing an app.

Do bundled passes still update and scan individually?

Yes. Bundling streamlines initial distribution, but inside Apple Wallet and Google Wallet each pass keeps its own serial number, barcode, scan telemetry, and independent live push updates.

Can we control pass order or modify a bundle after it is created?

Yes. Use template bundlingOrder or POST /api/v1/bundles/{id}/define-order to set sequence, call assign-passes / remove-passes to edit membership, or run unbundle and DELETE /bundles/{id} without deleting individual passes.

Can an entire group order be renewed or voided in one step?

Yes. POST /api/v1/bundles/{id}/renew extends validity across every pass in the bundle and syncs wallets, while POST /api/v1/bundles/{id}/void marks all passes voided when a booking is cancelled.

Can we offer a printable backup alongside mobile wallets?

Yes. Calling GET /api/v1/bundles/{id}/print-pdf compiles every pass in the bundle into a single printable PDF, useful for hospitality check-in desks, concierge packs, and email attachments.

Deliver complete multi-pass packs in one customer save

Start free and orchestrate Apple .pkpasses bundles and Google Wallet multi-save links with zero separate app required.