Skip to content
Helpcentrum-gids · NFC & contactloos
3 min leestijdGecontroleerd 2026-11-16

Compatibele NFC-lezers

Configureer ondersteunde contactloze NFC-terminals per validatieplek in Passinstance NFC.

In deze gids

Overzicht: contactloze lezerhardware selecteren & koppelen

Omdat iOS- en Android-smartphones voor consumenten directe host-card-emulatie beperken en cryptografische terminal-handshakes vereisen voor closed-loop walletpassen, is voor echte tap-to-redeem lezerhardware vereist met ondersteuning voor Apple VAS + Google Smart Tap. Passinstance modelleert en authenticeert fysieke lezerparken rechtstreeks via de database-entiteiten hardware reader, reader device, store location en POS terminal.

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
HARDWARE NFC-LEZER & POS-TERMINALINTEGRATIE
FASE 01 KLANTAPPARAAT-TAP (iPhone / Watch / Android)
13.56 MHz ISO/IEC 14443 RF-veldApple VAS / Google Smart Tap
FASE 02 FYSIEKE NFC-LEZERHARDWARE-LAAG
certified NFC50 / NFC Terminal (USB Keyboard Wedge, Virtual COM of Cloud HTTP)
Enterprise POS-betaalterminals (Verifone P400/V400m, Ingenico Lane/Move, Square)
Ontsleutelt VAS / Smart Tap-payload in hardware Secure Element (slot 1..6)
Modus A: Cloud HTTP Push
FASE 03A `POST/api/v1/
integrations/hardware/ reader/validate`
Direct Wi-Fi/Ethernet
Modus B: POS Gateway API
FASE 03B `POST/api/v1/reader/
redeem`
Header: X-Reader-Secret
Gebonden: request payload
Modus C: USB Wedge
FASE 03C Stuurt ontsleutelde
serialNumber + CR in invoerveld van
Web-/Desktopscanner
FASE 04 PASSINSTANCE 14-REGELIGE VALIDATIE- & MECHANICA-ENGINE (/scans)
Voert Stempel/Punten/Prepaid/Check-in uit & pusht live APNs- / Google-update

Ondersteunde lezerarchitecturen & NfcReaderMode

Passinstance ondersteunt vier operationele modi zoals gedefinieerd door de backend-enum NfcReaderMode over de ondersteunde hardwareproviders (reader provider: HID, ZEBRA, INGENICO, VERIFONE, PAX, SUNMI):

NfcReaderMode-enumProtocolgedrag & geschikte hardware
AUTOAutomatisch dual-protocol pollen: de terminal wisselt binnen één tapvenster van 300 ms af tussen Apple VAS en Google Smart Tap (aanbevolen voor certified NFC en moderne POS-terminals).
KEYBOARD_WEDGEUSB HID-toetsenbordemulatie: de lezer ontsleutelt de paspayload op het apparaat en typt het serialNumber + Enter rechtstreeks in de Passinstance Web Scanner of het POS-kassascherm.
APPLE_WALLETUitsluitend Apple VAS-pollen; geoptimaliseerd voor omgevingen met alleen iOS of snelle single-protocol toegangspoorten.
GOOGLE_SMART_TAPUitsluitend Google Smart Tap NDEF-pollen.

Gecertificeerde hardwarefamilies

  1. 1
    certified NFC-lezers (NFC Terminal, NFC Terminal, NFC Terminal Wi-Fi/PoE): speciaal gebouwde NFC-lezers voor mobiele wallets die gelijktijdige ontsleuteling van Apple VAS en Google Smart Tap ondersteunen. NFC Pro-units sturen ontsleutelde taps rechtstreeks door naar POST /api/v1/reader/validate met de HMAC-handtekeningheader x-reader-signature (of x-signature).
  2. 2
    Verifone-, Ingenico-, HID-, Zebra-, PAX- & Sunmi-terminals: enterprise-terminals gemodelleerd via reader provider en de records store location, POS terminal en hardware reader.
  3. 3
    2D optische baliescanners (terugvaloptie zonder entitlements): standaard optische 2D-barcodescanners (Zebra, Honeywell, Tera) die Wallet QR-/Aztec-codes lezen in de modus KEYBOARD_WEDGE bieden directe inzetbaarheid zonder Apple- of Google NFC-sleutelgoedkeuring.

Belangrijk: Lezers die POST /api/v1/reader/redeem of /api/v1/reader/validate aanroepen, moeten zich authenticeren met X-Reader-Secret (reader integration secret), terwijl NFC cloud-webhooks die POST /api/v1/reader/validate aanroepen hun verzoeken ondertekenen met x-reader-signature / x-signature.

API-endpoints voor hardwarelezers & terminals (Reader Management API / Reader Orchestration API)

MethodeEndpoint-padAuth-headerBeschrijving
GET / POST/api/v1/reader/devicesBearer / API KeyGeeft een overzicht van of registreert certified NFC hardware reader-apparaten (GET/PUT/DELETE .../readers/:id en POST .../readers/:id/test).
GET/api/v1/reader/devices/:id/config-fileBearer / API KeyGenereert een kant-en-klare config.txt-bundel voor certified NFC-lezers (VAS1MerchantID, ST1CollectorID, sleutelslots en cloud-webhook-URL).
POST/api/v1/reader/validatex-reader-signatureSpecifieke webhook voor tapinvoer van certified NFC Pro cloud-lezers (reader event payload, plus batch /events/batch).
POST/api/v1/reader/validateX-Reader-SecretValideert een invoer op barcodeValue (request payload: customerId, barcodeValue, idempotencyKey, operatorId?, location?).
POST/api/v1/reader/redeemX-Reader-SecretVerwerkt een idempotente tap-inwisseling (request payload: customerId, passId, amount?, idempotencyKey, operatorId?).

Voorbeeld: tap-inwisseling via hardwarelezer (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"
}

Antwoord (200 OK):

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

Bekijk NFC-pasconfiguratie, Apple VAS, Google Smart Tap en Scannerconfiguratie & -instellingen.

Gerelateerde product- en ontwikkelaarsdocs

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.