Architectuurvergelijking: Apple Wallet vs. Google Wallet
Hoewel Passinstance een uniforme sjabloonontwerper en REST API biedt die platformcomplexiteit abstraheert, verschillen Apple Wallet en Google Wallet fundamenteel in de manier waarop passen op OS-niveau worden verpakt, vormgegeven, bijgewerkt en gemeten:
Gedetailleerde technische vergelijkingsmatrix
| Functie / technische beperking | Apple Wallet (iOS & watchOS) | Google Wallet (Android) | Samsung Wallet (partner-gebonden) |
|---|---|---|---|
| Afgeleverd artifact | Ondertekend .pkpass ZIP-archief (application/vnd.apple.pkpass) | Met RS256 ondertekende Save JWT-URL (https://pay.google.com/gp/v/save/<jwt>) + Cloud REST Object | Partner-gebonden kaartreferentie (samsungWalletCardId, samsungWalletRefId) |
| Kleurserialisatie | Moet rgb(r, g, b) zijn (hex en alfakanalen worden door iOS geweigerd) | Hexadecimaal #RRGGBB (hexBackgroundColor) | Hexadecimaal #RRGGBB |
| Veldlay-outzones | 6 afzonderlijke zones: header, primary, secondary, auxiliary, back, footer | Verticale secties: cardTitle, subheader, header, textModulesData (rijen), linksModuleData | Vendor-sjabloonslots |
| HTML / klikbare links | Alleen toegestaan in backFields via attributedValue (uitsluitend <a href="...">-tags) | Weergegeven via de speciale linksModuleData.uris-array (uri, description) | Speciale linkvelden |
| Update- & pushprotocol | Tweestaps: stille APNs HTTP/2-push ({}-payload, max. 4096 bytes) activeert iPhone om GET /v1/passes/... op te halen | Eén stap: server voert REST PATCH uit op walletobjects/v1/...; Google Play Services pusht naar telefoon | Provider REST API |
| Trigger voor vergrendelschermmelding | Veldwaarde wijzigt bij een veld dat changeMessage: "... %@" definieert | notifyPreference: "NOTIFY_ON_UPDATE" of addMessage (TEXT_AND_NOTIFY, max. 3 per 24 uur) | Niet ingeschakeld als primaire pushlaag |
| Meting van actieve passen | Per geregistreerde deviceLibraryIdentifier (1 iPhone + 1 gekoppelde Apple Watch = 2 registraties) | Ontdubbeld per unieke <issuerId>.<objectId> over alle Android-apparaten die zijn ingelogd met hetzelfde Google-account | Accountgebonden waar ingeschakeld |
| Geofencing & beacons | Tot 10 GPS-coördinaten (locations) + tot 10 BLE iBeacons (beacons) per .pkpass | Tot 10 GPS-coördinaten op Class/Object (locations-opmerking: uitgefaseerd/beperkt door Google in nieuwere Play Services) | Apparaatafhankelijk |
| Verwijderingstelemetrie | Directe DELETE /v1/devices/:deviceLibId/registrations/...-aanroep bij verwijdering uit Wallet | Directe POST /api/v1/wallet/callback met eventType: "del" | Beperkte telemetrie |
| Contactloos NFC-protocol | Apple VAS (ISO/IEC 14443 Type A/B, ECDH P-256, vereist Apple NFC-entitlement) | Google Smart Tap (NFC_SMART_TAP, collectorId, ECDH P-256) | Niet ondersteund |
Belangrijk: Behandel Samsung Wallet niet als wereldwijd identiek aan Apple Wallet en Google Wallet in elke regio en werkruimte. Hoewel
Passinstance APIschemavelden (samsungWalletCardId,samsungWalletRefId) bevat voor Samsung-integraties, vereist Samsung Wallet partner-gebonden onboarding per regio — bekijk Samsung Wallet ondersteuningsbereik voor de voorwaarden.
Platformspecifieke ontwerp- en payloadregels
1. Kleurconversie en contrastafdwinging
Apple's PassKit-parser weigert .pkpass-archieven als backgroundColor, foregroundColor of labelColor een #RRGGBB-hexstring of een rgba()-alfakanaal bevat. Passinstance slaat genormaliseerde kleurmodellen (Color) op en serialiseert automatisch rgb(r, g, b) voor Apple .pkpass-generatie, terwijl het #RRGGBB uitstuurt voor Google Wallet-classes.
2. Beperkingen voor HTML-ankers in attributedValue
In Apple Wallet worden klikbare hyperlinks, telefoonnummers (tel:) en mailto-links uitsluitend ondersteund op de achterkant van de pas (backFields) via de eigenschap attributedValue. Apple verwijdert alle HTML-tags behalve <a href="...">...</a>. In Google Wallet wijst Passinstance deze links toe aan de gestructureerde sectie linksModuleData onderaan de scrollende pasweergave:
{
"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. Registratietellingen op meerdere apparaten (iPhone + Apple Watch)
Wanneer een iPhone-eigenaar met een gekoppelde Apple Watch een Apple Wallet-pas installeert, registreren iOS en watchOS elk een onafhankelijke deviceLibraryIdentifier en APNs pushToken via POST /v1/devices/.../registrations/.... Passinstance houdt in het Analytics Dashboard zowel installedDevices (totaal aantal pushendpoints) als uniqueDevices bij, zodat u unieke pashouders kunt onderscheiden van installaties op meerdere apparaten.
Raadpleeg Apple Wallet, Google Wallet en Sjabloonontwerp & configuratie voor best practices rond lay-out.
