Skip to content
Help Center Guide · NFC & Contactless
3 min readVerified 2026-11-16

Compatible NFC Readers

Configure compatible contactless NFC readers per Validation Place using Passinstance NFC settings.

In This Guide

Overview: Selecting & Pairing Contactless Reader Hardware

Because consumer iOS and Android smartphones restrict raw host-card emulation and require cryptographic terminal handshakes for closed-loop wallet passes, true tap-to-redeem requires Apple VAS + Google Smart Tap reader hardware. Passinstance natively models and authenticates physical reader estates through the hardware reader, reader device, store location, and POS terminal database entities.

SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
HARDWARE NFC READER & POS TERMINAL INTEGRATION
STAGE 01 CUSTOMER DEVICE TAP (iPhone / Watch / Android)
13.56 MHz ISO/IEC 14443 RF FieldApple VAS / Google Smart Tap
STAGE 02 PHYSICAL NFC READER HARDWARE LAYER
certified NFC50 / NFC Terminal (USB Keyboard Wedge, Virtual COM, or Cloud HTTP)
Enterprise POS Pin Pads (Verifone P400/V400m, Ingenico Lane/Move, Square)
Decrypts VAS / Smart Tap payload in hardware Secure Element (slot 1..6)
Mode A: Cloud HTTP Push
STAGE 03A `POST/api/v1/
integrations/hardware/ reader/validate`
Direct Wi-Fi/Ethernet
Mode B: POS Gateway API
STAGE 03B `POST/api/v1/reader/
redeem`
Header: X-Reader-Secret
Bound to request payload
Mode C: USB Wedge
STAGE 03C Emits decrypted
serialNumber + CR into Web/Desktop
Scanner input field
STAGE 04 PASSINSTANCE 14-RULE VALIDATION & MECHANIC ENGINE (/scans)
Executes Stamp/Points/Prepaid/Check-In rule & pushes live APNs / Google update

Supported Reader Architectures & NfcReaderMode

Passinstance supports four operational modes defined by the backend NfcReaderMode enum across supported hardware providers (reader provider: HID, ZEBRA, INGENICO, VERIFONE, PAX, SUNMI):

NfcReaderMode EnumProtocol Behavior & Hardware Fit
AUTODual-protocol automatic polling: terminal alternates between Apple VAS and Google Smart Tap within a single 300ms tap window (recommended for certified NFC and modern POS terminals).
KEYBOARD_WEDGEUSB HID keyboard emulation: the reader decrypts the pass payload on-device and types the serialNumber + Enter directly into the Passinstance Web Scanner or POS checkout screen.
APPLE_WALLETDedicated Apple VAS polling only; optimized for iOS-exclusive environments or fast single-protocol turnstiles.
GOOGLE_SMART_TAPDedicated Google Smart Tap NDEF polling only.

Certified Hardware Families

  1. 1
    certified NFC Readers (NFC Terminal, NFC Terminal, NFC Terminal Wi-Fi/PoE): Purpose-built mobile wallet NFC readers supporting simultaneous Apple VAS and Google Smart Tap decryption. NFC Pro units post decrypted taps directly to POST /api/v1/reader/validate with HMAC signature header x-reader-signature (or x-signature).
  2. 2
    Verifone, Ingenico, HID, Zebra, PAX & Sunmi Terminals: Enterprise terminals modeled via reader provider and store location / POS terminal / hardware reader records.
  3. 3
    2D Optical Counter Scanners (Zero-Entitlement Fallback): Standard 2D optical barcode scanners (Zebra, Honeywell, Tera) reading Wallet QR/Aztec codes in KEYBOARD_WEDGE mode provide instant deployment with zero Apple/Google NFC key approvals.

Important: Readers calling POST /api/v1/reader/redeem or /api/v1/reader/validate must authenticate using X-Reader-Secret (reader integration secret), whereas NFC cloud webhooks calling POST /api/v1/reader/validate sign requests with x-reader-signature / x-signature.

Hardware Reader & Terminal API Endpoints (Reader Management API / Reader Orchestration API)

MethodEndpoint PathAuth HeaderDescription
GET / POST/api/v1/reader/devicesBearer / API KeyLists or registers certified NFC hardware reader devices (GET/PUT/DELETE .../readers/:id and POST .../readers/:id/test).
GET/api/v1/reader/devices/:id/config-fileBearer / API KeyGenerates a ready-to-load config.txt bundle for certified NFC readers (VAS1MerchantID, ST1CollectorID, key slots, and cloud webhook URL).
POST/api/v1/reader/validatex-reader-signatureDedicated tap ingestion webhook for certified NFC Pro cloud readers (reader event payload, plus batch /events/batch).
POST/api/v1/reader/validateX-Reader-SecretValidates an entry by barcodeValue (request payload: customerId, barcodeValue, idempotencyKey, operatorId?, location?).
POST/api/v1/reader/redeemX-Reader-SecretProcesses an idempotent tap redemption (request payload: customerId, passId, amount?, idempotencyKey, operatorId?).

Example: Hardware Reader Tap Redemption (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"
}

Response (200 OK):

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

Review NFC Pass Configuration, Apple VAS, Google Smart Tap, and Scanner Setup & Configuration.

Related Product & Developer Documentation

Ready to launch your first pass program?

Create your workspace, configure your pass template, and test a real pass in Apple Wallet and Google Wallet before you scale.