Architekturvergleich: Apple Wallet vs. Google Wallet
Obwohl Passinstance einen einheitlichen Vorlagen-Designer und eine gemeinsame REST-API bereitstellt, um Plattformkomplexität zu abstrahieren, unterscheiden sich Apple Wallet und Google Wallet auf Betriebssystemebene grundlegend bei Paketierung, Styling, Aktualisierung und Kapazitätsmessung:
Detaillierte technische Vergleichsmatrix
| Funktion / Technische Grenze | Apple Wallet (iOS & watchOS) | Google Wallet (Android) | Samsung Wallet (Partner-gebunden) |
|---|---|---|---|
| Auslieferungs-Artefakt | Signiertes .pkpass-ZIP-Archiv (application/vnd.apple.pkpass) | RS256-signierte Save-JWT-URL (https://pay.google.com/gp/v/save/<jwt>) + Cloud-REST-Objekt | Partnergebundene Kartenreferenz (samsungWalletCardId, samsungWalletRefId) |
| Farbserialisierung | Zwingend rgb(r, g, b) (Hex-Codes und Alpha-Kanäle werden von iOS abgelehnt) | Hexadezimal #RRGGBB (hexBackgroundColor) | Hexadezimal #RRGGBB |
| Feldlayout-Zonen | 6 definierte Zonen: header, primary, secondary, auxiliary, back, footer | Vertikale Abschnitte: cardTitle, subheader, header, textModulesData (Zeilen), linksModuleData | Herstellerspezifische Vorlagen-Slots |
| HTML / Klickbare Links | Ausschließlich in backFields über attributedValue erlaubt (nur <a href="...">-Tags) | Darstellung über das dedizierte Array linksModuleData.uris (uri, description) | Dedizierte Link-Felder |
| Update- & Push-Protokoll | Zweistufig: Stiller APNs-HTTP/2-Push ({}-Payload, max. 4096 Bytes) weckt iPhone zum Abruf via GET /v1/passes/... | Einstufig: Server führt REST-PATCH auf walletobjects/v1/... aus; Google Play Services pushen aufs Gerät | Anbieter-REST-API |
| Sperrbildschirm-Auslöser | Feldwertänderung bei Feldern mit definiertem changeMessage: "... %@" | notifyPreference: "NOTIFY_ON_UPDATE" oder addMessage (TEXT_AND_NOTIFY, max. 3 in 24 Std.) | Nicht als primärer Push-Kanal aktiviert |
| Messung aktiver Pässe | Pro registrierter deviceLibraryIdentifier (1 iPhone + 1 gekoppelte Apple Watch = 2 Registrierungen) | Dedupliziert pro eindeutiger <issuerId>.<objectId> über alle Android-Geräte desselben Google-Kontos | Kontobezogen, sofern aktiviert |
| Geofencing & Beacons | Bis zu 10 GPS-Koordinaten (locations) + bis zu 10 BLE iBeacons (beacons) je .pkpass | Bis zu 10 GPS-Koordinaten auf Class/Object (locations-Hinweis: in neueren Play Services von Google eingeschränkt/veraltet) | Geräteabhängig |
| Lösch-Telemetrie | Sofortiger Aufruf von DELETE /v1/devices/:deviceLibId/registrations/... beim Entfernen aus Wallet | Sofortiges POST /api/v1/wallet/callback mit eventType: "del" | Eingeschränkte Telemetrie |
| Kontaktloses NFC-Protokoll | Apple VAS (ISO/IEC 14443 Typ A/B, ECDH P-256, erfordert Apple-NFC-Berechtigung) | Google Smart Tap (NFC_SMART_TAP, collectorId, ECDH P-256) | Nicht unterstützt |
Wichtig: Behandeln Sie Samsung Wallet nicht pauschal als in jeder Region und jedem Workspace funktionsgleich zu Apple Wallet und Google Wallet. Obwohl
Passinstance APISchemafelder (samsungWalletCardId,samsungWalletRefId) für Samsung-Integrationen vorhält, erfordert Samsung Wallet pro Region ein partnergebundenes Onboarding — prüfen Sie die Voraussetzungen im Funktionsumfang Samsung Wallet.
Plattformspezifische Design- & Payload-Regeln
1. Farbkonvertierung & Kontrastdurchsetzung
Apples PassKit-Parser lehnt .pkpass-Archive ab, wenn backgroundColor, foregroundColor oder labelColor einen #RRGGBB-Hex-String oder einen rgba()-Alpha-Kanal enthält. Passinstance speichert normalisierte Farbmodelle (Color) und serialisiert für Apple-.pkpass-Pakete automatisch rgb(r, g, b), während für Google-Wallet-Klassen #RRGGBB ausgegeben wird.
2. HTML-Anchor-Einschränkungen in attributedValue
In Apple Wallet werden anklickbare Hyperlinks, Telefonnummern (tel:) und E-Mail-Links (mailto:) ausschließlich auf der Rückseite des Passes (backFields) über die Eigenschaft attributedValue unterstützt. Apple entfernt alle HTML-Tags außer <a href="...">...</a>. In Google Wallet überführt Passinstance diese Links in den strukturierten Bereich linksModuleData am unteren Ende der scrollbaren Pass-Ansicht:
{
"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. Mehrfachzählung über Geräte hinweg (iPhone + Apple Watch)
Wenn eine iPhone-Besitzerin oder ein iPhone-Besitzer mit gekoppelter Apple Watch einen Apple-Wallet-Pass installiert, registrieren sowohl iOS als auch watchOS jeweils eine eigene deviceLibraryIdentifier und ein eigenes APNs-pushToken an POST /v1/devices/.../registrations/.... Passinstance erfasst im Analyse-Dashboard sowohl installedDevices (Gesamtzahl der Push-Endpunkte) als auch uniqueDevices, damit Sie einzelne Karteninhaberinnen sauber von Multi-Device-Installationen unterscheiden können.
Lesen Sie Apple Wallet, Google Wallet sowie Vorlagen-Design & Konfiguration für optimale Layout-Praktiken.
