Comparaison architecturale : Apple Wallet vs Google Wallet
Bien que Passinstance unifie la conception des modèles et l'API REST pour masquer la complexité propre à chaque fournisseur, Apple Wallet et Google Wallet reposent sur des modèles techniques profondément différents en matière d'empaquetage, de mise en page, de synchronisation et de comptabilisation des appareils :
Matrice technique comparative détaillée
| Fonctionnalité / Contrainte technique | Apple Wallet (iOS & watchOS) | Google Wallet (Android) | Samsung Wallet (sur accès partenaire) |
|---|---|---|---|
| Artefact de distribution | Archive ZIP signée .pkpass (application/vnd.apple.pkpass) | Lien JWT Save signé RS256 (https://pay.google.com/gp/v/save/<jwt>) + Objet REST cloud | Référence de carte partenaire (samsungWalletCardId, samsungWalletRefId) |
| Sérialisation des couleurs | Doit utiliser rgb(r, g, b) (les codes hexadécimaux et canaux alpha sont rejetés par iOS) | Hexadécimal #RRGGBB (hexBackgroundColor) | Hexadécimal #RRGGBB |
| Zones de mise en page | 6 zones distinctes : header, primary, secondary, auxiliary, back, footer | Sections verticales : cardTitle, subheader, header, textModulesData (lignes), linksModuleData | Emplacements définis par le modèle constructeur |
| HTML / Liens cliquables | Autorisés uniquement dans backFields via attributedValue (balises <a href="..."> seules) | Affichés via le tableau dédié linksModuleData.uris (uri, description) | Champs de liens dédiés |
| Protocole de mise à jour & push | En 2 temps : push silencieux APNs HTTP/2 ({}, max 4096 octets) réveillant l'iPhone pour appeler GET /v1/passes/... | En 1 temps : le serveur exécute un PATCH REST sur walletobjects/v1/... ; Google Play Services pousse sur le téléphone | API REST fournisseur |
| Déclencheur d'alerte écran verrouillé | Modification de la valeur d'un champ définissant changeMessage: "... %@" | notifyPreference: "NOTIFY_ON_UPDATE" ou addMessage (TEXT_AND_NOTIFY, max 3 par 24 h) | Non activé comme canal push principal |
| Comptage des passes actifs | Par deviceLibraryIdentifier enregistré (1 iPhone + 1 Apple Watch jumelée = 2 enregistrements) | Dédupliqué par <issuerId>.<objectId> unique sur tous les appareils Android d'un même compte Google | Lié au compte lorsque pris en charge |
| Géofencing & iBeacons | Jusqu'à 10 coordonnées GPS (locations) + jusqu'à 10 iBeacons BLE (beacons) par .pkpass | Jusqu'à 10 coordonnées GPS sur Class/Object (locations, sujet aux restrictions récentes des Google Play Services) | Selon l'appareil |
| Télémétrie de suppression | Appel immédiat DELETE /v1/devices/:deviceLibId/registrations/... au retrait de Cartes | Appel immédiat POST /api/v1/wallet/callback avec eventType: "del" | Télémétrie limitée |
| Protocole sans contact NFC | Apple VAS (ISO/IEC 14443 Type A/B, ECDH P-256, droit NFC Apple requis) | Google Smart Tap (NFC_SMART_TAP, collectorId, ECDH P-256) | Non pris en charge |
Important : Ne considérez pas Samsung Wallet comme strictement équivalent à Apple Wallet et Google Wallet sur toutes les régions et tous les espaces de travail. Bien que
Passinstance APIgère les champs de schéma (samsungWalletCardId,samsungWalletRefId), Samsung Wallet requiert un onboarding partenaire par pays — consultez Portée du support Samsung Wallet pour vérifier votre éligibilité.
Règles de mise en page & de sérialisation propres aux plateformes
1. Conversion des couleurs & respect du contraste
L'analyseur PassKit d'Apple rejette toute archive .pkpass dès lors que backgroundColor, foregroundColor ou labelColor contient un code hexadécimal #RRGGBB ou un canal alpha rgba(). Passinstance stocke des modèles de couleurs normalisés (Color) et sérialise automatiquement en rgb(r, g, b) pour les paquets Apple .pkpass tout en générant du #RRGGBB pour les classes Google Wallet.
2. Restrictions des liens HTML dans attributedValue
Dans Apple Wallet, les liens hypertextes cliquables, numéros de téléphone (tel:) et adresses e-mail (mailto:) ne fonctionnent qu'au verso de la carte (backFields) via la propriété attributedValue. Apple supprime toute balise HTML autre que <a href="...">...</a>. Dans Google Wallet, Passinstance transpose ces liens dans la section structurée linksModuleData en bas de la vue défilante :
{
"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. Comptage multi-appareils (iPhone + Apple Watch)
Lorsqu'un utilisateur iPhone possédant une Apple Watch jumelée installe une carte Apple Wallet, iOS et watchOS enregistrent chacun un deviceLibraryIdentifier et un pushToken APNs distincts sur POST /v1/devices/.../registrations/.... Passinstance suit séparément installedDevices (nombre total de points d'envoi push) et uniqueDevices dans le tableau de bord Analytics afin de distinguer vos titulaires uniques des installations multi-appareils.
Consultez Apple Wallet, Google Wallet et Design & configuration des modèles pour optimiser vos mises en page.
