Skip to content
Guía del Centro de ayuda · NFC y sin contacto
3 min de lecturaVerificado 2026-11-16

Google Smart Tap

Requisitos de Google Smart Tap: Collector ID, par de claves y parámetros NFC_SMART_TAP.

En esta guía

¿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.

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
NEGOCIACIÓN NDEF Y ECDH P-256 EN GOOGLE SMART TAP
ETAPA 01 FASE 1: VÍNCULO DE EMISOR, COLLECTOR ID Y CLAVES DE CLASE
1
Configurar smartTapMerchantId y collectorId (8 dígitos hex/int) mediante POST/api/v1/google-wallet/setup
2
Registrar clave pública ECDH P-256 + versión de clave en Google Wallet Issuer
3
Activar Smart Tap en Class (enableSmartTap: true, redemptionIssuers: [...])
4
Rellenar smartTapRedemptionValue en cada objeto (LoyaltyObject, etc.)
ETAPA 02 FASE 2: NEGOCIACIÓN DE SERVICIO NDEF SIN CONTACTO (NFC_SMART_TAP)
1
El lector selecciona el AID Smart Tap (A000000476D0000111) sobre ISO-DEP
2
Negocia sesión NDEF (Negotiate SmartTap Request + clave efímera del lector)
3
Android valida collectorId, firma y cifra smartTapRedemptionValue usando secreto compartido ECDH P-256 + AES-128-CTR / HMAC-SHA256
4
El lector descifra el payloadEnvía al motor de validación Passinstance (readerType: "NFC_SMART_TAP"POST/api/v1/reader/redeem o /scans)

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 sus redemptionIssuers autorizados (issuerId), su terminal debe anunciar el collectorId de 32 bits coincidente y su Configuración de validación en Passinstance debe tener habilitado el modo de lector NFC_SMART_TAP.

  1. 1
    Collector ID en Google Pay & Wallet Business Console (collectorId): Configure un Collector ID numérico único (y smartTapMerchantId) 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. 2
    Hidratación de Smart Tap en Class y Object: Cuando nfcEnabled: true está activo en una plantilla de Passinstance, Passinstance establece automáticamente enableSmartTap: true y redemptionIssuers: ["<issuerId>"] en la Google Wallet Class, y escribe el serialNumber del pase (o el mensaje NFC personalizado) en smartTapRedemptionValue de cada Google Wallet Object emitido.
  3. 3
    Emparejamiento del terminal lector: Cargue el collectorId coincidente, la versión de clave y la clave privada ECDH P-256 en el perfil de su POS o lector certified NFC.
  4. 4
    Ajustes del lector en Passinstance (NFC_SMART_TAP): Configure el modo del lector del dispositivo en NFC_SMART_TAP (o protocolo dual AUTO para 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:

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

Referencia de API de configuración y validación Smart Tap

MétodoRuta del endpointDescripción
POST/api/v1/google-wallet/setupConfigura su cuenta emisora de Google Wallet y aprovisiona su collectorId de Smart Tap y smartTapMerchantData.
GET/api/v1/google-wallet/statusDevuelve { isConfigured, collectorId } para su configuración de Google Wallet y Smart Tap en el espacio de trabajo.
PUT/api/v1/reader/validateConfigura 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/redeemProcesa 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

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

Respuesta (200 OK):

JSON
{
  "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.

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.