Skip to content
Guía del Centro de ayuda · NFC y sin contacto
3 min de lecturaVerificado 2026-11-16

Apple VAS

Requisitos para Apple Value Added Services (VAS): certificado VAS, autorización comercial y lectores compatibles.

En esta guía

¿Qué es Apple Value Added Services (VAS)?

Apple Value Added Services (VAS) es el protocolo de comunicación NFC sin contacto de Apple basado en ISO/IEC 14443 Tipo A/B (13,56 MHz). Permite transmitir de forma inalámbrica un payload cifrado del pase (nfc.message, de hasta 64 bytes) almacenado en Apple Wallet de un iPhone o Apple Watch al acercarlo a un lector sin contacto certificado por Apple, sin necesidad de desbloquear la pantalla para mostrar un código de barras y sin realizar por error un cargo en una tarjeta de crédito o débito de Apple Pay.

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
PERMISO APPLE VAS Y NEGOCIACIÓN ECDH P-256
ETAPA 01 FASE 1: PERMISO Y APROVISIONAMIENTO DE CLAVES (NFC entitlement request)
1
El comercio solicita permiso Apple NFC (status: PENDING -> APPROVED)
2
Generar par de claves ECDH P-256 (prime256v1)
Clave pública (encryptionPublicKey)Incrustada en dict nfc pass.json
Clave privadaCargada en Secure Element del lector NFC (Slot 1..6)
3
Transición de NFC entitlement requeststatus: PROVISIONED
ETAPA 02 FASE 2: SONDEO SIN CONTACTO ISO/IEC 14443 Y DESCIFRADO
1
El lector emite SELECT OSE + SHA-256(pass.com.yourbrand.loyalty)
2
iPhone / Apple Watch despierta Wallet y valida requiresAuthentication (Face ID)
3
El dispositivo genera clave efímera ECDH P-256 y cifra nfc.message (64 B) mediante secreto compartido (ANSI X9.63 KDF + AES-256-GCM)
4
El lector descifra con su clave privadaExtrae el serialNumber
5
El lector llama a POST/api/v1/reader/redeem o POST/api/v1/reader/validate

Requisitos previos obligatorios (cumplimiento estricto)

Importante: Apple VAS no se activa automáticamente al crear un espacio de trabajo en Passinstance ni al usar un enlace NDEF. Debido a que Apple restringe a nivel de núcleo de iOS la transmisión NFC sin contacto mediante Secure Element / PassKit, todo despliegue en producción de Apple VAS requiere tres elementos obligatorios:

  1. 1
    Aprobación del permiso Apple NFC / Enhanced PassKit Entitlement: Su organización debe solicitar y recibir el NFC-Enabled Pass Entitlement directamente de Apple en su cuenta de Apple Developer (developer.apple.com/contact/passkit/). Los certificados estándar Apple Pass Type ID sin este permiso hacen que iOS ignore el diccionario nfc dentro de pass.json.
  2. 2
    Flujo de solicitud de certificado NFC en Passinstance (NFC entitlement request): Envíe y supervise su activación NFC (POST /api/v1/certificates/nfc-requests) y empareje sus dispositivos lectores (NFC Settings API) para que su clave pública de cifrado quede vinculada correctamente al diccionario nfc del .pkpass.
  3. 3
    Hardware lector certificado para Apple VAS: Los terminales de mostrador o tornos de acceso deben implementar el protocolo Apple VAS (como Certified Apple VAS & Google Smart Tap NFC readers, Verifone o terminales Ingenico compatibles con VAS) configurados con el hash SHA-256 de su passTypeIdentifier y la clave privada de descifrado ECDH P-256 correspondiente.

Ciclo de vida y estados de NFC entitlement request (NfcCertificateRequestStatus)

Passinstance realiza el seguimiento de la solicitud de permiso Apple VAS de su espacio de trabajo a través del modelo NFC entitlement request (NfcCertificateRequestStatus):

Estado (NfcCertificateRequestStatus)Significado operativo
PENDINGEl espacio de trabajo ha enviado una solicitud Apple NFC/VAS; a la espera de revisión y aprobación del permiso.
APPROVEDSolicitud de permiso aprobada; listo para emitir y subir el certificado de Apple TYPE_NFC habilitado para NFC.
REJECTEDSolicitud rechazada o verificación incompleta del Apple Team / Pass Type ID enviado.
PROVISIONEDEl certificado Pass Type habilitado para NFC (CertificateType.TYPE_NFC) y las claves de cifrado están activos en Passinstance.

Endpoints de API de Apple VAS y solicitudes NFC (NFC Request API)

MétodoRuta del endpointPermiso requeridoDescripción
POST/api/v1/certificates/nfc-requestscertificates:manageCrea una nueva solicitud NFC entitlement request (status: PENDING) mediante request payload.
GET/api/v1/certificates/nfc-requestscertificates:readLista todos los registros NFC entitlement request de su espacio de trabajo.
GET/api/v1/certificates/nfc-requests/:idcertificates:readRecupera los detalles y el estado actual de revisión de una solicitud de certificado NFC concreta.
POST/api/v1/certificates/nfc-requests/:id/reviewAdministrador de plataformaRevisa y transiciona el estado de la solicitud (APPROVED, REJECTED, PROVISIONED) vía request payload.
POST/api/v1/nfc/testAutenticadoEjecuta una prueba de configuración y payload NFC para una plantilla.

Ejemplo: crear una solicitud NFC entitlement request (request payload)

JSON
POST /api/v1/certificates/nfc-requests
{
  "organizationName": "Phenix Roasters GmbH",
  "appleTeamId": "9A8B7C6D5E",
  "passTypeId": "pass.com.phenixroasters.loyalty",
  "websiteUrl": "https://phenixroasters.com",
  "useCaseDescription": "In-store loyalty tap redemption on NFC Terminal readers across 45 cafes",
  "contactEmail": "nfc-admin@phenixroasters.com"
}

Respuesta (201 Created):

JSON
{
  "id": "nfcreq_01J9Z8A2B4C6D8E0F2G4H6J8",
  "organizationName": "Phenix Roasters GmbH",
  "appleTeamId": "9A8B7C6D5E",
  "passTypeId": "pass.com.phenixroasters.loyalty",
  "status": "PENDING",
  "createdAt": "2026-11-15T12:00:00.000Z"
}

¿Necesita ayuda para dimensionar Apple VAS en un despliegue multitienda o de control de acceso? Contacte con Soporte o revise Configuración de pases NFC 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.