Skip to content
Guía del Centro de ayuda · NFC y sin contactoFase de incorporación 2
3 min de lecturaVerificado 2026-11-16

Configuración de pases NFC

Distingue etiquetas NFC NDEF abiertas (abren enlace de descarga) de la redención cifrada por lector.

En esta guía

Recorridos visuales interactivos

Abrir en la guía de 6 fases

Inspecciona las pantallas reales del panel y las anotaciones ampliadas de esta guía.

Enfoque de interfaz ampliado
Elementos clave de la interfaz

Configuración de código de barras, QR y NFC (Zoom)

Configura la codificación QR, el origen del valor, el token dinámico ({memberQrToken}), el texto alternativo ({passReference}) y NFC.

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).

CapacidadPropósitoProtocolo y modeloHardware y aprobación necesarios
Distribución con etiqueta NFC NDEFEl cliente acerca el teléfono desbloqueado a una pegatina en mostrador -> abre la URL de Añadir al monedero o PassFlowRegistro 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:

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
PAYLOAD DE PASE NFC CIFRADO Y PROTOCOLO CON TERMINAL
ETAPA 01 ESQUEMA NFC DE PLANTILLA Y PASE (Modelo NFC)
nfcEnabled: true
message: Payload dinámico (hasta 64 bytes, p. ej. serialNumber o token)
encryptionPublicKey: Clave pública ECDH P-256 en Base64 (prime256v1)
requiresAuthentication (nfcFaceIdRequired): Exigir Face ID / Touch ID
nfcNoBarcode: Ocultación opcional del código de barras 2D visual en tarjeta
Apple Wallet pass.json
ETAPA 02A "nfc": {
"message": "PI-8849-2026-X9", "encryptionPublicKey": "MDkwEw...", "requiresAuthentication": true }
[ Campo RF 13,56
TERMINAL LECTOR POS / ACCESO
1
Anuncia Hash de Pass Type ID Apple VA
2
Realiza acuerdo de claves efímero ECD
3
Envía el message descifrado a `POST
Google Wallet WalletObject
ETAPA 02B "smartTapRedemptionValue": "<msg>"
"hasUsers": true
Vinculado a redemptionIssuers de
Class (collectorId / clave P-256)
ISO/IEC 14443 ]
FC / Verifone / Ingenico)
Collector ID Google Smart Tap
-256 y descifrado AES-GCM pi/v1/scanso/api/v1/reader/redeem`

Propiedades y restricciones de configuración NFC

Propiedad (NFC / Template.nfc)Clave Apple pass.jsonTipo y restricciónComportamiento técnico
messagenfc.messagestring (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).
encryptionPublicKeynfc.encryptionPublicKeystring (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.
nfcFaceIdRequirednfc.requiresAuthenticationbooleanCuando es true, iOS exige que el titular se autentique con Face ID, Touch ID o código antes de transmitir el payload VAS.
nfcNoBarcodeOmite barcodes[]booleanCuando 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:

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):

JSON
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.

Documentación de producto y API relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.