¿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.
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
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 diccionarionfcdentro depass.json. -
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 diccionarionfcdel.pkpass. -
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
passTypeIdentifiery 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 |
|---|---|
PENDING | El espacio de trabajo ha enviado una solicitud Apple NFC/VAS; a la espera de revisión y aprobación del permiso. |
APPROVED | Solicitud de permiso aprobada; listo para emitir y subir el certificado de Apple TYPE_NFC habilitado para NFC. |
REJECTED | Solicitud rechazada o verificación incompleta del Apple Team / Pass Type ID enviado. |
PROVISIONED | El 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étodo | Ruta del endpoint | Permiso requerido | Descripción |
|---|---|---|---|
| POST | /api/v1/certificates/nfc-requests | certificates:manage | Crea una nueva solicitud NFC entitlement request (status: PENDING) mediante request payload. |
| GET | /api/v1/certificates/nfc-requests | certificates:read | Lista todos los registros NFC entitlement request de su espacio de trabajo. |
| GET | /api/v1/certificates/nfc-requests/:id | certificates:read | Recupera los detalles y el estado actual de revisión de una solicitud de certificado NFC concreta. |
| POST | /api/v1/certificates/nfc-requests/:id/review | Administrador de plataforma | Revisa y transiciona el estado de la solicitud (APPROVED, REJECTED, PROVISIONED) vía request payload. |
| POST | /api/v1/nfc/test | Autenticado | Ejecuta una prueba de configuración y payload NFC para una plantilla. |
Ejemplo: crear una solicitud NFC entitlement request (request payload)
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):
{
"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.
