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é | Objectif | Protocole & modèle | Matériel & autorisations nécessaires |
|---|---|---|---|
| Distribution par tag NFC NDEF | Le client approche son téléphone déverrouillé d'un autocollant comptoir -> ouvre le lien Ajouter au Wallet ou PassFlow | Enregistrement URI NDEF ISO/IEC 14443 | Simple 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 :
Propriétés & contraintes de configuration NFC
Propriété (NFC / Template.nfc) | Clé Apple pass.json | Type & contrainte | Comportement technique |
|---|---|---|---|
message | nfc.message | string (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). |
encryptionPublicKey | nfc.encryptionPublicKey | string (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. |
nfcFaceIdRequired | nfc.requiresAuthentication | boolean | Si true, iOS impose au titulaire de s'authentifier via Face ID, Touch ID ou code d'accès avant d'émettre le signal VAS. |
nfcNoBarcode | Omet barcodes[] | boolean | Si 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 :
{
"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) :
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.
