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.
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 propriredemptionIssuers(issuerId) autorizzati, il terminale deve trasmettere il corrispondentecollectorIda 32 bit e la Configurazione di validazione Passinstance deve abilitare la modalità lettoreNFC_SMART_TAP.
-
1
Collector ID nella Google Pay & Wallet Business Console (
collectorId): Configuri un Collector ID numerico univoco (esmartTapMerchantId) nel proprio profilo Google Wallet Issuer e carichi la chiave pubblica ECDH P-256 (prime256v1) compressa con un intero versione chiave (es.1). -
2
Popolamento Smart Tap su Class e Object: Quando
nfcEnabled: trueè attivo su un modello Passinstance, la piattaforma imposta automaticamenteenableSmartTap: trueeredemptionIssuers: ["<issuerId>"]sulla Google Wallet Class, e scrive ilserialNumberdel pass (o il messaggio NFC personalizzato) insmartTapRedemptionValuesu ogni Google Wallet Object emesso. -
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
Impostazioni lettore Passinstance (
NFC_SMART_TAP): Imposti la modalità lettore del dispositivo suNFC_SMART_TAP(oppureAUTOdoppio 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:
{
"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
| Metodo | Percorso endpoint | Descrizione |
|---|---|---|
| POST | /api/v1/google-wallet/setup | Configura l'account emittente Google Wallet e predispone collectorId e smartTapMerchantData Smart Tap. |
| GET | /api/v1/google-wallet/status | Restituisce { isConfigured, collectorId } per la configurazione Google Wallet e Smart Tap del workspace. |
| PUT | /api/v1/reader/validate | Configura chiavi collector hardware Smart Tap / VAS e impostazioni predefinite NFC sull'integrazione del workspace. |
| POST | /api/v1/reader/redeem | Elabora un payload di riscatto da tap decifrato dal lettore (X-Reader-Secret, request payload). |
Esempio: verificare il Collector ID Smart Tap predisposto
GET /api/v1/google-wallet/status
X-API-Key: <API_KEY>
Risposta (200 OK):
{
"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.
