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

Google Smart Tap

Anforderungen für kontaktloses Google Smart Tap: Collector ID, Schlüsselpaarung und NFC_SMART_TAP-Einstellungen.

In dieser Anleitung

Was ist Google Smart Tap?

Google Smart Tap (NFC_SMART_TAP) ist das verschlüsselte, kontaktlose NFC-Protokoll von Google Wallet auf Basis der NFC-Forum-Type-4-Tag- / ISO-DEP-NDEF-Dienstverhandlung. Es ermöglicht Android-Smartphones, Loyalty-, Angebots-, Geschenkkarten-, Event-Ticket- oder Generic-Pass-Daten über 13,56-MHz-NFC direkt an kompatible Kassen- oder Zutrittsterminals zu übertragen, ohne dass Nutzerinnen oder Nutzer zuerst einen Barcode auf dem Display öffnen müssen.

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
GOOGLE SMART TAP NDEF & ECDH-P-256-VERHANDLUNG
STUFE 01 PHASE 1: ISSUER-, COLLECTOR-ID- & CLASS-SCHLÜSSELBINDUNG
1
smartTapMerchantId & 8-stellige Hex/Int collectorId einrichten über POST/api/v1/google-wallet/setup
2
ECDH-P-256-Public-Key + Key-Version im Google-Wallet-Issuer-Konto hinterlegen
3
Smart Tap auf Class aktivieren (enableSmartTap: true, redemptionIssuers)
4
smartTapRedemptionValue auf jedem Pass-Objekt befüllen (LoyaltyObject etc.)
STUFE 02 PHASE 2: KONTAKTLOSES NDEF-SERVICE-HANDSHAKE (NFC_SMART_TAP)
1
Reader selektiert Smart-Tap-AID (A000000476D0000111) über ISO-DEP
2
Verhandelt NDEF-Sitzung (Negotiate SmartTap Request + Reader-Ephemeral-Key)
3
Android-Gerät prüft collectorId, signiert & verschlüsselt smartTapRedemptionValue via ECDH-P-256-Shared-Secret + AES-128-CTR/HMAC
4
Reader entschlüsselt PayloadÜbergabe an Passinstance Validierungs-Engine (readerType: "NFC_SMART_TAP"POST/api/v1/reader/redeem oder /scans)

Voraussetzungen & Konfigurationsparameter

Voraussetzungen: Um Google Smart Tap (NFC_SMART_TAP) an physischen Standorten zu nutzen, muss Ihre Google Wallet Class Ihre autorisierten redemptionIssuers (issuerId) deklarieren, Ihr Terminal muss die passende 32-Bit-collectorId aussenden, und Ihre Passinstance-Validierungskonfiguration muss den Lesermodus NFC_SMART_TAP aktivieren.

  1. 1
    Google Pay & Wallet Business Console Collector ID (collectorId): Hinterlegen Sie eine eindeutige numerische Collector ID (sowie smartTapMerchantId) in Ihrem Google-Wallet-Issuer-Profil und laden Sie Ihren komprimierten ECDH-P-256 (prime256v1) Public Key mit einer ganzzahligen Schlüsselversion (z. B. 1) hoch.
  2. 2
    Smart-Tap-Hydrierung auf Class & Object: Sobald nfcEnabled: true auf einer Passinstance-Vorlage aktiv ist, setzt Passinstance automatisch enableSmartTap: true sowie redemptionIssuers: ["<issuerId>"] auf der Google Wallet Class und schreibt die serialNumber des Passes (oder eine benutzerdefinierte NFC-Nachricht) in smartTapRedemptionValue auf jedem ausgegebenen Google-Wallet-Objekt.
  3. 3
    Kopplung des Leseterminals: Laden Sie die zugehörige collectorId, Key-Version und den privaten ECDH-P-256-Schlüssel in das Profil Ihres POS- oder zertifizierten NFC-Lesegeräts.
  4. 4
    Passinstance-Reader-Einstellungen (NFC_SMART_TAP): Konfigurieren Sie den Lesegeräte-Modus unter Validierungskonfiguration -> NFC-Einstellungen zusammen mit Ihrem Validation Place auf NFC_SMART_TAP (oder AUTO für Dual-Protokoll VAS + Smart Tap), sodass kontaktlose Taps exakt dieselbe 14-Regel-Validierungs- und Mechanik-Engine auslösen wie optische Barcode-Scans.

Smart-Tap-Schema in Google Wallet Class & Object

Wenn Passinstance eine Smart-Tap-fähige Vorlage samt Pass an Googles walletobjects/v1-API synchronisiert, werden folgende Protokolleigenschaften übertragen:

JSON
{
  "loyaltyClass": {
    "id": "3388000000022194812.cls_7b9e4c12",
    "issuerName": "Phenix Roasters",
    "programName": "VIP Coffee Club",
    "enableSmartTap": true,
    "redemptionIssuers": [
      "3388000000022194812"
    ]
  },
  "loyaltyObject": {
    "id": "3388000000022194812.pass_c41a8d20",
    "classId": "3388000000022194812.cls_7b9e4c12",
    "state": "ACTIVE",
    "smartTapRedemptionValue": "PI-8849-2026-X9",
    "barcode": {
      "type": "QR_CODE",
      "value": "PI-8849-2026-X9"
    }
  }
}

API-Referenz für Smart-Tap-Einrichtung & Validierung

MethodeEndpunkt-PfadBeschreibung
POST/api/v1/google-wallet/setupRichtet Ihr Google-Wallet-Issuer-Konto ein und stellt collectorId sowie smartTapMerchantData für Smart Tap bereit.
GET/api/v1/google-wallet/statusLiefert { isConfigured, collectorId } für Ihre Workspace-Konfiguration von Google Wallet & Smart Tap.
PUT/api/v1/reader/validateKonfiguriert Smart-Tap-/VAS-Collector-Schlüssel und NFC-Standardwerte in Ihrer Workspace-Hardware-Integration.
POST/api/v1/reader/redeemVerarbeitet ein vom Lesegerät entschlüsseltes Tap-Einlösungs-Payload (X-Reader-Secret, request payload).

Beispiel: Hinterlegte Smart-Tap-Collector-ID prüfen

BASH
GET /api/v1/google-wallet/status
X-API-Key: <API_KEY>

Antwort (200 OK):

JSON
{
  "isConfigured": true,
  "collectorId": "50992104"
}

Konfigurieren Sie die passende collectorId und ECDH-Schlüssel-Slots auf Ihrem Hardware-Lesegerät über Einstellungen -> Wallet -> NFC (/settings/workspace/wallet/nfc) oder laden Sie eine fertige NFC-config.txt-Datei über GET /api/v1/reader/devices/:id/config-file herunter.

Optischen Barcode-Fallback stets beibehalten

Selbst wenn NFC_SMART_TAP an Ihren Kassen aktiv ist, sollten Sie einen Standard-2D-QR- oder Aztec-Barcode im Pass-Layout aktiviert lassen (nfcNoBarcode: false), damit Kundinnen und Kunden mit älteren Android-Smartphones oder deaktiviertem NFC weiterhin problemlos optisch scannen können.

Lesen Sie weiter unter NFC-Pass-Konfiguration, Apple VAS und Kompatible NFC-Lesegeräte.

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.