Skip to content
Guide du centre d'aide · NFC & sans contact
3 min de lectureVérifié 2026-11-16

Lecteurs NFC compatibles

Configurez des lecteurs NFC sans contact pris en charge par point de validation via les paramètres NFC.

Dans ce guide

Aperçu : choisir et appairer le matériel lecteur sans contact

Parce que les smartphones grand public iOS et Android restreignent l'émulation de carte brute et exigent une poignée de main cryptographique avec le terminal pour les passes Wallet en boucle fermée, une véritable lecture par passage sans contact nécessite du matériel lecteur Apple VAS + Google Smart Tap. Passinstance modélise et authentifie nativement les parcs de terminaux physiques via les entités hardware reader, reader device, store location et POS terminal.

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
LECTEUR NFC MATÉRIEL & INTÉGRATION TERMINAL DE CAISSE
ÉTAPE 01 PASSAGE APPAREIL CLIENT (iPhone / Watch / Android)
Champ RF 13,56 MHz ISO/IEC 14443Apple VAS / Google Smart Tap
ÉTAPE 02 COUCHE MATÉRIELLE DU LECTEUR NFC PHYSIQUE
certified NFC50 / NFC Terminal (USB Keyboard Wedge, COM virtuel ou HTTP Cloud)
Terminaux de paiement POS (Verifone P400/V400m, Ingenico Lane/Move, Square)
Déchiffre la charge VAS / Smart Tap dans le Secure Element (slot 1..6)
Mode A : Push Cloud HTTP
ÉTAPE 03A `POST/api/v1/
integrations/hardware/ reader/validate`
Wi-Fi/Ethernet direct
Mode B : API Passerelle POS
ÉTAPE 03B `POST/api/v1/reader/
redeem`
En-tête : `X-Reader-Sec
Lié à request payload
Mode C : Émulation USB
ÉTAPE 03C Envoie le
serialNumber + CR ` | déchiffré dans le amp Web Scanner
ÉTAPE 04 MOTEUR DE VALIDATION & MÉCANIQUES PASSINSTANCE À 14 RÈGLES (/scans)
Exécute la règle Tampons/Points/Prépayé/Check-In & pousse la MàJ APNs / Google

Architectures lecteurs prises en charge & modes NfcReaderMode

Passinstance gère quatre modes de fonctionnement définis par l'énumération backend NfcReaderMode sur les constructeurs supportés (reader provider : HID, ZEBRA, INGENICO, VERIFONE, PAX, SUNMI) :

Valeur NfcReaderModeProtocole & adéquation matérielle
AUTOScrutation automatique double protocole : le terminal alterne entre Apple VAS et Google Smart Tap dans une fenêtre de 300 ms (recommandé pour certified NFC et les TPE modernes).
KEYBOARD_WEDGEÉmulation clavier USB HID : le lecteur déchiffre localement le passe puis saisit le serialNumber suivi de Entrée directement dans le Scanner Web Passinstance ou l'écran de caisse.
APPLE_WALLETScrutation dédiée Apple VAS uniquement ; optimisée pour les environnements exclusifs iOS ou les portiques à haut débit mono-protocole.
GOOGLE_SMART_TAPScrutation NDEF dédiée Google Smart Tap uniquement.

Familles matérielles certifiées

  1. 1
    Lecteurs certified NFC (NFC Terminal, NFC Terminal, NFC Terminal Wi-Fi/PoE) : Lecteurs NFC dédiés aux portefeuilles mobiles supportant le déchiffrement simultané Apple VAS et Google Smart Tap. Les boîtiers NFC Pro publient directement les passages déchiffrés sur POST /api/v1/reader/validate avec l'en-tête de signature HMAC x-reader-signature (ou x-signature).
  2. 2
    Terminaux Verifone, Ingenico, HID, Zebra, PAX & Sunmi : Terminaux professionnels modélisés via reader provider et les enregistrements store location / POS terminal / hardware reader.
  3. 3
    Douchettes optiques 2D de comptoir (solution immédiate sans agrément) : Les lecteurs optiques 2D standard (Zebra, Honeywell, Tera) lisant les codes QR/Aztec Wallet en mode KEYBOARD_WEDGE permettent un déploiement instantané sans aucune demande de clés NFC Apple ou Google.

Important : Les lecteurs appelant POST /api/v1/reader/redeem ou /api/v1/reader/validate doivent s'authentifier via l'en-tête X-Reader-Secret (reader integration secret), tandis que les webhooks cloud NFC sur POST /api/v1/reader/validate signent leurs requêtes avec x-reader-signature / x-signature.

Points d'entrée API des lecteurs & terminaux (Reader Management API / Reader Orchestration API)

MéthodeChemin du point d'entréeEn-tête d'authDescription
GET / POST/api/v1/reader/devicesBearer / API KeyListe ou enregistre les équipements hardware reader certified NFC (GET/PUT/DELETE .../readers/:id et POST .../readers/:id/test).
GET/api/v1/reader/devices/:id/config-fileBearer / API KeyGénère un fichier config.txt prêt à charger pour lecteurs certified NFC (VAS1MerchantID, ST1CollectorID, emplacements de clés et URL webhook cloud).
POST/api/v1/reader/validatex-reader-signatureWebhook d'ingestion dédié aux lecteurs cloud certified NFC Pro (reader event payload, et lots sur /events/batch).
POST/api/v1/reader/validateX-Reader-SecretValide une entrée à partir de barcodeValue (request payload : customerId, barcodeValue, idempotencyKey, operatorId?, location?).
POST/api/v1/reader/redeemX-Reader-SecretExécute un encaissement sans contact idempotent (request payload : customerId, passId, amount?, idempotencyKey, operatorId?).

Exemple : validation sans contact depuis un lecteur matériel (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"
}

Réponse (200 OK) :

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

Consultez Configuration des passes NFC, Apple VAS, Google Smart Tap et Configuration du Scanner.

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.