Skip to content
Guia da Central de Ajuda · NFC e sem contacto
3 min de leituraVerificado 2026-11-16

Google Smart Tap

Requisitos para Google Smart Tap sem contacto: Collector ID, par de chaves e definição NFC_SMART_TAP.

Neste guia

O Que É o Google Smart Tap?

O Google Smart Tap (NFC_SMART_TAP) é o protocolo encriptado de apresentação NFC sem contacto da Google Wallet baseado na negociação de serviços NDEF NFC Forum Type 4 Tag / ISO-DEP. Permite que smartphones Android transmitam uma credencial de passe de Fidelização, Oferta, Cartão Presente, Bilhete de Evento ou Genérico através de NFC a 13,56 MHz diretamente para terminais POS ou de acesso compatíveis, sem exigir que o utilizador procure e abra um código de barras no ecrã.

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
FLUXO DA ARQUITETURA DO SISTEMA: NEGOCIAÇÃO NDEF GOOGLE SMART TAP E ECDH P-256
ETAPA 01 FASE 1: EMISSOR, COLLECTOR ID E ASSOCIAÇÃO DE CHAVES DE CLASSE
1
Configurar smartTapMerchantId e collectorId hex/int de 8 dígitos via POST/api/v1/google-wallet/setup
2
Registar Chave Pública ECDH P-256 + Versão na Conta Emissora Google Wallet
3
Ativar Smart Tap na Classe (enableSmartTap: true, redemptionIssuers)
4
Preencher smartTapRedemptionValue em cada Objeto de Passe (LoyaltyObject)
ETAPA 02 FASE 2: NEGOCIAÇÃO DE SERVIÇO NDEF SEM CONTACTO (NFC_SMART_TAP)
1
O leitor seleciona o Smart Tap AID (A000000476D0000111) sobre ISO-DEP
2
Negoceia sessão NDEF (Negotiate SmartTap Request + Chave Efémera do Leitor)
3
Dispositivo Android corresponde collectorId, assina e encripta smartTapRedemptionValue com ECDH P-256 + AES-128-CTR / HMAC-SHA256
4
O leitor desencripta o payloadEnvia ao Motor de Validação Passinstance (readerType: "NFC_SMART_TAP"POST/api/v1/reader/redeem ou /scans)

Pré-requisitos e Parâmetros de Configuração

Pré-requisitos: Para utilizar o Google Smart Tap (NFC_SMART_TAP) em localizações físicas, a sua Classe Google Wallet tem de declarar os redemptionIssuers (issuerId) autorizados, o terminal tem de difundir o collectorId de 32 bits correspondente e a sua Configuração de Validação na Passinstance tem de ativar o modo de leitor NFC_SMART_TAP.

  1. 1
    Collector ID da Google Pay & Wallet Business Console (collectorId): Configure um Collector ID numérico único (e smartTapMerchantId) no seu perfil de Emissor da Google Wallet e carregue a sua chave pública ECDH P-256 (prime256v1) comprimida com um número inteiro de versão da chave (por exemplo, 1).
  2. 2
    Hidratação Smart Tap em Classes e Objetos: Quando nfcEnabled: true está ativo num modelo Passinstance, a plataforma define automaticamente enableSmartTap: true e redemptionIssuers: ["<issuerId>"] na Classe Google Wallet e escreve o serialNumber do passe (ou mensagem NFC personalizada) em smartTapRedemptionValue em cada Objeto Google Wallet emitido.
  3. 3
    Emparelhamento do Terminal Leitor: Carregue o collectorId, a versão da chave e a chave privada ECDH P-256 correspondentes no perfil do seu terminal POS ou leitor certified NFC.
  4. 4
    Definições do Leitor Passinstance (NFC_SMART_TAP): Configure o modo do leitor do dispositivo para NFC_SMART_TAP (ou AUTO em protocolo duplo VAS + Smart Tap) em Configuração de Validação -> Definições NFC juntamente com o seu Local de Validação, para que as aproximações sem contacto executem exatamente o mesmo motor de validação de 14 regras e mecânicas que as leituras óticas de códigos de barras.

Esquema Smart Tap de Classe e Objeto da Google Wallet

Quando a Passinstance sincroniza um modelo e um passe com Smart Tap ativado para a API walletobjects/v1 da Google, inclui as seguintes propriedades de 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"
    }
  }
}

Referência da API de Configuração e Validação Smart Tap

MétodoCaminho do EndpointDescrição
POST/api/v1/google-wallet/setupConfigura a sua conta de emissor Google Wallet e aprovisiona o seu collectorId e smartTapMerchantData do Smart Tap.
GET/api/v1/google-wallet/statusDevolve { isConfigured, collectorId } para a configuração Google Wallet e Smart Tap do seu espaço de trabalho.
PUT/api/v1/reader/validateConfigura chaves collector de leitores de hardware Smart Tap / VAS e predefinições NFC na integração do seu espaço de trabalho.
POST/api/v1/reader/redeemProcessa um payload de resgate por aproximação desencriptado pelo leitor (X-Reader-Secret, request payload).

Exemplo: Verificar o Collector ID Smart Tap Aprovisionado

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

Resposta (200 OK):

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

Configure o collectorId e as ranhuras de chaves ECDH correspondentes no seu leitor de hardware em Definições -> Carteira -> NFC (/settings/workspace/wallet/nfc) ou transfira um pacote config.txt NFC através de GET /api/v1/reader/devices/:id/config-file.

Mantenha Sempre um Código de Barras Ótico de Contingência

Mesmo com o NFC_SMART_TAP ativo nas suas caixas de pagamento, mantenha um código de barras 2D QR ou Aztec padrão ativado no layout do passe (nfcNoBarcode: false) para que os clientes com telemóveis Android mais antigos ou com o NFC desativado possam continuar a validar oticamente.

Explore Configuração de Passes NFC, Apple VAS e Leitores NFC Compatíveis.

Pronto para lançar o seu primeiro programa de cartões Wallet?

Crie o seu espaço de trabalho, configure o seu modelo e teste um cartão real na Apple Wallet e Google Wallet antes de escalar.