Skip to content
Guide du centre d'aide · Intégrations Wallet
4 min de lectureVérifié 2026-11-16

Différences & limites des plateformes

Comparez Apple Wallet, Google Wallet et Samsung Wallet sur les notifications, le géofencing et les emplacements.

Dans ce guide

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 :

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
SÉRIALISATION DOUBLE WALLET & DIVERGENCES DE SYNCHRO
ÉTAPE 01 MODÈLE & ENREGISTREMENT PASSINSTANCE UNIFIÉ
Schéma de modèle unique + Attributs dynamiques + Moteur d'état des mécaniques
Sérialiseur Apple Wallet
ÉTAPE 02A
Artefact : archive ZIP .pkpass signée
Couleurs : format strict rgb(r, g, b)
Mise en page : Recto fixe + Verso
Texte riche : balises <a> au Verso
Synchro : Push vide APNs {}Pull
Comptage : par appareil (iPhone+Watch)
Sérialiseur Google Wallet
ÉTAPE 02B
Artefact : Class + Object cloud
Couleurs : hexadécimal #RRGGBB
Mise en page : Vue verticale
Texte riche : `Google Wallet links
Synchro : PATCH REST cloud direct
Comptage : par objet unique

Matrice technique comparative détaillée

Fonctionnalité / Contrainte techniqueApple Wallet (iOS & watchOS)Google Wallet (Android)Samsung Wallet (sur accès partenaire)
Artefact de distributionArchive ZIP signée .pkpass (application/vnd.apple.pkpass)Lien JWT Save signé RS256 (https://pay.google.com/gp/v/save/<jwt>) + Objet REST cloudRéférence de carte partenaire (samsungWalletCardId, samsungWalletRefId)
Sérialisation des couleursDoit 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 page6 zones distinctes : header, primary, secondary, auxiliary, back, footerSections verticales : cardTitle, subheader, header, textModulesData (lignes), linksModuleDataEmplacements définis par le modèle constructeur
HTML / Liens cliquablesAutorisé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 & pushEn 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éphoneAPI 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 actifsPar 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 GoogleLié au compte lorsque pris en charge
Géofencing & iBeaconsJusqu'à 10 coordonnées GPS (locations) + jusqu'à 10 iBeacons BLE (beacons) par .pkpassJusqu'à 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 suppressionAppel immédiat DELETE /v1/devices/:deviceLibId/registrations/... au retrait de CartesAppel immédiat POST /api/v1/wallet/callback avec eventType: "del"Télémétrie limitée
Protocole sans contact NFCApple 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 API gè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 :

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. 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.

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.