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

Kompatible NFC-Lesegeräte

Richten Sie unterstützte kontaktlose NFC-Terminals pro Validation Place über Passinstance NFC-Settings ein.

In dieser Anleitung

Überblick: Kontaktlose Lesehardware auswählen & koppeln

Da iOS- und Android-Smartphones im Verbraucherbereich eine rohe Host-Card-Emulation einschränken und für geschlossene Wallet-Pässe kryptografische Terminal-Handshakes vorschreiben, erfordert echtes Tap-to-Redeem Apple-VAS- und Google-Smart-Tap-fähige Lesehardware. Passinstance bildet physische Lesegeräteflotten nativ über die Datenbank-Entitäten hardware reader, reader device, store location und POS terminal ab und authentifiziert deren Zugriffe.

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
HARDWARE-NFC-LESER & POS-TERMINAL-INTEGRATION
STUFE 01 TAP DES KUNDENGERÄTS (iPhone / Watch / Android)
13,56-MHz-ISO/IEC-14443-HF-FeldApple VAS / Google Smart Tap
STUFE 02 PHYSISCHE NFC-LESEGERÄTE-SCHICHT
certified NFC50 / NFC Terminal (USB-Tastaturweiche, Virtual COM o. Cloud HTTP)
Enterprise-POS-Terminals (Verifone P400/V400m, Ingenico Lane/Move, Square)
Entschlüsselt VAS-/Smart-Tap-Payload im Hardware-Secure-Element (Slot 1..6)
Modus A: Cloud-HTTP-Push
STUFE 03A `POST/api/v1/
integrations/hardware/ reader/validate`
Direkt via WLAN/Ethernet
Modus B: POS-Gateway-API
STUFE 03B `POST/api/v1/reader/
redeem`
Header: X-Reader-Secret
DTO: request payload
Modus C: USB-Wedge
STUFE 03C Sendet entschl.
serialNumber + CR in Eingabefeld von
Web-/Desktop-Scanner
STUFE 04 PASSINSTANCE 14-REGEL-VALIDIERUNGS- & MECHANIK-ENGINE (/scans)
Führt Stempel-/Punkte-/Prepaid-/Check-in-Regel aus & pusht APNs / Google Update

Unterstützte Reader-Architekturen & NfcReaderMode

Passinstance unterstützt vier Betriebsmodi gemäß dem Backend-Enum NfcReaderMode über alle angebundenen Hardware-Anbieter hinweg (reader provider: HID, ZEBRA, INGENICO, VERIFONE, PAX, SUNMI):

NfcReaderMode-EnumProtokollverhalten & Hardware-Eignung
AUTOAutomatisches Dual-Protokoll-Polling: Das Terminal wechselt innerhalb eines einzigen 300-ms-Tap-Fensters automatisch zwischen Apple VAS und Google Smart Tap (empfohlen für certified NFC und moderne POS-Terminals).
KEYBOARD_WEDGEUSB-HID-Tastaturemulation: Das Lesegerät entschlüsselt das Pass-Payload direkt auf dem Gerät und tippt die serialNumber + Enter unmittelbar in den Passinstance-Web-Scanner oder die POS-Kassenoberfläche ein.
APPLE_WALLETDediziertes Apple-VAS-Polling; optimiert für reine iOS-Umgebungen oder extrem schnelle Einzelprotokoll-Drehkreuze.
GOOGLE_SMART_TAPDediziertes Google-Smart-Tap-NDEF-Polling.

Zertifizierte Hardware-Familien

  1. 1
    certified NFC-Lesegeräte (NFC Terminal, NFC Terminal, NFC Terminal WLAN/PoE): Speziell für Mobile-Wallet-Pässe entwickelte NFC-Reader mit gleichzeitiger Apple-VAS- und Google-Smart-Tap-Entschlüsselung. NFC-Hardware-Einheiten senden entschlüsselte Taps direkt per HTTP an POST /api/v1/reader/validate mit dem HMAC-Signaturheader x-reader-signature (oder x-signature).
  2. 2
    Verifone-, Ingenico-, HID-, Zebra-, PAX- & Sunmi-Terminals: Enterprise-Kassen- und Zutrittsterminals, modelliert über reader provider sowie store location- / POS terminal- / hardware reader-Datensätze.
  3. 3
    Optische 2D-Kassenscanner (Fallback ohne Entitlement): Herkömmliche 2D-Barcode-Scanner (Zebra, Honeywell, Tera), die Wallet-QR- oder Aztec-Codes im KEYBOARD_WEDGE-Modus lesen, ermöglichen den sofortigen Produktivstart ganz ohne Apple-/Google-NFC-Schlüsselanträge.

Wichtig: Lesegeräte, die POST /api/v1/reader/redeem oder /api/v1/reader/validate aufrufen, müssen sich mit X-Reader-Secret (reader integration secret) authentifizieren, während NFC-Cloud-Webhooks an POST /api/v1/reader/validate ihre Anfragen mit x-reader-signature / x-signature signieren.

API-Endpunkte für Hardware-Lesegeräte & Terminals (Reader Management API / Reader Orchestration API)

MethodeEndpunkt-PfadAuth-HeaderBeschreibung
GET / POST/api/v1/reader/devicesBearer / API KeyListet certified NFC-hardware reader-Geräte auf oder registriert neue (GET/PUT/DELETE .../readers/:id sowie POST .../readers/:id/test).
GET/api/v1/reader/devices/:id/config-fileBearer / API KeyErzeugt ein einspielbereites config.txt-Paket für certified NFC-Leser (VAS1MerchantID, ST1CollectorID, Schlüssel-Slots und Cloud-Webhook-URL).
POST/api/v1/reader/validatex-reader-signatureDedizierter Webhook zur Tap-Erfassung durch certified NFC Pro Cloud-Reader (reader event payload, plus Batch /events/batch).
POST/api/v1/reader/validateX-Reader-SecretValidiert einen Eintrag anhand von barcodeValue (request payload: customerId, barcodeValue, idempotencyKey, operatorId?, location?).
POST/api/v1/reader/redeemX-Reader-SecretVerarbeitet eine idempotente Tap-Einlösung (request payload: customerId, passId, amount?, idempotencyKey, operatorId?).

Beispiel: Tap-Einlösung über Hardware-Lesegerät (POST /api/v1/reader/redeem)

JSON
POST /api/v1/reader/redeem
Headers:
  X-Reader-Secret: <reader integration secret>
  Content-Type: application/json

{
  "customerId": "8f94d930-b302-4fc8-9f12-000000000001",
  "passId": "c41a8d20-6e11-4f3b-9a81-0029d81a4f10",
  "amount": "12.50",
  "idempotencyKey": "tap_01J9Z9K2M4N6P8Q0R2S4",
  "operatorId": "term_checkout_lane_02"
}

Antwort (200 OK):

JSON
{
  "success": true,
  "resultingValue": "37.50"
}

Lesen Sie NFC-Pass-Konfiguration, Apple VAS, Google Smart Tap sowie Scanner-Einrichtung & Konfiguration.

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.