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.
Voraussetzungen & Konfigurationsparameter
Voraussetzungen: Um Google Smart Tap (
NFC_SMART_TAP) an physischen Standorten zu nutzen, muss Ihre Google Wallet Class Ihre autorisiertenredemptionIssuers(issuerId) deklarieren, Ihr Terminal muss die passende 32-Bit-collectorIdaussenden, und Ihre Passinstance-Validierungskonfiguration muss den LesermodusNFC_SMART_TAPaktivieren.
-
1
Google Pay & Wallet Business Console Collector ID (
collectorId): Hinterlegen Sie eine eindeutige numerische Collector ID (sowiesmartTapMerchantId) 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
Smart-Tap-Hydrierung auf Class & Object: Sobald
nfcEnabled: trueauf einer Passinstance-Vorlage aktiv ist, setzt Passinstance automatischenableSmartTap: truesowieredemptionIssuers: ["<issuerId>"]auf der Google Wallet Class und schreibt dieserialNumberdes Passes (oder eine benutzerdefinierte NFC-Nachricht) insmartTapRedemptionValueauf jedem ausgegebenen Google-Wallet-Objekt. -
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
Passinstance-Reader-Einstellungen (
NFC_SMART_TAP): Konfigurieren Sie den Lesegeräte-Modus unter Validierungskonfiguration -> NFC-Einstellungen zusammen mit Ihrem Validation Place aufNFC_SMART_TAP(oderAUTOfü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:
{
"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
| Methode | Endpunkt-Pfad | Beschreibung |
|---|---|---|
| POST | /api/v1/google-wallet/setup | Richtet Ihr Google-Wallet-Issuer-Konto ein und stellt collectorId sowie smartTapMerchantData für Smart Tap bereit. |
| GET | /api/v1/google-wallet/status | Liefert { isConfigured, collectorId } für Ihre Workspace-Konfiguration von Google Wallet & Smart Tap. |
| PUT | /api/v1/reader/validate | Konfiguriert Smart-Tap-/VAS-Collector-Schlüssel und NFC-Standardwerte in Ihrer Workspace-Hardware-Integration. |
| POST | /api/v1/reader/redeem | Verarbeitet ein vom Lesegerät entschlüsseltes Tap-Einlösungs-Payload (X-Reader-Secret, request payload). |
Beispiel: Hinterlegte Smart-Tap-Collector-ID prüfen
GET /api/v1/google-wallet/status
X-API-Key: <API_KEY>
Antwort (200 OK):
{
"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.
