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

Lectores NFC compatibles

Configura lectores NFC sin contacto compatibles por punto de validación en Passinstance.

En esta guía

Descripción general: selección y emparejamiento de hardware lector sin contacto

Debido a que los teléfonos inteligentes iOS y Android restringen la emulación directa de tarjetas y exigen protocolos criptográficos con el terminal para pases de monedero de circuito cerrado, el canje real por aproximación requiere hardware lector Apple VAS + Google Smart Tap. Passinstance modela y autentica de forma nativa parques de lectores físicos mediante las entidades de base de datos hardware reader, reader device, store location y POS terminal.

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
LECTOR NFC HARDWARE E INTEGRACIÓN POS
ETAPA 01 LECTURA POR PROXIMIDAD DEL CLIENTE (iPhone / Watch / Android)
Campo RF 13,56 MHz ISO/IEC 14443Apple VAS / Google Smart Tap
ETAPA 02 CAPA DE HARDWARE LECTOR NFC FÍSICO
certified NFC50 / NFC Terminal (USB Keyboard Wedge, COM virtual o HTTP Cloud)
Pin Pads POS empresariales (Verifone P400/V400m, Ingenico Lane/Move, Square)
Descifra payload VAS / Smart Tap en Secure Element del lector (slot 1..6)
Modo A: Push HTTP Cloud
ETAPA 03A `POST/api/v1/
integrations/hardware/ reader/validate`
Wi-Fi/Ethernet directo
Modo B: API Pasarela POS
ETAPA 03B `POST/api/v1/reader/
redeem`
Cabecera: `X-Reader-Sec
Vinculado request payload
Modo C: USB Wedge
ETAPA 03C Introduce el
serialNumber + CR ` | descifrado en cam del Escáner Web/POS
ETAPA 04 MOTOR DE VALIDACIÓN DE 14 REGLAS Y MECÁNICAS PASSINSTANCE (/scans)
Ejecuta regla Sello/Puntos/Prepago/Check-In y envía update APNs / Google en vivo

Arquitecturas de lectores compatibles y NfcReaderMode

Passinstance admite cuatro modos operativos definidos por el enum de backend NfcReaderMode entre los proveedores de hardware compatibles (reader provider: HID, ZEBRA, INGENICO, VERIFONE, PAX, SUNMI):

Enum NfcReaderModeComportamiento de protocolo e idoneidad de hardware
AUTOSondeo automático de protocolo dual: el terminal alterna entre Apple VAS y Google Smart Tap dentro de una misma ventana de 300 ms al acercar el teléfono (recomendado para certified NFC y terminales POS modernos).
KEYBOARD_WEDGEEmulación de teclado USB HID: el lector descifra el payload del pase localmente y escribe el serialNumber + Enter directamente en el Escáner Web de Passinstance o en la pantalla de cobro del POS.
APPLE_WALLETSondeo dedicado exclusivamente a Apple VAS; optimizado para entornos exclusivos de iOS o tornos rápidos de protocolo único.
GOOGLE_SMART_TAPSondeo NDEF dedicado exclusivamente a Google Smart Tap.

Familias de hardware certificadas

  1. 1
    Lectores certified NFC (NFC Terminal, NFC Terminal, NFC Terminal Wi-Fi/PoE): Lectores NFC diseñados específicamente para monederos móviles compatibles con descifrado simultáneo de Apple VAS y Google Smart Tap. Las unidades NFC Pro envían lecturas descifradas directamente a POST /api/v1/reader/validate con cabecera de firma HMAC x-reader-signature (o x-signature).
  2. 2
    Terminales Verifone, Ingenico, HID, Zebra, PAX y Sunmi: Terminales empresariales modelados mediante reader provider y registros store location / POS terminal / hardware reader.
  3. 3
    Escáneres ópticos 2D de mostrador (respaldo sin permisos Apple/Google): Escáneres ópticos estándar de códigos 2D (Zebra, Honeywell, Tera) que leen códigos QR o Aztec en modo KEYBOARD_WEDGE ofrecen despliegue inmediato sin aprobaciones de claves NFC de Apple ni Google.

Importante: Los lectores que invocan POST /api/v1/reader/redeem o /api/v1/reader/validate deben autenticarse mediante X-Reader-Secret (reader integration secret), mientras que los webhooks en la nube NFC que invocan POST /api/v1/reader/validate firman las peticiones mediante x-reader-signature / x-signature.

Endpoints de API de lectores físicos y terminales (Reader Management API / Reader Orchestration API)

MétodoRuta del endpointCabecera de authDescripción
GET / POST/api/v1/reader/devicesBearer / Clave APILista o registra dispositivos hardware reader de certified NFC (GET/PUT/DELETE .../readers/:id y POST .../readers/:id/test).
GET/api/v1/reader/devices/:id/config-fileBearer / Clave APIGenera un archivo config.txt listo para cargar en lectores certified NFC (VAS1MerchantID, ST1CollectorID, ranuras de clave y URL de webhook en nube).
POST/api/v1/reader/validatex-reader-signatureWebhook dedicado de ingesta de lecturas para lectores en nube certified NFC Pro (reader event payload, además de /events/batch).
POST/api/v1/reader/validateX-Reader-SecretValida una entrada mediante barcodeValue (request payload: customerId, barcodeValue, idempotencyKey, operatorId?, location?).
POST/api/v1/reader/redeemX-Reader-SecretProcesa un canje por proximidad idempotente (request payload: customerId, passId, amount?, idempotencyKey, operatorId?).

Ejemplo: canje desde lector 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"
}

Respuesta (200 OK):

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

Consulte Configuración de pases NFC, Apple VAS, Google Smart Tap y Configuración del escáner.

Documentación de producto y API relacionada

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