Skip to content
Guida del Centro assistenza · NFC e contactless
3 min di letturaVerificato 2026-11-16

Google Smart Tap

Requisiti Google Smart Tap contactless: Collector ID, coppia chiavi e parametri NFC_SMART_TAP.

In questa guida

Che cos'è Google Smart Tap?

Google Smart Tap (NFC_SMART_TAP) è il protocollo di presentazione NFC contactless cifrato di Google Wallet basato sulla negoziazione di servizi NFC Forum Type 4 Tag / ISO-DEP NDEF. Consente agli smartphone Android di trasmettere una credenziale Loyalty, Offer, Gift Card, Event Ticket o Generic pass su NFC a 13,56 MHz direttamente a terminali POS o di accesso compatibili, senza che l'utente debba cercare e aprire un codice a barre sullo schermo.

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
NEGOZIAZIONE NDEF E ECDH P-256 GOOGLE SMART TAP
FASE 01 FASE 1: ISSUER, COLLECTOR ID E ASSOCIAZIONE CHIAVE DI CLASSE
1
Configura smartTapMerchantId e collectorId hex/int a 8 cifre tramite POST/api/v1/google-wallet/setup
2
Registra chiave pubblica ECDH P-256 + versione chiave nell'Issuer Google
3
Abilita Smart Tap sulla Class (enableSmartTap: true, redemptionIssuers)
4
Popola smartTapRedemptionValue su ogni Pass Object (LoyaltyObject, ecc.)
FASE 02 FASE 2: NEGOZIAZIONE SERVIZIO NDEF CONTACTLESS (NFC_SMART_TAP)
1
Il lettore seleziona l'AID Smart Tap (A000000476D0000111) su ISO-DEP
2
Negozia la sessione NDEF (Negotiate SmartTap Request + Chiave Effimera)
3
Android abbina collectorId, firma e cifra smartTapRedemptionValue con segreto condiviso ECDH P-256 + AES-128-CTR / HMAC-SHA256
4
Il lettore decifra il payloadInvia al Motore Validazione Passinstance (readerType: "NFC_SMART_TAP"POST/api/v1/reader/redeem o /scans)

Prerequisiti e parametri di configurazione

Prerequisiti: Per utilizzare Google Smart Tap (NFC_SMART_TAP) presso le sedi fisiche, la Google Wallet Class deve dichiarare i propri redemptionIssuers (issuerId) autorizzati, il terminale deve trasmettere il corrispondente collectorId a 32 bit e la Configurazione di validazione Passinstance deve abilitare la modalità lettore NFC_SMART_TAP.

  1. 1
    Collector ID nella Google Pay & Wallet Business Console (collectorId): Configuri un Collector ID numerico univoco (e smartTapMerchantId) nel proprio profilo Google Wallet Issuer e carichi la chiave pubblica ECDH P-256 (prime256v1) compressa con un intero versione chiave (es. 1).
  2. 2
    Popolamento Smart Tap su Class e Object: Quando nfcEnabled: true è attivo su un modello Passinstance, la piattaforma imposta automaticamente enableSmartTap: true e redemptionIssuers: ["<issuerId>"] sulla Google Wallet Class, e scrive il serialNumber del pass (o il messaggio NFC personalizzato) in smartTapRedemptionValue su ogni Google Wallet Object emesso.
  3. 3
    Abbinamento terminale lettore: Carichi il collectorId, la versione chiave e la chiave privata ECDH P-256 corrispondenti nel profilo del POS o del lettore certified NFC.
  4. 4
    Impostazioni lettore Passinstance (NFC_SMART_TAP): Imposti la modalità lettore del dispositivo su NFC_SMART_TAP (oppure AUTO doppio protocollo VAS + Smart Tap) sotto Configurazione validazione -> Impostazioni NFC insieme al proprio Luogo di validazione, affinché i tap contactless eseguano esattamente lo stesso motore a 14 regole e meccaniche delle scansioni ottiche.

Schema Smart Tap per Class e Object Google Wallet

Quando Passinstance sincronizza un modello e un pass abilitati a Smart Tap verso l'API walletobjects/v1 di Google, include le seguenti proprietà di protocollo:

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"
    }
  }
}

Riferimento API per configurazione e validazione Smart Tap

MetodoPercorso endpointDescrizione
POST/api/v1/google-wallet/setupConfigura l'account emittente Google Wallet e predispone collectorId e smartTapMerchantData Smart Tap.
GET/api/v1/google-wallet/statusRestituisce { isConfigured, collectorId } per la configurazione Google Wallet e Smart Tap del workspace.
PUT/api/v1/reader/validateConfigura chiavi collector hardware Smart Tap / VAS e impostazioni predefinite NFC sull'integrazione del workspace.
POST/api/v1/reader/redeemElabora un payload di riscatto da tap decifrato dal lettore (X-Reader-Secret, request payload).

Esempio: verificare il Collector ID Smart Tap predisposto

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

Risposta (200 OK):

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

Configuri il collectorId corrispondente e gli slot chiavi ECDH sul lettore hardware tramite Impostazioni -> Wallet -> NFC (/settings/workspace/wallet/nfc) oppure scarichi un file di configurazione NFC config.txt tramite GET /api/v1/reader/devices/:id/config-file.

Mantenere sempre il fallback con codice a barre ottico

Anche con NFC_SMART_TAP attivo alle casse, mantenga abilitato un codice a barre standard 2D QR o Aztec sul layout del pass (nfcNoBarcode: false), affinché i clienti con smartphone Android meno recenti o con NFC disattivato possano comunque eseguire la scansione ottica.

Esplori Configurazione pass NFC, Apple VAS e Lettori NFC compatibili.

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.