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

Configuration des passes NFC

Distinguez les tags NFC NDEF ouverts (URL de téléchargement) du passage sans contact chiffré sur terminal dédié.

Dans ce guide

Visites interactives de l'interface

Ouvrir dans le guide en 6 phases

Inspectez les écrans exacts du tableau de bord et les zooms annotés liés à ce guide.

Focus interface zoomé
Éléments clés de l'interface

Configuration Code-barres, QR code et NFC (Zoom)

Configurez le format QR-Code, la source de valeur, le jeton dynamique ({memberQrToken}), le texte alternatif ({passReference}) et le NFC.

Deux usages très différents du terme « NFC » sur les passes Wallet

Important : Avant de cadrer un projet d'encaissement ou de contrôle d'accès sans contact avec vos équipes, distinguez bien la distribution par tag NFC NDEF (étiquettes URL standard ouvertes fonctionnant nativement sur n'importe quel smartphone) de la validation chiffrée sans contact (Apple VAS et Google Smart Tap, qui transmettent une charge utile chiffrée depuis le portefeuille vers un terminal lecteur NFC spécialisé).

CapacitéObjectifProtocole & modèleMatériel & autorisations nécessaires
Distribution par tag NFC NDEFLe client approche son téléphone déverrouillé d'un autocollant comptoir -> ouvre le lien Ajouter au Wallet ou PassFlowEnregistrement URI NDEF ISO/IEC 14443Simple sticker NTAG213/215 peu coûteux ; aucun lecteur dédié ni agrément Apple VAS requis.
Passage sans contact (Apple VAS / Google Smart Tap)Le client approche son iPhone/Watch ou Android d'un terminal -> le lecteur déchiffre la charge (message)Apple VAS & Google Smart Tap (modèle NFC & Template.nfc)Nécessite un matériel lecteur compatible VAS/Smart Tap + configuration des clés cryptographiques marchand (non activé par défaut sur tous les comptes).

Architecture du modèle NFC & du dictionnaire nfc dans pass.json

Lorsque la lecture sans contact est activée sur un modèle (Template.nfc / modèle Passinstance database NFC), Passinstance intègre les métadonnées cryptographiques NFC à la fois dans le dictionnaire nfc du fichier Apple Wallet pass.json et dans smartTapRedemptionValue côté Google Wallet :

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
CHARGE UTILE NFC CHIFFRÉE & DIALOGUE TERMINAL
ÉTAPE 01 SCHÉMA NFC DU MODÈLE & DU PASSE (Modèle NFC)
nfcEnabled : true
message : Charge dynamique (max 64 octets, ex. serialNumber ou jeton)
encryptionPublicKey : Clé publique Base64 ECDH P-256 (prime256v1)
requiresAuthentication (nfcFaceIdRequired) : Exige Face ID / Touch ID
nfcNoBarcode : Masque optionnellement le code-barres 2D au recto de la carte
Apple Wallet pass.json
ÉTAPE 02A "nfc": {
"message": "PI-8849-2026-X9", "encryptionPublicKey": "MDkwEw...", "requiresAuthentication": true }
[ Champ RF 13,56 MH
TERMINAL LECTEUR CAISSE / A
1
Diffuse le hash Pass Type ID Apple VA
2
Établit une session ECDH P-256 éphémè
3
Transmet le message déchiffré vers
Google Wallet WalletObject
ÉTAPE 02B "smartTapRedemptionValue": "<msg>"
"hasUsers": true
Lié à redemptionIssuers de Class (collectorId / clé ECDH P-256)
SO/IEC 14443 ]
S (NFC / Verifone / Ingenico) le Collector ID Google Smart Tap
& déchiffre en AES-GCM
ST /api/v1/scansou/reader/redeem`

Propriétés & contraintes de configuration NFC

Propriété (NFC / Template.nfc)Clé Apple pass.jsonType & contrainteComportement technique
messagenfc.messagestring (Max 64 octets UTF-8)La donnée en clair chiffrée par le téléphone puis envoyée au lecteur NFC (par défaut serialNumber ou externalId du passe).
encryptionPublicKeynfc.encryptionPublicKeystring (DER/PEM Base64)Clé publique ECDH P-256 (prime256v1) compressée ou non compressée correspondant à la clé privée chargée sur vos lecteurs NFC.
nfcFaceIdRequirednfc.requiresAuthenticationbooleanSi true, iOS impose au titulaire de s'authentifier via Face ID, Touch ID ou code d'accès avant d'émettre le signal VAS.
nfcNoBarcodeOmet barcodes[]booleanSi true, supprime le code-barres 2D QR/Aztec visuel afin que le passe soit présenté uniquement par lecture NFC chiffrée.

Exemple : dictionnaire nfc dans pass.json Apple Wallet & configuration du modèle

Lorsque nfcEnabled: true est configuré sur un modèle, Passinstance sérialise l'objet nfc à la racine de pass.json :

JSON
{
  "formatVersion": 1,
  "passTypeIdentifier": "pass.com.phenixroasters.access",
  "serialNumber": "PI-8849-2026-X9",
  "nfc": {
    "message": "PI-8849-2026-X9",
    "encryptionPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE8v3x9K2m5N7p1Q4r6S8t0V2w4Y6z8A1b3C5d7E9f0G2h4J6k8L0m2N4p6Q8r0S==",
    "requiresAuthentication": true
  }
}

Pour mettre à jour les paramètres NFC d'un modèle via l'API REST (et contrôler la configuration via POST /api/v1/nfc/test) :

JSON
PATCH /api/v1/templates/7b9e4c12-3f81-4a90-b8d2-19c48a70e112
{
  "nfc": {
    "message": "{serialNumber}",
    "encryptionPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE8v3x9K2m5N7p1Q4r6S8t0V2w4Y6z8A1b3C5d7E9f0G2h4J6k8L0m2N4p6Q8r0S==",
    "requiresAuthentication": true
  },
  "nfcFaceIdRequired": true,
  "nfcNoBarcode": false
}

Bonne pratique : conservez le code-barres optique 2D en secours

Sauf si vous déployez des badges d'accès professionnels haute sécurité interdisant strictement les captures d'écran de codes-barres (nfcNoBarcode: true ou addSecurityAnimation: true), conservez nfcNoBarcode: false pour afficher un QR code ou code Aztec de secours. Vos équipes pourront ainsi toujours scanner la carte optiquement si un lecteur est hors ligne ou si la puce NFC d'un client est désactivée.

Consultez Portée des passes NFC Wallet, Apple VAS, Google Smart Tap et Lecteurs NFC compatibles.

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.