Skip to content
Helpcentrum-gids · Wallet-integraties
3 min leestijdGecontroleerd 2026-11-16

Platformverschillen & beperkingen

Vergelijk Apple Wallet, Google Wallet en Samsung Wallet voor meldingen, geofencing en veldindelingen.

In deze gids

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:

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
DUAL-WALLET SERIALISATIE & SYNCHRONISATIEDIVERGENTIE
FASE 01 UNIFORM PASSINSTANCE-SJABLOON & PASRECORD
Eén sjabloonschema + dynamische kenmerken + mechanica-statusengine
Apple Wallet Serializer
FASE 02A
Artifact: Ondertekende .pkpass ZIP
Kleuren: Strikt rgb(r, g, b)-formaat
Lay-out: Vaste voorkant + omkeerbare achterkant
Rich Text: <a>-tags in Back Fields
Sync: Lege APNs-push {}Pull
Meting: Per apparaat (iPhone + Watch)
Google Wallet Serializer
FASE 02B
Artifact: Cloud Class + Object
Kleuren: Hexadecimaal #RRGGBB
Lay-out: Verticaal scrollende weergave
Rich Text: Gestructureerde Google Wallet links module
Sync: Directe Cloud REST PATCH
Meting: Per uniek pasobject

Gedetailleerde technische vergelijkingsmatrix

Functie / technische beperkingApple Wallet (iOS & watchOS)Google Wallet (Android)Samsung Wallet (partner-gebonden)
Afgeleverd artifactOndertekend .pkpass ZIP-archief (application/vnd.apple.pkpass)Met RS256 ondertekende Save JWT-URL (https://pay.google.com/gp/v/save/<jwt>) + Cloud REST ObjectPartner-gebonden kaartreferentie (samsungWalletCardId, samsungWalletRefId)
KleurserialisatieMoet rgb(r, g, b) zijn (hex en alfakanalen worden door iOS geweigerd)Hexadecimaal #RRGGBB (hexBackgroundColor)Hexadecimaal #RRGGBB
Veldlay-outzones6 afzonderlijke zones: header, primary, secondary, auxiliary, back, footerVerticale secties: cardTitle, subheader, header, textModulesData (rijen), linksModuleDataVendor-sjabloonslots
HTML / klikbare linksAlleen toegestaan in backFields via attributedValue (uitsluitend <a href="...">-tags)Weergegeven via de speciale linksModuleData.uris-array (uri, description)Speciale linkvelden
Update- & pushprotocolTweestaps: stille APNs HTTP/2-push ({}-payload, max. 4096 bytes) activeert iPhone om GET /v1/passes/... op te halenEén stap: server voert REST PATCH uit op walletobjects/v1/...; Google Play Services pusht naar telefoonProvider REST API
Trigger voor vergrendelschermmeldingVeldwaarde wijzigt bij een veld dat changeMessage: "... %@" definieertnotifyPreference: "NOTIFY_ON_UPDATE" of addMessage (TEXT_AND_NOTIFY, max. 3 per 24 uur)Niet ingeschakeld als primaire pushlaag
Meting van actieve passenPer 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-accountAccountgebonden waar ingeschakeld
Geofencing & beaconsTot 10 GPS-coördinaten (locations) + tot 10 BLE iBeacons (beacons) per .pkpassTot 10 GPS-coördinaten op Class/Object (locations-opmerking: uitgefaseerd/beperkt door Google in nieuwere Play Services)Apparaatafhankelijk
VerwijderingstelemetrieDirecte DELETE /v1/devices/:deviceLibId/registrations/...-aanroep bij verwijdering uit WalletDirecte POST /api/v1/wallet/callback met eventType: "del"Beperkte telemetrie
Contactloos NFC-protocolApple 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 API schemavelden (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:

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

Gerelateerde product- en ontwikkelaarsdocs

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.