Skip to content
Guida del Centro assistenza · Integrazioni Wallet
4 min di letturaVerificato 2026-11-16

Differenze e limiti di piattaforma

Confronta Apple Wallet, Google Wallet e Samsung Wallet su messaggi lock-screen, geofencing e zone campo.

In questa guida

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:

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
DIVERGENZE DI SERIALIZZAZIONE E SYNC DUAL-WALLET
FASE 01 MODELLO E RECORD PASS UNIFICATI PASSINSTANCE
Schema unico del modello + Attributi dinamici + Motore di stato meccaniche
Serializzatore Apple Wallet
FASE 02A
Artefatto: Bundle ZIP .pkpass firm.
Colori: Formato rgb(r, g, b) rigor.
Layout: Fronte fisso + Retro volt.
Testo ricco: tag <a> nei Back Field
Sync: Push vuoto APNs {}Pull
Conteggio: Per dispositivo (iPh+Watch)
Serializzatore Google Wallet
FASE 02B
Artefatto: Cloud Class+Object
Colori: Esadecimale #RRGGBB
Layout: Vista verticale scorrevole
Testo ricco: `Google Wallet links m
Sync: Cloud REST PATCH diretto
Conteggio: Per Pass Object univoco

Matrice comparativa tecnica dettagliata

Funzionalità / Vincolo tecnicoApple Wallet (iOS & watchOS)Google Wallet (Android)Samsung Wallet (Accesso partner)
Artefatto di consegnaArchivio ZIP .pkpass firmato (application/vnd.apple.pkpass)URL Save JWT firmato RS256 (https://pay.google.com/gp/v/save/<jwt>) + Oggetto Cloud RESTRiferimento tessera vincolato a partner (samsungWalletCardId, samsungWalletRefId)
Serializzazione coloriDeve essere rgb(r, g, b) (hex e canali alfa rifiutati da iOS)Esadecimale #RRGGBB (hexBackgroundColor)Esadecimale #RRGGBB
Zone layout dei campi6 zone distinte: header, primary, secondary, auxiliary, back, footerSezioni verticali: cardTitle, subheader, header, textModulesData (righe), linksModuleDataSlot modello del vendor
HTML / Link cliccabiliConsentiti solo nei backFields tramite attributedValue (esclusivamente tag <a href="...">)Renderizzati tramite array dedicato linksModuleData.uris (uri, description)Campi link dedicati
Protocollo aggiornamenti e pushA 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 telefonoREST API del provider
Trigger avvisi lock-screenIl 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 attiviPer deviceLibraryIdentifier registrato (1 iPhone + 1 Apple Watch abbinato = 2 registrazioni)Deduplicato per singolo <issuerId>.<objectId> su tutti i dispositivi Android connessi allo stesso Account GooglePer account ove abilitato
Geofencing e BeaconFino a 10 coordinate GPS (locations) + fino a 10 BLE iBeacon (beacons) per .pkpassFino a 10 coordinate GPS su Class/Object (nota su locations: deprecato/limitato da Google nei Play Services più recenti)Dipendente dal dispositivo
Telemetria eliminazioneChiamata immediata DELETE /v1/devices/:deviceLibId/registrations/... alla rimozione dal WalletChiamata immediata POST /api/v1/wallet/callback con eventType: "del"Telemetria limitata
Protocollo NFC contactlessApple 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 API mantenga 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:

JSON
{
  "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.

Documentazione prodotto e API correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.