Confronto architetturale: Apple Wallet vs. Google Wallet
Sebbene Passinstance fornisca un editor unificato dei modelli e una REST API che astrae la complessità delle piattaforme, Apple Wallet e Google Wallet differiscono profondamente a livello di sistema operativo nel modo in cui i pass vengono impacchettati, stilizzati, aggiornati e conteggiati:
Matrice comparativa tecnica dettagliata
| Funzionalità / Vincolo tecnico | Apple Wallet (iOS & watchOS) | Google Wallet (Android) | Samsung Wallet (Accesso partner) |
|---|---|---|---|
| Artefatto di consegna | Archivio ZIP .pkpass firmato (application/vnd.apple.pkpass) | URL Save JWT firmato RS256 (https://pay.google.com/gp/v/save/<jwt>) + Oggetto Cloud REST | Riferimento tessera vincolato a partner (samsungWalletCardId, samsungWalletRefId) |
| Serializzazione colori | Deve essere rgb(r, g, b) (hex e canali alfa rifiutati da iOS) | Esadecimale #RRGGBB (hexBackgroundColor) | Esadecimale #RRGGBB |
| Zone layout dei campi | 6 zone distinte: header, primary, secondary, auxiliary, back, footer | Sezioni verticali: cardTitle, subheader, header, textModulesData (righe), linksModuleData | Slot modello del vendor |
| HTML / Link cliccabili | Consentiti solo nei backFields tramite attributedValue (esclusivamente tag <a href="...">) | Renderizzati tramite array dedicato linksModuleData.uris (uri, description) | Campi link dedicati |
| Protocollo aggiornamenti e push | A due fasi: push silenzioso HTTP/2 APNs (payload {}, max 4096 byte) risveglia iPhone per scaricare GET /v1/passes/... | A fase singola: il server esegue PATCH REST su walletobjects/v1/...; Google Play Services aggiorna il telefono | REST API del provider |
| Trigger avvisi lock-screen | Il valore cambia su un campo con changeMessage: "... %@" | notifyPreference: "NOTIFY_ON_UPDATE" oppure addMessage (TEXT_AND_NOTIFY, max 3 ogni 24h) | Non abilitato come canale push primario |
| Conteggio pass attivi | Per deviceLibraryIdentifier registrato (1 iPhone + 1 Apple Watch abbinato = 2 registrazioni) | Deduplicato per singolo <issuerId>.<objectId> su tutti i dispositivi Android connessi allo stesso Account Google | Per account ove abilitato |
| Geofencing e Beacon | Fino a 10 coordinate GPS (locations) + fino a 10 BLE iBeacon (beacons) per .pkpass | Fino a 10 coordinate GPS su Class/Object (nota su locations: deprecato/limitato da Google nei Play Services più recenti) | Dipendente dal dispositivo |
| Telemetria eliminazione | Chiamata immediata DELETE /v1/devices/:deviceLibId/registrations/... alla rimozione dal Wallet | Chiamata immediata POST /api/v1/wallet/callback con eventType: "del" | Telemetria limitata |
| Protocollo NFC contactless | Apple VAS (ISO/IEC 14443 Tipo A/B, ECDH P-256, richiede entitlement NFC Apple) | Google Smart Tap (NFC_SMART_TAP, collectorId, ECDH P-256) | Non supportato |
Importante: Non consideri Samsung Wallet globalmente identico ad Apple Wallet e Google Wallet in ogni area geografica e workspace. Sebbene
Passinstance APImantenga campi di schema (samsungWalletCardId,samsungWalletRefId) per le integrazioni Samsung, Samsung Wallet richiede un onboarding abilitato tramite partner per singola area geografica — verifichi l'Ambito di supporto Samsung Wallet per i dettagli di idoneità.
Regole di design e payload specifiche per piattaforma
1. Conversione colori e verifica del contrasto
Il parser PassKit di Apple rifiuta gli archivi .pkpass se backgroundColor, foregroundColor o labelColor contengono una stringa esadecimale #RRGGBB o un canale alfa rgba(). Passinstance salva modelli colore normalizzati (Color) e serializza automaticamente rgb(r, g, b) nella generazione Apple .pkpass, emettendo al contempo #RRGGBB per le classi di Google Wallet.
2. Restrizioni sui tag anchor HTML in attributedValue
In Apple Wallet, collegamenti ipertestuali cliccabili, numeri di telefono (tel:) e link mailto: sono supportati esclusivamente sul retro del pass (backFields) usando la proprietà attributedValue. Apple rimuove tutti i tag HTML eccetto <a href="...">...</a>. Su Google Wallet, Passinstance mappa questi collegamenti nella sezione strutturata linksModuleData in fondo alla vista scorrevole del pass:
{
"appleBackField": {
"key": "website",
"label": "TERMS & CONDITIONS",
"value": "https://yourbrand.com/terms",
"attributedValue": "<a href=\"https://yourbrand.com/terms\">View Terms & Conditions</a>"
},
"googleLinksModule": {
"uris": [
{
"uri": "https://yourbrand.com/terms",
"description": "View Terms & Conditions",
"id": "link_terms"
}
]
}
}
3. Conteggi di registrazione multi-dispositivo (iPhone + Apple Watch)
Quando il proprietario di un iPhone con un Apple Watch abbinato installa un pass Apple Wallet, iOS e watchOS registrano ciascuno un deviceLibraryIdentifier e un pushToken APNs indipendenti presso POST /v1/devices/.../registrations/.... Passinstance traccia sia installedDevices (endpoint push totali) sia uniqueDevices nella Dashboard Analytics per distinguere i titolari unici dalle installazioni su più dispositivi.
Consulti Apple Wallet, Google Wallet e Design e configurazione dei modelli per le best practice di layout.
