¿Qué es Google Smart Tap?
Google Smart Tap (NFC_SMART_TAP) es el protocolo de presentación NFC sin contacto cifrada de Google Wallet basado en negociación de servicios NDEF sobre NFC Forum Type 4 Tag / ISO-DEP. Permite que teléfonos Android transmitan una credencial Loyalty, Offer, Gift Card, Event Ticket o Generic mediante NFC a 13,56 MHz directamente a terminales POS o de acceso compatibles, sin que el usuario tenga que abrir y mostrar un código de barras en pantalla.
Requisitos previos y parámetros de configuración
Requisitos previos: Para utilizar Google Smart Tap (
NFC_SMART_TAP) en ubicaciones físicas, su Google Wallet Class debe declarar susredemptionIssuersautorizados (issuerId), su terminal debe anunciar elcollectorIdde 32 bits coincidente y su Configuración de validación en Passinstance debe tener habilitado el modo de lectorNFC_SMART_TAP.
-
1
Collector ID en Google Pay & Wallet Business Console (
collectorId): Configure un Collector ID numérico único (ysmartTapMerchantId) en su perfil de emisor de Google Wallet y suba su clave pública comprimida ECDH P-256 (prime256v1) con un entero de versión de clave (por ejemplo,1). -
2
Hidratación de Smart Tap en Class y Object: Cuando
nfcEnabled: trueestá activo en una plantilla de Passinstance, Passinstance establece automáticamenteenableSmartTap: trueyredemptionIssuers: ["<issuerId>"]en la Google Wallet Class, y escribe elserialNumberdel pase (o el mensaje NFC personalizado) ensmartTapRedemptionValuede cada Google Wallet Object emitido. -
3
Emparejamiento del terminal lector: Cargue el
collectorIdcoincidente, la versión de clave y la clave privada ECDH P-256 en el perfil de su POS o lector certified NFC. -
4
Ajustes del lector en Passinstance (
NFC_SMART_TAP): Configure el modo del lector del dispositivo enNFC_SMART_TAP(o protocolo dualAUTOpara VAS + Smart Tap) bajo Configuración de validación -> Ajustes NFC junto con su Lugar de validación, de modo que las lecturas sin contacto ejecuten exactamente el mismo motor de 14 reglas de validación y mecánicas que el escaneo óptico de códigos de barras.
Esquema Smart Tap en Class y Object de Google Wallet
Cuando Passinstance sincroniza una plantilla y un pase habilitados para Smart Tap con la API walletobjects/v1 de Google, incluye las siguientes propiedades del protocolo:
{
"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"
}
}
}
Referencia de API de configuración y validación Smart Tap
| Método | Ruta del endpoint | Descripción |
|---|---|---|
| POST | /api/v1/google-wallet/setup | Configura su cuenta emisora de Google Wallet y aprovisiona su collectorId de Smart Tap y smartTapMerchantData. |
| GET | /api/v1/google-wallet/status | Devuelve { isConfigured, collectorId } para su configuración de Google Wallet y Smart Tap en el espacio de trabajo. |
| PUT | /api/v1/reader/validate | Configura las claves de colector Smart Tap / VAS de lectores hardware y los valores predeterminados NFC en la integración del espacio de trabajo. |
| POST | /api/v1/reader/redeem | Procesa un payload de canje por proximidad ya descifrado por el lector (X-Reader-Secret, request payload). |
Ejemplo: comprobar el Collector ID de Smart Tap aprovisionado
GET /api/v1/google-wallet/status
X-API-Key: <API_KEY>
Respuesta (200 OK):
{
"isConfigured": true,
"collectorId": "50992104"
}
Configure el collectorId coincidente y las ranuras de claves ECDH en su lector físico mediante Configuración -> Wallet -> NFC (/settings/workspace/wallet/nfc) o descargue un archivo config.txt para NFC mediante GET /api/v1/reader/devices/:id/config-file.
Mantenga siempre el respaldo de código de barras óptico
Incluso con NFC_SMART_TAP activo en sus líneas de caja, mantenga habilitado un código de barras 2D QR o Aztec estándar en el diseño del pase (nfcNoBarcode: false) para que los clientes con teléfonos Android más antiguos o con NFC desactivado puedan seguir validándose ópticamente.
Explore Configuración de pases NFC, Apple VAS y Lectores NFC compatibles.
