Skip to content
Hilfecenter-Anleitung · NFC & KontaktlosOnboarding-Phase 2
3 Min. LesezeitGeprüft 2026-11-16

NFC-Pass-Konfiguration

Unterscheiden Sie offene NDEF-NFC-Download-Tags (URL öffnen) von verschlüsselter kontaktloser Terminal-Einlösung.

In dieser Anleitung

Prüfen Sie passende Dashboard-Bereiche, Steuerelemente und Zoom-Hinweise zu diesem Thema.

Vergrößerter UI-Fokus
Wichtige UI-Elemente

Barcode-, QR-Code- & NFC-Konfiguration (Zoom)

Konfigurieren Sie QR-Code-Format, Wertquelle, dynamischen Token-Inhalt ({memberQrToken}), Alternativtext ({passReference}) und NFC.

Zwei grundlegend verschiedene Bedeutungen von „NFC“ bei Wallet-Pässen

Wichtig: Bevor Sie kontaktlosen Checkout oder Zutrittskontrolle mit Beteiligten planen, unterscheiden Sie klar zwischen NDEF-NFC-Tag-Verteilung (offene Standard-URL-Tags, die mit jedem Smartphone sofort funktionieren) und verschlüsseltem Tap-to-Redeem (Apple VAS und Google Smart Tap, die ein verschlüsseltes Pass-Payload aus dem Wallet an ein spezialisiertes NFC-Leseterminal übertragen).

FunktionZweckProtokoll & ModellBenötigte Hardware & Freigabe
NDEF-NFC-Tag-VerteilungKundin/Kunde hält entsperrtes Smartphone an Kassensticker -> öffnet URL für Wallet oder PassFlowISO/IEC 14443 NDEF URI RecordNur preiswerter NTAG213/215-Sticker; kein NFC-Lesegerät und kein Apple VAS erforderlich.
Tap-to-Redeem (Apple VAS / Google Smart Tap)Kundin/Kunde hält Smartphone/Watch ans Terminal -> Lesegerät entschlüsselt Pass-Payload (message)Apple VAS & Google Smart Tap (NFC-Modell & Template.nfc)Erfordert VAS-/Smart-Tap-NFC-Lesehardware + Händler-Schlüsselpaarung (nicht bei jedem Konto standardmäßig aktiv).

Pass-NFC-Modell & Architektur des nfc-Dictionary in pass.json

Wenn die kontaktlose Einlösung auf einer Vorlage aktiviert ist (Template.nfc / Passinstance database-NFC-Modell), bettet Passinstance kryptografische NFC-Metadaten sowohl in das nfc-Dictionary von Apple Wallets pass.json als auch in smartTapRedemptionValue des Google-Wallet-Objekts ein:

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
VERSCHLÜSSELTES NFC-PAYLOAD & TERMINAL-HANDSHAKE
STUFE 01 VORLAGEN- & PASS-NFC-SCHEMA (NFC-Modell)
nfcEnabled: true
message: Dynamisches Payload (bis zu 64 Bytes, z. B. serialNumber / Token)
encryptionPublicKey: Base64 ECDH P-256 Public Key (prime256v1)
requiresAuthentication (nfcFaceIdRequired): Erzwingt Face ID / Touch ID
nfcNoBarcode: Optionales Ausblenden des visuellen 2D-Barcodes auf Vorderseite
Apple Wallet pass.json
STUFE 02A "nfc": {
"message": "PI-8849-2026-X9", "encryptionPublicKey": "MDkwEw...", "requiresAuthentication": true }
[ 13,56-MHz-ISO/I
POS- / ZUTRITTS-LESETERMIN
1
Sendet Apple-VAS-Pass-Type-ID-Hash &
2
Führt ephemere ECDH-P-256-Schlüsselve
3
Leitet entschlüsselte message an `P
Google Wallet WalletObject
STUFE 02B "smartTapRedemptionValue": "<msg>"
"hasUsers": true
Gebunden an Class redemptionIssuers (collectorId / ECDH-P-256-Key)
14443-HF-Feld ] (NFC / Verifone / Ingenico) gle-Smart-Tap-Collector-ID nbarung & AES-GCM-Entschlüsselung aus
/api/v1/scansoder/reader/redeem`

NFC-Konfigurationseigenschaften & Vorgaben

Eigenschaft (NFC / Template.nfc)Apple-pass.json-SchlüsselTyp & EinschränkungTechnisches Verhalten
messagenfc.messagestring (Max. 64 Bytes UTF-8)Das vom Gerät verschlüsselte und an den NFC-Reader übertragene Klartext-Payload (Standard: serialNumber oder externalId des Passes).
encryptionPublicKeynfc.encryptionPublicKeystring (Base64 DER/PEM)Komprimierter oder unkomprimierter ECDH-P-256 (prime256v1) Public Key passend zum Private Key auf Ihren NFC-Leseterminals.
nfcFaceIdRequirednfc.requiresAuthenticationbooleanBei true verlangt iOS eine Authentifizierung per Face ID, Touch ID oder Gerätecode, bevor das VAS-Payload gesendet wird.
nfcNoBarcodeLässt barcodes[] wegbooleanBei true wird der visuelle 2D-QR-/Aztec-Barcode auf der Vorderseite ausgeblendet, sodass der Pass nur per verschlüsseltem NFC-Tap vorgezeigt werden kann.

Beispiel: nfc-Dictionary in Apple Wallet pass.json & Vorlagenkonfiguration

Wenn nfcEnabled: true auf einer Vorlage konfiguriert ist, serialisiert Passinstance das nfc-Dictionary im Wurzelobjekt von pass.json:

JSON
{
  "formatVersion": 1,
  "passTypeIdentifier": "pass.com.phenixroasters.access",
  "serialNumber": "PI-8849-2026-X9",
  "nfc": {
    "message": "PI-8849-2026-X9",
    "encryptionPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE8v3x9K2m5N7p1Q4r6S8t0V2w4Y6z8A1b3C5d7E9f0G2h4J6k8L0m2N4p6Q8r0S==",
    "requiresAuthentication": true
  }
}

Um die NFC-Einstellungen einer Vorlage per REST-API zu aktualisieren, patchen Sie die Vorlagenressource (und prüfen Sie die Konfiguration mit POST /api/v1/nfc/test):

JSON
PATCH /api/v1/templates/7b9e4c12-3f81-4a90-b8d2-19c48a70e112
{
  "nfc": {
    "message": "{serialNumber}",
    "encryptionPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE8v3x9K2m5N7p1Q4r6S8t0V2w4Y6z8A1b3C5d7E9f0G2h4J6k8L0m2N4p6Q8r0S==",
    "requiresAuthentication": true
  },
  "nfcFaceIdRequired": true,
  "nfcNoBarcode": false
}

Best Practice: Optischen 2D-Barcode-Fallback aktiviert lassen

Sofern Sie keine Hochsicherheits-Mitarbeiterausweise ausgeben, bei denen Barcode-Screenshots strikt ausgeschlossen werden müssen (nfcNoBarcode: true oder addSecurityAnimation: true), lassen Sie nfcNoBarcode: false, damit Pässe weiterhin einen 2D-QR- oder Aztec-Barcode als Fallback anzeigen. So kann Ihr Personal Pässe weiterhin per Kamera scannen, falls ein Terminal offline oder das NFC-Modul eines Kundengeräts deaktiviert ist.

Lesen Sie auch Funktionsumfang NFC-Wallet-Pässe, Apple VAS, Google Smart Tap sowie Kompatible NFC-Lesegeräte.

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.