Dos usos muy diferentes del término «NFC» en pases de monedero
Importante: Antes de definir un flujo de cobro sin contacto o control de acceso con las partes interesadas, distinga entre Distribución mediante etiquetas NFC NDEF (etiquetas URL de estándar abierto que funcionan de serie con cualquier smartphone) y Canje cifrado al acercar el teléfono (Apple VAS y Google Smart Tap, que transmiten un payload cifrado del pase desde el monedero hacia un terminal lector NFC especializado).
| Capacidad | Propósito | Protocolo y modelo | Hardware y aprobación necesarios |
|---|---|---|---|
| Distribución con etiqueta NFC NDEF | El cliente acerca el teléfono desbloqueado a una pegatina en mostrador -> abre la URL de Añadir al monedero o PassFlow | Registro URI NDEF ISO/IEC 14443 | Únicamente una pegatina económica NTAG213/215; no requiere lector hardware ni Apple VAS. |
| Canje por proximidad (Apple VAS / Google Smart Tap) | El cliente acerca su teléfono/Watch al terminal -> el lector descifra el payload del pase (message) | Apple VAS y Google Smart Tap (modelo NFC y Template.nfc) | Requiere hardware lector NFC VAS/Smart Tap + configuración de claves pública/privada del comercio (no viene activado por defecto en todas las cuentas). |
Modelo NFC del pase y arquitectura del diccionario nfc en pass.json
Cuando se activa el canje sin contacto en una plantilla (Template.nfc / modelo NFC de Passinstance database), Passinstance incrusta metadatos criptográficos sin contacto tanto en el diccionario nfc de pass.json en Apple Wallet como en smartTapRedemptionValue del objeto de Google Wallet:
Propiedades y restricciones de configuración NFC
Propiedad (NFC / Template.nfc) | Clave Apple pass.json | Tipo y restricción | Comportamiento técnico |
|---|---|---|---|
message | nfc.message | string (Máx. 64 bytes UTF-8) | Payload en texto plano cifrado por el dispositivo y transmitido al lector NFC (por defecto el serialNumber o externalId del pase). |
encryptionPublicKey | nfc.encryptionPublicKey | string (DER/PEM Base64) | Clave pública comprimida o sin comprimir ECDH P-256 (prime256v1) coincidente con la clave privada cargada en sus terminales lectores NFC. |
nfcFaceIdRequired | nfc.requiresAuthentication | boolean | Cuando es true, iOS exige que el titular se autentique con Face ID, Touch ID o código antes de transmitir el payload VAS. |
nfcNoBarcode | Omite barcodes[] | boolean | Cuando es true, suprime el código de barras visual QR/Aztec en el anverso para que el pase solo pueda presentarse mediante lectura NFC cifrada. |
Ejemplo: diccionario nfc en pass.json de Apple Wallet y configuración de plantilla
Cuando nfcEnabled: true está configurado en una plantilla, Passinstance serializa el diccionario nfc en la raíz 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
}
}
Para actualizar los ajustes NFC de una plantilla mediante API REST, aplique un PATCH sobre el recurso de plantilla (y compruebe la configuración con 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
}
Buenas prácticas: mantenga activo el respaldo óptico con código de barras 2D
Salvo que esté desplegando acreditaciones corporativas de alta seguridad en las que haya que impedir estrictamente capturas visuales del código (nfcNoBarcode: true o addSecurityAnimation: true), mantenga nfcNoBarcode: false para que los pases muestren también un código QR o Aztec 2D de respaldo. Así el personal podrá validar pases con cámaras ópticas si un terminal está sin conexión o si el cliente tiene desactivada la antena NFC del teléfono.
Consulte Alcance de pases NFC Wallet, Apple VAS, Google Smart Tap y Lectores NFC compatibles.
