Skip to content
Hilfecenter-Anleitung · Wallet-Integrationen
3 Min. LesezeitGeprüft 2026-11-16

Plattformunterschiede & Grenzen

Vergleichen Sie Apple Wallet, Google Wallet und Samsung Wallet bei Sperrbildschirmmeldungen, Geofencing-Limits und Feldzonen.

In dieser Anleitung

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:

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
DUAL-WALLET-SERIALISIERUNG & SYNC-UNTERSCHIEDE
STUFE 01 EINHEITLICHE PASSINSTANCE-VORLAGE & PASS-DATENSATZ
Einheitliches Vorlagenschema + dynamische Attribute + Mechanik-Zustands-Engine
Apple-Wallet-Serializer
STUFE 02A
Artefakt: Signiertes .pkpass-ZIP
Farben: Strikt rgb(r, g, b)-Format
Layout: Feste Vorder- & Rückseite
Rich Text: <a>-Tags in Back Fields
Sync: Leerer APNs-Push {}Pull
Zählung: Pro Gerät (iPhone + Watch)
Google-Wallet-Serializer
STUFE 02B
Artefakt: Cloud Class + Object
Farben: Hexadezimal #RRGGBB
Layout: Vertikal scrollbare Karte
Rich Text: Strukt. `Google Wallet l
Sync: Direkter Cloud-REST-PATCH
Zählung: Pro eindeutigem Object

Detaillierte technische Vergleichsmatrix

Funktion / Technische GrenzeApple Wallet (iOS & watchOS)Google Wallet (Android)Samsung Wallet (Partner-gebunden)
Auslieferungs-ArtefaktSigniertes .pkpass-ZIP-Archiv (application/vnd.apple.pkpass)RS256-signierte Save-JWT-URL (https://pay.google.com/gp/v/save/<jwt>) + Cloud-REST-ObjektPartnergebundene Kartenreferenz (samsungWalletCardId, samsungWalletRefId)
FarbserialisierungZwingend rgb(r, g, b) (Hex-Codes und Alpha-Kanäle werden von iOS abgelehnt)Hexadezimal #RRGGBB (hexBackgroundColor)Hexadezimal #RRGGBB
Feldlayout-Zonen6 definierte Zonen: header, primary, secondary, auxiliary, back, footerVertikale Abschnitte: cardTitle, subheader, header, textModulesData (Zeilen), linksModuleDataHerstellerspezifische Vorlagen-Slots
HTML / Klickbare LinksAusschließlich in backFields über attributedValue erlaubt (nur <a href="...">-Tags)Darstellung über das dedizierte Array linksModuleData.uris (uri, description)Dedizierte Link-Felder
Update- & Push-ProtokollZweistufig: 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ätAnbieter-REST-API
Sperrbildschirm-AuslöserFeldwertä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ässePro registrierter deviceLibraryIdentifier (1 iPhone + 1 gekoppelte Apple Watch = 2 Registrierungen)Dedupliziert pro eindeutiger <issuerId>.<objectId> über alle Android-Geräte desselben Google-KontosKontobezogen, sofern aktiviert
Geofencing & BeaconsBis zu 10 GPS-Koordinaten (locations) + bis zu 10 BLE iBeacons (beacons) je .pkpassBis zu 10 GPS-Koordinaten auf Class/Object (locations-Hinweis: in neueren Play Services von Google eingeschränkt/veraltet)Geräteabhängig
Lösch-TelemetrieSofortiger Aufruf von DELETE /v1/devices/:deviceLibId/registrations/... beim Entfernen aus WalletSofortiges POST /api/v1/wallet/callback mit eventType: "del"Eingeschränkte Telemetrie
Kontaktloses NFC-ProtokollApple 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 API Schemafelder (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:

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

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.