Skip to content
Distribuzione multi-pass

Raggruppamento di pass per consegnare fino a 10 tessere Wallet insieme

Unisci fino a 10 pass Apple Wallet (.pkpasses) e Google Wallet in un'unica consegna per far salvare tessera socio, buono di benvenuto o biglietti di gruppo con un solo gesto.

  • Modalità AUTO da template e collegati
  • Pacchetti MANUAL fino a 10 pass
  • .pkpasses iOS nativo e link Google Multi-Save
  • Ordine personalizzato, revoca/rinnovo e PDF
Compatibile con:
Apple WalletApple WalletGoogle WalletGoogle Wallet
Pacchetto multi-pass
3 pass collegati • 1 salvataggio
01Tessera Socio
Club Atelier Gold
Punti: 1.240 • Attiva
MEM-4082
MIME: application/vnd.apple.pkpassesPrincipale
02Buono Benvenuto
Omaggio Benvenuto -15 €
Uso singolo • Sync autonomo
OFF-9120
03Pass VIP
Accesso Anteprima
Valido 30 gg • Trasferibile
VIP-2214
Aggiunta multipla in 1 tap (iOS)
Max 10 pass/pacchetto
Panoramica

Inviare link o codici QR separati per ogni pass crea attrito al checkout e all'ingresso. Il raggruppamento consente di riunire fino a 10 pass correlati — tessera associativa con coupon di benvenuto, biglietti multi-posto con parcheggio o soggiorno hotel + accesso spa — in un unico salvataggio.

Attiva la modalità AUTO tramite le opzioni del template (bundleEnabled, bundleOnDownload, bundlingOrder) oppure componi pacchetti MANUAL da dashboard e API REST (/api/v1/bundles/upsert). Nel Wallet del cliente ogni pass conserva numero di serie, codice a barre e aggiornamenti push APNs/Google indipendenti.

Modalità AUTO e MANUAL

Raggruppamento automatico per template (bundleEnabled / Linked Templates) o manuale tramite dashboard e API REST.

Apple .pkpasses e Google Multi-Save

Flusso nativo application/vnd.apple.pkpasses su iOS o un singolo URL JWT firmato di Google Wallet su Android.

Ordine personalizzato e PDF

Imposta il pass principale con define-order ed esporta il pacchetto in PDF con GET /bundles/{id}/print-pdf.

Sync per pass e azioni di gruppo

Aggiorna punti e stati singolarmente via APNs/Google oppure rinnova/annulla tutto il pacchetto.

1–10
Pass per pacchetto
.pkpasses
Archivio nativo Apple
Multi-JWT
Link Google Save
print-pdf
PDF unificato
Esplora pacchetti interattivi

Scopri come vengono assemblati e sincronizzati i pacchetti reali

Unisci automaticamente tessera socio e buono di benvenuto in un unico salvataggio rapido.

AUTOSeleziona un pass nell'ordine del pacchetto
3/10 pass
Club Atelier Gold (MEM-4082): Ogni pass mantiene campi dedicati, codice a barre, notifiche push APNs/Google e statistiche di scansione indipendenti.
# 1) Raggruppa fino a 10 pass in un pacchetto ordinato
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) Scarica archivio .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
Invia un archivio .pkpasses firmato per aggiungere tutti i pass su iPhone.Vai all'API Bundles
Apple Wallet

Consegnato come archivio .pkpasses con fino a 10 file .pkpass firmati.

Google Wallet

Consegnato tramite un URL JWT firmato che salva l'intero gruppo su Android.

Funzionalità

Tutto per distribuire le tue carte Wallet in produzione

01

Raggruppamento AUTO per template ed esperienze

Abilita bundleEnabled / bundleOnDownload o collega template secondari in una Wallet Experience per creare automaticamente il pacchetto cliente.

02

Pacchetti MANUAL nominativi via UI e API

Componi pacchetti fino a 10 pass tramite POST /api/v1/bundles o /api/v1/bundles/upsert per ordini, prenotazioni e campagne.

03

Archivio nativo Apple Wallet .pkpasses

Trasmetti un file firmato application/vnd.apple.pkpasses tramite GET /api/v1/bundles/{id}/download per aggiungere l'intero set su iPhone con un tap.

04

Link multi-salvataggio Google Wallet

Genera un unico URL JWT firmato (/api/v1/bundles/{id}/google-wallet-link o ?platform=google) per salvare tutti i pass del gruppo su Android.

05

Ordinamento deterministico dei pass

Imposta bundlingOrder o chiama POST /api/v1/bundles/{id}/define-order affinché la tessera principale o il primo biglietto compaia sempre in testa.

06

Aggiunta, rimozione e separazione atomica

Collega pass (assign-passes), rimuovi singole tessere (remove-passes) o sciogli il gruppo (unbundle) senza cancellare i record individuali.

07

PDF unificato pronto per la stampa

Esporta tutti i pass del pacchetto in un unico PDF tramite GET /api/v1/bundles/{id}/print-pdf per reception, concierge o copia cartacea.

08

Aggiornamenti indipendenti per singolo pass

Aggiorna punti, livelli o crediti su un solo pass tramite APNs e Google Wallet senza toccare gli altri pass inclusi nel pacchetto.

09

Rinnovo, revoca e azioni batch su tutto il set

Proroga la scadenza (/renew), annulla prenotazioni di gruppo (/void), gestisci operazioni batch e monitora le statistiche (/stats).

FAQ

Domande frequenti

Cos'è un pacchetto di pass e quanti pass può contenere?

È un gruppo nominativo o automatico da 1 a 10 pass Apple Wallet o Google Wallet destinati allo stesso flusso cliente, consegnato con un solo download o link di salvataggio.

Come gestiscono i pacchetti Apple (.pkpasses) e Google Wallet?

Su iOS Passinstance invia un archivio firmato .pkpasses che Safari installa in blocco. Su Android un unico URL JWT firmato di Google Wallet aggiunge tutti i pass senza alcuna app.

I pass raggruppati si aggiornano e si scansionano comunque singolarmente?

Sì. Il pacchetto semplifica la distribuzione iniziale, ma nel Wallet ogni pass mantiene il proprio seriale, codice a barre, telemetria e notifiche push autonome.

Possiamo cambiare l'ordine o modificare un pacchetto dopo la creazione?

Sì. Usa define-order per la sequenza, assign-passes / remove-passes per aggiornare i pass, oppure unbundle e DELETE /bundles/{id} lasciando intatti i singoli pass.

Si può rinnovare o annullare un intero ordine di gruppo in una chiamata?

Sì. POST /api/v1/bundles/{id}/renew estende la validità su tutti i pass e sincronizza i Wallet, mentre POST /api/v1/bundles/{id}/void li invalida tutti in caso di cancellazione.

È disponibile anche un PDF stampabile per l'intero pacchetto?

Sì. GET /api/v1/bundles/{id}/print-pdf genera un unico file PDF con tutti i pass del pacchetto per reception, desk eventi o allegati e-mail.

Consegna pacchetti multi-pass completi in un solo clic

Inizia gratis e gestisci archivi Apple .pkpasses e link Google Multi-Save senza app dedicate.