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ã.
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 osredemptionIssuers(issuerId) autorizados, o terminal tem de difundir ocollectorIdde 32 bits correspondente e a sua Configuração de Validação na Passinstance tem de ativar o modo de leitorNFC_SMART_TAP.
-
1
Collector ID da Google Pay & Wallet Business Console (
collectorId): Configure um Collector ID numérico único (esmartTapMerchantId) 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
Hidratação Smart Tap em Classes e Objetos: Quando
nfcEnabled: trueestá ativo num modelo Passinstance, a plataforma define automaticamenteenableSmartTap: trueeredemptionIssuers: ["<issuerId>"]na Classe Google Wallet e escreve oserialNumberdo passe (ou mensagem NFC personalizada) emsmartTapRedemptionValueem cada Objeto Google Wallet emitido. -
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
Definições do Leitor Passinstance (
NFC_SMART_TAP): Configure o modo do leitor do dispositivo paraNFC_SMART_TAP(ouAUTOem 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:
{
"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étodo | Caminho do Endpoint | Descrição |
|---|---|---|
| POST | /api/v1/google-wallet/setup | Configura a sua conta de emissor Google Wallet e aprovisiona o seu collectorId e smartTapMerchantData do Smart Tap. |
| GET | /api/v1/google-wallet/status | Devolve { isConfigured, collectorId } para a configuração Google Wallet e Smart Tap do seu espaço de trabalho. |
| PUT | /api/v1/reader/validate | Configura 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/redeem | Processa um payload de resgate por aproximação desencriptado pelo leitor (X-Reader-Secret, request payload). |
Exemplo: Verificar o Collector ID Smart Tap Aprovisionado
GET /api/v1/google-wallet/status
X-API-Key: <API_KEY>
Resposta (200 OK):
{
"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.
