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

Leitores NFC compatíveis

Configure leitores NFC sem contato suportados por ponto de validação nas definições NFC.

Neste guia

Visão Geral: Selecionar e Emparelhar Hardware Leitor Sem Contacto

Como os smartphones iOS e Android de consumo restringem a emulação simples de cartões anfitriões e exigem handshakes criptográficos do terminal para passes de carteira de circuito fechado, a verdadeira validação por aproximação requer hardware leitor Apple VAS + Google Smart Tap. A Passinstance modela e autentica nativamente parques físicos de leitores através das entidades de base de dados hardware reader, reader device, store location e POS terminal.

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
FLUXO DA ARQUITETURA DO SISTEMA: LEITOR NFC DE HARDWARE E INTEGRAÇÃO POS
ETAPA 01 APROXIMAÇÃO DO DISPOSITIVO DO CLIENTE (iPhone / Watch / Android)
Campo RF 13,56 MHz ISO/IEC 14443Apple VAS / Google Smart Tap
ETAPA 02 CAMADA DE HARDWARE LEITOR NFC FÍSICO
certified NFC50 / NFC Terminal (USB Keyboard Wedge, Virtual COM ou Cloud HTTP)
Terminais POS Empresariais (Verifone P400/V400m, Ingenico Lane/Move, Square)
Desencripta o payload VAS / Smart Tap no Secure Element do hardware (slot 1..6)
Modo A: Push Cloud HTTP
ETAPA 03A `POST/api/v1/
integrations/hardware/ reader/validate`
Wi-Fi/Ethernet direto
Modo B: API Gateway POS
ETAPA 03B `POST/api/v1/reader/
redeem`
Header: `X-Reader-Secre
Ligado a request payload
Modo C: USB Wedge
ETAPA 03C Emite serialNumber
desencriptado + CR no campo de entra do Web/Desktop Scan.
ETAPA 04 MOTOR DE VALIDAÇÃO DE 14 REGRAS E MECÂNICAS PASSINSTANCE (/scans)
Executa a regra Selo/Pontos/Pré-pago/Check-In e envia atualização APNs / Google

Arquiteturas de Leitores Suportadas e NfcReaderMode

A Passinstance suporta quatro modos operacionais definidos pelo enum de backend NfcReaderMode entre os fornecedores de hardware suportados (reader provider: HID, ZEBRA, INGENICO, VERIFONE, PAX, SUNMI):

Enum NfcReaderModeComportamento do Protocolo e Adequação de Hardware
AUTOInterrogação automática de protocolo duplo: o terminal alterna entre Apple VAS e Google Smart Tap numa única janela de aproximação de 300ms (recomendado para certified NFC e terminais POS modernos).
KEYBOARD_WEDGEEmulação de teclado HID USB: o leitor desencripta o payload do passe no dispositivo e escreve o serialNumber + Enter diretamente no Web Scanner da Passinstance ou no ecrã de caixa do POS.
APPLE_WALLETInterrogação dedicada apenas a Apple VAS; otimizado para ambientes exclusivos iOS ou torniquetes rápidos de protocolo único.
GOOGLE_SMART_TAPInterrogação NDEF dedicada apenas a Google Smart Tap.

Famílias de Hardware Certificadas

  1. 1
    Leitores certified NFC (NFC Terminal, NFC Terminal, NFC Terminal Wi-Fi/PoE): Leitores NFC dedicados para carteiras móveis que suportam desencriptação simultânea Apple VAS e Google Smart Tap. As unidades NFC Pro enviam aproximações desencriptadas diretamente para POST /api/v1/reader/validate com cabeçalho de assinatura HMAC x-reader-signature (ou x-signature).
  2. 2
    Terminais Verifone, Ingenico, HID, Zebra, PAX e Sunmi: Terminais empresariais modelados através de reader provider e registos store location / POS terminal / hardware reader.
  3. 3
    Leitores Óticos de Balcão 2D (Alternativa Sem Autorização): Leitores de códigos de barras óticos 2D padrão (Zebra, Honeywell, Tera) a ler códigos QR/Aztec da Carteira em modo KEYBOARD_WEDGE oferecem implementação instantânea sem necessidade de aprovações de chaves NFC da Apple/Google.

Importante: Os leitores que chamam POST /api/v1/reader/redeem ou /api/v1/reader/validate têm de se autenticar com X-Reader-Secret (reader integration secret), ao passo que os webhooks na cloud NFC que chamam POST /api/v1/reader/validate assinam os pedidos com x-reader-signature / x-signature.

Endpoints da API de Leitores de Hardware e Terminais (Reader Management API / Reader Orchestration API)

MétodoCaminho do EndpointCabeçalho AuthDescrição
GET / POST/api/v1/reader/devicesBearer / API KeyLista ou regista dispositivos hardware reader certified NFC (GET/PUT/DELETE .../readers/:id e POST .../readers/:id/test).
GET/api/v1/reader/devices/:id/config-fileBearer / API KeyGera um pacote config.txt pronto a carregar para leitores certified NFC (VAS1MerchantID, ST1CollectorID, ranhuras de chaves e URL de webhook cloud).
POST/api/v1/reader/validatex-reader-signatureWebhook dedicado de receção de aproximações para leitores cloud certified NFC Pro (reader event payload, além de lote /events/batch).
POST/api/v1/reader/validateX-Reader-SecretValida uma entrada por barcodeValue (request payload: customerId, barcodeValue, idempotencyKey, operatorId?, location?).
POST/api/v1/reader/redeemX-Reader-SecretProcessa um resgate idempotente por aproximação (request payload: customerId, passId, amount?, idempotencyKey, operatorId?).

Exemplo: Resgate por Aproximação em Leitor de Hardware (POST /api/v1/reader/redeem)

JSON
POST /api/v1/reader/redeem
Headers:
  X-Reader-Secret: <reader integration secret>
  Content-Type: application/json

{
  "customerId": "8f94d930-b302-4fc8-9f12-000000000001",
  "passId": "c41a8d20-6e11-4f3b-9a81-0029d81a4f10",
  "amount": "12.50",
  "idempotencyKey": "tap_01J9Z9K2M4N6P8Q0R2S4",
  "operatorId": "term_checkout_lane_02"
}

Resposta (200 OK):

JSON
{
  "success": true,
  "resultingValue": "37.50"
}

Consulte Configuração de Passes NFC, Apple VAS, Google Smart Tap e Configuração e Definições do Scanner.

Documentação de produto e API relacionada

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.